Syntax:

ion-species [<path>/]<id>[<suffix>].<format>
      | [<path>/]$ID[<suffix>].<format>

Description:

Read pseudopotential from file [<path>/]<id>.<format>, which will be referred to internally by <id> in all other commands and in the output. Note that <id> is the start of the basename of the file, obtained by removing the path, extension and any suffix starting with non-aphanumeric characters eg. Br.fhi, ../Br.fhi and /home/foo/Br_theNotSoBadOne.uspp will all have <id> = Br.

If the filename contains the string $ID, then this command specifies an entire set of pseudopotentials. Every time command ion encounters an otherwise undefined species, it will search for a pseudopotential file with this pattern (replacing $ID with the as yet undefined <id> needed by the ion command). If there are multiple such patterns, then they will be searched in the order that they appear in the input file.

Currently supported <format>'s are:

.fhi ABINIT format FHI98 norm-conserving pseudopotentials (eg. generated by OPIUM).
.uspp Ultrasoft pseudopotentials generated by the USPP program (native binary format).
.upf Quantum Espresso Universal Pseudopotential Format (only the XML-like version 2).

If [<path>/]<id>.pulay exists, pulay data (derivative of total energy with respect to number of planewaves per unit volume) will be read from that file. This is useful for lattice minimization at low cutoffs; see script calcPulay for generating such files.

Properties:

Requires: (None)

Forbids: (None)

Allow multiple: yes

Default: (None)

Back to: Input file documentation or Index of commands