Debian Codegraph @

GUI/PWgui/doc/pwdocs/INPUT_LD1.html

raw
1
2 <html>
3 <body>
4 <pre>
5
6 ------------------------------------------------------------------------
7 INPUT FILE DESCRIPTION
8
9 Program: ld1.x / / Quantum Espresso (version: 6.6)
10 ------------------------------------------------------------------------
11
12
13 Input data cards for ld1.x program:
14
15 Always present:
16 1 namelist &input
17 1.1 optional cards for all-electron calculations
18
19 Needed for PP generation:
20 2 namelist &inputp
21 2.1 additional cards for PP generation
22
23 Needed for pseudo-potential (PP) test. optional for PP generation:
24 3 namelist &test
25 3.1 optional cards for PP test
26
27
28
29 ========================================================================
30 NAMELIST: &INPUT
31
32 THIS NAMELIST IS ALWAYS NEEDED !
33
34 +--------------------------------------------------------------------
35 Variable: title
36
37 Type: CHARACTER
38 Description: A string describing the job.
39 Status: OPTIONAL
40 +--------------------------------------------------------------------
41
42 ///---
43 EITHER:
44
45 +--------------------------------------------------------------------
46 Variable: zed
47
48 Type: REAL
49 See: atom
50 Description: The nuclear charge (1 &lt; zed &lt; 100).
51
52 IMPORTANT:
53 Specify either "zed" OR "atom", not both!
54 +--------------------------------------------------------------------
55
56 OR:
57
58 +--------------------------------------------------------------------
59 Variable: atom
60
61 Type: CHARACTER
62 See: zed
63 Description: Atomic symbol: atom='H', 'He', 'Be', etc.
64
65 IMPORTANT:
66 Specify either "atom" OR "zed", not both!
67 +--------------------------------------------------------------------
68
69 \\\---
70
71 ///---
72 RADIAL GRID PARAMETERS:
73
74 +--------------------------------------------------------------------
75 Variable: xmin
76
77 Type: REAL
78 See: dx
79 Default: -7.0 if "iswitch"&gt;1 or "rel"=0,
80 -8.0 otherwise
81 Description: Radial grid parameter.
82 +--------------------------------------------------------------------
83
84 +--------------------------------------------------------------------
85 Variable: dx
86
87 Type: REAL
88 Description: Radial grid parameter.
89
90 The radial grid is: r(i+1) = exp(xmin+i*dx)/zed a.u.
91 Default: 0.0125 if "iswitch"&gt;1,
92 0.008 otherwise
93 +--------------------------------------------------------------------
94
95 +--------------------------------------------------------------------
96 Variable: rmax
97
98 Type: REAL
99 Description: Outermost grid point.
100 Default: 100.0 a.u.
101 +--------------------------------------------------------------------
102
103 \\\---
104
105 +--------------------------------------------------------------------
106 Variable: beta
107
108 Type: REAL
109 Description: parameter for potential mixing
110 Default: 0.2
111 +--------------------------------------------------------------------
112
113 +--------------------------------------------------------------------
114 Variable: tr2
115
116 Type: REAL
117 Description: convergence threshold for scf
118 Default: 1e-14
119 +--------------------------------------------------------------------
120
121 +--------------------------------------------------------------------
122 Variable: iswitch
123
124 Type: INTEGER
125 Description: 1 all-electron calculation
126 2 PP test calculation
127 3 PP generation
128 4 LDA-1/2 correction, needs a previously generated PP file
129 Default: 1
130 +--------------------------------------------------------------------
131
132 ///---
133 PARAMETERS FOR LOGARITHMIC DERIVATIVES:
134
135 +--------------------------------------------------------------------
136 Variable: nld
137
138 Type: INTEGER
139 Description: the number of logarithmic derivatives to be calculated
140 +--------------------------------------------------------------------
141
142 +--------------------------------------------------------------------
143 Variable: rlderiv
144
145 Type: REAL
146 Description: radius (a.u.) at which logarithmic derivatives are calculated
147 +--------------------------------------------------------------------
148
149 +--------------------------------------------------------------------
150 Variables: eminld, emaxld
151
152 Type: REAL
153 Description: Energy range (min, max energy, in Ry) at which
154 logarithmic derivatives are calculated.
155 +--------------------------------------------------------------------
156
157 +--------------------------------------------------------------------
158 Variable: deld
159
160 Type: REAL
161 Description: Delta e (Ry) of energy for logarithmic derivatives.
162 +--------------------------------------------------------------------
163
164 +--------------------------------------------------------------------
165 Variable: rpwe
166
167 Type: REAL
168 Description: radius (a.u.) at which partial wave expansions are calculated
169 Default: rlderiv
170 +--------------------------------------------------------------------
171
172 If the above parameters are not specified, logarithmic
173 derivatives and partial wave expansions are not calculated.
174
175 \\\---
176
177 +--------------------------------------------------------------------
178 Variable: rel
179
180 Type: INTEGER
181 Description: 0 ... non relativistic calculation
182 1 ... scalar relativistic calculation
183 2 ... full relativistic calculation with spin-orbit
184 Default: 0 for Z &lt;= 18;
185 1 for Z &gt; 18
186 +--------------------------------------------------------------------
187
188 +--------------------------------------------------------------------
189 Variable: lsmall
190
191 Type: LOGICAL
192 Default: .false.
193 Description: if .true. writes on files the small component
194 +--------------------------------------------------------------------
195
196 +--------------------------------------------------------------------
197 Variable: max_out_wfc
198
199 Type: INTEGER
200 Default: 7
201 Description: Maximum number of atomic wavefunctions written in the output
202 file.
203 +--------------------------------------------------------------------
204
205 +--------------------------------------------------------------------
206 Variable: noscf
207
208 Type: LOGICAL
209 Default: .false.
210 Description: if .true. the charge is not computed. The occupations are
211 not used and the eigenvalues and eigenfunctions are those
212 of a hydrogen-like atom.
213 +--------------------------------------------------------------------
214
215 +--------------------------------------------------------------------
216 Variable: lsd
217
218 Type: INTEGER
219 Description: 0 ... non spin polarized calculation
220 1 ... spin-polarized calculation
221
222 BEWARE:
223 not allowed if "iswitch"=3 (PP generation) or with full
224 relativistic calculation
225 Default: 0
226 +--------------------------------------------------------------------
227
228 +--------------------------------------------------------------------
229 Variable: dft
230
231 Type: CHARACTER
232 Description: Exchange-correlation functional.
233
234 Examples:
235 'PZ' Perdew and Zunger formula for LDA
236 'PW91' Perdew and Wang GGA
237 'BP' Becke and Perdew GGA
238 'PBE' Perdew, Becke and Ernzerhof GGA
239 'BLYP' ...
240
241 For the complete list, see module "functionals" in ../Modules/
242 The default is 'PZ' for all-electron calculations,
243 it is read from the PP file in a PP calculation.
244 +--------------------------------------------------------------------
245
246 +--------------------------------------------------------------------
247 Variable: latt
248
249 Type: INTEGER
250 Description: 0 ... no Latter correction
251 1 ... apply Latter correction
252 Default: 0
253 +--------------------------------------------------------------------
254
255 +--------------------------------------------------------------------
256 Variable: isic
257
258 Type: INTEGER
259 Description: 0 ... no Self-interaction correction
260 1 ... apply Self-interaction correction
261 Default: 0
262 Status: only for all-electron calculation
263 +--------------------------------------------------------------------
264
265 +--------------------------------------------------------------------
266 Variable: rytoev_fact
267
268 Type: REAL
269 Default: as specified in file Modules/constants.f90
270 Description: Factor used to convert Ry into eV.
271 +--------------------------------------------------------------------
272
273 +--------------------------------------------------------------------
274 Variable: cau_fact
275
276 Type: REAL
277 Default: as specified in file Modules/constants.f90
278 Description: Speed of light in a.u..
279
280 (Be careful the default value is always used in the
281 relativistic exchange.)
282 +--------------------------------------------------------------------
283
284 +--------------------------------------------------------------------
285 Variable: vdw
286
287 Type: LOGICAL
288 Default: .false.
289 Description: If .true., the frequency dependent polarizability and van der
290 Waals coefficient C6 will be computed in Thomas-Fermi and
291 von Weizsaecker approximation(only for closed-shell ions).
292 Status: Gradient-corrected DFT not yet implemented.
293 +--------------------------------------------------------------------
294
295 +--------------------------------------------------------------------
296 Variable: prefix
297
298 Type: CHARACTER
299 Default: 'ld1'
300 Description: Prefix for file names - only for output file names
301 containing the orbitals, logarithmic derivatives, tests
302 See below for file names and the content of the file.
303 +--------------------------------------------------------------------
304
305 +--------------------------------------------------------------------
306 Variable: verbosity
307
308 Type: CHARACTER
309 Default: 'low'
310 Description: 'low' or 'high'
311
312 if 'high' with "iswitch"=2,3 prints separately core and
313 valence contributions to the energies. Print the
314 frozen-core energy.
315 +--------------------------------------------------------------------
316
317 +--------------------------------------------------------------------
318 Variable: file_charge
319
320 Type: CHARACTER
321 Default: ' '
322 Description: Name of the file where the code writes the all-electron
323 total charge. No charge is written if file_charge=' '.
324 +--------------------------------------------------------------------
325
326 +--------------------------------------------------------------------
327 Variable: config
328
329 Type: CHARACTER
330 Default: ' '
331 Description: A string with the electronic configuration.
332
333 Example:
334 '[Ar] 3d10 4s2 4p2.5'
335
336 * If "lsd"=1, spin-up and spin-down state may appear twice
337 with the respective occupancy: 3p4 3p2 = 4 up,
338 2 down. Otherwise, the Hund's rule is assumed.
339
340 * If "rel"=2, states with jj=l-1/2 are filled first.
341 If a state appears twice, the first one has jj=l-1/2,
342 the second one jj=l+1/2 (except S states)
343 (Use rel_dist if you want to average the electrons
344 over all available states.)
345
346 * If config='default' the code uses "zed" to set the ground
347 state electronic configuration for the atom.
348
349 Negative occupancies are used to flag unbound states;
350 they are not actually used.
351 +--------------------------------------------------------------------
352
353 +--------------------------------------------------------------------
354 Variable: relpert
355
356 Type: LOGICAL
357 Default: .false.
358 Description: If .true. the relativistic corrections to the non-relativistic
359 Kohn-Sham energy levels ("rel"=0 .and. "lsd"=0) are computed using
360 first-order perturbation theory in all-electron calculations.
361 The corrections consist of the following terms:
362 E_vel: velocity (p^4) correction
363 E_Dar: Darwin term
364 E_S-O: spin-orbit coupling
365 The spin-orbit term vanishes for s-electron states and gives
366 rise to a splitting of (2*l+1)*E_S-O for the other states.
367 The separate contributions are printed only if verbosity='high'.
368
369 Formulas and notation are based on the Herman-Skillman book:
370 F. Herman and S. Skillman, "Atomic Structure Calculations",
371 Prentice-Hall, Inc., Englewood Cliffs, New Jersey, 1963
372 +--------------------------------------------------------------------
373
374 +--------------------------------------------------------------------
375 Variable: rel_dist
376
377 Type: CHARACTER
378 Default: 'energy'
379 Description: 'energy' or 'average'
380
381 * if 'energy' the relativistic l-1/2 states are filled first.
382
383 * if 'average' the electrons are uniformly distributed
384 among all the states with the given l.
385 +--------------------------------------------------------------------
386
387 +--------------------------------------------------------------------
388 Variable: write_coulomb
389
390 Type: LOGICAL
391 Default: .false.
392 Description: If .true., a fake pseudo-potential file with name X.UPF,
393 where X is the atomic symbol, is written. It contains
394 the radial grid and the wavefunctions as specified in input,
395 plus the info needed to build the Coulomb potential
396 for an all-electron calculation - for testing only.
397 +--------------------------------------------------------------------
398
399 ===END OF NAMELIST======================================================
400
401
402 ========================================================================
403 CARD:
404
405 IF CONFIG IS EMPTY THE ELECTRONIC CONFIGURATION IS READ FROM
406 THE FOLLOWING CARDS:
407
408 ________________________________________________________________________
409 * IF rel &lt; 2 :
410
411 /////////////////////////////////////////
412 // Syntax: //
413 /////////////////////////////////////////
414
415 nwf
416 nl(1) n(1) l(1) oc(1) isw(1)
417 nl(2) n(2) l(2) oc(2) isw(2)
418 . . .
419 nl(nwf) n(nwf) l(nwf) oc(nwf) isw(nwf)
420
421 /////////////////////////////////////////
422
423
424 * ELSE IF rel = 2 :
425
426 /////////////////////////////////////////
427 // Syntax: //
428 /////////////////////////////////////////
429
430 nwf
431 nl(1) n(1) l(1) oc(1) jj(1)
432 nl(2) n(2) l(2) oc(2) jj(2)
433 . . .
434 nl(nwf) n(nwf) l(nwf) oc(nwf) jj(nwf)
435
436 /////////////////////////////////////////
437
438
439 ENDIF
440 ________________________________________________________________________
441
442 DESCRIPTION OF ITEMS:
443
444 +--------------------------------------------------------------------
445 Variable: nwf
446
447 Type: INTEGER
448 Description: number of wavefunctions
449 +--------------------------------------------------------------------
450
451 +--------------------------------------------------------------------
452 Variable: nl
453
454 Type: CHARACTER
455 Description: wavefunction label (e.g. 1s, 2s, etc.)
456 +--------------------------------------------------------------------
457
458 +--------------------------------------------------------------------
459 Variable: n
460
461 Type: INTEGER
462 Description: principal quantum number
463 +--------------------------------------------------------------------
464
465 +--------------------------------------------------------------------
466 Variable: l
467
468 Type: INTEGER
469 Description: angular quantum number
470 +--------------------------------------------------------------------
471
472 +--------------------------------------------------------------------
473 Variable: oc
474
475 Type: REAL
476 Description: occupation number
477 +--------------------------------------------------------------------
478
479 +--------------------------------------------------------------------
480 Variable: isw
481
482 Type: INTEGER
483 Description: the spin index (1-2) used only in the lsda case
484 +--------------------------------------------------------------------
485
486 +--------------------------------------------------------------------
487 Variable: jj
488
489 Type: REAL
490 Description: The total angular momentum (0.0 is allowed for complete
491 shells: the codes fills 2l states with jj=l-1/2,
492 2l+2 with jj=l+1/2).
493 +--------------------------------------------------------------------
494
495 ===END OF CARD==========================================================
496
497
498 ========================================================================
499 NAMELIST: &INPUTP
500
501 +--------------------------------------------------------------------
502 Variable: zval
503
504 Type: REAL
505 Default: (calculated)
506 Description: Valence charge.
507
508 zval is automatically calculated from available data.
509 If the value of zval is provided in input, it will be
510 checked versus the calculated value. The only case in
511 which you need to explicitly provide the value of zval
512 for noninteger zval (i.e. half core-hole pseudo-potentials).
513 +--------------------------------------------------------------------
514
515 +--------------------------------------------------------------------
516 Variable: pseudotype
517
518 Type: INTEGER
519 Description: 1 ... norm-conserving, single-projector PP
520 IMPORTANT: if pseudotype=1 all calculations are done
521 using the SEMILOCAL form, not the separable nonlocal form
522
523 2 ... norm-conserving PP in separable form (obsolescent)
524 All calculations are done using SEPARABLE non-local form
525 IMPORTANT: multiple projectors allowed but not properly
526 implemented, use only if you know what you are doing
527
528 3 ... ultrasoft PP or PAW
529 +--------------------------------------------------------------------
530
531 +--------------------------------------------------------------------
532 Variable: file_pseudopw
533
534 Type: CHARACTER
535 Status: REQUIRED
536 Description: File where the generated PP is written.
537
538 * if the file name ends with "upf" or "UPF",
539 or in any case for spin-orbit PP (rel=2),
540 the file is written in UPF format;
541
542 * if the file name ends with 'psp' it is
543 written in native CPMD format (this is currently
544 an experimental feature); otherwise it is written
545 in the old "NC" format if pseudotype=1, or
546 in the old RRKJ format if pseudotype=2 or 3
547 (no default, must be specified).
548 +--------------------------------------------------------------------
549
550 +--------------------------------------------------------------------
551 Variable: file_recon
552
553 Type: CHARACTER
554 Description: File containing data needed for GIPAW reconstruction
555 of all-electron wavefunctions from PP results.
556 If you want to use additional states to perform the
557 reconstruction, add them at the end of the list
558 of all-electron states.
559 Default: ' '
560 +--------------------------------------------------------------------
561
562 +--------------------------------------------------------------------
563 Variable: lloc
564
565 Type: INTEGER
566 Default: -1
567 Description: Angular momentum of the local channel.
568
569 * lloc=-1 or lloc=-2 pseudizes the all-electron potential
570 if lloc=-2 the original recipe of Troullier-Martins
571 is used (zero first and second derivatives at r=0)
572 * lloc&gt;-1 uses the corresponding channel as local PP
573
574 NB: if lloc&gt;-1, the corresponding channel must be the last in the
575 list of wavefunctions appearing after the namelist &inputp
576 In the relativistic case, if lloc &gt; 0 both the j=lloc-1/2 and
577 the j=lloc+1/2 wavefunctions must be at the end of the list.
578 +--------------------------------------------------------------------
579
580 +--------------------------------------------------------------------
581 Variable: rcloc
582
583 Type: REAL
584 Status: Must be specified only if "lloc"=-1, otherwise the
585 corresponding value of "rcut" is used.
586 Description: Matching radius (a.u.) for local pseudo-potential (no default).
587 +--------------------------------------------------------------------
588
589 +--------------------------------------------------------------------
590 Variable: nlcc
591
592 Type: LOGICAL
593 Default: .false.
594 Description: If .true. produce a PP with the nonlinear core
595 correction of Louie, Froyen, and Cohen
596 [PRB 26, 1738 (1982)].
597 +--------------------------------------------------------------------
598
599 +--------------------------------------------------------------------
600 Variable: new_core_ps
601
602 Type: LOGICAL
603 Default: .false.
604 Status: requires nlcc=.true.
605 Description: If .true. pseudizes the core charge with bessel functions.
606 +--------------------------------------------------------------------
607
608 +--------------------------------------------------------------------
609 Variable: rcore
610
611 Type: REAL
612 Description: Matching radius (a.u.) for the smoothing of the core charge.
613 If not specified, the matching radius is determined
614 by the condition: rho_core(rcore) = 2*rho_valence(rcore)
615 +--------------------------------------------------------------------
616
617 +--------------------------------------------------------------------
618 Variable: tm
619
620 Type: LOGICAL
621 Default: .false.
622 Description: * .true. for Troullier-Martins pseudization [PRB 43, 1993 (1991)]
623
624 * .false. for Rappe-Rabe-Kaxiras-Joannopoulos pseudization
625 [PRB 41, 1227 (1990), erratum PRB 44, 13175 (1991)]
626 +--------------------------------------------------------------------
627
628 +--------------------------------------------------------------------
629 Variable: rho0
630
631 Type: REAL
632 Description: Charge at the origin: when the Rappe-Rabe-Kaxiras-Joannopoulos
633 method with 3 Bessel functions fails, specifying rho0 &gt; 0
634 may allow to override the problem (using 4 Bessel functions).
635 Typical values are in the order of 0.01-0.02
636 Default: 0.0
637 +--------------------------------------------------------------------
638
639 +--------------------------------------------------------------------
640 Variable: lpaw
641
642 Type: LOGICAL
643 Description: If .true. produce a PAW dataset, experimental feature
644 only for "pseudotype"=3
645 Default: .false.
646 +--------------------------------------------------------------------
647
648 ///---
649 +--------------------------------------------------------------------
650 Variable: which_augfun
651
652 Type: CHARACTER
653 Default: 'AE' for Vanderbilt-Ultrasoft pseudo-potentials and 'BESSEL' for PAW datasets.
654 Description: If different from 'AE' the augmentation functions are pseudized
655 before "rmatch_augfun". The pseudization options are:
656
657 * 'PSQ' Use Bessel functions to pseudize Q
658 from the origin to rmatch_augfun.
659
660 These features are available only for PAW:
661
662 * 'BESSEL' Use Bessel functions to pseudize the Q.
663 * 'GAUSS' Use 2 Gaussian functions to pseudize the Q.
664 * 'BG' Use original Bloechl's recipe with a single gaussian.
665
666 Note: if lpaw is true and which_augfun is set to AE real all-
667 electron charge will be used, which will produce extremely
668 hard augmentation.
669 +--------------------------------------------------------------------
670
671 +--------------------------------------------------------------------
672 Variable: rmatch_augfun
673
674 Type: REAL
675 Default: 0.5 a.u.
676 Status: Used only if which_augfun is different from 'AE'.
677 Description: Pseudization radius for the augmentation functions. Presently
678 it has the same value for all L.
679 +--------------------------------------------------------------------
680
681 +--------------------------------------------------------------------
682 Variable: rmatch_augfun_nc
683
684 Type: REAL
685 Default: .false.
686 Status: Used only if which_augfun is 'PSQ'.
687 Description: If .true. the augmentation functions are pseudized
688 from the origin to min(rcut(ns),rcut(ns1)) where ns
689 and ns1 are the two channels for that Q. In this case
690 rmatch_augfun is not used.
691 +--------------------------------------------------------------------
692
693 \\\---
694
695 +--------------------------------------------------------------------
696 Variable: lsave_wfc
697
698 Type: LOGICAL
699 Default: .false. if .not. lpaw, otherwise .true.
700 Description: Set it to .true. to save all-electron and pseudo wavefunctions
701 used in the pseudo-potential generation in the UPF file. Only
702 works for UPFv2 format.
703 +--------------------------------------------------------------------
704
705 +--------------------------------------------------------------------
706 Variable: lgipaw_reconstruction
707
708 Type: LOGICAL
709 Default: .false.
710 Description: Set it to .true. to generate pseudo-potentials containing the
711 additional info required for reconstruction of all-electron
712 orbitals, used by GIPAW. You will typically need to specify
713 additional projectors beyond those used in the generation of
714 pseudo-potentials. You should also specify "file_recon".
715
716 All projectors used in the reconstruction must be listed BOTH
717 in the test configuration after namelist &test AND in the
718 all-electron configuration (variable 'config', namelist &inputp,
719 Use negative occupancies for projectors on unbound states). The
720 core radii in the test configuration should be the same as in
721 the pseudo-potential generation section and will be used as the
722 radius of reconstruction. Projectors not used to generate the
723 pseudo-potential should have zero occupation number.
724 +--------------------------------------------------------------------
725
726 +--------------------------------------------------------------------
727 Variable: use_paw_as_gipaw
728
729 Type: LOGICAL
730 Default: .false.
731 Description: When generating a PAW dataset, setting this option to .true. will
732 save the core all-electron wavefunctions to the UPF file.
733 The GIPAW reconstruction to be performed using the PAW data and
734 projectors for the valence wavefunctions.
735
736 In the default case, the GIPAW valence wavefunction and projectors
737 are independent from the PAW ones and must be then specified as
738 explained above in lgipaw_reconstruction.
739
740 Setting this to .true. always implies "lgipaw_reconstruction" = .true.
741 +--------------------------------------------------------------------
742
743 +--------------------------------------------------------------------
744 Variable: author
745
746 Type: CHARACTER
747 Description: Name of the author.
748 Default: 'anonymous'
749 +--------------------------------------------------------------------
750
751 +--------------------------------------------------------------------
752 Variable: file_chi
753
754 Type: CHARACTER
755 Description: file containing output PP chi functions
756 Default: ' '
757 +--------------------------------------------------------------------
758
759 +--------------------------------------------------------------------
760 Variable: file_beta
761
762 Type: CHARACTER
763 Description: file containing output PP beta functions
764 Default: ' '
765 +--------------------------------------------------------------------
766
767 +--------------------------------------------------------------------
768 Variable: file_qvan
769
770 Type: CHARACTER
771 Description: file containing output PP qvan functions
772 Default: ' '
773 +--------------------------------------------------------------------
774
775 +--------------------------------------------------------------------
776 Variable: file_screen
777
778 Type: CHARACTER
779 Description: file containing output screening potential
780 Default: ' '
781 +--------------------------------------------------------------------
782
783 +--------------------------------------------------------------------
784 Variable: file_core
785
786 Type: CHARACTER
787 Description: file containing output total and core charge
788 Default: ' '
789 +--------------------------------------------------------------------
790
791 +--------------------------------------------------------------------
792 Variable: file_wfcaegen
793
794 Type: CHARACTER
795 Description: file with the all-electron wfc for generation
796 Default: ' '
797 +--------------------------------------------------------------------
798
799 +--------------------------------------------------------------------
800 Variable: file_wfcncgen
801
802 Type: CHARACTER
803 Description: file with the norm-conserving wfc for generation
804 Default: ' '
805 +--------------------------------------------------------------------
806
807 +--------------------------------------------------------------------
808 Variable: file_wfcusgen
809
810 Type: CHARACTER
811 Description: file with the ultra-soft wfc for generation
812 Default: ' '
813 +--------------------------------------------------------------------
814
815 ===END OF NAMELIST======================================================
816
817
818 ========================================================================
819 CARD:
820
821 ________________________________________________________________________
822 * IF rel=0 OR rel=2 :
823
824 /////////////////////////////////////////
825 // Syntax: //
826 /////////////////////////////////////////
827
828 nwfs
829 nls(1) nns(1) lls(1) ocs(1) ener(1) rcut(1) rcutus(1) jjs(1)
830 nls(2) nns(2) lls(2) ocs(2) ener(2) rcut(2) rcutus(2) jjs(2)
831 . . .
832 nls(nwfs) nns(nwfs) lls(nwfs) ocs(nwfs) ener(nwfs) rcut(nwfs) rcutus(nwfs) jjs(nwfs)
833
834 /////////////////////////////////////////
835
836 * if "lloc"&gt;-1 the state with "lls"="lloc" must be the last
837
838 * if "lloc"&gt;0 in the relativistic case, both states with "jjs"="lloc"-1/2
839 and "jjs"="lloc"+1/2 must be the last two
840
841
842 * ELSE :
843
844 /////////////////////////////////////////
845 // Syntax: //
846 /////////////////////////////////////////
847
848 nwfs
849 nls(1) nns(1) lls(1) ocs(1) ener(1) rcut(1) rcutus(1)
850 nls(2) nns(2) lls(2) ocs(2) ener(2) rcut(2) rcutus(2)
851 . . .
852 nls(nwfs) nns(nwfs) lls(nwfs) ocs(nwfs) ener(nwfs) rcut(nwfs) rcutus(nwfs)
853
854 /////////////////////////////////////////
855
856
857 ENDIF
858 ________________________________________________________________________
859
860 DESCRIPTION OF ITEMS:
861
862 +--------------------------------------------------------------------
863 Variable: nwfs
864
865 Type: INTEGER
866 Description: number of wavefunctions to be pseudized
867 +--------------------------------------------------------------------
868
869 +--------------------------------------------------------------------
870 Variable: nls
871
872 Type: CHARACTER
873 Description: Wavefunction label (same as in the all-electron configuration).
874 +--------------------------------------------------------------------
875
876 +--------------------------------------------------------------------
877 Variable: nns
878
879 Type: INTEGER
880 Description: Principal quantum number (referred to the PSEUDOPOTENTIAL case;
881 nns=1 for lowest s, nns=2 for lowest p, and so on).
882 +--------------------------------------------------------------------
883
884 +--------------------------------------------------------------------
885 Variable: lls
886
887 Type: INTEGER
888 Description: Angular momentum quantum number.
889 +--------------------------------------------------------------------
890
891 +--------------------------------------------------------------------
892 Variable: ocs
893
894 Type: REAL
895 Description: Occupation number (same as in the all-electron configuration).
896 +--------------------------------------------------------------------
897
898 +--------------------------------------------------------------------
899 Variable: ener
900
901 Type: REAL
902 Description: Energy (Ry) used to pseudize the corresponding state.
903 If 0.d0, use the one-electron energy of the all-electron state.
904 Do not use 0.d0 for unbound states!
905 +--------------------------------------------------------------------
906
907 +--------------------------------------------------------------------
908 Variable: rcut
909
910 Type: REAL
911 Description: Matching radius (a.u.) for norm conserving PP.
912 +--------------------------------------------------------------------
913
914 +--------------------------------------------------------------------
915 Variable: rcutus
916
917 Type: REAL
918 Description: Matching radius (a.u.) for ultrasoft PP - only for pseudotype=3.
919 +--------------------------------------------------------------------
920
921 +--------------------------------------------------------------------
922 Variable: jjs
923
924 Type: REAL
925 Description: The total angular momentum (0.0 is allowed for complete shells).
926 +--------------------------------------------------------------------
927
928 ===END OF CARD==========================================================
929
930
931 ========================================================================
932 NAMELIST: &TEST
933
934 NEEDED ONLY IF "ISWITCH"=2 OR "ISWITCH"=4, OPTIONAL IF "ISWITCH"=3
935
936 +--------------------------------------------------------------------
937 Variable: nconf
938
939 Type: INTEGER
940 Description: the number of configurations to be tested. For "iswitch"=4 nconf=2
941 Default: 1
942 +--------------------------------------------------------------------
943
944 +--------------------------------------------------------------------
945 Variable: file_pseudo
946
947 Type: CHARACTER
948 Status: ignored if "iswitch"=3
949 Description: File containing the PP.
950
951 * If the file name contains ".upf" or ".UPF",
952 the file is assumed to be in UPF format;
953
954 * else if the file name contains ".rrkj3" or ".RRKJ3",
955 the old RRKJ format is first tried;
956
957 * otherwise, the old NC format is read.
958
959 IMPORTANT: in the latter case, all calculations are done
960 using the SEMILOCAL form, not the separable nonlocal form.
961 Use the UPF format if you want to test the separable form!
962 Default: ' '
963 +--------------------------------------------------------------------
964
965 +--------------------------------------------------------------------
966 Variables: ecutmin, ecutmax, decut
967
968 Type: REAL
969 Default: decut=5.0 Ry; ecutmin=ecutmax=0Ry
970 Status: specify @ref ecutmin and @ref ecutmax if you want to perform this test
971 Description: Parameters (Ry) used for test with a basis set of spherical
972 Bessel functions j_l(qr) . The hamiltonian at fixed scf
973 potential is diagonalized for various values of ecut:
974 @ref ecutmin, @ref ecutmin+@ref decut, @ref ecutmin+2*@ref decut ... up to @ref ecutmax.
975 This yields an indication of convergence with the
976 corresponding plane-wave cutoff in solids, and shows
977 in an unambiguous way if there are "ghost" states
978 +--------------------------------------------------------------------
979
980 +--------------------------------------------------------------------
981 Variable: rm
982
983 Type: REAL
984 Description: Radius of the box used with spherical Bessel functions.
985 Default: 30 a.u.
986 +--------------------------------------------------------------------
987
988 +--------------------------------------------------------------------
989 Variable: configts(i), i=1,nconf
990
991 Type: CHARACTER
992 Description: A string array containing the test electronic configuration.
993 "configts"(nc), nc=1,"nconf", has the same syntax as for "config"
994 but only VALENCE states must be included.
995 If "configts"(i) is not set, the electron configuration
996 is read from the cards following the namelist.
997 +--------------------------------------------------------------------
998
999 +--------------------------------------------------------------------
1000 Variable: lsdts(i), i=1,nconf
1001
1002 Type: INTEGER
1003 Default: 1
1004 See: lsd
1005 Description: 0 or 1. It is the value of lsd used in the i-th test.
1006 Allows to make simultaneously spin-polarized and
1007 spin-unpolarized tests.
1008 +--------------------------------------------------------------------
1009
1010 +--------------------------------------------------------------------
1011 Variable: frozen_core
1012
1013 Type: LOGICAL
1014 Default: .false.
1015 Description: If .true. only the core wavefunctions of the first
1016 configuration are calculated. The eigenvalues, orbitals
1017 and energies of the other configurations are calculated
1018 with the core of the first configuration.
1019 The first configuration must be spin-unpolarized.
1020 +--------------------------------------------------------------------
1021
1022 +--------------------------------------------------------------------
1023 Variable: rcutv
1024
1025 Type: REAL
1026 Description: Cutoff distance (CUT) for the inclusion of LDA-1/2 potential.
1027 Needed (mandatory) only if "iswitch" = 4
1028 Default: -1.0
1029 +--------------------------------------------------------------------
1030
1031 ===END OF NAMELIST======================================================
1032
1033
1034 ========================================================================
1035 CARD:
1036
1037 IMPORTANT: THIS CARD HAS TO BE SPECIFIED FOR EACH MISSING CONFIGTS(I)
1038
1039 ________________________________________________________________________
1040 * IF lsd=1 :
1041
1042 /////////////////////////////////////////
1043 // Syntax: //
1044 /////////////////////////////////////////
1045
1046 nwfts
1047 elts(1) nnts(1) llts(1) octs(1) enerts(1) rcutts(1) rcutusts(1) iswts(1)
1048 elts(2) nnts(2) llts(2) octs(2) enerts(2) rcutts(2) rcutusts(2) iswts(2)
1049 . . .
1050 elts(nwfts) nnts(nwfts) llts(nwfts) octs(nwfts) enerts(nwfts) rcutts(nwfts) rcutusts(nwfts) iswts(nwfts)
1051
1052 /////////////////////////////////////////
1053
1054
1055 * ELSE IF rel=2 :
1056
1057 /////////////////////////////////////////
1058 // Syntax: //
1059 /////////////////////////////////////////
1060
1061 nwfts
1062 elts(1) nnts(1) llts(1) octs(1) enerts(1) rcutts(1) rcutusts(1) jjts(1)
1063 elts(2) nnts(2) llts(2) octs(2) enerts(2) rcutts(2) rcutusts(2) jjts(2)
1064 . . .
1065 elts(nwfts) nnts(nwfts) llts(nwfts) octs(nwfts) enerts(nwfts) rcutts(nwfts) rcutusts(nwfts) jjts(nwfts)
1066
1067 /////////////////////////////////////////
1068
1069
1070 * ELSE :
1071
1072 /////////////////////////////////////////
1073 // Syntax: //
1074 /////////////////////////////////////////
1075
1076 nwfts
1077 elts(1) nnts(1) llts(1) octs(1) enerts(1) rcutts(1) rcutusts(1)
1078 elts(2) nnts(2) llts(2) octs(2) enerts(2) rcutts(2) rcutusts(2)
1079 . . .
1080 elts(nwfts) nnts(nwfts) llts(nwfts) octs(nwfts) enerts(nwfts) rcutts(nwfts) rcutusts(nwfts)
1081
1082 /////////////////////////////////////////
1083
1084
1085 ENDIF
1086 ________________________________________________________________________
1087
1088 DESCRIPTION OF ITEMS:
1089
1090 +--------------------------------------------------------------------
1091 Variable: nwfts
1092
1093 Type: INTEGER
1094 Description: number of wavefunctions
1095 +--------------------------------------------------------------------
1096
1097 +--------------------------------------------------------------------
1098 Variable: elts
1099
1100 Type: CHARACTER
1101 See: nls
1102 +--------------------------------------------------------------------
1103
1104 +--------------------------------------------------------------------
1105 Variable: nnts
1106
1107 Type: INTEGER
1108 See: nns
1109 +--------------------------------------------------------------------
1110
1111 +--------------------------------------------------------------------
1112 Variable: llts
1113
1114 Type: INTEGER
1115 See: lls
1116 +--------------------------------------------------------------------
1117
1118 +--------------------------------------------------------------------
1119 Variable: octs
1120
1121 Type: REAL
1122 See: ocs
1123 +--------------------------------------------------------------------
1124
1125 +--------------------------------------------------------------------
1126 Variable: enerts
1127
1128 Type: REAL
1129 Status: not used
1130 +--------------------------------------------------------------------
1131
1132 +--------------------------------------------------------------------
1133 Variable: rcutts
1134
1135 Type: REAL
1136 Status: not used
1137 +--------------------------------------------------------------------
1138
1139 +--------------------------------------------------------------------
1140 Variable: rcutusts
1141
1142 Type: REAL
1143 Status: not used
1144 +--------------------------------------------------------------------
1145
1146 +--------------------------------------------------------------------
1147 Variable: iswts
1148
1149 Type: INTEGER
1150 Description: spin index (1 or 2, used in lsda case)
1151 +--------------------------------------------------------------------
1152
1153 +--------------------------------------------------------------------
1154 Variable: jjts
1155
1156 Type: REAL
1157 Description: total angular momentum of the state
1158 +--------------------------------------------------------------------
1159
1160 ===END OF CARD==========================================================
1161
1162
1163
1164 :::: Notes
1165
1166 For PP generation you do not need to specify namelist &test, UNLESS:
1167
1168 1. you want to use a different configuration for unscreening wrt the
1169 one used to generate the PP. This is useful for PP with semicore
1170 states: use semicore states ONLY to produce the PP, use semicore
1171 AND valence states (if occupied) to make the unscreening
1172
1173 2. you want to specify some more states for PAW style reconstruction of
1174 all-electron orbitals from pseudo-orbitals
1175
1176
1177 ::: Output files written
1178
1179 * file_tests "prefix".test results of transferability test
1180
1181 for each testing configuration N:
1182
1183 * file_wavefunctions "prefix"N.wfc all-electron KS orbitals
1184 * file_wavefunctionsps "prefix"Nps.wfc pseudo KS orbitals
1185
1186 if lsd=1:
1187
1188 * file_wavefunctions "prefix"N.wfc.up all-electron KS up orbitals
1189 * file_wavefunctions "prefix"N.wfc.dw all-electron KS down orbitals
1190
1191 if rel=2 and lsmall=.true.:
1192
1193 * file_wavefunctions "prefix".wfc.small all-electron KS small component
1194
1195 if parameters for logarithmic derivatives are specified:
1196
1197 * file_logder "prefix"Nps.dlog all-electron logarithmic derivatives
1198 * file_logderps "prefix"Nps.dlog pseudo logarithmic derivatives
1199
1200 "N" is not present if there is just one testing configuration.
1201
1202
1203
1204 ::: Recipes to reproduce old all-electron atomic results with the ld1 program
1205
1206 * The Hartree results in Phys. Rev. 59, 299 (1940) or in
1207 Phys. Rev. 59, 306 (1940) can be reproduced with:
1208
1209 rel=0,
1210 isic=1,
1211 dft='NOX-NOC'
1212
1213 * The Herman-Skillman tables can be reproduced with:
1214
1215 rel=0,
1216 isic=0,
1217 latt=1,
1218 dft='SL1-NOC'
1219
1220 * Data on the paper Liberman, Waber, Cromer Phys. Rev. 137, A27 (1965) can be
1221 reproduced with:
1222
1223 rel=2,
1224 isic=0,
1225 latt=1,
1226 dft='SL1-NOC'
1227
1228 * Data on the paper S. Cohen Phys. Rev. 118, 489 (1960) can be reproduced with:
1229
1230 rel=2,
1231 isic=1,
1232 latt=0,
1233 dft='NOX-NOC'
1234
1235 * The revised PBE described in PRL 80, 890 (1998) can be obtained with:
1236
1237 isic=0
1238 latt=0
1239 dft='SLA-PW-RPB-PBC' or 'dft='revPBE'
1240
1241 * The relativistic energies of closed shell atoms reported in PRB 64 235126 (2001)
1242 can be reproduced with:
1243
1244 isic=0
1245 latt=0
1246 cau_fact=137.0359895
1247 dft='sla-vwn' for the LDA case
1248 dft='PBE' for the PBE case
1249
1250 * The NIST results in PRA 55, 191 (1997):
1251
1252 LDA:
1253 rel=0
1254 dft='sla-vwn'
1255
1256 LSD:
1257 rel=0
1258 lsd=1
1259 dft='sla-vwn'
1260
1261 RLDA
1262 rel=2
1263 rel_dist='average'
1264 dft='rxc-vwn'
1265
1266 ScRLDA:
1267 rel=1
1268 dft='rxc-vwn'
1269
1270
1271
1272 This file has been created by helpdoc utility on Wed Dec 02 08:04:51 CET 2020
1273
1274 </pre>
1275 </body>
1276 </html>