KERNEL TRUNCATION/LTRUNCATE: Difference between revisions

From VASP Wiki
No edit summary
No edit summary
Line 4: Line 4:
Description: Truncates the Coulomb kernel to remove [[:Category:electrostatics|electrostatic interactions]] along non-periodic dimensions.
Description: Truncates the Coulomb kernel to remove [[:Category:electrostatics|electrostatic interactions]] along non-periodic dimensions.
----
----
Setting {{TAG|KERNEL_TRUNCATION/LTRUNCATE}} = T  switches on the Coulomb-kernel-truncation method. It 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.
Setting {{TAG|KERNEL_TRUNCATION/LTRUNCATE}} = T  switches on the Coulomb-kernel-truncation method. 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.
{{NB|important| Slabs must be centered in the unit cell.}}
{{NB|important| Slabs must be centered in the unit cell.}}
In the simplest implementation of the Coulomb-kernel-truncation method ({{TAG|KERNEL_TRUNCATION/LCOARSEN|F}}), the computational cell provided in the {{FILE|POSCAR}} file is internally padded by an additional vacuum that is of the same extend as the computational cell in each direction. This implies increasing the [[Energy cutoff and FFT meshes|FFT-grid sizes]] by a factor three and thus significant increase in computational cost.
{{NB|tip|Use the default {{TAG|KERNEL_TRUNCATION/LCOARSEN|T}} to avoid the increased [[Energy cutoff and FFT meshes|FFT-grid sizes]].}}
{{NB|mind|
{{NB|mind|
*{{TAG|KERNEL_TRUNCATION/LTRUNCATE}} acts as a "super-tag", i.e. unless this tag is switched on further options in KERNEL_TRUNCATION will be ignored.
*{{TAG|KERNEL_TRUNCATION/LTRUNCATE}} acts as a "super-tag", i.e. unless this tag is switched on further options in KERNEL_TRUNCATION will be ignored.

Revision as of 10:14, 17 March 2026

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. 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.

Important: Slabs must be centered in the unit cell.

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 that is of the same extend as the computational cell in each direction. This implies increasing the FFT-grid sizes by a factor three and thus significant increase in computational cost.

Tip: Use the default 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.

Default settings

The following default settings are assumed when setting KERNEL_TRUNCATION/LTRUNCATE = T,

  KERNEL_TRUNCATION/LTRUNCATE = T
  KERNEL_TRUNCATION/IDIMENSIONALITY = 0
  KERNEL_TRUNCATION/LCOARSEN = T

which translates to 0D coulomb truncation. This is suitable for a molecule using the coarsen before pad strategy[1]. The above INCAR settings can equivalently be specified using the following nested syntax

  KERNEL_TRUNCATION {
        LTRUNCATE      = T
        IDIMENSIONALITY = 0
        LCOARSEN       = T
  }

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

Related tags and articles

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

References