phonopy1
Manual page for phonopy 2.38.1
Overview
usage: phonopy [-h] [--abacus] [--abinit] [--aims] [--castep] [--cp2k]
-
[--crystal] [--dftb+] [--elk] [--fleur] [--lammps] [--qe] [--siesta] [--turbomole] [--vasp] [--wien2k] [--pwmat] [--alm] [--amplitude DISPLACEMENT_DISTANCE] [--amax DISPLACEMENT_DISTANCE_MAX] [--anime ANIME [ANIME ...]] [--band BAND_PATHS [BAND_PATHS ...]] [--band-connection] [--band-const-interval] [--band-labels BAND_LABELS [BAND_LABELS ...]] [--band-format BAND_FORMAT] [--band-points BAND_POINTS] [--bi BAND_INDICES [BAND_INDICES ...]] [-c FILE] [--classical] [--cutoff-freq CUTOFF_FREQUENCY] [--cutoff-radius CUTOFF_RADIUS] [-d] [--dim SUPERCELL_DIMENSION [SUPERCELL_DIMENSION ...]] [--dm-decimals DYNAMICAL_MATRIX_DECIMALS] [--dos] [--eigvecs] [-f CREATE_FORCE_SETS [CREATE_FORCE_SETS ...]] [--factor FREQUENCY_CONVERSION_FACTOR] [--fc FILE] [--fc-calc FC_CALCULATOR] [--fc-calc-opt FC_CALCULATOR_OPTIONS] [--fc-decimals FORCE_CONSTANTS_DECIMALS] [--fc-format FC_FORMAT] [--fc-spg-symmetry] [--fc-symmetry] [--fits-debye-model] [--full-fc] [--fz CREATE_FORCE_SETS_ZERO [CREATE_FORCE_SETS_ZERO ...]] [--fmax FMAX] [--fmin FMIN] [--fpitch FPITCH] [--gc] [--gv] [--gv-delta-q GV_DELTA_Q] [--hdf5] [--hdf5-compression HDF5_COMPRESSION] [--irreps IRREPS_QPOINT [IRREPS_QPOINT ...]] [--include-fc] [--include-fs] [--include-disp] [--include-all] [--legend] [--legacy-plot] [--lcg] [--loglevel LOGLEVEL] [--mass MASSES [MASSES ...]] [--magmom MAGMOMS [MAGMOMS ...]] [--mesh-format MESH_FORMAT] [--modulation MODULATION [MODULATION ...]] [--mp MESH_NUMBERS [MESH_NUMBERS ...]] [--mlp-params MLP_PARAMS] [--moment] [--moment-order MOMENT_ORDER] [--nac] [--nac-method NAC_METHOD] [--nodiag] [--nomeshsym] [--nosym] [--nowritemesh] [-p] [--pa PRIMITIVE_AXES [PRIMITIVE_AXES ...]] [--pd PROJECTION_DIRECTION [PROJECTION_DIRECTION ...]] [--pdos PDOS [PDOS ...]] [--pm] [--pr] [--pt] [--pypolymlp] [--qpoints QPOINTS [QPOINTS ...]] [--qpoints-format QPOINTS_FORMAT] [--q-direction NAC_Q_DIRECTION [NAC_Q_DIRECTION ...]] [-q] [--random-seed RANDOM_SEED] [--rd RANDOM_DISPLACEMENTS] [--rd-temperature TEMPERATURE] [--temperature TEMPERATURE] [--readfc] [--readfc-format READFC_FORMAT] [--read-qpoints] [-s] [--sp] [--show-irreps] [--sigma SIGMA] [--sscha SSCHA_ITERATIONS] [--symfc] [--symmetry] [-t] [--td] [--tdm] [--tdm-cif TEMPERATURE] [--tmax TMAX] [--tmin TMIN] [--tolerance SYMMETRY_TOLERANCE] [--trigonal] [--tstep TSTEP] [-v] [--wien2k-p1] [--writefc] [--writefc-format WRITEFC_FORMAT] [--writedm] [--xyz-projection] [filename ...]
Phonopy command-line-tool
positional arguments:
- filename
-
Phonopy configure file. However if the file is recognized as phonopy.yaml like file, this file is read as phonopy.yaml like file.
options:
-
-h, --help -
show this help message and exit
-
--abacus -
Invoke ABACUS mode
-
--abinit -
Invoke Abinit mode
-
--aims -
Invoke FHI-aims mode
-
--castep -
Invoke CASTEP mode
-
--cp2k -
Invoke CP2K mode
-
--crystal -
Invoke CRYSTAL mode
-
--dftb+ -
Invoke dftb+ mode
-
--elk -
Invoke elk mode
-
--fleur -
Invoke Fleur mode
-
--lammps -
Invoke Lammps mode
-
--qe -
Invoke Quantum espresso (QE) mode
-
--siesta -
Invoke Siesta mode
-
--turbomole -
Invoke TURBOMOLE mode
-
--vasp -
Invoke Vasp mode
-
--wien2k -
Invoke Wien2k mode
-
--pwmat -
Invoke PWmat mode
-
--alm -
Use ALM for generating force constants
-
--amplitude, --amin DISPLACEMENT_DISTANCE -
Distance of displacements and also minimum distance of displacements in random displacements
-
--amax DISPLACEMENT_DISTANCE_MAX -
Minimum distance of displacements in random displacements
|
Same as ANIME tag |
|---|---|
|
Same behavior as BAND tag |
-
--band-connection -
Treat band crossings
-
--band-const-interval -
Band paths are sampled with similar interval.
--band-labelsBAND_LABELS [BAND_LABELS ...]-
Show labels at band segments
-
--band-format BAND_FORMAT -
Band structure output file-format
-
--band-points BAND_POINTS -
Number of points calculated on a band segment in the band structure mode
--bi,--band-indicesBAND_INDICES [BAND_INDICES ...]-
Band indices to be included to calcualte thermal properties
-
-c, --cell FILE -
Read unit cell
-
--classical -
Compute thermodynamic properties using classical statistics.
-
--cutoff-freq, --cutoff-frequency CUTOFF_FREQUENCY -
Thermal properties are not calculated below this cutoff frequency.
-
--cutoff-radius CUTOFF_RADIUS -
Out of cutoff radius, force constants are set zero.
-
-d, --displacement -
Create supercells with displacements
--dimSUPERCELL_DIMENSION [SUPERCELL_DIMENSION ...]-
Same behavior as DIM tag
-
--dm-decimals DYNAMICAL_MATRIX_DECIMALS -
Decimals of values of decimals
-
--dos -
Calculate (P)DOS
-
--eigvecs, --eigenvectors -
Output eigenvectors
-f,--force-setsCREATE_FORCE_SETS [CREATE_FORCE_SETS ...]-
Create FORCE_SETS
-
--factor FREQUENCY_CONVERSION_FACTOR -
Frequency unit conversion factor
-
--fc, --force-constants FILE -
Create FORCE_CONSTANTS from vaspurn.xml. vasprun.xml has to be passed as argument.
-
--fc-calc, --fc-calculator FC_CALCULATOR -
Force constants calculator
-
--fc-calc-opt, --fc-calculator-options FC_CALCULATOR_OPTIONS -
Options for force constants calculator as comma separated string with the style of key = values
-
--fc-decimals FORCE_CONSTANTS_DECIMALS -
Decimals of values of force constants
-
--fc-format FC_FORMAT -
Force constants input/output file-format
-
--fc-spg-symmetry -
Enforce space group symmetry to force constants
-
--fc-symmetry, --sym-fc -
Symmetrize force constants
-
--fits-debye-model -
Fits total DOS to a Debye model
-
--full-fc -
Calculate full supercell force constants matrix
--fz,--force-sets-zeroCREATE_FORCE_SETS_ZERO [CREATE_FORCE_SETS_ZERO ...]-
Create FORCE_SETS. disp.yaml in the current directory and vapsrun.xml's for VASP or case.scf(m) for Wien2k as arguments are required. The first argument is that of the perfect supercell to subtract residual forces
-
--fmax FMAX -
Maximum frequency used for DOS or moment calculation
-
--fmin FMIN -
Minimum frequency used for DOS or moment calculation
-
--fpitch FPITCH -
Frequency pitch used for DOS or moment calculation
-
--gc, --gamma-center -
Set mesh as Gamma center
-
--gv, --group-velocity -
Calculate group velocities at q-points
-
--gv-delta-q GV_DELTA_Q -
Delta-q distance used for group velocity calculation
-
--hdf5 -
Use hdf5 for force constants
-
--hdf5-compression HDF5_COMPRESSION -
hdf5 compression filter (default: gzip)
--irreps,--irreps-qpointIRREPS_QPOINT [IRREPS_QPOINT ...]-
A q-point where characters of irreps are calculated
-
--include-fc -
Include force constants in phonopy.yaml
-
--include-fs -
Include force sets in phonopy.yaml
-
--include-disp -
Include displacements in phonopy.yaml
-
--include-all -
Include all output file data in phonopy.yaml
-
--legend -
Legend of plots is shown in thermal displacements
-
--legacy-plot -
Legacy style band structure pl
-
--lcg, --little-cogroup -
Show irreps of little co-group (or point-group of wave vector q) instead of little group
-
--loglevel LOGLEVEL -
Log level
|
Same as MASS tag |
|---|---|
|
Same as MAGMOM tag |
-
--mesh-format MESH_FORMAT -
Mesh output file-format
|
Same as MODULATION tag |
|---|---|
|
Same behavior as MP tag |
-
--mlp-params MLP_PARAMS -
Parameters for machine learning potentials as comma separated string with the style of key = values
-
--moment -
Calculate moment of phonon states distribution
-
--moment-order MOMENT_ORDER -
Order of moment of phonon states distribution
-
--nac -
Non-analytical term correction
-
--nac-method NAC_METHOD -
Non-analytical term correction method: Gonze (default) or Wang
-
--nodiag -
Set displacements parallel to axes
-
--nomeshsym -
Symmetry is not imposed for mesh sampling.
-
--nosym -
Symmetry is not imposed.
-
--nowritemesh -
Do not write mesh.yaml or mesh.hdf5
-
-p, --plot -
Plot data
|
Same as PRIMITIVE_AXES tag |
|---|---|
|
Same as PROJECTION_DIRECTION tag |
|
Same as PDOS tag |
-
--pm -
Set plus minus displacements
-
--pr, --pretend-real -
Use imaginary frequency as real for thermal property calculation. For a testing purpose only, when a small amount of imaginary branches obtained.
-
--pt, --projected-thermal-property -
Output projected thermal properties
-
--pypolymlp -
Use pypolymlp for generating force constants
--qpointsQPOINTS [QPOINTS ...]-
Calculate at specified q-points
-
--qpoints-format QPOINTS_FORMAT -
Q-points output file-format
--q-directionNAC_Q_DIRECTION [NAC_Q_DIRECTION ...]-
Direction of q-vector perturbation used for NAC at q->0, and group velocity for degenerate phonon mode in q-points mode
-
-q, --quiet -
Print out smallest information
-
--random-seed RANDOM_SEED -
Random seed by a 32 bit unsigned integer
-
--rd, --random-displacements RANDOM_DISPLACEMENTS -
Number of supercells with random displacements or "auto".
-
--rd-temperature TEMPERATURE -
A temperature used to generate random displacements.
-
--temperature TEMPERATURE -
(Deprecated) A temperature used to generate random displacements.
-
--readfc -
Read FORCE_CONSTANTS
-
--readfc-format READFC_FORMAT -
Force constants input file-format
-
--read-qpoints -
Read QPOITNS
-
-s, --save -
Save plot data in pdf
-
--sp, --save-params -
Save parameters that can run phonopy in phonopy_params.yaml.
-
--show-irreps -
Show IR-Reps along with characters
-
--sigma SIGMA -
Smearing width for DOS
-
--sscha SSCHA_ITERATIONS -
Number of iterations in SSCHA calculation
-
--symfc -
Use symfc for generating force constants
-
--symmetry -
Check crystal symmetry
-
-t, --thermal-property -
Output thermal properties
-
--td, --thermal-displacements -
Output thermal displacements
-
--tdm, --thermal-displacement-matrix -
Output thermal displacement matrices
-
--tdm-cif, --thermal-displacement-matrix-cif TEMPERATURE -
Write cif with aniso_U for which temperature is specified
-
--tmax TMAX -
Maximum calculated temperature
-
--tmin TMIN -
Minimum calculated temperature
-
--tolerance SYMMETRY_TOLERANCE -
Symmetry tolerance to search
-
--trigonal -
Set displacements of all trigonal axes
-
--tstep TSTEP -
Calculated temperature step
-
-v, --verbose -
Detailed information is shown.
-
--wien2k-p1 -
Assume Wien2k structs with displacements are P1
-
--writefc -
Write FORCE_CONSTANTS
-
--writefc-format WRITEFC_FORMAT -
Force constants output file-format
-
--writedm -
Write dynamical matrices. This has to be used with QPOINTS setting (or
--qpoints)
-
--xyz-projection -
Project PDOS x, y, z directions in Cartesian coordinates
Releases
2 releases since Debian 12 (Bookworm); the text changed 1 time.
--amax since Debian 13 (Trixie);
--amin since Debian 13 (Trixie);
--classical since Debian 13 (Trixie);
--fc-calc since Debian 13 (Trixie);
--fc-calculator since Debian 13 (Trixie);
--lammps since Debian 13 (Trixie);
--mlp-params since Debian 13 (Trixie);
--pwmat since Debian 13 (Trixie);
--pypolymlp since Debian 13 (Trixie);
--rd-temperature since Debian 13 (Trixie);
--sscha since Debian 13 (Trixie);
--symfc since Debian 13 (Trixie).
--dense-svecs until Debian 12 (Bookworm);
--freq-scale until Debian 12 (Bookworm);
--hiphive until Debian 12 (Bookworm);
--include-born until Debian 12 (Bookworm);
--include-nac-params until Debian 12 (Bookworm).