Debian Codegraph @

GUI/PWgui/doc/pwdocs/INPUT_HP.html

raw
1
2 <html>
3 <body>
4 <pre>
5
6 ------------------------------------------------------------------------
7 INPUT FILE DESCRIPTION
8
9 Program: hp.x / PWscf / Quantum Espresso (version: 6.6)
10 ------------------------------------------------------------------------
11
12
13 Input data format: { } = optional, [ ] = it depends, # = comment
14
15 Structure of the input data:
16 ===============================================================================
17
18 &INPUTHP
19 ...
20 /
21
22
23
24 ========================================================================
25 NAMELIST: &INPUTHP
26
27 +--------------------------------------------------------------------
28 Variable: prefix
29
30 Type: CHARACTER
31 Default: 'pwscf'
32 Description: Prepended to input/output filenames; must be the same
33 used in the calculation of unperturbed system.
34 +--------------------------------------------------------------------
35
36 +--------------------------------------------------------------------
37 Variable: outdir
38
39 Type: CHARACTER
40 Default: value of the ESPRESSO_TMPDIR environment variable if set;
41 current directory ('./') otherwise
42 Description: Directory containing input, output, and scratch files;
43 must be the same as specified in the calculation of
44 the unperturbed system.
45 +--------------------------------------------------------------------
46
47 +--------------------------------------------------------------------
48 Variable: iverbosity
49
50 Type: INTEGER
51 Default: 1
52 Description: = 1 : minimal output
53 = 2 : as above + symmetry matrices, final response
54 matrices chi0 and chi1 and their inverse matrices,
55 full U matrix
56 = 3 : as above + various detailed info about the NSCF
57 calculation at k and k+q
58 = 4 : as above + response occupation matrices at every
59 iteration and for every q point in the star
60 +--------------------------------------------------------------------
61
62 +--------------------------------------------------------------------
63 Variable: max_seconds
64
65 Type: REAL
66 Default: 1.d7
67 Description: Maximum allowed run time before the job stops smoothly.
68 +--------------------------------------------------------------------
69
70 +--------------------------------------------------------------------
71 Variables: nq1, nq2, nq3
72
73 Type: INTEGER
74 Default: 1,1,1
75 Description: Parameters of the Monkhorst-Pack grid (no offset).
76 Same meaning as for nk1, nk2, nk3 in the input of pw.x.
77 +--------------------------------------------------------------------
78
79 +--------------------------------------------------------------------
80 Variable: skip_equivalence_q
81
82 Type: LOGICAL
83 Default: .false.
84 Description: If .true. then the HP code will skip the equivalence
85 analysis of q points, and thus the full grid of q points
86 will be used. Otherwise the symmetry is used to determine
87 equivalent q points (star of q), and then perform
88 calculations only for inequivalent q points.
89 +--------------------------------------------------------------------
90
91 +--------------------------------------------------------------------
92 Variable: determine_num_pert_only
93
94 Type: LOGICAL
95 Default: .false.
96 See: find_atpert
97 Description: If .true. determines the number of perturbations
98 (i.e. which atoms will be perturbed) and exits smoothly
99 without performing any calculation. For DFT+U+V, it also
100 determines the indices of inter-site couples.
101 +--------------------------------------------------------------------
102
103 +--------------------------------------------------------------------
104 Variable: find_atpert
105
106 Type: INTEGER
107 Default: 1
108 Description: Method for searching of atoms which must be perturbed.
109 1 = Find how many inequivalent Hubbard atoms there are
110 by analyzing unperturbed occupations.
111 2 = Find how many Hubbard atoms to perturb based on
112 how many different Hubbard atomic types there are.
113 Warning: atoms which have the same type but which
114 are inequivalent by symmetry or which have different
115 occupations will not be distinguished in this case
116 (use option 1 or 3 instead).
117 3 = Find how many inequivalent Hubbard atoms
118 there are using symmetry. Atoms which have the
119 same type but are not equivalent by symmetry will
120 be distinguished in this case.
121 +--------------------------------------------------------------------
122
123 +--------------------------------------------------------------------
124 Variable: docc_thr
125
126 Type: REAL
127 Default: 5.D-5
128 Description: Threshold for a comparison of unperturbed occupations
129 which is needed for the selection of atoms which must
130 be perturbed. Can be used only when "find_atpert" = 1.
131 +--------------------------------------------------------------------
132
133 +--------------------------------------------------------------------
134 Variable: skip_type(i), i=1,ntyp
135
136 Type: LOGICAL
137 Default: skip_type(i) = .false.
138 See: equiv_type
139 Description: "skip_type"(i), where i runs over types of atoms.
140 If "skip_type"(i)=.true. then no linear-response
141 calculation will be performed for the i-th atomic type:
142 in this case "equiv_type"(i) must be specified, otherwise
143 the HP code will stop. This option is useful if the
144 system has atoms of the same type but opposite spin
145 pollarizations (anti-ferromagnetic case).
146 This keyword cannot be used when "find_atpert" = 1.
147 +--------------------------------------------------------------------
148
149 +--------------------------------------------------------------------
150 Variable: equiv_type(i), i=1,ntyp
151
152 Type: INTEGER
153 Default: equiv_type(i) = 0
154 See: skip_type
155 Description: "equiv_type"(i), where i runs over types of atoms.
156 "equiv_type"(i)=j, will make type i equivalent to type j
157 (useful when nspin=2). Such a merging of types is done
158 only at the post-processing stage.
159 This keyword cannot be used when "find_atpert" = 1.
160 +--------------------------------------------------------------------
161
162 +--------------------------------------------------------------------
163 Variable: perturb_only_atom(i), i=1,ntyp
164
165 Type: LOGICAL
166 Default: perturb_only_atom(i) = .false.
167 See: compute_hp
168 Description: If "perturb_only_atom"(i)=.true. then only the i-th
169 atom will be perturbed and considered in the run.
170 This variable is useful when one wants to split
171 the whole calculation on parts.
172
173 Note: this variable has a higher priority than "skip_type".
174 +--------------------------------------------------------------------
175
176 +--------------------------------------------------------------------
177 Variable: start_q
178
179 Type: INTEGER
180 Default: 1
181 See: last_q, sum_pertq
182 Description: Computes only the q points from "start_q" to "last_q".
183
184 IMPORTANT: "start_q" must be smaller or equal to
185 the total number of q points found.
186 +--------------------------------------------------------------------
187
188 +--------------------------------------------------------------------
189 Variable: last_q
190
191 Type: INTEGER
192 Default: number of q points
193 See: start_q, sum_pertq
194 Description: Computes only the q points from "start_q" to "last_q".
195
196 IMPORTANT: "last_q" must be smaller or equal to
197 the total number of q points found.
198 +--------------------------------------------------------------------
199
200 +--------------------------------------------------------------------
201 Variable: sum_pertq
202
203 Type: LOGICAL
204 Default: .false.
205 See: start_q, last_q, perturb_only_atom
206 Description: If it is set to .true. then the HP code will collect
207 pieces of the response occupation matrices for all
208 q points. This variable should be used only when
209 "start_q", "last_q" and "perturb_only_atom" are used.
210 +--------------------------------------------------------------------
211
212 +--------------------------------------------------------------------
213 Variable: compute_hp
214
215 Type: LOGICAL
216 Default: .false.
217 See: perturb_only_atom
218 Description: If it is set to .true. then the HP code will collect
219 pieces of the chi0 and chi matrices (which must have
220 been produced in previous runs) and then compute
221 Hubbard parameters. The HP code will look for files
222 tmp_dir/HP/prefix.chi.i.dat. Note that all files
223 prefix.chi.i.dat (where i runs over all perturbed
224 atoms) must be placed in one folder tmp_dir/HP/.
225 "compute_hp"=.true. must be used only when the
226 calculation was parallelized over perturbations.
227 +--------------------------------------------------------------------
228
229 +--------------------------------------------------------------------
230 Variable: conv_thr_chi
231
232 Type: REAL
233 Default: 1.D-5
234 Description: Convergence threshold for the response function chi,
235 which is defined as a trace of the response
236 occupation matrix.
237 +--------------------------------------------------------------------
238
239 +--------------------------------------------------------------------
240 Variable: thresh_init
241
242 Type: REAL
243 Default: 1.D-14
244 Description: Initial threshold for the solution of the linear
245 system (first iteration). Needed to converge the
246 bare (non-interacting) response function chi0.
247 The specified value will be multiplied by the
248 number of electrons in the system.
249 +--------------------------------------------------------------------
250
251 +--------------------------------------------------------------------
252 Variable: ethr_nscf
253
254 Type: REAL
255 Default: 1.D-11
256 Description: Threshold for the convergence of eigenvalues during
257 the iterative diagonalization of the Hamiltonian in
258 the non-self-consistent-field (NSCF) calculation at
259 k and k+q points. Note, this quantity is NOT extensive.
260 +--------------------------------------------------------------------
261
262 +--------------------------------------------------------------------
263 Variable: niter_max
264
265 Type: INTEGER
266 Default: 100
267 Description: Maximum number of iterations in the iterative
268 solution of the linear-response Kohn-Sham equations.
269 +--------------------------------------------------------------------
270
271 +--------------------------------------------------------------------
272 Variable: alpha_mix(i)
273
274 Type: REAL
275 Default: alpha_mix(1)=0.3
276 Description: Mixing parameter (for the i-th iteration) for updating
277 the response SCF potential using the modified Broyden
278 method. See: D.D. Johnson, PRB 38, 12807 (1988).
279 +--------------------------------------------------------------------
280
281 +--------------------------------------------------------------------
282 Variable: nmix
283
284 Type: INTEGER
285 Default: 4
286 Description: Number of iterations used in potential mixing
287 using the modified Broyden method. See:
288 D.D. Johnson, PRB 38, 12807 (1988).
289 +--------------------------------------------------------------------
290
291 +--------------------------------------------------------------------
292 Variable: num_neigh
293
294 Type: INTEGER
295 Default: 6
296 Description: Number of nearest neighbors of every Hubbard atom which
297 will be considered when writting Hubbard V parameters to
298 the file parameters.out, which can be used in the
299 subsequent DFT+U+V calculation. This keyword is used only
300 when lda_plus_u_kind = 2 (post-processing stage).
301 +--------------------------------------------------------------------
302
303 +--------------------------------------------------------------------
304 Variable: lmin
305
306 Type: INTEGER
307 Default: 2
308 Description: Minimum value of the orbital quantum number of the Hubbard
309 atoms starting from which (and up to the maximum l in the
310 system) Hubbard V will be written to the file parameters.out.
311 "lmin" refers to the orbital quantum number of the atom
312 corresponding to the first site-index in Hubbard_V(:,:,:).
313 This keyword is used only when lda_plus_u_kind = 2 and only
314 in the post-processing stage. Example: "lmin"=1 corresponds to
315 writing to file V between e.g. oxygen (with p states) and its
316 neighbors, and including V between transition metals (with d
317 states) and their neighbors. Instead, when "lmin"=2 only the
318 latter will be written to parameters.out.
319 +--------------------------------------------------------------------
320
321 +--------------------------------------------------------------------
322 Variable: rmax
323
324 Type: REAL
325 Default: 100.D0
326 Description: Maximum distance (in Bohr) between two atoms to search
327 neighbors (used only at the postprocessing step when
328 lda_plus_u_kind = 2). This keyword is useful when there
329 are e.g. defects in the system.
330 +--------------------------------------------------------------------
331
332 ===END OF NAMELIST======================================================
333
334
335 This file has been created by helpdoc utility on Wed Dec 02 08:04:42 CET 2020
336
337 </pre>
338 </body>
339 </html>