Debian Codegraph @

PHonon/Doc/INPUT_DYNMAT.html

raw
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <!-- *** FILE AUTOMATICALLY CREATED: DO NOT EDIT, CHANGES WILL BE LOST *** --><meta http-equiv="Content-Style-Type" CONTENT="text/css">
5 <style>
6 body {
7 background-color:#ffffff;
8 font:normal 14px/1.8em arial, helvetica, sans-serif;
9 width:900px;
10 text-align:justify;
11 margin: 30 10 10 30;
12 }
13
14 h1 {
15 font-size:24px;
16 }
17
18 h2 {
19 font-size:18px;
20 }
21
22 h3 {
23 font-size:16px;
24 }
25 pre, tt, code {
26 font-size:14px;
27 }
28 .syntax, .syntax table {
29 font-size:14px;
30 }
31 span.namelist {
32 color: #214478;
33 }
34 span.card {
35 color: #782167;
36 }
37 span.flag {
38 color: #008000;
39 font-weight: bold;
40 }
41 </style>
42 <title>dynmat.x: input description</title>
43 </head>
44 <body>
45 <a name="__top__"></a><table style="border-width: 0; table-layout: auto; width: 100%; text-align: left; vertical-align: top; background: #00395a;">
46 <tr><th style="margin: 3 3 3 10; background: #005789; background: linear-gradient(rgba(0,87,137,1),rgba(0,119,189,1)); color: #ffffee; ">
47 <h1 style="margin: 10 10 10 15; text-align: left;"> Input File Description </h1>
48 <h2 style="margin: 10 10 10 15; text-align: left;"> Program:
49 dynmat.x / PWscf / Quantum Espresso<span style="font-weight: normal;"> (version: 6.6)</span>
50 </h2>
51 </th></tr>
52 <tr><td style="padding: 10 3 3 3; background: #ffffff; color: #222222; ">
53 <blockquote style="margin-bottom: 2em;">
54 <h3>TABLE OF CONTENTS</h3>
55 <blockquote>
56
57
58 <p><a href="#idm3">INTRODUCTION</a></p>
59 <p><a href="#idm8">&amp;INPUT</a></p>
60 <blockquote>
61 <a href="#idm9">fildyn</a> | <a href="#idm12">q</a> | <a href="#idm15">amass</a> | <a href="#idm19">asr</a> | <a href="#idm31">axis</a> | <a href="#idm34">lperm</a> | <a href="#idm37">lplasma</a> | <a href="#idm41">filout</a> | <a href="#idm44">fileig</a> | <a href="#idm47">filmol</a> | <a href="#idm50">filxsf</a> | <a href="#idm53">loto_2d</a> | <a href="#idm56">el_ph_nsig</a> | <a href="#idm58">el_ph_sigma</a>
62 </blockquote>
63 </blockquote>
64 </blockquote>
65 <blockquote>
66 <a name="idm3"></a><h3>INTRODUCTION</h3>
67 <blockquote><pre>
68 <b>Purpose of dynmat.x:</b>
69
70 - reads a dynamical matrix file produced by the phonon code
71
72 - adds the non-analytical part (if Z* and epsilon are read from
73 file), applies the chosen Acoustic Sum Rule (if q=0)
74
75 - diagonalise the dynamical matrix
76
77 - calculates IR and Raman cross sections (if Z* and Raman
78 tensors are read from file, respectively)
79
80 - writes the results to files, both for inspection and for
81 plotting
82
83
84 <b>Structure of the input data:</b>
85 ========================================================================
86
87 <b>&amp;INPUT</b>
88 ...specs of namelist variables...
89 <b>/</b>
90 </pre></blockquote>
91 </blockquote>
92 <a name="idm8"></a><a name="INPUT"></a><table border="0" width="100%" style="margin-bottom: 20;">
93 <tr><th bgcolor="#ddcba6"><h2 style="margin: 10 10 10 15; text-align: left;"> Namelist: <span class="namelist"><span style="font-weight:normal">&amp;</span>INPUT</span>
94 </h2></th></tr>
95 <tr><td style="text-align: left; background: #ffebc6; padding: 5 5 5 30; "><table style="border-color: #505087; border-style: solid; border-width: 0; margin-bottom: 10; table-layout: auto; width: 800;"><tbody><tr><td>
96 <a name="idm9"></a><a name="fildyn"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
97 <tr>
98 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">fildyn</th>
99 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">CHARACTER</td>
100 </tr>
101 <tr>
102 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
103 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> 'matdyn'
104 </td>
105 </tr>
106 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
107 input file containing the dynamical matrix
108 </pre></blockquote></td></tr>
109 </table>
110 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
111 <a name="idm12"></a><a name="q"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
112 <tr>
113 <th width="20%" style="white-space: nowrap; text-align: left; vertical-align: top; background: #ffff99; padding: 2 2 2 10; ">q(i), i=1,3</th>
114 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">REAL</td>
115 </tr>
116 <tr>
117 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
118 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> q = (0,0,0)
119 </td>
120 </tr>
121 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
122 calculate LO modes (add non-analytic terms) along the direction q (Cartesian axis)
123 </pre></blockquote></td></tr>
124 </table>
125 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
126 <a name="idm15"></a><a name="amass"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
127 <tr>
128 <th width="20%" style="white-space: nowrap; text-align: left; vertical-align: top; background: #ffff99; padding: 2 2 2 10; ">amass(i), i=1,ntyp</th>
129 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">REAL</td>
130 </tr>
131 <tr>
132 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
133 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> amass is read from file <a href="#fildyn">fildyn</a>
134 </td>
135 </tr>
136 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
137 mass for each atom type
138 </pre></blockquote></td></tr>
139 </table>
140 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
141 <a name="idm19"></a><a name="asr"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
142 <tr>
143 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">asr</th>
144 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">CHARACTER</td>
145 </tr>
146 <tr>
147 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
148 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> 'no'
149 </td>
150 </tr>
151 <tr><td align="left" valign="top" colspan="2"><blockquote>
152 <pre style="margin-bottom: -1em;">
153 Indicates the type of Acoustic Sum Rule imposed.
154
155 Allowed values:
156 </pre>
157 <dl style="margin-left: 1.5em;">
158 <dt><tt><span class="flag">'no'</span> :</tt></dt>
159 <dd><pre style="margin-top: 0em; margin-bottom: -1em;">
160 no Acoustic Sum Rules imposed <b>(default)</b>
161 </pre></dd>
162 </dl>
163 <dl style="margin-left: 1.5em;">
164 <dt><tt><span class="flag">'simple'</span> :</tt></dt>
165 <dd><pre style="margin-top: 0em; margin-bottom: -1em;">
166 previous implementation of the asr used
167 (3 translational asr imposed by correction of
168 the diagonal elements of the dynamical matrix)
169 </pre></dd>
170 </dl>
171 <dl style="margin-left: 1.5em;">
172 <dt><tt><span class="flag">'crystal'</span> :</tt></dt>
173 <dd><pre style="margin-top: 0em; margin-bottom: -1em;">
174 3 translational asr imposed by optimized
175 correction of the dyn. matrix (projection)
176 </pre></dd>
177 </dl>
178 <dl style="margin-left: 1.5em;">
179 <dt><tt><span class="flag">'one-dim'</span> :</tt></dt>
180 <dd><pre style="margin-top: 0em; margin-bottom: -1em;">
181 3 translational asr + 1 rotational asr imposed
182 by optimized correction of the dyn. mat. (the
183 rotation axis is the direction of periodicity; it
184 will work only if this axis considered is one of
185 the Cartesian axis).
186 </pre></dd>
187 </dl>
188 <dl style="margin-left: 1.5em;">
189 <dt><tt><span class="flag">'zero-dim'</span> :</tt></dt>
190 <dd><pre style="margin-top: 0em; margin-bottom: -1em;">
191 3 translational asr + 3 rotational asr imposed
192 by optimized correction of the dyn. mat.
193 </pre></dd>
194 </dl>
195 <pre style="margin-bottom: -1em;">
196 Note that in certain cases, not all the rotational asr
197 can be applied (e.g. if there are only 2 atoms in a
198 molecule or if all the atoms are aligned, etc.). In
199 these cases the supplementary asr are canceled during
200 the orthonormalization procedure (see below).
201
202 Finally, in all cases except <b>'no'</b> a simple correction
203 on the effective charges is performed (same as in the
204 previous implementation).
205 </pre>
206 </blockquote></td></tr>
207 </table>
208 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
209 <a name="idm31"></a><a name="axis"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
210 <tr>
211 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">axis</th>
212 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">INTEGER</td>
213 </tr>
214 <tr>
215 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
216 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> 3
217 </td>
218 </tr>
219 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
220 indicates the rotation axis for a 1D system (1=Ox, 2=Oy, 3=Oz)
221 </pre></blockquote></td></tr>
222 </table>
223 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
224 <a name="idm34"></a><a name="lperm"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
225 <tr>
226 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">lperm</th>
227 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">LOGICAL</td>
228 </tr>
229 <tr>
230 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
231 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> .false.
232 </td>
233 </tr>
234 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
235 if .true. then calculate Gamma-point mode contributions to
236 dielectric permittivity tensor
237 </pre></blockquote></td></tr>
238 </table>
239 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
240 <a name="idm37"></a><a name="lplasma"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
241 <tr>
242 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">lplasma</th>
243 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">LOGICAL</td>
244 </tr>
245 <tr>
246 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
247 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> .false.
248 </td>
249 </tr>
250 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
251 if .true. then calculate Gamma-point mode effective plasma
252 frequencies, automatically triggers <a href="#lperm">lperm</a> = .true.
253 </pre></blockquote></td></tr>
254 </table>
255 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
256 <a name="idm41"></a><a name="filout"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
257 <tr>
258 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">filout</th>
259 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">CHARACTER</td>
260 </tr>
261 <tr>
262 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
263 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> 'dynmat.out'
264 </td>
265 </tr>
266 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
267 output file containing phonon frequencies and normalized
268 phonon displacements (i.e. eigenvectors divided by the
269 square root of the mass and then normalized; they are
270 not orthogonal)
271 </pre></blockquote></td></tr>
272 </table>
273 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
274 <a name="idm44"></a><a name="fileig"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
275 <tr>
276 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">fileig</th>
277 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">CHARACTER</td>
278 </tr>
279 <tr>
280 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
281 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> ' '
282 </td>
283 </tr>
284 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
285 output file containing phonon frequencies and eigenvectors
286 of the dynamical matrix (they are orthogonal)
287 </pre></blockquote></td></tr>
288 </table>
289 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
290 <a name="idm47"></a><a name="filmol"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
291 <tr>
292 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">filmol</th>
293 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">CHARACTER</td>
294 </tr>
295 <tr>
296 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
297 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> 'dynmat.mold'
298 </td>
299 </tr>
300 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
301 as above, in a format suitable for molden
302 </pre></blockquote></td></tr>
303 </table>
304 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
305 <a name="idm50"></a><a name="filxsf"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
306 <tr>
307 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">filxsf</th>
308 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">CHARACTER</td>
309 </tr>
310 <tr>
311 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
312 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> 'dynmat.axsf'
313 </td>
314 </tr>
315 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
316 as above, in axsf format suitable for xcrysden
317 </pre></blockquote></td></tr>
318 </table>
319 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
320 <a name="idm53"></a><a name="loto_2d"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
321 <tr>
322 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">loto_2d</th>
323 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">LOGICAL</td>
324 </tr>
325 <tr>
326 <td style="text-align: right; vertical-align: top; background: #ffffc3; padding: 2 10 2 10; "><i>Default:</i></td>
327 <td style="text-align: left; vertical-align: top; background: #fff3d9; padding: 2 2 2 5; "> '.false.'
328 </td>
329 </tr>
330 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
331 set to .true. to activate two-dimensional treatment of LO-TO splitting.
332 </pre></blockquote></td></tr>
333 </table>
334 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
335 <a name="idm56"></a><a name="el_ph_nsig"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
336 <tr>
337 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">el_ph_nsig</th>
338 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">INTEGER</td>
339 </tr>
340 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
341 The number of double-delta smearing values used in an electron-phonon
342 coupling calculation.
343 </pre></blockquote></td></tr>
344 </table>
345 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
346 <a name="idm58"></a><a name="el_ph_sigma"></a><table width="100%" style="border-color: #b5b500; border-style: solid; border-width: 2; margin-bottom: 10; table-layout: auto; background-color: #FFFFFF;">
347 <tr>
348 <th align="left" valign="top" width="20%" style="background: #ffff99; padding: 2 2 2 10; ">el_ph_sigma</th>
349 <td style="text-align: left; vertical-align: top; background: #ffffc3; padding: 2 2 2 5; ">REAL</td>
350 </tr>
351 <tr><td align="left" valign="top" colspan="2"><blockquote><pre style="margin-bottom: -1em;">
352 The spacing of double-delta smearing values used in an electron-phonon
353 coupling calculation.
354 </pre></blockquote></td></tr>
355 </table>
356 <div align="right" style="margin-bottom: 5;">[<a href="#__top__">Back to Top</a>]</div>
357 </td></tr></tbody></table></td></tr>
358 </table>
359 </td></tr>
360 </table>
361 <small>
362 This file has been created by helpdoc utility on Wed Dec 02 08:04:43 CET 2020.
363 </small>
364 </body>
365 </html>