KERNEL_TRUNCATION/LTRUNCATE

From VASP Wiki
Revision as of 15:23, 18 March 2026 by Svijay (talk | contribs) (→‎Example)

KERNEL_TRUNCATION/LTRUNCATE = .True. | .False.
Default: KERNEL_TRUNCATION/LTRUNCATE = .False. 

Description: Truncates the Coulomb kernel to remove electrostatic interactions along non-periodic dimensions.


Setting KERNEL_TRUNCATION/LTRUNCATE = T switches on the Coulomb-kernel-truncation method[1][2][3]. It effectively removes interactions with periodic replicas in non-periodic directions. In other words, the interactions are removed along the surface normal for 2D materials, and along all directions for 0D systems, i.e. for isolated atoms and molecules.

In the simplest implementation of the Coulomb-kernel-truncation method (KERNEL_TRUNCATION/LCOARSEN = F), the computational cell provided in the POSCAR file is internally padded by an additional vacuum (see KERNEL_TRUNCATION/IPAD). This implies increasing the FFT-grid sizes by a certain factor and thus leads to a significant increase in computational cost.

Tip: Use the KERNEL_TRUNCATION/LCOARSEN = T to avoid the increased FFT-grid sizes.
Mind:
  • KERNEL_TRUNCATION/LTRUNCATE acts as a "super-tag", i.e. unless this tag is switched on further options in KERNEL_TRUNCATION will be ignored.
  • This tag is only available as of VASP.6.5.0.

Detailed information about the setting are documented on respective related tags.

Warning: When padding is used, the vaccum is added on the edges of the cell, therefore it is very important there are no atoms on the cell boundary in the non-periodic direction. We recommend centering the motif in the simulation box. If you encounter problems using Coulomb truncation with padding, try the same calculations without padding (see examples bellow).

Example

KERNEL_TRUNCATION {
     LTRUNCATE       = T
     IDIMENSIONALITY = 2
     ISURFACE        = 3
     LCOARSEN        = F
}

In this case, we pad the cell along the surface normal direction. The Coulomb interaction is truncated beyond the boundaries of the cell along this direction.

KERNEL_TRUNCATION {
     LTRUNCATE       = T
     IDIMENSIONALITY = 2
     ISURFACE        = 3
     IPAD            = 1
     FACTOR          = 0.5
}

This setup corresponds to truncating the Coulomb interaction along the surface normal direction for a 2D material, using no vacuum padding and a truncation length of z/2. In this case, half of the simulation box is effectively unused and will produce a potential that is not desired. However, the algorithm is much simpler. We recommend this configuration can for debugging purposes.

Related tags and articles

KERNEL_TRUNCATION/LCOARSEN, KERNEL_TRUNCATION/IDIMENSIONALITY, KERNEL_TRUNCATION/ISURFACE, KERNEL_TRUNCATION/FACTOR, KERNEL_TRUNCATION/IPAD

References