Thermodynamic integration calculations: Difference between revisions

From VASP Wiki
No edit summary
Line 1: Line 1:
A detailed description of calculations using thermodynamic integration within VASP is given in the supplemental information of reference {{cite|dorner:PRL:2018}} ('''caution''': the tag ''ISPECIAL''=0 used in that reference is not valid anymore, instead the tag {{TAG|PHON_NSTRUCT}}=-1 is used).
There are three ways for thermodynamic integration (TI) implemented in VASP:


*TI with an "arbitrary" reference state using {{TAG|VCAIMAGES}}{{cite|dorner:PRL:2018}}.
*TI with a harmonic solid as a reference state using {{TAG|SCALEE}}{{cite|dorner:PRL:2018}}.
*TI with a harmonic solid as a reference state using {{TAG|TILAMBDA}}.
'''Caution:''' the tag ''ISPECIAL''=0 used in that reference {{cite|dorner:PRL:2018}} is not valid anymore, instead the tag {{TAG|PHON_NSTRUCT}}=-1 is used).
=== TI using VCAIMAGES ===
The main tags for this type of calculation are {{TAG|VCAIMAGES}} and {{TAG|NCORE_IN_IMAGE1}}.
This calculation requires a parent directory and two subdirectories named ''01'' and ''02'' (two images). All thre directories must contain {{TAG|VCAIMAGES}} and {{TAG|NCORE_IN_IMAGE1}} in the {{FILE|INCAR}} file with identical values in each of them. The subdirectories must contain identical {{FILE|POSCAR}} and {{FILE|POTCAR}} files. The rest of the files can be different. For example one can do a TI from a smaller number of k-points to a larger number (different {{FILE|KPOINT}} file) or a TI from a machine learning force field (MLFF) to ab-initio. The files in the parent directory must be identical to the files of the ''01'' directory, with exception of the {{FILE|INCAR}} file. The parent directory only requires to have the {{TAG|VCAIMAGES}} and {{TAG|NCORE_IN_IMAGE1}} in it. The {{FILE|INCAR}} tags concerning the molecular dynamics parameters (e.g. IBRION, ISIF, POTIM, MDALGO, etc.) need to be identical in both subdirectories. The parameters concerning the calculation of the forces can be different (different parameters for electronic minimization, MLFF vs. ab-initio, etc.). 
=== TI using SCALEE ===
This calculaion is run in a single folder.
This calculation requires a {{FILE|DYNMATFULL}} file in the calculation directory which contains the eigenvalues and eigenvectors from the diagonalization of the dynamic matrix within the harmonic approximation from a previous calulation. To obtain that you must before run a calculation with {{TAG|IBRION}}=6 and {{TAG|PHON_NSTRUCT}}=-1 in the {{FILE|INCAR}} file.
The tag {{TAG|SCALEE}} sets the coupling parameter <math>\lambda</math> and hence controls the Hamiltonian of the calculation.  
The tag {{TAG|SCALEE}} sets the coupling parameter <math>\lambda</math> and hence controls the Hamiltonian of the calculation.  
By default {{TAG|SCALEE}}=1 and the scaling of the energies and forces via the coupling constant is internally skipped in the code. To enable the scaling {{TAG|SCALEE}}<math>\ne</math>1 has to be specified. A VASP calculation outputs the integrand for a given coupling constant at every molecular dynamics step. How to choose the ensemble size and carry out the integration is described in the main text and especially in the supplementary information of reference {{cite|dorner:PRL:2018}}.
By default {{TAG|SCALEE}}=1 and the scaling of the energies and forces via the coupling constant is internally skipped in the code. To enable the scaling {{TAG|SCALEE}}<math>\lt</math>1 has to be specified. A VASP calculation outputs the integrand for a given coupling constant at every molecular dynamics step. How to choose the ensemble size and carry out the integration is described in the main text and especially in the supplementary information of reference {{cite|dorner:PRL:2018}}.  
 
To carry out thermodyanamic integration calculations the calculation needs to be split into two images via the tag {{TAG|VCAIMAGES}}. One also needs to set how many cores are used for each image vial {{TAG|NCORE_IN_IMAGE1}}.


Two possible options are available for the reference system:
Two possible options are available for the reference system:

Revision as of 10:15, 12 September 2025

There are three ways for thermodynamic integration (TI) implemented in VASP:

  • TI with an "arbitrary" reference state using VCAIMAGES[1].
  • TI with a harmonic solid as a reference state using SCALEE[1].
  • TI with a harmonic solid as a reference state using TILAMBDA.

