40#include "./base/base_uses.f90"
45 CHARACTER(len=*),
PARAMETER,
PRIVATE :: moduleN =
'input_cp2k_negf'
63 cpassert(.NOT.
ASSOCIATED(section))
65 description=
"Parameters which control quantum transport calculation"// &
66 " based on Non-Equilibrium Green Function method.", &
68 n_keywords=18, n_subsections=6, repeats=.false.)
70 NULLIFY (keyword, print_key, subsection)
72 CALL create_contact_section(subsection)
76 CALL create_scattering_region_section(subsection)
86 description=
"Do not keep contact self-energy matrices for future reuse", &
87 default_l_val=.false., lone_keyword_l_val=.true.)
93 description=
"Target accuracy for electronic density.", &
94 n_var=1, type_of_var=
real_t, default_r_val=1.0e-5_dp)
99 description=
"Target accuracy for surface Green's functions.", &
100 n_var=1, type_of_var=
real_t, default_r_val=1.0e-5_dp)
105 description=
"Target accuracy for SCF convergence.", &
106 n_var=1, type_of_var=
real_t, default_r_val=1.0e-5_dp)
111 description=
"Accuracy in mapping atoms between different force environments.", &
112 n_var=1, type_of_var=
real_t, unit_str=
"angstrom", &
113 default_r_val=1.0e-6_dp)
117 CALL keyword_create(keyword, __location__, name=
"ENERGY_LBOUND", &
118 description=
"Lower bound energy of the conductance band.", &
119 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
120 default_r_val=-5.0_dp)
125 description=
"Infinitesimal offset from the real axis.", &
126 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
127 default_r_val=1.0e-5_dp)
131 CALL keyword_create(keyword, __location__, name=
"HOMO_LUMO_GAP", &
132 description=
"The gap between the HOMO and some fictitious LUMO. This option is used as"// &
133 " an initial offset to determine the actual Fermi level of bulk contacts."// &
134 " It does not need to be exact HOMO-LUMO gap, just some value to start with.", &
135 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
136 default_r_val=0.2_dp)
141 description=
"Number of poles of Fermi function to consider.", &
148 description=
"Offset from the axis (in terms of k*T)"// &
149 " where poles of the Fermi function reside.", &
155 CALL keyword_create(keyword, __location__, name=
"INTEGRATION_METHOD", &
156 description=
"Method to integrate Green's functions along a closed-circuit contour.", &
158 enum_c_vals=
s2a(
"CLENSHAW-CURTIS",
"SIMPSON"), &
160 "Adaptive Clenshaw-Curtis quadrature method. Requires FFTW3 library.", &
161 "Adaptive Simpson method. Works without FFTW3."), &
166 CALL keyword_create(keyword, __location__, name=
"INTEGRATION_MIN_POINTS", &
167 description=
"Initial (minimal) number of grid point for adaptive numerical integration.", &
173 CALL keyword_create(keyword, __location__, name=
"INTEGRATION_MAX_POINTS", &
174 description=
"Maximal number of grid point for adaptive numerical integration.", &
181 description=
"Maximum number of SCF iterations to be performed.", &
188 description=
"Number of MPI processes to be used per energy point."// &
189 " Default is to use all processors (0).", &
196 description=
"Initial value of the Hartree potential shift", &
197 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
198 default_r_val=0.0_dp)
202 CALL keyword_create(keyword, __location__, name=
"V_SHIFT_OFFSET", &
203 description=
"Initial offset to determine the optimal shift in Hartree potential.", &
204 n_var=1, type_of_var=
real_t, default_r_val=0.10_dp)
208 CALL keyword_create(keyword, __location__, name=
"V_SHIFT_MAX_ITERS", &
209 description=
"Maximal number of iteration to determine the optimal shift in Hartree potential.", &
210 n_var=1, type_of_var=
integer_t, default_i_val=30)
215 CALL section_create(subsection, __location__,
"PRINT",
"Printing of information during the NEGF.", &
218 CALL create_print_program_run_info_section(print_key)
222 CALL create_print_dos_section(print_key,
"DOS",
"the Density of States (DOS) in the scattering region")
226 CALL create_print_dos_section(print_key,
"TRANSMISSION",
"the transmission function")
231 description=
"Energy unit used for the printed Transmission/DOS energy axis. "// &
232 "Density of states (DOS) values are converted consistently to the selected energy unit.", &
233 usage=
"ENERGY_UNIT HARTREE", type_of_var=
enum_t, &
234 enum_c_vals=
s2a(
"HARTREE",
"EV"), &
235 enum_i_vals=[1, 2], &
236 enum_desc=
s2a(
"Print energies in Hartree (a.u.).", &
237 "Print energies in electronvolt (eV)."), &
244 description=
"Controls the dumping of the restart files during NEGF SCF.", &
246 each_iter_names=
s2a(
"NEGF_SCF"), each_iter_values=[1], &
255 CALL section_create(subsection, __location__,
"SCF",
"Additional parameters for an NEGF SCF run.", &
259 description=
"Change the atomic Hamiltonian during NEGF self-consistent cycle."// &
260 " If .FALSE., only the density matrix is updated.", &
261 default_l_val=.true., lone_keyword_l_val=.true.)
266 description=
"Restart SCF from files saved as defined in NEGF%PRINT%RESTART", &
267 default_l_val=.true., lone_keyword_l_val=.true.)
282 SUBROUTINE create_contact_section(section)
286 TYPE(
section_type),
POINTER :: print_key, subsection, subsection2
288 cpassert(.NOT.
ASSOCIATED(section))
291 description=
"Section defining the contact region of NEGF setup.", &
292 n_keywords=5, n_subsections=3, repeats=.true.)
294 NULLIFY (keyword, print_key, subsection, subsection2)
296 CALL create_atomlist_section(subsection,
"BULK_REGION", &
297 "the bulk contact adjacent to the screening region.", .false.)
299 CALL create_atomlist_section(subsection2,
"CELL", &
300 "a single bulk contact unit cell. Bulk Hamiltonian will be contstructed "// &
301 "using two such unit cells instead of performing k-point bulk calculation. "// &
302 "FORCE_EVAL_SECTION must be 0.", .true.)
307 CALL create_atomlist_section(subsection,
"SCREENING_REGION", &
308 "the given contact adjacent to the scattering region.", .false.)
312 CALL keyword_create(keyword, __location__, name=
"FORCE_EVAL_SECTION", &
313 description=
" Index of the FORCE_EVAL section which will be used for bulk calculation.", &
314 n_var=1, type_of_var=
integer_t, default_i_val=0)
318 CALL keyword_create(keyword, __location__, name=
"ELECTRIC_POTENTIAL", &
319 description=
"External electrostatic potential applied to the given contact.", &
320 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
321 default_r_val=0.0_dp)
326 description=
"Contact Fermi level at the given temperature."// &
327 " If this keyword is not given explicitly, the Fermi level"// &
328 " will be automatically computed prior the actual NEGF calculation.", &
329 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
330 default_r_val=0.0_dp)
334 CALL keyword_create(keyword, __location__, name=
"REFINE_FERMI_LEVEL", &
335 description=
"Compute the Fermi level using the value from the FERMI_LEVEL keyword"// &
336 " as a starting point. By default the Fermi level is computed only"// &
337 " when the keyword FERMI_LEVEL is not given explicitly.", &
338 default_l_val=.false., lone_keyword_l_val=.true.)
342 CALL keyword_create(keyword, __location__, name=
"FERMI_LEVEL_SHIFTED", &
343 description=
"Used to shift the zero-energy level of an electrode to the common zero-energy level."// &
344 " If this keyword is specified, the Fermi level,"// &
345 " calculated by standard DFT or NEGF (using the REFINE_FERMI_LEVEL keyword),"// &
346 " or previously specified using the FERMI_LEVEL keyword,"// &
347 " is changed to this value. All diagonal elements of the Hamiltonian are shifted accordingly.", &
348 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
349 default_r_val=0.0_dp)
354 description=
"Electronic temperature.", &
355 n_var=1, type_of_var=
real_t, unit_str=
"K", &
356 default_r_val=300.0_dp/
kelvin)
361 CALL section_create(subsection, __location__,
"PRINT",
"Print properties for the given contact.", &
364 CALL create_print_dos_section(print_key,
"DOS",
"the Density of States (DOS)")
373 "Controls reading and writing of the restart files for the specified contact.", repeats=.false.)
376 description=
' Controls part of the filename for output. '// &
377 ' Use filename to obtain projectname-filename. '// &
378 ' Use ./filename to get filename.'// &
379 ' A middle name (contact number, type of matrix, spin if 2 spins) and extension '// &
380 ' are always added to the filename.', &
381 usage=
"FILENAME ./filename ", &
386 CALL keyword_create(keyword, __location__, name=
"READ_WRITE_HS", &
387 description=
"Requests reading of the electrode Hamiltonian and overlap matrices from a file."// &
388 " If at least one of these files doesn't exist, all Hamiltonian and overlap matrices"// &
389 " are calculated and saved. If no name is specified by FILENAME, the default file names are"// &
390 " projectname-Nn-H00, projectname-Nn-H01, projectname-Nn-S00, projectname-Nn-S01"// &
391 " for restricted calculations with identical spin population, or"// &
392 " projectname-Nn-H00-Ss, projectname-Nn-H01-Ss, projectname-Nn-S00-Ss, projectname-Nn-S01-Ss"// &
393 " for unrestricted calculations with two spin components,"// &
394 " where n is the number of the contact and s is the spin index."// &
395 " Otherwise, projectname is modified. Note that the code does not distinguish"// &
396 " between the files created by a separate electrode or the entire system.", &
397 default_l_val=.false., lone_keyword_l_val=.true.)
404 END SUBROUTINE create_contact_section
412 SUBROUTINE create_scattering_region_section(section)
418 cpassert(.NOT.
ASSOCIATED(section))
420 CALL section_create(section, __location__, name=
"SCATTERING_REGION", &
421 description=
"Section defining the scattering region of NEGF setup.", &
422 n_keywords=2, n_subsections=1, repeats=.false.)
424 NULLIFY (keyword, subsection)
427 description=
"Specifies a list of atoms.", &
428 usage=
"LIST {integer} {integer} .. {integer}", repeats=.true., &
434 description=
"Specifies a list of named molecular fragments.", &
435 usage=
"MOLNAME WAT MEOH", repeats=.true., &
436 n_var=-1, type_of_var=
char_t)
442 "Controls reading and writing of the initial restart files for the scattering region,"// &
443 " including the coupling to the electrodes.", repeats=.false.)
445 description=
' Controls part of the filename. '// &
446 ' Use filename to obtain projectname-filename. '// &
447 ' Use ./filename to get filename.'// &
448 ' A middle name (type of matrix, contact number for coupling matrices, spin if 2 spins)'// &
449 ' and extension are always added to the filename.', &
450 usage=
"FILENAME ./filename ", &
454 CALL keyword_create(keyword, __location__, name=
"READ_WRITE_HS", &
455 description=
"Requests reading of the Hamiltonian and overlap matrices from a file."// &
456 " For the scattering region, including the coupling to the electrodes."// &
457 " If at least one of these files doesn't exist, all Hamiltonian and overlap matrices"// &
458 " are calculated and saved. If no name is specified by FILENAME, the default file names are"// &
459 " projectname-H, projectname-H-Nn, projectname-S, projectname-S-Nn"// &
460 " for restricted calculations with identical spin population, or"// &
461 " projectname-H-Ss, projectname-H-Nn-Ss, projectname-S-Ss, projectname-S-Nn-Ss"// &
462 " for unrestricted calculations with two spin components,"// &
463 " where n is the number of the contact and s is the spin index."// &
464 " Otherwise, projectname is modified.", &
465 default_l_val=.false., lone_keyword_l_val=.true.)
471 END SUBROUTINE create_scattering_region_section
482 SUBROUTINE create_atomlist_section(section, name, description, repeats)
484 CHARACTER(len=*),
INTENT(in) :: name, description
485 LOGICAL,
INTENT(in) :: repeats
489 cpassert(.NOT.
ASSOCIATED(section))
491 CALL section_create(section, __location__, name=trim(adjustl(name)), &
492 description=
"Atoms belonging to "//trim(adjustl(description)), &
493 n_keywords=2, n_subsections=0, repeats=repeats)
498 description=
"Specifies a list of atoms.", &
499 usage=
"LIST {integer} {integer} .. {integer}", repeats=.true., &
505 description=
"Specifies a list of named molecular fragments.", &
506 usage=
"MOLNAME WAT MEOH", repeats=.true., &
507 n_var=-1, type_of_var=
char_t)
510 END SUBROUTINE create_atomlist_section
518 SUBROUTINE create_print_program_run_info_section(section)
525 description=
"Controls the printing of basic information during the NEGF.", &
529 CALL keyword_create(keyword, __location__, name=
"_SECTION_PARAMETERS_", &
530 description=
"Level starting at which this property is printed", &
531 usage=
"_SECTION_PARAMETERS_", &
533 enum_c_vals=
s2a(
"on",
"off",
"silent",
"low",
"medium",
"high",
"debug"), &
541 variants=[
"IOLEVEL"], &
542 description=
"Determines the verbose level for this section "// &
543 "additionally to GLOBAL%PRINT_LEVEL and SECTION_PARAMETERS, "// &
544 "which switch on printing.", &
545 usage=
"PRINT_LEVEL HIGH", &
547 s2a(
"SILENT",
"LOW",
"MEDIUM",
"HIGH",
"DEBUG"), &
548 enum_desc=
s2a(
"No output", &
549 "Little output",
"Quite some output",
"Lots of output", &
550 "Everything is written out, useful for debugging purposes only"), &
556 END SUBROUTINE create_print_program_run_info_section
566 SUBROUTINE create_print_dos_section(section, name, description)
568 CHARACTER(len=*),
INTENT(in) :: name, description
573 description=
"Controls the printing of "//trim(adjustl(description))//
".", &
578 description=
"Energy point to start with.", &
579 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
580 default_r_val=-1.0_dp)
585 description=
"Energy point to end with.", &
586 n_var=1, type_of_var=
real_t, unit_str=
"hartree", &
587 default_r_val=1.0_dp)
592 description=
"Number of points to compute.", &
593 n_var=1, type_of_var=
integer_t, default_i_val=201)
596 END SUBROUTINE create_print_dos_section
collects all references to literature in CP2K as new algorithms / method are included from literature...
integer, save, public papior2017
integer, save, public bailey2006
routines to handle the output, The idea is to remove the decision of wheter to output and what to out...
subroutine, public cp_print_key_section_create(print_key_section, location, name, description, print_level, each_iter_names, each_iter_values, add_last, filename, common_iter_levels, citations, unit_str, do_backup)
creates a print_key section
integer, parameter, public debug_print_level
integer, parameter, public low_print_level
integer, parameter, public medium_print_level
integer, parameter, public high_print_level
integer, parameter, public add_last_numeric
integer, parameter, public silent_print_level
Defines the basic variable types.
integer, parameter, public dp
Definition of physical constants:
real(kind=dp), parameter, public kelvin
module that contains the definitions of the scf types
subroutine, public create_mixing_section(section, ls_scf, active_space)
Create CP2K input section for SCF or active-space density mixing.
Utilities for string manipulations.