Debian Codegraph @

GUI/PWgui/doc/pwdocs/INPUT_PROJWFC.html

raw
1
2 <html>
3 <body>
4 <pre>
5
6 ------------------------------------------------------------------------
7 INPUT FILE DESCRIPTION
8
9 Program: projwfc.x / PWscf / Quantum Espresso (version: 6.6)
10 ------------------------------------------------------------------------
11
12
13 Purpose of projwfc.x:
14 projects wavefunctions onto orthogonalized atomic wavefunctions,
15 calculates Lowdin charges, spilling parameter, projected DOS
16 (separated into up and down components for lSDA)
17 alternatively, computes the local DOS(E), integrated in volumes
18 given in input
19
20 Structure of the input data:
21 ============================
22
23 &PROJWFC
24 ...
25 /
26
27
28
29 ========================================================================
30 NAMELIST: &PROJWFC
31
32 +--------------------------------------------------------------------
33 Variable: prefix
34
35 Type: CHARACTER
36 Description: prefix of input file produced by pw.x (wavefunctions are needed)
37 Default: 'pwscf'
38 +--------------------------------------------------------------------
39
40 +--------------------------------------------------------------------
41 Variable: outdir
42
43 Type: CHARACTER
44 Description: directory containing the input data, i.e. the same as in pw.x
45 Default: value of the ESPRESSO_TMPDIR environment variable if set;
46 current directory ('./') otherwise
47 +--------------------------------------------------------------------
48
49 +--------------------------------------------------------------------
50 Variable: ngauss
51
52 Type: INTEGER
53 Default: 0
54 Description: Type of gaussian broadening:
55 0 ... Simple Gaussian (default)
56 1 ... Methfessel-Paxton of order 1
57 -1 ... "cold smearing" (Marzari-Vanderbilt-DeVita-Payne)
58 -99 ... Fermi-Dirac function
59 +--------------------------------------------------------------------
60
61 +--------------------------------------------------------------------
62 Variable: degauss
63
64 Type: REAL
65 Default: 0.0
66 Description: gaussian broadening, Ry (not eV!)
67 +--------------------------------------------------------------------
68
69 +--------------------------------------------------------------------
70 Variables: Emin, Emax
71
72 Type: REAL
73 Default: (band extrema)
74 Description: min & max energy (eV) for DOS plot
75 +--------------------------------------------------------------------
76
77 +--------------------------------------------------------------------
78 Variable: DeltaE
79
80 Type: REAL
81 Description: energy grid step (eV)
82 +--------------------------------------------------------------------
83
84 +--------------------------------------------------------------------
85 Variable: lsym
86
87 Type: LOGICAL
88 Default: .true.
89 Description: if .true. the projections are symmetrized,
90 the partial density of states are computed
91 if .false. the projections are not symmetrized, the partial
92 DOS can be computed only in the k-resolved case
93 +--------------------------------------------------------------------
94
95 +--------------------------------------------------------------------
96 Variable: pawproj
97
98 Type: LOGICAL
99 Default: .false.
100 Description: if .true. use PAW projectors and all-electron PAW basis
101 functions to calculate weight factors for the partial
102 densities of states. Following Bloechl, PRB 50, 17953 (1994),
103 Eq. (4 & 6), the weight factors thus approximate the real
104 charge within the augmentation sphere of each atom.
105 Only for PAW, not implemented in the noncolinear case.
106 +--------------------------------------------------------------------
107
108 +--------------------------------------------------------------------
109 Variable: filpdos
110
111 Type: CHARACTER
112 Description: prefix for output files containing PDOS(E)
113 Default: (value of "prefix" variable)
114 +--------------------------------------------------------------------
115
116 +--------------------------------------------------------------------
117 Variable: filproj
118
119 Type: CHARACTER
120 Default: (standard output)
121 Description: file containing the projections
122 +--------------------------------------------------------------------
123
124 +--------------------------------------------------------------------
125 Variable: lwrite_overlaps
126
127 Type: LOGICAL
128 Default: .false.
129 Description: if .true., the overlap matrix of the atomic orbitals
130 prior to orthogonalization is written to the atomic_proj
131 datafile. Does not work together with linear-algebra
132 diagonalization: run as "mpirun -np N projwfc.x -nd 1 ... "
133 +--------------------------------------------------------------------
134
135 +--------------------------------------------------------------------
136 Variable: lbinary_data
137
138 Type: LOGICAL
139 Default: .false.
140 Description: if .true., the atomic_proj datafile is written in binary fmt.
141 Currently disabled.
142 +--------------------------------------------------------------------
143
144 +--------------------------------------------------------------------
145 Variable: kresolveddos
146
147 Type: LOGICAL
148 Default: .false.
149 Description: if .true. the k-resolved DOS is computed: not summed over
150 all k-points but written as a function of the k-point index.
151 In this case all k-point weights are set to unity
152 +--------------------------------------------------------------------
153
154 +--------------------------------------------------------------------
155 Variable: tdosinboxes
156
157 Type: LOGICAL
158 Default: .false.
159 Description: if .true. compute the local DOS integrated in volumes
160
161 Volumes are defined as boxes with edges parallel to the unit cell,
162 containing the points of the (charge density) FFT grid included within
163 "irmin" and "irmax", in the three dimensions:
164
165 from "irmin"(j,n) to "irmax"(j,n) for j=1,2,3 (n=1,"n_proj_boxes").
166 +--------------------------------------------------------------------
167
168 +--------------------------------------------------------------------
169 Variable: n_proj_boxes
170
171 Type: INTEGER
172 Default: 1
173 Description: number of boxes where the local DOS is computed
174 +--------------------------------------------------------------------
175
176 +--------------------------------------------------------------------
177 Variable: irmin(3,n_proj_boxes)
178
179 Type: INTEGER
180 Default: 1 for each box
181 Description: first point of the given box
182
183 BEWARE: "irmin" is a 2D array of the form: "irmin"(3,"n_proj_boxes")
184 +--------------------------------------------------------------------
185
186 +--------------------------------------------------------------------
187 Variable: irmax(3,n_proj_boxes)
188
189 Type: INTEGER
190 Default: 0 for each box
191 Description: last point of the given box;
192 ( 0 stands for the last point in the FFT grid )
193
194 BEWARE: "irmax" is a 2D array of the form: "irmax"(3,"n_proj_boxes")
195 +--------------------------------------------------------------------
196
197 +--------------------------------------------------------------------
198 Variable: plotboxes
199
200 Type: LOGICAL
201 Default: .false.
202 Description: if .true., the boxes are written in output as xsf files with
203 3D datagrids, valued 1.0 inside the box volume and 0 outside
204 (visualize them as isosurfaces with isovalue 0.5)
205 +--------------------------------------------------------------------
206
207 ===END OF NAMELIST======================================================
208
209
210
211 :::: Notes
212
213
214 ::: Format of output files
215
216 Projections are written to standard output, and also to file
217 "filproj" if given as input.
218
219 The total DOS and the sum of projected DOS are written to file
220 "filpdos".pdos_tot.
221
222 * The format for the collinear, spin-unpolarized case and the
223 non-collinear, spin-orbit case is:
224 E DOS(E) PDOS(E)
225 ...
226
227 * The format for the collinear, spin-polarized case is:
228 E DOSup(E) DOSdw(E) PDOSup(E) PDOSdw(E)
229 ...
230
231 * The format for the non-collinear, non spin-orbit case is:
232 E DOS(E) PDOSup(E) PDOSdw(E)
233 ...
234
235 In the collinear case and the non-collinear, non spin-orbit case
236 projected DOS are written to file "filpdos".pdos_atm#N(X)_wfc#M(l),
237 where N = atom number , X = atom symbol, M = wfc number, l=s,p,d,f
238 (one file per atomic wavefunction found in the pseudopotential file)
239
240 * The format for the collinear, spin-unpolarized case is:
241 E LDOS(E) PDOS_1(E) ... PDOS_2l+1(E)
242 ...
243 where LDOS = \sum m=1,2l+1 PDOS_m(E)
244 and PDOS_m(E) = projected DOS on atomic wfc with component m
245
246 * The format for the collinear, spin-polarized case and the
247 non-collinear, non spin-orbit case is as above with
248 two components for both LDOS(E) and PDOS_m(E)
249
250 In the non-collinear, spin-orbit case (i.e. if there is at least one
251 fully relativistic pseudopotential) wavefunctions are projected
252 onto eigenstates of the total angular-momentum.
253 Projected DOS are written to file "filpdos".pdos_atm#N(X)_wfc#M(l_j),
254 where N = atom number , X = atom symbol, M = wfc number, l=s,p,d,f
255 and j is the value of the total angular momentum.
256 In this case the format is:
257 E LDOS(E) PDOS_1(E) ... PDOS_2j+1(E)
258 ...
259
260 If "kresolveddos"=.true., the k-point index is prepended
261 to the formats above, e.g. (collinear, spin-unpolarized case)
262 ik E DOS(E) PDOS(E)
263
264 All DOS(E) are in states/eV plotted vs E in eV
265
266
267
268 ::: Orbital Order
269
270 Order of m-components for each l in the output:
271
272 1, cos(phi), sin(phi), cos(2*phi), sin(2*phi), .., cos(l*phi), sin(l*phi)
273
274 where phi is the polar angle:x=r cos(theta)cos(phi), y=r cos(theta)sin(phi)
275 This is determined in file Modules/ylmr2.f90 that calculates spherical harmonics.
276
277 for l=1:
278 1 pz (m=0)
279 2 px (real combination of m=+/-1 with cosine)
280 3 py (real combination of m=+/-1 with sine)
281
282 for l=2:
283 1 dz2 (m=0)
284 2 dzx (real combination of m=+/-1 with cosine)
285 3 dzy (real combination of m=+/-1 with sine)
286 4 dx2-y2 (real combination of m=+/-2 with cosine)
287 5 dxy (real combination of m=+/-2 with sine)
288
289
290
291 ::: Defining boxes for the Local DOS(E)
292
293 Boxes are specified using the variables "irmin" and "irmax":
294
295 FFT grid points are included from irmin(j,n) to irmax(j,n)
296 for j=1,2,3 and n=1,...,"n_proj_boxes"
297
298 "irmin" and "irmax" range from 1 to nr1 or nr2 or nr3
299
300 Values larger than nr1/2/3 or smaller than 1 are folded
301 to the unit cell.
302
303 If "irmax"&lt;"irmin" FFT grid points are included from 1 to irmax
304 and from irmin to nr1/2/3.
305
306
307
308 ::: Important notices
309
310 The tetrahedron method is used if
311
312 - the input data file has been produced by pw.x using the option
313 occupations='tetrahedra', AND
314
315 - a value for degauss is not given as input to namelist &projwfc
316
317 * Gaussian broadening is used in all other cases:
318
319 - if "degauss" is set to some value in namelist &PROJWFC, that value
320 (and the optional value for ngauss) is used
321
322 - if "degauss" is NOT set to any value in namelist &PROJWFC, the
323 value of "degauss" and of "ngauss" are read from the input data
324 file (they will be the same used in the pw.x calculations)
325
326 - if "degauss" is NOT set to any value in namelist &PROJWFC, AND
327 there is no value of "degauss" and of "ngauss" in the input data
328 file, "degauss"="DeltaE" (in Ry) and "ngauss"=0 will be used
329
330
331 Obsolete variables, ignored:
332 io_choice
333 smoothing
334
335
336
337 This file has been created by helpdoc utility on Wed Dec 02 08:04:45 CET 2020
338
339 </pre>
340 </body>
341 </html>