Caution: the tag ISPECIAL=0 used in that reference [1] is not valid anymore, instead the tag PHON_NSTRUCT=-1 is used).

TI using VCAIMAGES

The main tags for this type of calculation are VCAIMAGES and NCORE_IN_IMAGE1. This calculation requires a parent directory and two subdirectories named 01 and 02 (two images). All thre directories must contain VCAIMAGES and NCORE_IN_IMAGE1 in the INCAR file with identical values in each of them. The subdirectories must contain identical POSCAR and POTCAR files. The rest of the files can be different. For example one can do a TI from a smaller number of k-points to a larger number (different KPOINT file) or a TI from a machine learning force field (MLFF) to ab-initio. The files in the parent directory must be identical to the files of the 01 directory, with exception of the INCAR file. The parent directory only requires to have the VCAIMAGES and NCORE_IN_IMAGE1 in it. The INCAR tags concerning the molecular dynamics parameters (e.g. IBRION, ISIF, POTIM, MDALGO, etc.) need to be identical in both subdirectories. The parameters concerning the calculation of the forces can be different (different parameters for electronic minimization, MLFF vs. ab-initio, etc.).

TI using SCALEE

This calculaion is run in a single folder. This calculation requires a DYNMATFULL file in the calculation directory which contains the eigenvalues and eigenvectors from the diagonalization of the dynamic matrix within the harmonic approximation from a previous calulation. To obtain that you must before run a calculation with IBRION=6 and PHON_NSTRUCT=-1 in the INCAR file. The tag SCALEE sets the coupling parameter [math]\displaystyle{ \lambda }[/math] and hence controls the Hamiltonian of the calculation. By default SCALEE=1 and the scaling of the energies and forces via the coupling constant is internally skipped in the code. To enable the scaling SCALEE[math]\displaystyle{ \lt }[/math]1 has to be specified. A VASP calculation outputs the integrand for a given coupling constant at every molecular dynamics step. How to choose the ensemble size and carry out the integration is described in the main text and especially in the supplementary information of reference [1].

Two possible options are available for the reference system:

  • Ideal gas:

By default the thermodynamic integration is carried out from the ideal gas to the fully interacting case (in the case when no DYNMATFULL is present in the calculation folder). Usually the Stirling approximation is used for the free energy of the ideal gas written as

[math]\displaystyle{ F = -\frac{1}{\beta} \mathrm{ln} \left[ \frac{V^{N}}{\Alpha^{3N} N!} \right] }[/math]

where [math]\displaystyle{ V }[/math] is the volume of the system, [math]\displaystyle{ N }[/math] is the number of particles in the system and [math]\displaystyle{ \Alpha }[/math] is the de Broglie wavelength. The Stirling approximation applies in principle only in the limes of infinitely many particles. In reference [1] the exact ideal gas equation was used since it helped to speed up the convergence of the final free energy of liquid Si with respect to the system size.

  • Harmonic solid:

If the file DYNMATFULL exists in the calculation directory and SCALEE[math]\displaystyle{ \ne }[/math]1, the second order Hessian matrix is added to the force and thermodynamic integration from a harmonic model to a fully interacting system is carried out. The DYNMATFULL file stores the eigenmodes and eigenvalues from diagonalizing the dynamic matrix. This file is written by a previous calculation using the INCAR tags IBRION=6 and PHON_NSTRUCT=-1.

Alternative way of thermodynamic integration for harmonic solid

The TI calculations in internal coordinates are performed in NVT ensemble using any thermostat available in VASP. The coupling parameter [math]\displaystyle{ \lambda }[/math] is defined by setting the parameter TILAMBDA in the INCAR file. The set of internal coordinates used in the TI calculation are defined via the ICONST file by setting the status to 3. The Hesse matrix [math]\displaystyle{ \mathbf{\underline{H}}^\mathbf{x} }[/math] is provided in the file HESSEMAT and its transformation into [math]\displaystyle{ \mathbf{\underline{H}}^\mathbf{q} }[/math] is performed by VASP. The potential energies of the system 1 and 0,[math]\displaystyle{ \mathbf{q} }[/math], needed to compute [math]\displaystyle{ \langle V_1 -V_{0,\mathbf{q}} \rangle }[/math] used as integrant in the TI expression for [math]\displaystyle{ \Delta A_{0,\mathbf{q} \rightarrow 1} }[/math], are written in the file REPORT in lines introduce by a string "e_ti>"

References