LATTICE CONSTRAINTS: Difference between revisions

Latest revision as of 13:18, 9 December 2024

LATTICE_CONSTRAINTS = [logical][logical][logical]

Description: Sets three boolean to selectively allow changes in the lattice vectors.

The lattice vectors $\mathbf{a}_{1}$ , $\mathbf{a}_{2}$ , $\mathbf{a}_{3}$ defined in the POSCAR file can be represented by following matrix:

${\displaystyle \mathbf{A} = \begin{bmatrix} a_{11} & a_{12} & a_{13} \\ a_{21} & a_{22} & a_{23} \\ a_{31} & a_{32} & a_{33} \end{bmatrix}. }$

LATTICE_CONSTRAINTS is used to constrain certain entries of this matrix during an MD run.

Orthorhombic case

For orthorhombic unit cells $\mathbf{A}$ is of diagonal form:

${\displaystyle \mathbf{A} = \begin{bmatrix} a_{11} & 0 & 0 \\ 0 & a_{22} & 0 \\ 0 & 0 & a_{33} \end{bmatrix}, }$

Therefore by setting one of the entries of LATTICE_CONSTRAINTS to FALSE the lattice parameter in this direction will not be allowed to change. For MD simulations (IBRION=0), we recommend using LATTICE_CONSTRAINTS for (orthorhombic) liquids in the isobaric-isothermal (NpT) ensemble in the following way:

LATTICE_CONSTRAINTS = .FALSE. .FALSE. .TRUE.

Here, the first two lattice constants are not allowed to change. The third lattice constant needs to be free to allow volume changes for the barostat. The system is then like a piston. The constraints are necessary for liquids in NpT simulations because if all lattice degrees of freedom are allowed to relax, irreversible deformations of the cell are very likely to happen. This can lead to undesirable results like a very flat supercell, which cannot be used to obtain valid MD trajectories.

For structure relaxation (IBRION=1,2), LATTICE_CONSTRAINTS is useful to relax the lattice constants of 2D materials. In case of a slab in the $\mathbf{a}_1$ - $\mathbf{a}_2$ plane, add vacuum padding along $\mathbf{a}_3$ and set

LATTICE_CONSTRAINTS = .TRUE. .TRUE. .FALSE.

Non-orthorhombic case

For non-orthorhombic boxes LATTICE_CONSTRAINTS is more complicated to use. The tag will set certain rows and columns of the stress tensor

${\displaystyle \mathbf{\sigma} = \begin{bmatrix} xx & xy & xz \\ yx & yy & yz \\ zx & zy & zz \end{bmatrix}, }$

to zero. By setting certain entries of the stress tensor to zero the corresponding entries of the lattice $\mathbf{A}$ will not be updated. For example when setting LATTICE_CONSTRAINTS = .FALSE. .TRUE. .TRUE. the used stress tensor will look like

${\displaystyle \mathbf{\sigma} = \begin{bmatrix} 0 & 0 & 0 \\ 0 & yy & yz \\ 0 & zy & zz \end{bmatrix}, }$

and therefore the first row and the first column of the lattice $\mathbf{A}$ will not change. Another example would be to set LATTICE_CONSTRAINTS = .FALSE. .TRUE. .FALSE. resulting in the following stress tensor

${\displaystyle \mathbf{\sigma} = \begin{bmatrix} 0 & 0 & 0 \\ 0 & yy & 0 \\ 0 & 0 & 0 \end{bmatrix} }$

So only the $yy$ / $a_{22}$ entry of the lattice $\mathbf{A}$ will change.

Mind: Note that for non-orthorhombic boxes the angles between the lattice vectors

\mathbf{a}_{1}

,

\mathbf{a}_{2}

,

\mathbf{a}_{3}

will not be conserved.

Mind: LATTICE_CONSTRAINTS in combination with IBRION=1,2 is available from VASP 6.4.3.

Warning: Be aware of a bug in versions < 6.5.0 as described in following forum post[1].

@@ Line 3: / Line 3: @@
 Description: Sets three boolean to selectively allow changes in the lattice vectors.
 ----
-The lattice in {{VASP}} is defined by 3 lattice vectors <math>\mathbf{a}_{1}</math>, <math>\mathbf{a}_{2}</math>, <math>\mathbf{a}_{3}</math>, which
+The lattice vectors <math>\mathbf{a}_{1}</math>, <math>\mathbf{a}_{2}</math>, <math>\mathbf{a}_{3}</math>
-are defined in the {{FILE|POSCAR}} file. The lattice can be represented by the following matrix:
+defined in the {{FILE|POSCAR}} file can be represented by following matrix:
 <math>
@@ Line 15: / Line 15: @@
 </math>
