Debian Codegraph @

GUI/PWgui/doc/pwdocs/INPUT_BANDS.html

raw
1
2 <html>
3 <body>
4 <pre>
5
6 ------------------------------------------------------------------------
7 INPUT FILE DESCRIPTION
8
9 Program: bands.x / PWscf / Quantum Espresso (version: 6.6)
10 ------------------------------------------------------------------------
11
12
13 Purpose of bands.x:
14 Re-order bands, computes band-related properties. Currently,
15 re-ordering can be done with two different algorithms:
16 (a) by maximising the overlap with bands at previous k-point
17 (b) by computing symmetry properties of each wavefunction
18 Bands-related properties that can be computed are currently
19 (a) The expectation value of the spin operator on each spinor
20 wave-function (noncolinear case only)
21 (b) The expectation value of p
22
23 The input data can be read from standard input or from file using
24 command-line options "bands.x -i file-name" (same syntax as for pw.x)
25
26 Output files:
27 - file "filband" containing the band structure, in a format
28 suitable for plotting code "plotband.x"
29 - file "filband".rap (if "lsym" is .t.) with symmetry information,
30 to be read by plotting code "plotband.x"
31 - if ("lsigma"(i)): file "filband".i, i=1,2,3, with expectation values
32 of the spin operator in the noncolinear case
33 - file "filband".gnu with bands in eV, directly plottable using gnuplot
34 - file "filp" with matrix elements of p
35
36 Structure of the input data:
37 ============================
38
39 &BANDS
40 ...
41 /
42
43
44
45 ========================================================================
46 NAMELIST: &BANDS
47
48 +--------------------------------------------------------------------
49 Variable: prefix
50
51 Type: CHARACTER
52 Default: 'pwscf'
53 Description: prefix of files saved by program pw.x
54 +--------------------------------------------------------------------
55
56 +--------------------------------------------------------------------
57 Variable: outdir
58
59 Type: CHARACTER
60 Description: directory containing the input data, i.e. the same as in pw.x
61 Default: value of the ESPRESSO_TMPDIR environment variable if set;
62 current directory ('./') otherwise
63 +--------------------------------------------------------------------
64
65 +--------------------------------------------------------------------
66 Variable: filband
67
68 Type: CHARACTER
69 Default: 'bands.out'
70 Description: file name for band output (to be read by "plotband.x")
71 +--------------------------------------------------------------------
72
73 +--------------------------------------------------------------------
74 Variable: spin_component
75
76 Type: INTEGER
77 Description: In the lsda case select:
78
79 1 = spin-up
80 2 = spin-down
81 +--------------------------------------------------------------------
82
83 +--------------------------------------------------------------------
84 Variable: lsigma(i), i=1,3
85
86 Type: LOGICAL
87 Description: If true computes expectation values of the spin operator
88 on the spinor wave-functions (only in the noncollinear case),
89 writes them to a file "filband".i, i=1,2,3
90 +--------------------------------------------------------------------
91
92 +--------------------------------------------------------------------
93 Variable: lp
94
95 Type: LOGICAL
96 Default: .false.
97 Description: If .true. matrix elements of the momentum operator p between
98 conduction and valence bands are computed and written to file
99 specified in "filp"
100 +--------------------------------------------------------------------
101
102 +--------------------------------------------------------------------
103 Variable: filp
104
105 Type: CHARACTER
106 Default: 'p_avg.dat'
107 Description: If "lp" is set to .true., file name for matrix elements of p
108 +--------------------------------------------------------------------
109
110 +--------------------------------------------------------------------
111 Variable: lsym
112
113 Type: LOGICAL
114 Default: .true.
115 Description: If .true. the bands are classified according to the
116 irreducible representations of the small group of k.
117 A file "filband".rap with the same format of "filband"
118 is written, for usage by "plotband.x"
119 +--------------------------------------------------------------------
120
121 +--------------------------------------------------------------------
122 Variable: no_overlap
123
124 Type: LOGICAL
125 Default: .true.
126 Description: If .false., and if "lsym" is .false., writes the eigenvalues
127 in the order that maximises overlap with the neighbor k-points
128 +--------------------------------------------------------------------
129
130 +--------------------------------------------------------------------
131 Variable: plot_2d
132
133 Type: LOGICAL
134 Default: .false.
135 Description: If .true. writes the eigenvalues in the output file
136 in a 2D format readable by gnuplot. Band ordering is not
137 changed. Each band is written in a different file called
138 filband.# with the format:
139
140 xk, yk, energy
141 xk, yk, energy
142 .. .. ..
143
144 energies are written in eV and xk in units 2\pi/a.
145 +--------------------------------------------------------------------
146
147 +--------------------------------------------------------------------
148 Variables: firstk, lastk
149
150 Type: INTEGER
151 Description: if @ref lsym=.true. makes the symmetry analysis only for k
152 points between firstk to lastk
153 +--------------------------------------------------------------------
154
155 ===END OF NAMELIST======================================================
156
157
158 This file has been created by helpdoc utility on Wed Dec 02 08:04:46 CET 2020
159
160 </pre>
161 </body>
162 </html>