VCAIMAGES: Difference between revisions

From VASP Wiki
No edit summary
No edit summary
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{TAGDEF|VCAIMAGES|[real]|-1}}
{{TAGDEF|VCAIMAGES|[real]|-1}}


Description: The tag {{TAG|VCAIMAGES}} allows to perform two different MD's with e.g. different {{TAG|POTCAR}} files and perform force averaging between the two calculations.
Description: The tag {{TAG|VCAIMAGES}} allows to perform thermodynamic coupling constant integrations. To achieve this, two molecular dynamics simulations are performed with e.g. different {{TAG|POTCAR}} or {{TAG|KPOINTS}} files or different exchange-correlation functionals, and force averaging between the two calculations is done{{cite|dorner:PRL:2018}}.
----
----
The tag {{TAG|VCAIMAGES}} gives the weight of the first image. The weight of the second image is 1-{{TAG|VCAIMAGES}}. Each image needs a seperate directory with all important files in it ({{TAG|POSCAR}}, {{TAG|INCAR}}, {{TAG|KPOINTS}} and {{TAG|POTCAR}}). The subdirectories for images one
The tag {{TAG|VCAIMAGES}} internally splits the available nodes into two groups, and each group
and two have to be named '''01''' and '''02''', respectively. The tags {{TAG|VCAIMAGES}} and {{TAG|NCORE_IN_IMAGE1}} have to be the same in the {{TAG|INCAR}} files of the parent directory and both subdirectories. {{TAG|POTCAR}}, {{TAG|POSCAR}} and {{TAG|KPOINTS}} are first seeked in the root directory, and if they do not exist they have to be in the subdirectories '''01''' or '''02'''. The {{TAG|KPOINTS}} files can differ in the subdirectories. Also the remaining {{TAG|INCAR}} tags can differ in the subdirectories.
then performs an independent VASP calculation (this implies {{TAG|VCAIMAGES}} only works in the MPI version).  
This behavior is implemented in the same way as
the nudged elastic band method described under the tag {{TAG|IMAGES}}. As opposed to the nudged
elastic band method, VASP creates always two images by setting the tag {{TAG|IMAGES}}=2 internally.
The two calculations are performed in subdirectories 01 and 02 (as opposed to the nudged elastic
band method, subdirectories 00 and 03  are not required). A precise description of the file
reading and writing is given below.


Forces and energies are averaged over the two images.
The two VASP calculations are essentially performed independently in subdirectories 01 and 02.
The forces, energies and the stress tensor of the two calculations are averaged according to the tag {{TAG|VCAIMAGES}}.
Specifically, the value supplied in the tag {{TAG|VCAIMAGES}} determines the weight of the calculations
performed in subdirectory 01. The weight of the second image is 1-{{TAG|VCAIMAGES}}. The averaging
is performed after self-consistency has been reached and affects the final total energy as well as
the forces. Since the energies and forces are averaged, the trajectories generated by the two simulations
will be exactly identical. Make sure though, that the initial {{TAG|POSCAR}} files in the two subdirectories
are exactly identical. The averaged energies can be found in the {{TAG|OUTCAR}} file after the lines
"ENERGY OF THE ELECTRON-ION-THERMOSTAT SYSTEM (eV)", as well as in the file {{TAG|OSZICAR}}
(in the lines writing the free energy  "F="). This makes scanning the {{TAG|OSZICAR}} file for the
required energies of the individual calculations somewhat awkward.


By setting this tag to {{TAG|VCAIMAGES}}>-1 (regardless of the value) the tag {{TAG|IMAGES}}=2 is set. This means the communicator is split into two images. To set the number of cores in the first image the tag {{TAG|NCORE_IN_IMAGE1}} has to be set. The second image contains the remaining number of cores.
Special handling: In some cases it might be desirable to use a different number of cores for
the first image and the second image. For instance, this might be expedient for calculations
where thermodynamic integration is performed from a coarse to a dense k-point grid, or from a cheap
to an expensive exchange-correlation functional.  
To set the number of cores in the first image the tag {{TAG|NCORE_IN_IMAGE1}} has to be set. The second image then
contains the remaining cores.


== Related Tags and Sections ==
The usage of this tag is also explained in the supplementary information of reference {{cite|dorner:PRL:2018}}.
{{TAG|NCORE_IN_IMAGE1}}


== Related tags and articles ==
{{TAG| NCORE_IN_IMAGE1}}, {{TAG|SCALEE}}, {{TAG| IMAGES}}
== References ==
<references/>
<noinclude>
----
----


[[Category:INCAR]][[Category:Molecular Dynamics]][[Category:Thermodynamic integration]]
[[Category:INCAR tag]][[Category:Advanced molecular-dynamics sampling]]

Latest revision as of 14:06, 16 October 2024

VCAIMAGES = [real]
Default: VCAIMAGES = -1 

Description: The tag VCAIMAGES allows to perform thermodynamic coupling constant integrations. To achieve this, two molecular dynamics simulations are performed with e.g. different POTCAR or KPOINTS files or different exchange-correlation functionals, and force averaging between the two calculations is done[1].


The tag VCAIMAGES internally splits the available nodes into two groups, and each group then performs an independent VASP calculation (this implies VCAIMAGES only works in the MPI version). This behavior is implemented in the same way as the nudged elastic band method described under the tag IMAGES. As opposed to the nudged elastic band method, VASP creates always two images by setting the tag IMAGES=2 internally. The two calculations are performed in subdirectories 01 and 02 (as opposed to the nudged elastic band method, subdirectories 00 and 03 are not required). A precise description of the file reading and writing is given below.

The two VASP calculations are essentially performed independently in subdirectories 01 and 02. The forces, energies and the stress tensor of the two calculations are averaged according to the tag VCAIMAGES. Specifically, the value supplied in the tag VCAIMAGES determines the weight of the calculations performed in subdirectory 01. The weight of the second image is 1-VCAIMAGES. The averaging is performed after self-consistency has been reached and affects the final total energy as well as the forces. Since the energies and forces are averaged, the trajectories generated by the two simulations will be exactly identical. Make sure though, that the initial POSCAR files in the two subdirectories are exactly identical. The averaged energies can be found in the OUTCAR file after the lines "ENERGY OF THE ELECTRON-ION-THERMOSTAT SYSTEM (eV)", as well as in the file OSZICAR (in the lines writing the free energy "F="). This makes scanning the OSZICAR file for the required energies of the individual calculations somewhat awkward.

Special handling: In some cases it might be desirable to use a different number of cores for the first image and the second image. For instance, this might be expedient for calculations where thermodynamic integration is performed from a coarse to a dense k-point grid, or from a cheap to an expensive exchange-correlation functional. To set the number of cores in the first image the tag NCORE_IN_IMAGE1 has to be set. The second image then contains the remaining cores.

The usage of this tag is also explained in the supplementary information of reference [1].

Related tags and articles

NCORE_IN_IMAGE1, SCALEE, IMAGES

References