-The tag {{TAG|LATTICE_CONSTRAINTS}} can be used to constrain certain entries of this matrix.
+{{TAG|LATTICE_CONSTRAINTS}} is used to constrain certain entries of this matrix during an MD run.
 ==Orthorhombic case==
-For orthorhombic boxes the lattice <math>\mathbf{A}</math> will be a diagonal matrix of the form:
+For orthorhombic unit cells <math>\mathbf{A}</math> is of diagonal form:
 <math>
@@ Line 32: / Line 32: @@
   {{TAGBL|LATTICE_CONSTRAINTS}} = .FALSE. .FALSE. .TRUE.
-This way, the first two lattice constants are not allowed to change. The third lattice constant needs to be free to allow volume changes for the barostat. The system is then like a piston. The constraints are necessary for liquids in [[NpT ensemble|NpT]] simulations because if all lattice degrees of freedom are allowed to relax, irreversible deformations of the cell are very likely to happen. This can lead to undesirable results like a very flat supercell, which cannot be used to obtain valid MD trajectories.
+Here, the first two lattice constants are not allowed to change. The third lattice constant needs to be free to allow volume changes for the barostat. The system is then like a piston. The constraints are necessary for liquids in [[NpT ensemble|NpT]] simulations because if all lattice degrees of freedom are allowed to relax, irreversible deformations of the cell are very likely to happen. This can lead to undesirable results like a very flat supercell, which cannot be used to obtain valid MD trajectories.
 For [[Ionic minimization|structure relaxation]] ({{TAG|IBRION}}=1,2), {{TAG|LATTICE_CONSTRAINTS}} is useful to relax the lattice constants of 2D materials. In case of a slab in the <math>\mathbf{a}_1</math>-<math>\mathbf{a}_2</math> plane, add vacuum padding along <math>\mathbf{a}_3</math> and set
@@ Line 39: / Line 39: @@
 ==Non-orthorhombic case==
 For non-orthorhombic boxes {{TAG|LATTICE_CONSTRAINTS}} is more complicated to use. The tag will set certain rows and columns of the stress tensor
-\begin{equation}
+<math>
     \mathbf{\sigma} =
     \begin{bmatrix}
@@ Line 46: / Line 47: @@
       zx & zy & zz
    \end{bmatrix},
-\end{equation}
+</math>
 to zero. By setting certain entries of the stress tensor to zero the corresponding entries of the lattice <math>\mathbf{A}</math> will not be updated.
-For example when setting {{TAGBL|LATTICE_CONSTRAINTS}} = .FALSE. .FALSE. .TRUE. the used stress tensor will look like
+For example when setting {{TAGBL|LATTICE_CONSTRAINTS}} = .FALSE. .TRUE. .TRUE. the used stress tensor will look like
 <math>
     \mathbf{\sigma} =
@@ Line 56: / Line 59: @@
 & zy & zz
    \end{bmatrix},
-</maht>
+</math>
 and therefore the first row and the first column of the lattice <math>\mathbf{A}</math> will not change.
-Another example would be to set {{TAGBL|LATTICE_CONSTRAINTS}} = .FALSE. .FALSE. .TRUE. resulting in the following
+Another example would be to set {{TAGBL|LATTICE_CONSTRAINTS}} = .FALSE. .TRUE. .FALSE. resulting in the following
 stress tensor
 <math>
     \mathbf{\sigma} =
@@ Line 68: / Line 73: @@
    \end{bmatrix}
 </math>
-So only the <math>yy</math>/<math>a_{22}<math> entry of the lattice <math>\mathbf{A}</math> will change.
+So only the <math>yy</math>/<math>a_{22}</math> entry of the lattice <math>\mathbf{A}</math> will change.
 {{NB|mind| Note that for non-orthorhombic boxes the angles between the lattice vectors <math>\mathbf{a}_{1}</math>, <math>\mathbf{a}_{2}</math>, <math>\mathbf{a}_{3}</math> will not be conserved.}}
-{{NB|mind| {{TAG|LATTICE_CONSTRAINTS}} in combination with {{TAG|IBRION}}{{=}}1,2 is available from VASP 6.5.0.}}
+{{NB|mind| {{TAG|LATTICE_CONSTRAINTS}} in combination with {{TAG|IBRION}}{{=}}1,2 is available from VASP 6.4.3.}}
+{{NB|warning| Be aware of a bug in versions < 6.5.0 as described in following forum post[https://www.vasp.at/forum/viewtopic.php?p{{=}}29882#p29882].}}
 == Related tags and articles ==
 {{TAG|IBRION}}, {{TAG|MDALGO}}, [[:Category:Interface pinning|Interface pinning]]