<?xml version="1.0" encoding="ISO-8859-1"?>
<?xml-stylesheet type="text/xsl" href="input_xx.xsl"?>
<!-- FILE AUTOMATICALLY CREATED: DO NOT EDIT, CHANGES WILL BE LOST -->
    
<input_description distribution="Quantum ESPRESSO" package="PWscf" program="pw2wannier90.x" >
   <toc>
   </toc>
   <intro>
<b>Purpose of pw2wannier90.x:</b>
   Interface with wannier90 code to construct maximally localized Wannier functions.

   The code reads the nnkp file which is generated by the wannier90.x postprocessing run,
   (wannier90.x -pp seedname). Then, it computes and writes initial projection,
   overlap matrices, energy eigenvalues, and several other quantities that are used by
   the wannier90 code.

<b>Structure of the input data:</b>
============================

   <b>&amp;INPUTPP</b>
     ...
   <b>/</b>
   </intro>
   <namelist name="INPUTPP" >
      <var name="prefix" type="CHARACTER" >
         <info>
prefix of files saved by program pw.x
         </info>
      </var>
      <var name="outdir" type="CHARACTER" >
         <info>
directory containing the input data, i.e. the same as in pw.x
         </info>
         <default>
value of the <tt>ESPRESSO_TMPDIR</tt> environment variable if set;
current directory (&apos;./&apos;) otherwise
         </default>
      </var>
      <var name="seedname" type="STRING" >
         <info>
Seedname for the wannier90 calculation.
         </info>
         <default> &apos;wannier&apos;
         </default>
      </var>
      <var name="spin_component" type="STRING" >
         <info>
Spin component.
&apos;up&apos;: spin up for collinear spin calculation
&apos;down&apos;: spin down for collinear spin calculation
&apos;none&apos;: for no-spin or non-collinear calculation
         </info>
         <default> &apos;none&apos;
         </default>
      </var>
      <var name="wan_mode" type="STRING" >
         <info>
&apos;standalone&apos;: for standalone execution of wannier90
&apos;library&apos;: for wannier90 library mode
         </info>
         <default> &apos;standalone&apos;
         </default>
      </var>
      <var name="write_unk" type="LOGICAL" >
         <info>
if .TRUE. write the periodic part of the Bloch functions in real space for plotting
the Wannier functions in wannier90.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="reduce_unk" type="LOGICAL" >
         <info>
if .TRUE. reduce file-size (and resolution) of the real-space Bloch functions
by a factor of <ref>reduce_unk_factor</ref> along each direction.
Only relevant if <ref>write_unk</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="reduce_unk_factor" type="INTEGER" >
         <info>
The reduction factor per direction for <ref>reduce_unk</ref>. Default 2 means a reduction
of 2x2x2 = 8 of the total number of grid points.
Only relevant if <ref>write_unk</ref> = .true.
         </info>
         <default> 1 if <ref>reduce_unk</ref> = .FALSE., 2 if <ref>reduce_unk</ref> = .TRUE.
         </default>
      </var>
      <var name="wvfn_formatted" type="LOGICAL" >
         <info>
if .TRUE. write the wavefunctions in Fortran formatted form.
Only relevant if <ref>write_unk</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_amn" type="LOGICAL" >
         <info>
Set to .false. if A(k) is not required.
         </info>
         <default> .TRUE.
         </default>
      </var>
      <var name="scdm_proj" type="LOGICAL" >
         <info>
Set to .true. to compute amn using the SCDM projection.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="scdm_entanglement" type="STRING" >
         <info>
&apos;isolated&apos;: use SCDM for isolated bands.
&apos;erfc&apos;: use erfc function as the SCDM occupation for entanglement bands.
&apos;gaussian&apos;: use gaussian function as the SCDM occupation for entanglement bands.
         </info>
         <default> &apos;isolated&apos;
         </default>
      </var>
      <var name="scdm_mu" type="REAL" >
         <info>
Set to the chemical potential for the SCDM occupation.
Only relevant if <ref>scdm_entanglement</ref> = &apos;erfc&apos; or &apos;gaussian&apos;.
         </info>
      </var>
      <var name="scdm_sigma" type="REAL" >
         <info>
Set to the smearing for the SCDM occupation.
Only relevant if <ref>scdm_entanglement</ref> = &apos;erfc&apos; or &apos;gaussian&apos;.
         </info>
      </var>
      <var name="atom_proj" type="LOGICAL" >
         <info>
