11.3. ANPHON: Output files#
The files are listed by MODE. PREFIX is the value of the PREFIX tag.
Several files come in two formats: the HDF5 version is written by default, and the plain-text version with FILE_FORMAT = text.
The layouts of the HDF5 files are described in HDF5 files.
MODE = phonons#
Files written for the points of the &kpoint field. KPMODE 0, 1, and 2 give a list of points, band paths, and a uniform mesh, respectively.
File |
Written when |
Contents |
|---|---|---|
|
KPMODE = 1 |
Phonon dispersion (cm-1) along the paths |
|
KPMODE = 1, |
How the branches connect along the paths |
|
KPMODE = 2 ( |
Phonon DOS; atom-projected DOS with |
|
KPMODE = 2, |
Two-phonon DOS at the irreducible \(k\) points |
|
KPMODE = 2, |
Longitudinal-projected DOS |
|
KPMODE = 2 |
Heat capacity, entropy, internal energy, and free energy vs. temperature. With
|
|
KPMODE = 2, |
Mean-square displacements of atoms vs. temperature |
|
KPMODE = 2, |
Displacement–displacement correlation function ( |
|
KPMODE = 2, |
Three-phonon scattering phase space; |
|
|
Group velocities along the paths, or at every mesh point (magnitude and components) |
|
|
Phonon eigenvalues. The file name follows KPMODE 0, 1, 2 (no suffix, |
|
|
Phonon eigenvalues and eigenvectors, named as above;
plain text |
|
|
Participation ratio and atomic participation ratio of every mode, named as above |
|
|
Mode directions at the given \(k\) points, for XCrySDen, named as above |
|
|
Animation of mode NNN; XYZ (default) or AXSF with |
|
|
Grüneisen parameters at the given points, along the paths, or on the mesh:
volumetric ( |
|
|
Force constants of the crystal strained by \(\pm u\), usable as |
|
|
Phonon contribution to the dielectric function \(\epsilon(\omega)\) |
|
|
Mode effective charges of the zone-center modes |
|
|
Irreducible representations and IR/Raman activities at \(\Gamma\) |
|
|
Harmonic force constants split into the dipole–dipole and short-range parts |
MODE = kappa#
File |
Written when |
Contents |
|---|---|---|
|
Always (default format) |
All results: frequencies, velocities, linewidths, and thermal conductivity. Updated during the run and used for restarting;
read by |
|
|
Legacy text versions of the three- and four-phonon linewidths |
|
|
Thermal conductivity tensor vs. temperature |
|
|
Thermal conductivity with three-phonon scattering only, and with three- and four-phonon scattering |
|
|
Thermal conductivity from the solution of the Boltzmann equation beyond the RTA |
|
|
Spectrum of the thermal conductivity (diagonal components) |
|
|
Coherent (off-diagonal) contribution to the thermal conductivity |
|
|
Mode-resolved contributions to the coherent term |
|
|
Linewidths due to isotope scattering |
|
|
Four-phonon linewidths interpolated onto the three-phonon mesh |
|
|
Diagnostic of the velocity matrix: largest deviation of its diagonal from the group velocities and largest deviation from hermiticity |
MODE = selfenergy#
File |
Written when |
Contents |
|---|---|---|
|
Always (default format) |
Results of all target modes. See Self-energy (PREFIX.selfenergy.h5) |
|
|
Linewidth \(2\Gamma\) vs. temperature of target N |
|
|
Frequency shifts vs. temperature |
|
|
Self-energy as a function of frequency |
|
|
Frequency-resolved final-state analysis of the linewidth |
|
|
Spectral function \(A(\boldsymbol{q}, \omega)\), total and per branch |
|
|
Three- and four-phonon matrix elements involving target N |
In the text files, N numbers the targets on the integration mesh first and the other targets after them;
the header of each file gives the wave vector and the branch.
The same per-target files are written in MODE = kappa with the KS_INPUT analysis (SELF_ENERGY = 1, REALPART = 1, …).
MODE = SCPH and MODE = QHA#
The file names start with PREFIX.scph for MODE = SCPH and PREFIX.qha for MODE = QHA.
With BUBBLE = 1, 2, 3, SCPH additionally writes the bubble-corrected versions
PREFIX.scph+bubble(0), +bubble(w), or +bubble(wQP) of the eval, bands, dos, msd, ucorr, and dfc2 files.
File |
Written when |
Contents |
|---|---|---|
|
Always (default format) |
Results at every temperature, used by later runs ( |
|
KPMODE = 0 |
Frequencies vs. temperature at the given \(k\) points |
|
KPMODE = 1 |
Dispersion vs. temperature. With |
|
KPMODE = 2 ( |
DOS vs. temperature |
|
KPMODE = 2 |
Heat capacity, entropy, and free energy vs. temperature. With |
|
|
Curvature of the SCP free energy at each converged temperature: frequencies of the SCPH
and of the free-energy curvature (static bubble + quartic ladder) along the \(\Gamma\)
displacements; negative values are unstable directions. With a cell ( |
|
|
The SCPH state file again, with the correction of the free-energy curvature at every
point of the mesh (\(\Gamma\) for |
|
|
Curvature of the SCP free energy at the irreducible \(\boldsymbol{Q}\)-points of the mesh other than \(\Gamma\): for each converged temperature and \(\boldsymbol{Q}\), the frequencies of the SCPH and of the free-energy curvature (all branches); negative values are unstable modulations |
|
|
For each unstable direction, the |
|
KPMODE = 2, |
Mean-square displacements vs. temperature |
|
KPMODE = 2, |
Displacement correlation function vs. temperature |
|
|
Dielectric function vs. temperature |
|
Always |
Change of the harmonic force constants \(\Delta\Phi_2\) at each temperature
(see the formalism of the SCPH calculation), relative to the full
harmonic dynamical matrix of the run; the comment line |
|
|
Atomic displacements vs. temperature, in Cartesian and normal coordinates |
|
|
Displacement gradient tensor \(u_{\mu\nu}\) vs. temperature |
step_q0.txt, step_u0.txt, step_u_tensor.txt |
|
History of the structural optimization at every step (fixed names in the working directory) |
|
|
Polarization of the relaxed structure vs. temperature |
|
|
Potential energy \(U_0\) vs. temperature |
|
|
Legacy restart files: the change of the dynamical matrix |
The optimization files (atom_disp, step_*.txt, …) and the dfc2 files are written by a new calculation, not by a restart.
Note
A calculation restarts automatically when the restart files of an earlier run with the same PREFIX are found
(PREFIX.kappa.h5 or .result, PREFIX.scph.h5 or .scph_dymat, …).
Remove them, or change PREFIX, to start from scratch.