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