| 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> |