Thermodynamic integration calculations

From VASP Wiki
Revision as of 10:30, 15 September 2025 by Karsai (talk | contribs) (→‎TI using TILAMBDA)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

VASP supports three approaches to thermodynamic integration (TI):

  • TI between any two states using VCAIMAGES[1].
  • TI with a harmonic solid or ideal gas as a reference state using SCALEE[1].
  • TI with a harmonic solid as a reference state using TILAMBDA.

Details on choosing the ensemble size and how to perform the integration are described in the main text and especially the supplementary information of reference [1]. Caution: the tag ISPECIAL=0 used in that reference is not valid anymore, instead the tag PHON_NSTRUCT=-1 is used.

TI using VCAIMAGES

Main tags:

Directory structure:

  • A parent directory with two subdirectories: 01 and 02 (these represent two images).
  • All three directories must include the VCAIMAGES and NCORE_IN_IMAGE1 tags in their INCAR files, with identical values.
  • Subdirectories must contain identical POSCAR and POTCAR files. Other files (e.g., KPOINTS) can differ, enabling TI between distinct calculation setups (e.g., different k-point meshes, machine learning force fields vs. ab-initio).
  • The parent directory's files should match those in 01, except for the INCAR, which only needs the VCAIMAGES and VCAIMAGES entries.
  • Parameters controlling atomic motion (e.g., IBRION, ISIF, POTIM, MDALGO) must be identical in both subdirectories.
  • Force calculation parameters may differ.

How it works:

  • Similar to nudged elastic band calculations, VASP runs multiple calculations (subdirectories 01 and 02).
  • The VCAIMAGES tag linearly combines the forces and stresses:
  • NCORE_IN_IMAGE1 sets the number of cores used for 01; remaining cores are used for 02.
Warning: Both directories must contain the same positions after applying the forces and the thermostat contributions. So thermostats containing random numbers cannot be used (MDALGO must be 2).

TI using SCALEE

Main tags:

  • SCALEE: Sets the coupling parameter and determines the Hamiltonian used in the calculation.

Directory structure:

  • Thermodynamic integration (TI) with SCALEE is performed in a single directory.
  • Optionally, the calculation can read the file DYNMATFULL if present (see details below).

How it works:

  • The main control tag is SCALEE, which sets the coupling parameter and determines the Hamiltonian used in the calculation.

Available options for 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

where is the volume of the system, is the number of particles in the system and 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 SCALEE1, 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. This calculaion runs in a single folder. It optionally reads in a DYNMATFULL file in the calculation directory (for more details see below). The tag SCALEE sets the coupling parameter 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 SCALEE1 has to be specified.

TI using TILAMBDA

Main tags:

Directory structure:

  • Thermodynamic integration (TI) with TILAMBDA is performed in a single directory.
  • Internal coordinates for the TI calculation are defined in the ICONST file, with the status set to 3.
  • The Hessian matrix in Cartesian coordinates, , must be provided in the HESSEMAT file. VASP automatically transforms this matrix to internal coordinates, .

How it works:

  • VASP computes the potential energies for both systems (system 1 and system 0) in the internal coordinate representation, .
  • These values are used to evaluate the integrand in the TI expression .
  • The TI calculations are performed in the NVT ensemble using any thermostat available in VASP.

Output:

  • The required energies are written in the REPORT file. Look for lines beginning with the string e_ti>.

References