POTCAR: Difference between revisions

Latest revision as of 08:12, 20 October 2023

The POTCAR file essentially contains the pseudopotential for each atomic species used in the calculation. If the number of species is larger than one, one simply concatenates the POTCAR files of the species. On a UNIX machine you might type the line

cat ~/pot/Al/POTCAR ~/pot/C/POTCAR ~/pot/H/POTCAR > POTCAR

to concatenate three POTCAR files. The first file will correspond to the first species in the POSCAR and the INCAR file etc.

Mind: It is a frequent error to give the wrong ordering in the POTCAR file!

For VASP version ≥ 3.2, the POTCAR file also contains information about the atoms, i.e., their mass POMASS, their number of valence electrons ZVAL, the energy of the reference configuration for which the pseudopotential was created, etc. If tags for the mass and valence exist in the INCAR file, they are checked against the parameters found in the POTCAR file, and error messages are printed. The POTCAR files also contain a default energy cutoff (ENMAX and ENMIN); therefore, it is no longer necessary to specify ENCUT in the INCAR file. The value in the INCAR file overwrites the default in the POTCAR file. For POTCAR files with more than one species, the maximum cutoffs (ENMAX or ENMIN) are used for the calculation.

Important: The POTCAR file is meant to be used as read-only by the user. There is no standard usage of VASP that requires modifying the POTCAR file. Specifically do not modify the LEXCH tag in the POTCAR file: VASP recalculates the exchange-correlation energy inside the PAW sphere using the functional specified in the INCAR file and corrects the atomic energies. For this to work properly, the original LEXCH tag must not be modified in the POTCAR file.

To decide which potentials to use in your calculations visit our list of available PAW potentials

@@ Line 1: / Line 1: @@
-The {{FILE|POTCAR}} file contains the pseudopotential for each atomic species used in the calculation. If the number of species is larger than one simply concats the {{FILE|POTCAR}} files of the species. On a UNIX machine you might type the line
+The {{FILE|POTCAR}} file essentially contains the pseudopotential for each atomic species used in the calculation. If the number of species is larger than one, one simply concatenates the {{FILE|POTCAR}} files of the species. On a UNIX machine you might type the line
-  cat ~/pot/Al/POTCAR ~/pot/C/POTCAR ~/pot/H/POTCAR >POTCAR
+  cat ~/pot/Al/POTCAR ~/pot/C/POTCAR ~/pot/H/POTCAR > POTCAR
-to concat three {{FILE|POTCAR}} files. The first file will correspond to the first species on the {{FILE|POSCAR}} and {{FILE|INCAR}} file and so on. Starting from version VASP 3.2, the {{FILE|POTCAR}} file also contains information about the atoms (i.e. there mass, their valence, the energy of the reference configuration for which the pseudopotential was created etc.). With these new {{FILE|POTCAR}} file it is not necessary to specify valence and mass in the {{FILE|INCAR}} file. If tags for the mass and valence exist in the {{FILE|INCAR}} file they are checked against the parameters found on the {{FILE|POTCAR}} file and error messages are printed.<br />
+to concatenate three {{FILE|POTCAR}} files. The first file will correspond to the first species in the {{FILE|POSCAR}} and the {{FILE|INCAR}} file etc.
-'''Mind''': Be very careful with the concatenation of the {{FILE|POTCAR}} files, it is a frequent error to give the wrong ordering in the {{FILE|POTCAR}} file!
+{{NB|mind| It is a frequent error to give the wrong ordering in the {{FILE|POTCAR}} file!}}
-The new {{FILE|POTCAR}} files also contains a default energy cutoff (ENMAX and ENMIN line), therefore it is no longer necessary to specify {{TAG|ENCUT}} in the INCAR file. Of course the value in the {{FILE|INCAR}} file overwrites the default in the {{FILE|POTCAR}} file. For {{FILE|POTCAR}} files with more than one species the maximum cutoffs (ENMAX or ENMIN) are used for the calculation.
+For VASP version ≥ 3.2, the {{FILE|POTCAR}} file also contains information about the atoms, i.e., their mass [[POMASS]], their number of valence electrons [[ZVAL]], the energy of the reference configuration for which the pseudopotential was created, etc. If tags for the mass and valence exist in the {{FILE|INCAR}} file, they are checked against the parameters found in the {{FILE|POTCAR}} file, and error messages are printed. The  {{FILE|POTCAR}} files also contain a default energy cutoff ([[ENMAX]] and [[ENMIN]]); therefore, it is no longer necessary to specify {{TAG|ENCUT}} in the {{FILE|INCAR}} file. The value in the {{FILE|INCAR}} file overwrites the default in the {{FILE|POTCAR}} file. For {{FILE|POTCAR}} files with more than one species, the maximum cutoffs ([[ENMAX]] or [[ENMIN]]) are used for the calculation.
+{{NB| important | The {{FILE|POTCAR}} file is meant to be used as read-only by the user. There is no standard usage of VASP that requires modifying the POTCAR file. Specifically do not modify the LEXCH tag in the POTCAR file: VASP recalculates the exchange-correlation energy inside the PAW sphere using the functional specified in the INCAR file and corrects the atomic energies. For this to work properly, the original LEXCH tag must not be modified in the POTCAR file.}}
+To decide which potentials to use in your calculations visit our list of [[available PAW potentials]]
 ----
-[[The_VASP_Manual|Contents]]
-[[Category:Files]][[Category:Input Files]]
+[[Category:Files]][[Category:Input files]]