NBMOD: Difference between revisions

From VASP Wiki
No edit summary
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{DEF|NBMOD|n| if {{TAG|IBAND}} is set and contains n values |-2| if {{TAG|EINT}} is set and {{TAG|IBAND}} is not set |-1| if neither {{TAG|EINT}} nor {{TAG|IBAND}} are set}}
{{DEF|NBMOD|n| if {{TAG|IBAND}} is set and contains n values |-2| if {{TAG|EINT}} is set and {{TAG|IBAND}} is not set |-1| if neither {{TAG|EINT}} nor {{TAG|IBAND}} are set}}


Description: {{TAG|NBMOD}} controls how bands are selected when computing partial charge densities.  
Description: {{TAG|NBMOD}} controls how bands are selected when computing [[Band-decomposed charge densities|partial charge densities]].  


----
----


{{TAG|NBMOD}} is used with other tags to define mode of band selection for partial charge densities in {{FILE|PARCHG}} or {{FILE|CHGCAR}} files. There are several ways to set this tag.  
{{TAG|NBMOD}} is used with other tags to define the mode of band selection for partial charge densities in {{FILE|PARCHG}}, {{FILE|vaspout.h5}}, or {{FILE|CHGCAR}} files. There are several ways to set this tag.  
* {{TAG|NBMOD}} = n: Use n bands
* {{TAG|NBMOD}} = n: Use n bands
:If a positive integer is passed, {{TAG|NBMOD}} represents the number of values in the array {{TAG|IBAND}}. If {{TAG|IBAND}} is specified, {{TAG|NBMOD}} is set automatically to the number of values passed in {{TAG|IBAND}}.
:If a positive integer is passed, {{TAG|NBMOD}} represents the number of values in the array {{TAG|IBAND}}. If {{TAG|IBAND}} is specified, {{TAG|NBMOD}} is set automatically to the number of values passed in {{TAG|IBAND}}.
Line 15: Line 15:


* {{TAG|NBMOD}} = -1: Use all occupied bands
* {{TAG|NBMOD}} = -1: Use all occupied bands
: This mode writes the charge density of all occupied states to the {{FILE|CHGCAR}} file, and no {{FILE|PARCHG}} file is produced. In contrast to producing a {{FILE|CHGCAR}} file from the {{FILE|WAVECAR}} input without the partial charges methodology (e.g. by setting {{TAG|LPARD}} = .FALSE., {{TAG|ALGO}} = None, and {{TAG|NELM}} = 1), the [[Projector-augmented-wave_formalism#The_compensation_or_augmentation_density|augmentation occupancies]] is not included in the produced {{FILE|CHGCAR}} file for {{TAG|NBMOD}} = -1. THowever, the fine FFT grid's valence charge density is equivalent.
: This mode writes the charge density of all occupied states to the {{FILE|CHGCAR}} file, and no {{FILE|PARCHG}} file is produced. In contrast to producing a {{FILE|CHGCAR}} file from the {{FILE|WAVECAR}} input without the partial charges methodology (e.g. by setting {{TAG|LPARD}} = .FALSE., {{TAG|ALGO}} = None, and {{TAG|NELM}} = 1), the [[Projector-augmented-wave_formalism#The_compensation_or_augmentation_density|augmentation occupancies]] is not included in the produced {{FILE|CHGCAR}} file for {{TAG|NBMOD}} = -1. However, the fine FFT grid's valence charge density is equivalent.


* {{TAG|NBMOD}} = -2: Use an absolute energy interval to select contributing bands
* {{TAG|NBMOD}} = -2: Use an absolute energy interval to select contributing bands
Line 30: Line 30:
{{TAG|LSEPB}},
{{TAG|LSEPB}},
{{TAG|LSEPK}},
{{TAG|LSEPK}},
<!--{{TAG|LPARDH5}},-->
{{FILE|PARCHG}},
{{FILE|PARCHG}},
{{TAG|Band decomposed charge densities}}
{{FILE|vaspout.h5}},
[[Band-decomposed charge densities]]


{{sc|NBMOD|Examples|Examples that use this tag}}
{{sc|NBMOD|Examples|Examples that use this tag}}
----
----


<!--[[Category:INCAR tag]][[Category:Charge density]]
[[Category:INCAR tag]][[Category:Charge density]]

Latest revision as of 11:41, 14 June 2024

NBMOD = -3 | -2 | -1 | 0 | [positive integer] 

Default: NBMOD = n if IBAND is set and contains n values
= -2 if EINT is set and IBAND is not set
= -1 if neither EINT nor IBAND are set

Description: NBMOD controls how bands are selected when computing partial charge densities.


NBMOD is used with other tags to define the mode of band selection for partial charge densities in PARCHG, vaspout.h5, or CHGCAR files. There are several ways to set this tag.

If a positive integer is passed, NBMOD represents the number of values in the array IBAND. If IBAND is specified, NBMOD is set automatically to the number of values passed in IBAND.
Tip: There is no good reason to set NBMOD to a positive integer since it will be overwritten regardless if IBAND is set or not. Use the IBAND tag alone to enter this mode.
All bands, even unoccupied ones, are contributing to calculating the partial charge density. E.g. the resulting partial charge density in the PARCHG file will sum up to twice the value of the number of total bands NBANDS.
  • NBMOD = -1: Use all occupied bands
This mode writes the charge density of all occupied states to the CHGCAR file, and no PARCHG file is produced. In contrast to producing a CHGCAR file from the WAVECAR input without the partial charges methodology (e.g. by setting LPARD = .FALSE., ALGO = None, and NELM = 1), the augmentation occupancies is not included in the produced CHGCAR file for NBMOD = -1. However, the fine FFT grid's valence charge density is equivalent.
  • NBMOD = -2: Use an absolute energy interval to select contributing bands
The partial charge density is calculated for electrons in the energy interval specified by EINT.
  • NBMOD = -3: Use an energy interval to select contributing bands and add the Fermi energy to the passed values
The partial charge density is calculated for electrons in the energy interval specified by EINT. In this mode, the values in EINT are interpreted as relative to the Fermi energy . E.g. if EINT = -0.1 0.5 and = 2.43, the chosen energy interval will range from 2.33 to 2.93 eV.

Related tags and articles

LPARD, IBAND, EINT, KPUSE, LSEPB, LSEPK, PARCHG, vaspout.h5, Band-decomposed charge densities

Examples that use this tag