Set to .true. to compute amn using the pseudo-atomic wavefunctions
from pseudopotentials as the initial projection.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <dimension name="atom_proj_exclude" start="1" end="n_exclude_proj" type="INTEGER" >
         <info>
Set to the index of the pseudo-atomic wavefunctions to be excluded
from the initial projection. This is useful for excluding the
semicore states from the initial projection.
Only relevant if <ref>atom_proj</ref> = .true.
         </info>
         <default> empty
         </default>
      </dimension>
      <var name="atom_proj_ext" type="LOGICAL" >
         <info>
Set to .true. to use the external pseudo-atomic wavefunctions
from the files stored in <ref>atom_proj_dir</ref> as the initial projection.
Only relevant if <ref>atom_proj</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="atom_proj_dir" type="CHARACTER" >
         <info>
Set to the directory containing the external pseudo-atomic wavefunctions.
The file names should be of the form SPECIES.dat, where SPECIES is the
species name of the atom.
For more details, see the wannier90 user guide and examples.
Only relevant if <ref>atom_proj_ext</ref> = .true.
         </info>
      </var>
      <var name="atom_proj_ortho" type="LOGICAL" >
         <info>
Set to .true. to orthonormalize the pseudo-atomic wavefunctions
before computing the inner product between Bloch states and
the pseudo-atomic wavefunctions.
It is recommended to keep this to .true., set it to .false. only
if you know what you are doing.
Only relevant if <ref>atom_proj</ref> = .true.
         </info>
         <default> .TRUE.
         </default>
      </var>
      <var name="write_mmn" type="LOGICAL" >
         <info>
Set to .false. if M(k,b) is not required.
         </info>
         <default> .TRUE.
         </default>
      </var>
      <var name="write_spn" type="LOGICAL" >
         <info>
Set to .true. to write out the matrix elements of spin operator
S between Bloch states (non-collinear spin calculation only).
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="spn_formatted" type="LOGICAL" >
         <info>
Set to .true. to write spn data as a formatted file.
Only relevant if <ref>write_spn</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_uHu" type="LOGICAL" >
         <info>
Set to .true. to write out the matrix elements of
&lt; unk+b1 | Hk | umk+b2 &gt;.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="uHu_formatted" type="LOGICAL" >
         <info>
Set to .true. to write uHu data as a Fortran formatted file.
Only relevant if <ref>write_uHu</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_uIu" type="LOGICAL" >
         <info>
Set to .true. to write out the matrix elements of
&lt; unk+b1 | umk+b2 &gt;.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="uIu_formatted" type="LOGICAL" >
         <info>
Set to .true. to write uIu data as a Fortran formatted file.
Only relevant if <ref>write_uIu</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_sHu" type="LOGICAL" >
         <info>
Set to .true. to write out the matrix elements of
&lt; unk | s H | umk+b &gt;, which is used in the Ryoo&apos;s method
to compute spin Hall conductivity. For more details, see the
wannier90 user guide and examples.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="sHu_formatted" type="LOGICAL" >
         <info>
Set to .true. to write sHu data as a Fortran formatted file.
Only relevant if <ref>write_sHu</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_sIu" type="LOGICAL" >
         <info>
Set to .true. to write out the matrix elements of
&lt; unk | s | umk+b &gt;, which is used in the Ryoo&apos;s method
to compute spin Hall conductivity. For more details, see the
wannier90 user guide and examples.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="sIu_formatted" type="LOGICAL" >
         <info>
Set to .true. to write sIu data as a Fortran formatted file.
Only relevant if <ref>write_sIu</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_unkg" type="LOGICAL" >
         <info>
Set to .true. to write the first few Fourier components of the
periodic parts of the Bloch functions.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="irr_bz" type="LOGICAL" >
         <info>
Set to .true. to use irreducible BZ for computing amn/mmn/eig
files. To differentiate from the standard full BZ case, the
files will use the extension names iamn/immn/ieig, respectively.
For more details, see the wannier90 user guide and examples.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="write_dmn" type="LOGICAL" >
         <info>
Set to .true. to construct symmetry-adapted Wannier functions.
         </info>
         <default> .FALSE.
         </default>
      </var>
      <var name="read_sym" type="LOGICAL" >
         <info>
Set to .true. to customize symmetry operations to be used in symmetry-adapted mode.
When read_sym = .true., an additional input seedname.sym is required.
Only relevant if <ref>write_dmn</ref> = .true.
         </info>
         <default> .FALSE.
         </default>
      </var>
   </namelist>
</input_description>
