Free reference · Checked against VASP 6.6.1
VASP cheat sheets
What to type, how to check that it worked, and what usually goes wrong, for the everyday jobs of a VASP calculation. Each sheet is organized by task, gives the default and the recommended value side by side, and says why, with a link to the lecture that explains the physics.
Start from your task
- Write an INCAR for a new calculationINCAR
- Choose ISMEAR and SIGMAINCAR
- Relax a structure, then run a static calculationINCAR
- Check what VASP actually read from my INCARINCAR
- Choose a k-point meshKPOINTS
- Pick the right POTCARPOTCAR
- Fix a POSCAR that VASP will not readPOSCAR
- Write a Slurm job scriptSlurm job script
- Get the energy, forces and moments from the outputReading the output
- My SCF will not convergeErrors and fixes
- Set up an antiferromagnetMagnetism
- Find out what VASP can calculateProperties
- Compute a migration barrierNEB
- Run molecular dynamics or train a force fieldAIMD and ML force fields
Where each sheet fits
A calculation moves through the same stages every time. Each box opens its sheet.
Essentials
The input files, the job script, the output, and what to do when it fails.
INCAR
The tags to set yourself, their defaults, smearing choices and copy-ready INCARs for each task.
Open the sheet →
KPOINTS
Every KPOINTS format, which mesh suits which lattice, KSPACING and band-structure paths.
Open the sheet →
POTCAR
Suffixes decoded, building and checking a POTCAR without printing it, and the rare-earth choice.
Open the sheet →
POSCAR
The format line by line, selective dynamics, CONTCAR reuse and the mistakes that stop a run.
Open the sheet →
Slurm job script
CPU and GPU job scripts, MPI ranks and threads, NCORE and KPAR, chained jobs and monitoring.
Open the sheet →
Reading the output
Which file holds what, one-line commands for energy, forces, stress, moments and convergence.
Open the sheet →
Errors and fixes
Each error message with its cause and fix, and what to try when the SCF or a relaxation will not converge.
Open the sheet →
Applications
Research workflows, step by step.
Relaxation
From a starting structure to converged geometry, static energy, DOS and band structure.
Open the sheet →
Magnetism
Ferro-, antiferro- and ferrimagnetic setups, moments, spin–orbit coupling, anisotropy and DFT+U.
Open the sheet →
Properties
Every major property with the tags, earlier steps, output files and analysis tools it needs.
Open the sheet →
NEB
Migration barriers with stock VASP and with VTST: setup, climbing image and checks.
Open the sheet →
AIMD and ML force fields
Thermostats and ensembles, time steps, analysis, and on-the-fly machine-learned force fields.
Open the sheet →
INCAR tag index, A to Z
Every tag used in the course and the sheets, with its default. Each tag name opens its page on the VASP Wiki.
| Tag | What it does | Default | More |
|---|---|---|---|
ADDGRID | An extra, finer grid for the augmentation charges. | .FALSE. | INCAR sheet |
AEXX | Fraction of exact (Hartree–Fock) exchange in a hybrid-functional calculation. With AEXX = 1.0 VASP switches off correlation and runs a full Hartree–Fock calculation. | 0.25 with LHFCALC = .TRUE.; 0 otherwise | — |
ALGO | Electronic minimization algorithm. | Normal (blocked Davidson) | INCAR sheet |
AMIX | Linear mixing parameter for the charge density. | 0.4 (PAW) | INCAR sheet |
AMIX_MAG | Mixing parameter for the magnetization density. | 1.6 | INCAR sheet |
ANDERSEN_PROB | Andersen collision probability per atom per step (MDALGO = 1). | 0 | AIMD and ML force fields sheet |
BANDGAP | How VASP reports the band gap in OUTCAR (VASP 6.4.3 and later). | COMPACT | — |
BMIX | Cutoff wave vector of the Kerker mixing for the charge density. | 1.0 | INCAR sheet |
BMIX_MAG | Kerker cutoff for the magnetization density. | 1.0 | INCAR sheet |
CSHIFT | Complex shift (broadening) in eV used for LOPTICS. | 0.1 (for LOPTICS) | — |
CSVR_PERIOD | Time scale of the CSVR thermostat (MDALGO = 5). | 0 (= NVE) | AIMD and ML force fields sheet |
DIPOL | Centre of the cell for the dipole correction, in fractional coordinates. | not set (VASP places it half a cell away from the plane of lowest charge density) | — |
EDIFF | SCF stopping criterion: the energy change between steps, in eV. | 10−4 eV | INCAR sheet |
EDIFFG | When a relaxation stops. | EDIFF × 10 | INCAR sheet |
EFERMI | How the Fermi energy is placed. | LEGACY | INCAR sheet |
EFIELD_PEAD | A finite homogeneous electric field (eV/Å), also used internally by LCALCEPS. | 0.01 in each direction with LCALCEPS, otherwise 0 | — |
EINT | The energy window for LPARD. | not set | — |
EMAX | Upper end of the DOS energy window (eV). | highest eigenvalue plus a margin | — |
EMIN | Lower end of the DOS energy window (eV). | lowest eigenvalue minus a margin | — |
ENCUT | Plane-wave cutoff in eV: the size of the basis set. | the largest ENMAX among the POTCAR files | INCAR sheet |
ENINI | Cutoff used during the first, non-self-consistent steps of a run. | ENCUT | — |
GGA | Exchange–correlation functional of the GGA family. | the functional given by LEXCH in the POTCAR, if METAGGA and XC are not set either | INCAR sheet |
GGA_COMPAT | .FALSE. restores the full lattice symmetry of the gradient terms of GGA and meta-GGA functionals. | .TRUE. | Magnetism sheet |
HFRCUT | Coulomb truncation for hybrid functionals. | 0 | INCAR sheet |
HFSCREEN | Range-separation parameter of screened hybrids, in Å⁻¹. | 0 (no screening) | INCAR sheet |
IBAND | The bands for LPARD. | not set | — |
IBRION | How the atoms move. | −1 if NSW = −1 or 0, otherwise 0 (molecular dynamics) | INCAR sheet |
ICHAIN | VTST method: 0 nudged elastic band, 2 dimer, 1 dynamical matrix, 3 Lanczos. | 0 | NEB sheet |
ICHARG | How the starting charge density is made. | 2 if ISTART = 0, otherwise 0 | INCAR sheet |
ICORELEVEL | Core-level energies: 1 initial state, 2 final state with a core hole. | 0 | — |
IDIPOL | Direction of the dipole correction: 1, 2 or 3 along a lattice vector, 4 in all directions. | not set | — |
IMAGES | Number of images between the two end points of an NEB, one folder each (01, 02, …). | 0 | NEB sheet |
INIWAV | How the orbitals are initialized when no WAVECAR is read. INIWAV = 1 fills them with random numbers. | 1 | — |
IOPT | VTST optimizer: 1 LBFGS, 2 conjugate gradient, 3 quick-min, 7 FIRE (0 = use IBRION). | 0 | NEB sheet |
ISEARCH | Line search used by ALGO = All. | 0 | INCAR sheet |
ISIF | Which of atoms, cell shape and volume relax, and whether the stress is computed. | 0 for molecular dynamics (IBRION = 0) or hybrid functionals (LHFCALC = .TRUE.), otherwise 2 | INCAR sheet |
ISMEAR | How electrons are smeared over states near the Fermi level. | 1 | INCAR sheet |
ISPIN | Spin polarization: 1 off, 2 collinear spin-polarized. | 1 | INCAR sheet |
ISTART | Read the orbitals from WAVECAR (1) or start from scratch (0). | 1 if a WAVECAR file exists, otherwise 0 | INCAR sheet |
ISYM | How symmetry is used. | 2 for PAW; 3 with hybrids (LHFCALC); 1 with ultrasoft potentials | INCAR sheet |
IVDW | Empirical van der Waals correction, e.g. 11 for DFT-D3 with zero damping, 12 for Becke–Johnson damping. | 0 (none) | — |
I_CONSTRAINED_M | Constrain local moments: 1 direction, 2 size and direction, 4 direction and sign (VASP 6.4.0 and later). | not set | Magnetism sheet |
KBLOCK | Averages (PCDAT, DOSCAR) are written every KBLOCK × NBLOCK steps. | NSW | AIMD and ML force fields sheet |
KGAMMA | Γ-centred mesh for KSPACING. | .TRUE. | INCAR sheet |
KPAR | Number of k-point groups that run in parallel. | 1 | INCAR sheet |
KPOINTS_OPT_MODE | Diagonalizer for the KPOINTS_OPT step: 0 skip, 1 blocked Davidson, 2 exact. | 1 | KPOINTS sheet |
KPOINTS_OPT_NKBATCH | Batch size of k-points in the KPOINTS_OPT step. | the number of irreducible k-points of the self-consistent run | KPOINTS sheet |
KSPACING | k-mesh from the INCAR: the largest allowed spacing between k-points, in Å⁻¹ (2π included). | 0.5 (Γ-centred while KGAMMA = .TRUE., its default) | INCAR sheet |
KSPACING_OPT | k-spacing (Å⁻¹, 2π included) of an extra non-self-consistent mesh, used when there is no KPOINTS_OPT file. | 0.5 | KPOINTS sheet |
LAECHG | Write the all-electron core and valence densities (AECCAR0, AECCAR2) for Bader analysis. | .FALSE. | — |
LAMBDA | Weight of the penalty term for constrained moments. | 0 | Magnetism sheet |
LANGEVIN_GAMMA | Langevin friction per species in ps⁻¹ (MDALGO = 3). | 0 for each species | AIMD and ML force fields sheet |
LANGEVIN_GAMMA_L | Langevin friction of the lattice in ps⁻¹ (MDALGO = 3, ISIF = 3). | 0 | AIMD and ML force fields sheet |
LASPH | Non-spherical gradient corrections inside the PAW spheres. | .FALSE. | INCAR sheet |
LATTICE_CONSTRAINTS | Three logicals that freeze or free the lattice components during a cell relaxation or MD. | no constraints | POSCAR sheet |
LCALCEPS | The same quantities as LEPSILON from finite electric fields; works for hybrids and meta-GGA, gapped systems only. | .FALSE. | — |
LCALCPOL | Berry-phase electronic polarization. | .FALSE. | — |
LCHARG | Write CHGCAR and CHG at the end of the run. | .TRUE. (VASP 6.0–6.4.2: .NOT. LH5) | INCAR sheet |
LCHIMAG | NMR chemical shielding tensors by linear response. | .FALSE. | — |
LCLIMB | VTST climbing image: the highest image climbs to the saddle point. | .TRUE. (VTST) | NEB sheet |
LDAU | Switch on DFT+U. | .FALSE. | Magnetism sheet |
LDAUJ | J in eV, one value per species. | 0 for each species | Magnetism sheet |
LDAUL | The l quantum number that gets U, one value per species: 2 for d, 3 for f, −1 for none. | 2 for each species | Magnetism sheet |
LDAUPRINT | How much of the occupation matrices to print. | 0 | Magnetism sheet |
LDAUTYPE | DFT+U flavour: 1 Liechtenstein (U and J), 2 Dudarev (only U − J matters), 4 like 1 without exchange splitting. | 2 | Magnetism sheet |
LDAUU | U in eV, one value per species. | 0 for each species | Magnetism sheet |
LDIPOL | Dipole correction of the potential and forces for slabs and molecules. | .FALSE. | — |
LEFG | Electric field gradients at the nuclei. | .FALSE. | — |
LELF | Write the electron localization function to ELFCAR. | .FALSE. | — |
LEPSILON | Static dielectric tensor, Born effective charges and piezoelectric tensor by density-functional perturbation theory (LDA and GGA only). | .FALSE. | — |
LHFCALC | Switches on a hybrid functional with exact exchange. | .FALSE. | INCAR sheet |
LHYPERFINE | Hyperfine coupling constants (spin-polarized runs). | .FALSE. | — |
LKPOINTS_OPT | Whether VASP reads the KPOINTS_OPT file. | .TRUE. if a KPOINTS_OPT file is present | KPOINTS sheet |
LMAXMIX | Highest angular momentum ℓ of the on-site densities that are mixed and written to CHGCAR. | 2 | INCAR sheet |
LMIXTAU | Also mix the kinetic-energy density (meta-GGA). | .FALSE. | INCAR sheet |
LNEBCELL | VTST solid-state NEB: the cell changes along the path too. | .FALSE. | NEB sheet |
LNONCOLLINEAR | Noncollinear magnetism: each moment can point anywhere. | .FALSE. (.TRUE. if LSORBIT = .TRUE.) | INCAR sheet |
LOPTICS | Frequency-dependent dielectric function in the independent-particle picture. | .FALSE. | — |
LORBIT | Projections onto atoms and orbitals: PROCAR, projected DOS and site moments. | 0 (which needs RWIGS; from LORBIT = 10 on, RWIGS is ignored) | INCAR sheet |
LORBMOM | Write the orbital moments to OUTCAR (spin–orbit runs only). | .FALSE. | Magnetism sheet |
LPARD | Write band- or energy-resolved partial charge densities (PARCHG), e.g. for STM images. | .FALSE. | — |
LPHON_DISPERSION | Phonon dispersion along the QPOINTS path, for the primitive cell, from the supercell force constants of the same run (6.3.2 and later). | .FALSE. | — |
LPHON_POLAR | Dipole–dipole (LO–TO) correction for phonon dispersions of polar insulators (6.3.2 and later). | .FALSE. | Lecture 31 |
LREAL | Evaluate the projection operators in real space, which is faster for large cells. | .FALSE. | INCAR sheet |
LRPA | .TRUE. leaves the exchange-correlation local-field effects out of LEPSILON and LCALCEPS. | .FALSE. | — |
LSORBIT | Spin–orbit coupling. | .FALSE. | INCAR sheet |
LSPIRAL | Spin spirals with the generalized Bloch theorem. | .FALSE. | Magnetism sheet |
LVACPOTAV | Print the vacuum potential on both sides of a slab to OUTCAR. | .FALSE. | — |
LVHAR | Write the ionic plus Hartree potential to LOCPOT (no exchange-correlation): the choice for work functions. | .FALSE. | — |
LVTOT | Write the total local potential, exchange-correlation included, to LOCPOT. | .FALSE. | — |
LWAVE | Write WAVECAR at the end of the run. | .TRUE. | INCAR sheet |
LZEROZ | Keep the z component of the moments zero in a spin-spiral run. | .FALSE. | — |
MAGMOM | Starting magnetic moment of each atom in μB, in POSCAR order. | 1.0 per atom for ISPIN = 2; 3 × 1.0 per atom for noncollinear runs | INCAR sheet |
MAXMIX | How many previous steps the Broyden mixer keeps. | −45 | INCAR sheet |
MDALGO | Thermostat: 1 Andersen, 2 Nosé–Hoover, 3 Langevin, 4 Nosé–Hoover chain (6.4.0), 5 CSVR (6.4.3). | 0 (legacy Nosé) | AIMD and ML force fields sheet |
METAGGA | Meta-GGA functional, e.g. R2SCAN. | the functional given by LEXCH in the POTCAR | INCAR sheet |
ML_CTIFOR | Bayesian error threshold that decides when to compute a step from first principles. | 0.02 or 0.002, depending on ML_CALGO | AIMD and ML force fields sheet |
ML_LMLFF | Switch on VASP's machine-learned force field (VASP 6.3.0 and later). | .FALSE. | AIMD and ML force fields sheet |
ML_MODE | Force-field mode: train, select, refit, run, or delta (6.6.0). | none (with ML_LMLFF = .TRUE., VASP then trains) | AIMD and ML force fields sheet |
ML_OUTBLOCK | How often a prediction run (ML_MODE = run) writes output. | 10 in most cases | AIMD and ML force fields sheet |
ML_WTSIF | Weight of the stress in the force-field fit. | 1.0 (5.0 with ML_IWEIGHT = 1) | AIMD and ML force fields sheet |
M_CONSTR | Target moment direction (or vector) of each atom for constrained runs, three numbers per atom. | 3*NIONS*0.0 | Magnetism sheet |
NBANDS | Number of bands (orbitals) per k-point. | max(nint(NELECT + 2)/2 + max(NIONS/2, 3), int(0.6 NELECT)) | INCAR sheet · Lecture 2 |
NBLOCK | Every NBLOCK steps VASP writes an XDATCAR frame and updates averages. | 1 | AIMD and ML force fields sheet |
NBMOD | How LPARD selects bands: band list, all bands, or an energy window (absolute or relative to the Fermi level). | set from IBAND or EINT | — |
NCORE | Number of cores that work together on one band. | 1 | INCAR sheet |
NEDOS | Number of points on the DOS energy grid. | 301 | INCAR sheet |
NELECT | Total number of electrons; set it for charged cells (fewer electrons for a positive charge). | the valence electrons of the POTCARs (neutral cell) | Lecture 2 |
NELM | Maximum number of SCF steps per ionic step. | 60 | INCAR sheet |
NELMDL | Non-self-consistent steps at the start, before the density is updated. | −12 if ISTART = 0, INIWAV = 1 and IALGO = 48 or 50; 0 if a WAVECAR is present; −5 otherwise | INCAR sheet |
NELMIN | Minimum number of SCF steps per ionic step. | 2 | INCAR sheet |
NFREE | IBRION = 1: how many previous steps the quasi-Newton optimizer remembers; IBRION = 5, 6: displacements per direction. | 2 for IBRION = 5 and 6, otherwise 0 | Relaxation sheet |
NHC_NCHAINS | Length of the Nosé–Hoover chain (MDALGO = 4). | 0 (= NVE) | AIMD and ML force fields sheet |
NHC_PERIOD | Time scale of the Nosé–Hoover chain thermostat, in MD steps. | 40 | AIMD and ML force fields sheet |
NPAR | Legacy: the number of band groups (MPI ranks ÷ NCORE). | the number of MPI ranks | INCAR sheet |
NSIM | Number of bands optimized at once in the blocked algorithms. | 4 | INCAR sheet |
NSW | Maximum number of ionic steps. | 0 | INCAR sheet |
NUPDOWN | Fixes the difference between spin-up and spin-down electrons, i.e. the total moment. | not set (free) | INCAR sheet |
PMASS | Fictitious mass of the lattice for NpT (MDALGO = 3, ISIF = 3), in amu. | 1000 | AIMD and ML force fields sheet |
POMASS | Atomic masses (amu) per species, overriding the POTCAR values. | from the POTCAR | AIMD and ML force fields sheet |
POTIM | Step size: the time step in fs for MD, a step scaling for relaxations, the displacement in Å for finite differences. | 0.5 for IBRION = 1, 2 and 3; 0.015 Å for IBRION = 5 and 6; none for molecular dynamics (must be set) | INCAR sheet |
PREC | Precision mode: sets the default FFT grids. | Normal (Medium in VASP 4) | INCAR sheet |
PSTRESS | An external pressure in kB (1 kB = 0.1 GPa) that relaxations and NpT runs target. | 0 | Relaxation sheet |
QSPIRAL | Propagation vector of a spin spiral, in units of the reciprocal lattice vectors. | 0 0 0 | Magnetism sheet |
RANDOM_SEED | Seed of the random numbers (initial velocities, stochastic thermostats). | from the system clock | AIMD and ML force fields sheet |
RWIGS | Radius of the sphere around each species (Å) used to integrate local quantities. | −1 (from the POTCAR when LORBIT ≥ 10) | Magnetism sheet |
SAXIS | Spin quantization axis of noncollinear runs: MAGMOM and the printed moments refer to it. | 0 0 1 | Magnetism sheet |
SIGMA | Smearing width in eV. | 0.2 | INCAR sheet |
SMASS | Nosé mass for MDALGO = 0 and 2 (−3 = NVE, −1 = velocity rescaling, ≥ 0 = Nosé thermostat); damping for IBRION = 3. | −3 | AIMD and ML force fields sheet |
SPRING | Spring constant between images; a negative value switches on nudging. | −5 | NEB sheet |
SYMPREC | Tolerance for finding symmetry from the POSCAR positions. | 1E-5 | INCAR sheet |
SYSTEM | A free-text title for the run, printed in the output files. | unknown system | — |
TEBEG | Starting temperature (K); velocities are drawn from it if POSCAR has none. | 0 | AIMD and ML force fields sheet |
TEEND | Final temperature (K) of a linear ramp. | TEBEG | AIMD and ML force fields sheet |
TIME | Trial time step of the electronic algorithms ALGO = Damped and All. | 0.4 | — |
VELOCITY | Write the velocities to vaspout.h5 (VASP 6.4 and later). | .FALSE. | AIMD and ML force fields sheet |
How the sheets are checked
- Every tag, default and recommendation is read on the VASP Wiki when its sheet is written, and the sheet says which VASP version it was checked against.
- Every INCAR on a sheet is checked by the same rules as the INCAR checker, and the build rejects unknown or misspelled tags.
- Shell commands are tested on real VASP output files.
- Labels separate VASP's own advice from rules of thumb, and say when a setting needs a newer VASP or the VTST add-on.
Part of a course
These sheets are the practical side of Density Functional Theory and VASP, a free interactive course that builds the physics behind every tag, from the Schrödinger equation to Kohn–Sham DFT, k-points, plane waves and PAW.