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 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.
Setting {{TAG|KERNEL_TRUNCATION/LTRUNCATE}} = T  switches on the Coulomb-kernel-truncation method{{cite|vijay:prb:2025}}. 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.
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.
Line 11: Line 11:
*{{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.
*This tag is only available as of VASP.6.5.0.}}
*This tag is only available as of VASP.6.5.0.}}
== Default settings ==
The following default settings are assumed when setting {{TAG|KERNEL_TRUNCATION/LTRUNCATE}} = T,
  {{TAGBL|KERNEL_TRUNCATION/LTRUNCATE}} = T
  {{TAGBL|KERNEL_TRUNCATION/IDIMENSIONALITY}} = 0
  {{TAGBL|KERNEL_TRUNCATION/LCOARSEN}} = T
which translates to 0D coulomb truncation. This is suitable for a molecule using the coarsen before pad strategy{{cite|vijay:prb:2025}}. The above {{FILE|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.
Detailed information about the setting are documented on respective related tags.



Revision as of 10:35, 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[1]. 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.

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