Debian Codegraph @

GUI/PWgui/doc/pwdocs/INPUT_DOS.html

raw
1
2 <html>
3 <body>
4 <pre>
5
6 ------------------------------------------------------------------------
7 INPUT FILE DESCRIPTION
8
9 Program: dos.x / PWscf / Quantum Espresso (version: 6.6)
10 ------------------------------------------------------------------------
11
12
13 Purpose of dos.x:
14 calculates the Density of States (DOS)
15 (separated into up and down components for DSDA)
16
17
18 Structure of the input data:
19 ============================
20
21 &DOS
22 ...
23 /
24
25 IMPORTANT: since v.5 namelist name is &DOS and no longer &INPUTPP
26
27
28
29 ========================================================================
30 NAMELIST: &DOS
31
32 +--------------------------------------------------------------------
33 Variable: prefix
34
35 Type: CHARACTER
36 Default: 'pwscf'
37 Description: prefix of input file produced by pw.x
38 (wavefunctions are not needed)
39 +--------------------------------------------------------------------
40
41 +--------------------------------------------------------------------
42 Variable: outdir
43
44 Type: CHARACTER
45 Description: directory containing the input data, i.e. the same as in pw.x
46 Default: value of the ESPRESSO_TMPDIR environment variable if set;
47 current directory ('./') otherwise
48 +--------------------------------------------------------------------
49
50 +--------------------------------------------------------------------
51 Variable: bz_sum
52
53 Type: CHARACTER
54 Description:
55 Keyword selecting the method for BZ summation. Available options are:
56
57 'smearing' :
58 integration using gaussian smearing. In fact currently
59 any string not related to tetrahedra defaults to smearing;
60
61 'tetrahedra' :
62 Tetrahedron method, Bloechl's version:
63 P.E. Bloechl, PRB 49, 16223 (1994)
64 Requires uniform grid of k-points, to be
65 automatically generated in pw.x.
66
67 'tetrahedra_lin' :
68 Original linear tetrahedron method.
69 To be used only as a reference;
70 the optimized tetrahedron method is more efficient.
71
72 'tetrahedra_opt' :
73 Optimized tetrahedron method:
74 see M. Kawamura, PRB 89, 094515 (2014).
75 Default: 'smearing' if degauss is given in input;
76 options read from the xml data file otherwise.
77 +--------------------------------------------------------------------
78
79 +--------------------------------------------------------------------
80 Variable: ngauss
81
82 Type: INTEGER
83 Default: 0
84 Status: optional
85 Description: Type of gaussian broadening:
86
87 = 0 Simple Gaussian (default)
88
89 = 1 Methfessel-Paxton of order 1
90
91 = -1 "cold smearing" (Marzari-Vanderbilt-DeVita-Payne)
92
93 =-99 Fermi-Dirac function
94 +--------------------------------------------------------------------
95
96 +--------------------------------------------------------------------
97 Variable: degauss
98
99 Type: REAL
100 Description: gaussian broadening, Ry (not eV!)
101 (see below)
102 +--------------------------------------------------------------------
103
104 +--------------------------------------------------------------------
105 Variables: Emin, Emax
106
107 Type: REAL
108 Default: band extrema
109 Description: min, max energy (eV) for DOS plot. If unspecified, the
110 lower and/or upper band value, plus/minus 3 times the
111 value of the gaussian smearing if present, will be used.
112 +--------------------------------------------------------------------
113
114 +--------------------------------------------------------------------
115 Variable: DeltaE
116
117 Type: REAL
118 Description: energy grid step (eV)
119 +--------------------------------------------------------------------
120
121 +--------------------------------------------------------------------
122 Variable: fildos
123
124 Type: CHARACTER
125 Default: '"prefix".dos'
126 Description: output file containing DOS(E)
127 +--------------------------------------------------------------------
128
129 ===END OF NAMELIST======================================================
130
131
132
133 :::: Notes
134
135
136 ::: Output
137
138 The total DOS (states/eV plotted vs E in eV) is written to file "fildos"
139
140
141
142 ::: Important !
143
144 The tetrahedron method is used if
145
146 - the input data file has been produced by pw.x using the option
147 occupations='tetrahedra', AND
148
149 - a value for degauss is not given as input to namelist &dos
150
151
152 Gaussian broadening is used in all other cases:
153
154 - if "degauss" is set to some value in namelist &DOS, that value
155 (and the optional value for "ngauss") is used
156
157 - if "degauss" is NOT set to any value in namelist &DOS, the
158 value of "degauss" and of "ngauss" are read from the input data
159 file (they will be the same used in the pw.x calculations)
160
161 - if "degauss" is NOT set to any value in namelist &DOS, AND
162 there is no value of "degauss" and of "ngauss" in the input data
163 file, "degauss"="DeltaE" (in Ry) and "ngauss"=0 will be used
164
165
166
167 This file has been created by helpdoc utility on Wed Dec 02 08:04:45 CET 2020
168
169 </pre>
170 </body>
171 </html>