Input File Description

Program: ph.x / PWscf / Quantum Espresso

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.
               
This file has been created by helpdoc utility.