TABLE OF CONTENTS
INTRODUCTION
Line-of-input: title_ph
&INPUTPH
amass | outdir | prefix | niter_ph | tr2_ph | alpha_mix(niter) | nmix_ph | iverbosity | reduce_io | max_seconds | fildyn | fildrho | fildvscf | epsil | lrpa | lnoloc | trans | lraman | eth_rps | eth_ns | dek | recover | elph | zue | elop | fpol | lnscf | ldisp | nq1 | nq2 | nq3 | iq1 | iq2 | iq3 | nrapp | maxirr | nat_todo
Line-of-input: xq(1) xq(2) xq(3)
Line-of-input: irrep(1) irrep(2) ... irrep(nrapp)
Line-of-input: atom(1) atom(2) ... atom(nat_todo)
INTRODUCTION
Input data format: { } = optional, [ ] = it depends, # = comment
Structure of the input data:
===============================================================================
title_line
&INPUTPH
...
/
xq(1) xq(2) xq(3)
[ irrep(1) irrep(2) ... irrep(nrapp) ] # if "nrapp" was specified
[ atom(1) atom(2) ... atom(nat_todo) ] # if "nat_todo" was specified
Line of input
|
Syntax:
title_ph
|
Description of items:
title_ph |
CHARACTER |
Title of the job, i.e., a line that is reprinted on output.
|
|
|
Namelist: INPUTPH |
amass(i), i=1,ntyp |
REAL |
Default: |
0.0
|
Atomic mass [amu] of each atomic type.
If not specified, masses are read from data file
|
outdir |
CHARACTER |
Default: |
'./'
|
Scratch directory.
|
prefix |
CHARACTER |
Default: |
'pwscf'
|
Prepended to input/output filenames; must be the same
used in the calculation of unperturbed system.
|
niter_ph |
INTEGER |
Default: |
50
|
Maximum number of iterations in a scf step.
|
tr2_ph |
REAL |
Default: |
1e-10
|
Threshold for selfconsistency.
|
alpha_mix(niter) |
REAL |
Default: |
alpha_mix(1)=0.7
|
Mixing factor (for each iteration) for updating the scf potential:
vnew(in) = alpha_mix*vold(out) + (1-alpha_mix)*vold(in)
|
nmix_ph |
INTEGER |
Default: |
4
|
Number of iterations used in potential mixing.
|
iverbosity |
INTEGER |
Default: |
0
|
0 = short output
1 = verbose output
|
reduce_io |
LOGICAL |
Default: |
.false.
|
Reduce I/O to the strict minimum.
|
max_seconds |
REAL |
Default: |
1.d7
|
Maximum allowed run time before the job stops smoothly.
|
fildyn |
CHARACTER |
Default: |
'matdyn'
|
File where the dynamical matrix is written.
|
fildrho |
CHARACTER |
Default: |
' '
|
File where the charge density responses are written.
|
fildvscf |
CHARACTER |
Default: |
' '
|
File where the the potential variation is written
(for later use in electron-phonon calculation).
|
epsil |
LOGICAL |
Default: |
.false.
|
If .true. in a q=0 calculation for a non metal the
macroscopic dielectric constant of the system is
computed. Do not set epsil to .true. if you have a
metallic system or q/=0: the code will complain and stop
|
lrpa |
LOGICAL |
Default: |
.false.
|
If .true. the dielectric constant is calculated at the
RPA level with DV_xc=0.
|
lnoloc |
LOGICAL |
Default: |
.false.
|
If .true. the dielectric constant is calculated without
local fields, i.e. by setting DV_H=0 and DV_xc=0.
|
trans |
LOGICAL |
Default: |
.true.
|
if .true. the phonons are computed
if trans .and. epsil effective charges are calculated
|
lraman |
LOGICAL |
Default: |
.false.
|
if .true. calculate nonresonant Raman coefficients
using second-order response as in:
M. Lazzeri and F. Mauri, Phys. Rev. Lett. 90, 036401 (2003)
|
Optional variables for Raman:
eth_rps |
REAL |
Default: |
1.0d-9
|
threshold for calculation of Pc R |psi>
|
eth_ns |
REAL |
Default: |
1.0e-12
|
threshold for non-scf wavefunction calculation
|
dek |
REAL |
Default: |
1.0e-3
|
delta_xk used for wavefunction derivation wrt k
|
|
recover |
LOGICAL |
Default: |
.false.
|
if .true. restart from an interrupted run
|
elph |
LOGICAL |
Default: |
.false.
|
if .true. electron-phonon lambda coeffs are computed
For metals only, requires gaussian smearing.
If elph .and. trans, the lambdas are calculated in the same
run, using the same k-point grid for phonons and lambdas
If elph.and..not.trans, the lambdas are calculated using
previously saved DeltaVscf in fildvscf, previously saved
dynamical matrix, and the present punch file. This allows
the use of a different (larger) k-point grid.
|
zue |
LOGICAL |
if .true. in a q=0 calculation for a non metal the
effective charges are computed from the phonon
density responses. Note that if trans.and.epsil
effective charges are calculated using a different
algorithm. The results should be the same within
numerical noise.
|
elop |
LOGICAL |
Default: |
.false.
|
if true calculate electro-optic tensor
|
fpol |
LOGICAL |
Default: |
.false.
|
if .true. calculate dynamic polarizabilities
( experimantal stage, see example33 for calculation
of methane )
|
lnscf |
LOGICAL |
Default: |
.false.
|
If .TRUE. the run makes first a nscf calculation.
|
ldisp |
LOGICAL |
Default: |
.false.
|
If .TRUE. the run calculates phonons for a grid of
q-points specified by nq1, nq2, nq3 - for direct
calculation of the entire phonon dispersion.
The pw.x data file should not be produced using
"calculation='phonon'" in this case.
|
nq1, nq2, nq3
|
INTEGER |
Default: |
0
|
Parameters of the Monkhorst-Pack grid (no offset) used
when ldisp=.true. Same meaning as for nk1, nk2, nk3
in the input of pw.x.
|
iq1, iq2, iq3
|
INTEGER |
These go together with nq1, nq2, nq3 and allow to choose
just one point out of the Monkhorst-Pack grid with ldisp=.true.
Note the the actual point chosen is something like
(iq1-1)/nq1, (iq2-1)/nq2, (iq3-1)/nq3 (so, check the
output for what you get). Also make sure that PW left *.wfc
files behind (no 'phonon' is needed though).
|
nrapp |
INTEGER |
Default: |
0, i.e. use all irreps
|
Choose the subset of irreducible representations (irreps)
for which the linear response calculation is performed:
"nrapp" irreps, specified in input (see below) are used.
IMPORTANT:
* nrapp must be <= 3*nat
* do not specify "nat_todo" together with "nrapp"
|
maxirr |
INTEGER |
Default: |
0, i.e. use all irreps
|
Perform calculations only up to the first "maxirr" irreps.
IMPORTANT:
* maxirr must be <= 3*nat
* do not specify "nat_todo" or "nrapp" together with "maxirr"
|
nat_todo |
INTEGER |
Default: |
0, i.e. displace all atoms
|
Choose the subset of atoms to be used in the linear response
calculation: "nat_todo" atoms, specified in input (see below)
are displaced.
IMPORTANT:
* nat_todo <= nat
* do not specify "nrapp" together with "nat_todo"
|
|
|
Line of input
|
Syntax:
xq(1) xq(2) xq(3)
|
Description of items:
xq(1) xq(2) xq(3)
|
REAL |
The phonon wavevector; must be equal to the one used
in the non-selfconsistent calculation (not read if
ldisp is true).
|
|
|
|
IF nrapp was specified :
Line of input
|
Syntax:
irrep(1) irrep(2) ... irrep(nrapp)
|
Description of items:
irrep(1) irrep(2) ... irrep(nrapp)
|
INTEGER |
The list of indices of irreps used in the calculation
if "nrapp" is specified.
|
|
|
|
ELSEIF nat_todo was specified :
Line of input
|
Syntax:
atom(1) atom(2) ... atom(nat_todo)
|
Description of items:
atom(1) atom(2) ... atom(nat_todo)
|
INTEGER |
Contains the list of indices of atoms used in the
calculation if "nat_todo" is specified.
|
|
|
|
|
|