KERNEL TRUNCATION/FACTOR: Difference between revisions

From VASP Wiki
(Created page with "{{TAGDEF|KERNEL_TRUNCATION/FACTOR| real}} {{DEF|KERNEL_TRUNCATION/FACTOR|$\sqrt{3}$|if {{TAGO|KERNEL_TRUNCATION/IDIMENSIONALITY|0}}|1|if {{TAGO|KERNEL_TRUNCATION/IDIMENSIONALITY|2}}}} '''Description:''' {{TAG|KERNEL_TRUNCATION/FACTOR}} determines the spatial extent of the truncated Coulomb interaction relative to the full cell dimension along the truncation direction{{cite|vijay:arxiv:2024}}. ---- This tag defines the cutoff distance of the Coulomb kernel truncati...")
 
No edit summary
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{TAGDEF|KERNEL_TRUNCATION/FACTOR| real}}
{{TAGDEF|KERNEL_TRUNCATION/FACTOR| real}}
{{DEF|KERNEL_TRUNCATION/FACTOR|$\sqrt{3}$|if {{TAGO|KERNEL_TRUNCATION/IDIMENSIONALITY|0}}|1|if {{TAGO|KERNEL_TRUNCATION/IDIMENSIONALITY|2}}}}
{{DEF|KERNEL_TRUNCATION/FACTOR|$\sqrt{3}$|if {{TAG|KERNEL_TRUNCATION/IDIMENSIONALITY|0}}|1|if {{TAG|KERNEL_TRUNCATION/IDIMENSIONALITY|2}}}}


'''Description:'''   
'''Description:'''   
Line 8: Line 8:


This tag defines the cutoff distance of the Coulomb kernel truncation boundary. It is expressed as a fraction of the simulation cell length along the truncated axis (e.g., the surface normal for 2D systems).   
This tag defines the cutoff distance of the Coulomb kernel truncation boundary. It is expressed as a fraction of the simulation cell length along the truncated axis (e.g., the surface normal for 2D systems).   
For example, when truncating along <code>z</code>, setting {{TAG|KERNEL_TRUNCATION/FACTOR}} = 0.5 ensures that electrostatic interactions only occur up to half the cell length in the <code>z</code>-direction, effectively centering the truncated region around the middle of the slab or molecule.
{{NB|mind|{{TAG|KERNEL_TRUNCATION/LTRUNCATE}} must be set to <code>.TRUE.</code> for {{TAG|KERNEL_TRUNCATION/FACTOR}} to take effect.}}
{{NB|mind|{{TAG|KERNEL_TRUNCATION/LTRUNCATE}} must be set to <code>.TRUE.</code> for {{TAG|KERNEL_TRUNCATION/FACTOR}} to take effect.}}
{{NB|warning|When padding is used, the vaccum is added on the edges of the cell, as such it is very important that the motif is centered in the simulation box. If you encounter problems using Coulomb truncation with padding, try the same calculations without padding (see examples bellow).}}
== Example ==


== Example ==
<pre>
KERNEL_TRUNCATION {
    LTRUNCATE      = T
    IDIMENSIONALITY = 2
    ISURFACE        = 3
    IPAD            = 2
    FACTOR          = 1
}
</pre>
In this case an additional empty cell is added along the z direciton as padding. The coulomb interaction is truncated beyond a z length. This ensures maximum usage of the simulation box.


<pre>
<pre>
Line 18: Line 27:
     LTRUNCATE      = T
     LTRUNCATE      = T
     IDIMENSIONALITY = 2
     IDIMENSIONALITY = 2
    ISURFACE        = 3
    IPAD            = 1
     FACTOR          = 0.5
     FACTOR          = 0.5
}
}
</pre>
</pre>


This corresponds to truncation along the surface normal (<code>z</code>-direction), keeping interactions within half of the cell length in <code>z</code>.
This setup corresponds to truncating the Coulomb interaction along the surface normal (z-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, but the algorithm remains simpler. This configuration can be useful for debugging purposes.


== Related tags and articles ==
== Related tags and articles ==

Latest revision as of 08:12, 24 October 2025

KERNEL_TRUNCATION/FACTOR = real 

Default: KERNEL_TRUNCATION/FACTOR = $\sqrt{3}$ if KERNEL_TRUNCATION/IDIMENSIONALITY = 0
= 1 if KERNEL_TRUNCATION/IDIMENSIONALITY = 2

Description: KERNEL_TRUNCATION/FACTOR determines the spatial extent of the truncated Coulomb interaction relative to the full cell dimension along the truncation direction[1].


This tag defines the cutoff distance of the Coulomb kernel truncation boundary. It is expressed as a fraction of the simulation cell length along the truncated axis (e.g., the surface normal for 2D systems).

Mind: KERNEL_TRUNCATION/LTRUNCATE must be set to .TRUE. for KERNEL_TRUNCATION/FACTOR to take effect.
Warning: When padding is used, the vaccum is added on the edges of the cell, as such it is very important that the motif is centered 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
     IPAD            = 2
     FACTOR          = 1
}

In this case an additional empty cell is added along the z direciton as padding. The coulomb interaction is truncated beyond a z length. This ensures maximum usage of the simulation box.

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 (z-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, but the algorithm remains simpler. This configuration can be useful for debugging purposes.

Related tags and articles

KERNEL_TRUNCATION/LTRUNCATE, KERNEL_TRUNCATION/IDIMENSIONALITY, KERNEL_TRUNCATION/LCOARSEN, KERNEL_TRUNCATION/IPAD, KERNEL_TRUNCATION/ISURFACE

References