PROOUT: Difference between revisions

From VASP Wiki
No edit summary
No edit summary
Line 1: Line 1:
This file is written when {{TAG|LORBIT}}=5 and {{TAG|RWIGS}} tags are set in the {{TAG|INCAR}} file and contains the projection of the Bloch wavefunctions <math>|\psi_{n\mathbf{k}}\rangle</math> onto <math>|\beta^\alpha_{lm}\rangle</math> which can be written as
This file is written if {{TAG|LORBIT}}=5 and the {{TAG|RWIGS}} tag is set in the {{TAG|INCAR}} file. It contains the projection of the Kohn-Sham orbitals <math>|\psi_{n\mathbf{k}}\rangle</math> onto a localized orbitals basis <math>|\beta^\alpha_{lm}\rangle</math> which can be written as


<math>
<math>
Line 5: Line 5:
\equiv \langle \beta_{lm}^{\alpha}|S|\psi_{n\mathbf{k}}\rangle
\equiv \langle \beta_{lm}^{\alpha}|S|\psi_{n\mathbf{k}}\rangle
= \underbrace{\langle \beta_{lm}^{\alpha}|\psi_{n\mathbf{k}}\rangle}_{P^{\text{SOFT},\alpha}_{lmn\mathbf{k}}} +  
= \underbrace{\langle \beta_{lm}^{\alpha}|\psi_{n\mathbf{k}}\rangle}_{P^{\text{SOFT},\alpha}_{lmn\mathbf{k}}} +  
\underbrace{\sum_{ij} \langle \beta^\alpha_{lm}|p_i\rangle Q_{ij} \langle p_j | \psi_{n\mathbf{k}}\rangle}_{P^{\text{AUG},\alpha}_{lmn\mathbf{k}}}
\underbrace{\sum_{ij} \langle \beta^\alpha_{lm}|p_i\rangle Q_{ij} \langle p_j | \phi_{n\mathbf{k}}\rangle}_{P^{\text{AUG},\alpha}_{lmn\mathbf{k}}}.
</math>
</math>


with the two terms on the right-hand side being called soft and augmentation part respectively and S the overlap matrix
Here, the two terms on the right-hand side are called soft and augmentation part, respectively, and <math>S</math> is the overlap matrix,


<math>S = 1+\sum_{ij} |p_i\rangle Q_{ij} \langle p_j|.</math>
<math>S = 1+\sum_{ij} |p_i\rangle Q_{ij} \langle p_j|.</math>


The angular part of the functions <math>\beta^\alpha_{lm}(\mathbf{r})</math> is described by spherical harmonics <math>Y^\alpha_{lm}(\hat{\mathbf{r}})</math> and the radial part by a linear combination of spherical bessel functions parametrized to be non-zero within a radius determined by {{TAG|RWIGS}}
The radial and the angular part of <math>\beta^\alpha_{lm}(\mathbf{r})</math> are described by a linear combination of spherical bessel functions <math>\phi_n(r)</math> and by spherical harmonics <math>Y^\alpha_{lm}(\hat{\mathbf{r}})</math>, respectively:


<math>
<math>
Line 19: Line 19:
</math>
</math>


It so happens that the <math>|p_i\rangle</math> functions have a similar structure to <math>|\beta^\alpha_{lm}\rangle</math> which simplifies the computations above.
The spherical bessel functions <math>\phi_n(r)</math> are parametrized to be non-zero within a radius determined by {{TAG|RWIGS}}. In addition, it so happens that <math>|p_i\rangle</math> has a similar form as <math>|\beta^\alpha_{lm}\rangle</math> which simplifies the computations above.


For the case of spin-polarized {{TAG|ISPIN}}=2 or noncollinear calculations {{TAG|LNONCOLLINEAR}}=.TRUE., two files are produced PROOUT.1 and PROOUT.2 referring to the up and down part of the spinor of the orbital.
The {{TAG|PROOUT}} file contains similar information as the {{TAG|PROCAR}} file but the following differences exist:
{{NB|warning|This file is not correctly written when {{TAG|LNONCOLLINEAR}} {{=}} .TRUE. for versions of VASP <{{=}} 6.2.1 }}
*The {{TAG|PROOUT}} file writes the real and imaginary parts of <math>P^{\text{SOFT},\alpha}_{lmn\mathbf{k}}</math>, and the real part of the augmentation part <math>P^{\text{AUG},\alpha}_{lmn\mathbf{k}}</math>.
*The {{TAG|PROCAR}} file contains the information of the squared projection, <math>P^\alpha_{lmn\mathbf{k}} (P^\alpha_{lmn\mathbf{k}})^{*}</math>, whereas the {{TAG|PROOUT}} file contains <math>P^\alpha_{lmn\mathbf{k}}</math>.
*The arrangement of the output is very different in both files.


