3.41 Superconductivity
This module calculates the Eliashberg function , the electron-phonon coupling parameter , and the superconducting transition temperature using the Allen-Dynes expression. It builds on the electron-phonon coupling / electronic friction infrastructure described in Section 3.40.
A dedicated publication focused on the superconductivity implementation is forthcoming. Until then, please cite and refer to the following reference when using this module:
-
•
C. L. Box, W. G. Stark, R. J. Maurer, “Ab initio calculation of electron-phonon linewidths and molecular dynamics with electronic friction at metal surfaces with numeric atom-centred orbitals,” Electron. Struct. 5, 035005 (2023), https://doi.org/10.1088/2516-1075/acf3c4.
Scope and Workflow
The present implementation obtains phonon linewidths from the friction/EPC machinery and then:
-
1.
constructs on a user-defined frequency grid,
-
2.
evaluates ,
-
3.
evaluates and via Allen-Dynes.
For periodic systems, the current friction-based EPC workflow corresponds to the -point / setup. The superconductivity driver can be combined with scans in friction broadening and electronic temperature (see keywords below).
Theory
The Eliashberg function is evaluated as
| (3.185) |
The electron-phonon coupling parameter is
| (3.186) |
In the present implementation, the linewidths passed from the friction module are treated as full widths at half maximum (FWHM).
The superconducting transition temperature is computed with the Allen-Dynes form
| (3.187) |
with
| (3.188) | ||||
Tags for general section of control.in
Tag: calculate_superconductivity(control.in)
Usage: calculate_superconductivity type
Purpose: Enables superconductivity analysis (linewidths, , , , ).
type: Method for EPC matrix elements:
-
•
numerical: finite-difference EPC matrix elements (default).
-
•
DFPT: DFPT EPC matrix elements (experimental in this context).
Tag: alpha2f_broadening_width(control.in)
Usage: alpha2f_broadening_width width
Purpose: Gaussian broadening width (in eV) used to represent delta functions when building .
This setting affects , and therefore also , , and .
Default: 0.001 eV.
Tag: alpha2f_grid(control.in)
Usage: alpha2f_grid Emin Emax dE
Purpose: Frequency grid (in eV) used for tabulating .
Emin: minimum frequency in eV.
Emax: maximum frequency in eV (must be larger than Emin).
dE: grid spacing in eV (must be positive).
Default: 0.0 0.5 0.0001 (eV).
Tag: supercond_mu_star(control.in)
Usage: supercond_mu_star mu_star
Purpose: Effective Coulomb pseudopotential used in Allen-Dynes .
Typical range: 0.1–0.2.
Default: 0.13.
Friction Keywords Used by Superconductivity
The superconductivity driver reuses friction settings for linewidth generation:
-
•
friction_broadening_width: one value, or a scan start end n_steps.
-
•
friction_temperature: one value, or a scan T_start T_end n_steps.
-
•
friction_print_tensors: defaults to .false. for superconductivity runs to reduce verbose tensor output; set explicitly to .true. if tensor printing is desired.
If both are scans, all combinations are evaluated (Cartesian product of smearing and temperature grids).
Output Files
Two files are written by the superconductivity module:
-
•
eliashberg_function.out: frequency grid (eV) and columns for each parameter point.
-
•
superconductivity_tc.out: one row per parameter point with smearing (eV), electronic temperature (K), , , (meV), DOS at (1/eV/spin), Allen-Dynes prefactors , , and (K).
Additionally, use empty_states large enough (or calculate_all_eigenstates) to ensure sufficient unoccupied states are available for the EPC/frequency-resolved analysis.