View source for Band decomposed charge densities

VASP can calculate the partial (band decomposed) charge density according to parameters specified in the {{TAG|INCAR}} file. It must be noted, that the densities calculated by VASP (including the band decomposed charge density) are always symmetrized using the space group and point group symmetry determined by VASP. In some cases (calculation of charge from selected k-points) this can lead to undesired results for the band decomposed charge density. In this case, the symmetry needs to be switched off for the ground state and successive band decomposed charge density calculations.

Mind that the partial charge density can be calculated only if a preconverged {{TAG|WAVECAR}} file exists, VASP enters the evaluation routine very quickly and stops immediately after evaluating the partial charge densities. This implementation was chosen to allow a fast (almost interactive) recalculation of the charge density for particular bands and k-points.

The following parameters control the behaviour of VASP:

*{{TAG|LPARD}}: Evaluate partial (band and/or k-point) decomposed charge densities. We want to stress again, that the orbitals read from {{TAG|WAVECAR}} must be converged in a separate prior run. If only {{TAG|LPARD}} is set (and none of the tags discussed below), the total charge density is evaluated from the orbitals and written to {{TAG|CHGCAR}}.

There are several ways how to specify for which bands the charge density is evaluated: In general the input lines with {{TAG|IBAND}}, {{TAG|EINT}} and {{TAG|NBMOD}} control this aspect of the routine.

*{{TAG|IBAND}}: Calculate the partial charge density for all bands specified in the array {{TAG|IBAND}}. If {{TAG|IBAND}} is specified in the {{TAG|INCAR}} file  and {{TAG|NBMOD}} is not given, {{TAG|NBMOD}} is set automatically to the size of the array. If {{TAG|IBAND}} is for instance

 IBAND = 20 21 22 23

the charge density will be calculated for bands 20 to 23.

*{{TAG|EINT}}: Specifies the energy range of the bands that are used for the evaluation of the partial charge density. Two real values should  be given, if only one value is specified, the second one is set to <math>\epsilon_{f}</math>. If {{TAG|EINT}} is given and {{TAG|NBMOD}} is not specified, {{TAG|NBMOD}} is set automatically to -2.

*{{TAG|NBMOD}}: This integer variable can take the following values

>0: Number of values in the array {{TAG|IBAND}}. If {{TAG|IBAND}} is specified, {{TAG|NBMOD}} is set automatically to the correct value (in that case {{TAG|NBMOD}} should not be set manually in the {{TAG|INCAR}} file)

0: Take all bands to calculate the charge density, even unoccupied bands are taken into account.

-1: Calculate the total charge density as usual. This is the default value if nothing else is given.

-2: Calculate the partial charge density for electrons with the eigenvalues in the range specified by {{TAG|EINT}}.

-3: The same as before, but the energy range is given vs. the Fermi energy.

*{TAG|KPUSE}}: Specifies which k-points are used in the evaluation of the partial DOS. {{TAG|KPUSE}} is an array of integer values. 

 KPUSE= 1 2 3 4

means that the charge density is evaluated and summed for the first four k-points. Be careful: VASP changes the k-point weights if {{TAG|KPUSE}} is specified.

{{TAG|LSEPB}}: Specifies whether the charge density is calculated for every band separately and written to a file {{TAG|PARCHG}}.nb.* ({{TAG|LSEPB}}=''.TRUE.'') or whether charge density is merged for all selected bands and written to the file {{TAG|PARCHG}}.ALLB.* or {{TAG|PARCHG}}. Default is {{TAG|LSEPB}}=''.FALSE.''.

{{TAG|LSEPK}}: Specifies whether the charge density of every k-point is write to the files {{TAG|PARCHG}}.*.nk ({{TAG|LSEPK}}=''.TRUE.'') or whether it is merged ({{TAG|LSEPK}}=''.FALSE.'') to a single file. If the merged file is written, then the weight of each k-point is determined from the {{TAG|KPOINTS}} file, otherwise the kpoints weights of one are chosen.

== Related Tags and Sections ==
{{TAG|LPARD}},
{{TAG|IBAND}},
{{TAG|EINT}},
{{TAG|NBMOD}},
{{TAG|KPUSE}},
{{TAG|LSEPB}}
{{TAG|LSEPK}}

----
[[The_VASP_Manual|Contents]]

[[Category:INCAR]]