The {{TAG|PROOUT}} file is similar in information to the {{TAG|PROCAR}} file but the following differences exist:
This information makes it possible to construct, e.g., partial DOS projected onto bonding and anti-bonding molecular orbitals and the so-called crystal-orbital-overlap-population (COOP) function. Depending on the application, users might find it more practical to use the information contained in the {{FILE|PROJCAR}} and {{FILE|LOCPROJ}} files. These are controlled by the {{TAG|LOCPROJ}} tag.
*The {{TAG|PROOUT}} file writes the real and imaginary parts of <math>P^{\text{SOFT},\alpha}_{lmn\mathbf{k}}</math> and the real part of the augmentation part <math>P^{\text{AUG},\alpha}_{lmn\mathbf{k}}</math>.
*The {{TAG|PROCAR}} file contains the information on the square, <math>P^\alpha_{lmn\mathbf{k}} (P^\alpha_{lmn\mathbf{k}})^{*}</math>, whereas the {{TAG|PROOUT}} file describes <math>P^\alpha_{lmn\mathbf{k}}</math>.
*The arrangement of the output is very different in both files.


Depending on the intended application users might find it more practical to use the information contained in the {{FILE|PROJCAR}} and {{FILE|LOCPROJ}} files controlled by the {{TAG|LOCPROJ}} tag.
For spin-polarized calculations with {{TAG|ISPIN}}=2 and noncollinear calculations with {{TAG|LNONCOLLINEAR}}=.TRUE., '''PROOUT.1''' and '''PROOUT.2''' are written, referring to the Kohn-Sham orbitals' two spin components.


== Format ==
== Format ==
Line 35: Line 34:
*line 2: Number of kpoints, bands and ions
*line 2: Number of kpoints, bands and ions
*line 3: Twice the number of types followed by the number of ions for each type
*line 3: Twice the number of types followed by the number of ions for each type
*line 4: The Fermi weights for each kpoint (inner loop) and band (outer loop)
*line 4: The Fermi weights for each k point (inner loop) and band (outer loop)
*line 5 <math>-</math> ...: Real and imaginary part of <math>P^{\text{SOFT},\alpha}_{lmn\mathbf{k}}</math> for every lm-quantum number (inner loop), band, ion per type, kpoint and ion-type (outer loop)
*line 5 <math>-</math> ...: Real and imaginary part of <math>P^{\text{SOFT},\alpha}_{lmn\mathbf{k}}</math> for every <math>lm</math>-quantum number (inner loop), band, ion per type, k point and ion type (outer loop).
*below : augmentation part
*below : augmentation part
*last line: real part of <math>P^{\text{AUG},\alpha}_{lmn\mathbf{k}}</math> for every lm-quantum number (inner loop), ion per type, ion-type, band and k point (outer loop)
*last line: real part of <math>P^{\text{AUG},\alpha}_{lmn\mathbf{k}}</math> for every <math>lm</math>-quantum number (inner loop), ion per type, ion type, band and k point (outer loop).
 
{{NB|warning|This file is not correctly written when {{TAG|LNONCOLLINEAR}} {{=}} .TRUE. for versions of VASP <{{=}} 6.2.1 }}
This information makes it possible to construct e.g. partial DOS projected onto bonding and anti-bonding molecular orbitals or the so-called coop (crystal overlap population function).


== Related Tags and Sections ==
== Related Tags and Sections ==
{{TAG|LORBIT}} {{FILE|LOCPROJ}} {{FILE|PROJCAR}}
{{TAG|LORBIT}}, {{FILE|LOCPROJ}}, {{FILE|PROJCAR}}, {{FILE|PROCAR}}


----
----


[[Category:Files]][[Category:Output Files]]
[[Category:Files]][[Category:Output Files]]

Revision as of 11:54, 29 November 2021

This file is written if LORBIT=5 and the RWIGS tag is set in the INCAR file. It contains the projection of the Kohn-Sham orbitals onto a localized orbitals basis which can be written as

Here, the two terms on the right-hand side are called soft and augmentation part, respectively, and is the overlap matrix,

The radial and the angular part of are described by a linear combination of spherical bessel functions and by spherical harmonics , respectively:

The spherical bessel functions are parametrized to be non-zero within a radius determined by RWIGS. In addition, it so happens that has a similar form as which simplifies the computations above.

The PROOUT file contains similar information as the PROCAR file but the following differences exist:

  • The PROOUT file writes the real and imaginary parts of , and the real part of the augmentation part .
  • The PROCAR file contains the information of the squared projection, , whereas the PROOUT file contains .
  • The arrangement of the output is very different in both files.

This information makes it possible to construct, e.g., partial DOS projected onto bonding and anti-bonding molecular orbitals and the so-called crystal-orbital-overlap-population (COOP) function. Depending on the application, users might find it more practical to use the information contained in the PROJCAR and LOCPROJ files. These are controlled by the LOCPROJ tag.

For spin-polarized calculations with ISPIN=2 and noncollinear calculations with LNONCOLLINEAR=.TRUE., PROOUT.1 and PROOUT.2 are written, referring to the Kohn-Sham orbitals' two spin components.

Format

  • line 1: PROOUT
  • line 2: Number of kpoints, bands and ions
  • line 3: Twice the number of types followed by the number of ions for each type
  • line 4: The Fermi weights for each k point (inner loop) and band (outer loop)
  • line 5 ...: Real and imaginary part of for every -quantum number (inner loop), band, ion per type, k point and ion type (outer loop).
  • below : augmentation part
  • last line: real part of for every -quantum number (inner loop), ion per type, ion type, band and k point (outer loop).
Warning: This file is not correctly written when LNONCOLLINEAR = .TRUE. for versions of VASP <= 6.2.1

Related Tags and Sections

LORBIT, LOCPROJ, PROJCAR, PROCAR