1. Interaction energy functionals

A few interaction energy functionals $W$ are defined in HyMD through the Hamiltonian class and associated subclasses.

1.1. $\chi$–interaction and $\kappa$–incompressibility

The most common hPF energy functional is specified by

hamiltonian = "DefaultWithChi"

in the configuration file (see Configuration file). It takes the form

$$W=\frac{1}{2{\varphi }_0}\int \mathrm{d}\mathbf{r}\sum _{\text{i},\text{j}}{\tilde{\chi }}_{\text{i}-\text{j}}{\tilde{\varphi }}_{\text{i}}(\mathbf{r}){\tilde{\varphi }}_{\text{j}}(\mathbf{r})+\frac{1}{2\kappa }{(\sum _{\text{k}}{\tilde{\varphi }}_{\text{k}}(\mathbf{r})-{\varphi }_0)}^2,$$

where ${\tilde{\chi }}_{\text{A}-\text{B}}$ is the interaction energy between overlapping densities of particle types $\text{A}$ and $\text{B}$. The incompressibility term is governed by the compressibility parameter $\kappa$. The average density of the full system is denoted ${\varphi }_0$.

Using this energy functional necessitates specification of $\tilde{\chi }$ and $\kappa$ in the configuration file (see Configuration file)

kappa = 0.05
chi = [
   ["A", "B", 15.85],
   ["B", "C", -5.70],
   ...
]

1.2. Only $\kappa$–incompressibility

The only $\kappa$ interactions energy functional is specified by

hamiltonian = "DefaultNoChi"

in the configuration file (see Configuration file). It takes the form

$$W=\int \mathrm{d}\mathbf{r}\frac{1}{2\kappa }{(\sum _{\text{k}}{\tilde{\varphi }}_{\text{k}}(\mathbf{r})-{\varphi }_0)}^2,$$

where the incompressibility term is governed by the compressibility parameter $\kappa$. The average density of the full system is denoted ${\varphi }_0$.

Using this energy functional necessitates specification of $\kappa$ in the configuration file (see Configuration file)

kappa = 0.05

1.3. Only ${\varphi }^2$

The ${\varphi }^2$ interactions energy functional is specified by

hamiltonian = "SquaredPhi"

in the configuration file (see Configuration file). It takes the form

$$W=\int \mathrm{d}\mathbf{r}\frac{1}{2\kappa {\varphi }_0}{(\sum _{\text{k}}{\tilde{\varphi }}_{\text{k}}(\mathbf{r}))}^2,$$

where the $\varphi$ squared term is governed by the compressibility parameter $\kappa$. The average density of the full system is denoted ${\varphi }_0$.

Using this energy functional necessitates specification of $\kappa$ in the configuration file (see Configuration file)

kappa = 0.05

1.4. Implementing new interaction energy forms

Implementing new interaction energy functions is straightforward by subclassing Hamiltonian and applying sympy differentiation to the symbolic field objects. The sympy.lamdify function creates vectorised numpy functions automatically from the differentiation result which is used to transform the density fields.