# pymatgen.io.abinit.inputs module¶

This module defines a simplified interface for generating ABINIT input files. Note that not all the features of Abinit are supported by BasicAbinitInput. For a more comprehensive implementation, use the AbinitInput object provided by AbiPy.

class AbstractInput[source]

Bases: collections.abc.MutableMapping

Abstract class defining the methods that must be implemented by Input objects.

deepcopy()[source]

Deep copy of the input.

pop_vars(keys)[source]

Remove the variables listed in keys. Return dictionary with the variables that have been removed. Unlike remove_vars, no exception is raised if the variables are not in the input.

Parameters

keys – string or list of strings with variable names.

Example

inp.pop_vars([“ionmov”, “optcell”, “ntime”, “dilatmx”])

remove_vars(keys, strict=True)[source]

Remove the variables listed in keys. Return dictionary with the variables that have been removed.

Parameters
• keys – string or list of strings with variable names.

• strict – If True, KeyError is raised if at least one variable is not present.

set_vars(*args, **kwargs)[source]

Set the value of the variables. Return dict with the variables added to the input.

Example

input.set_vars(ecut=10, ionmov=3)

set_vars_ifnotin(*args, **kwargs)[source]

Set the value of the variables but only if the variable is not already present. Return dict with the variables added to the input.

Example

input.set_vars(ecut=10, ionmov=3)

abstract to_string()[source]

Returns a string with the input.

abstract property vars[source]

Dictionary with the input variables. Used to implement dict-like interface.

write(filepath='run.abi')[source]

Write the input file to file to filepath.

class BasicAbinitInput(structure, pseudos, pseudo_dir=None, comment=None, abi_args=None, abi_kwargs=None)[source]

Bases: pymatgen.io.abinit.inputs.AbstractInput, monty.json.MSONable

This object stores the ABINIT variables for a single dataset.

Parameters
• structure – Parameters defining the crystalline structure. Accepts |Structure| object

• with structure (file) –

• pseudos – Pseudopotentials to be used for the calculation. Accepts: string or list of strings with the name of the pseudopotential files, list of |Pseudo| objects or |PseudoTable| object.

• pseudo_dir – Name of the directory where the pseudopotential files are located.

• ndtset – Number of datasets.

• comment – Optional string with a comment that will be placed at the beginning of the file.

• abi_args – list of tuples (key, value) with the initial set of variables. Default: Empty

• abi_kwargs – Dictionary with the initial set of variables. Default: Empty

Error[source]

alias of BasicAbinitInputError

add_abiobjects(*abi_objects)[source]

This function receive a list of AbiVarable objects and add the corresponding variables to the input.

as_dict(**kwargs)[source]

JSON interface used in pymatgen for easier serialization.

property comment[source]

Optional string with comment. None if comment is not set.

classmethod from_dict(d)[source]

JSON interface used in pymatgen for easier serialization.

property isnc[source]

True if norm-conserving calculation.

property ispaw[source]

True if PAW calculation.

new_with_vars(*args, **kwargs)[source]

Return a new input with the given variables.

Example

new = input.new_with_vars(ecut=20)

pop_irdvars()[source]

Remove all the ird* variables present in self. Return dictionary with the variables that have been removed.

pop_tolerances()[source]

Remove all the tolerance variables present in self. Return dictionary with the variables that have been removed.

property pseudos[source]

List of |Pseudo| objects.

set_comment(comment)[source]

Set a comment to be included at the top of the file.

set_gamma_sampling()[source]

Gamma-only sampling of the BZ.

set_kmesh(ngkpt, shiftk, kptopt=1)[source]

Set the variables for the sampling of the BZ.

Parameters
• ngkpt – Monkhorst-Pack divisions

• shiftk – List of shifts.

• kptopt – Option for the generation of the mesh.

set_kpath(ndivsm, kptbounds=None, iscf=- 2)[source]

Set the variables for the computation of the electronic band structure.

Parameters
• ndivsm – Number of divisions for the smallest segment.

• kptbounds – k-points defining the path in k-space. If None, we use the default high-symmetry k-path defined in the pymatgen database.

set_spin_mode(spin_mode)[source]

Set the variables used to the treat the spin degree of freedom. Return dictionary with the variables that have been removed.

Parameters
• spin_modeSpinMode object or string. Possible values for string are:

• polarized (-) –

• unpolarized (-) –

• afm (-) –

• spinor (-) –

• spinor_nomag (-) –

set_structure(structure)[source]

Set structure.

property structure[source]

The |Structure| object associated to this input.

to_string(post=None, with_structure=True, with_pseudos=True, exclude=None)[source]

String representation.

Parameters
• post – String that will be appended to the name of the variables Note that post is usually autodetected when we have multiple datatasets It is mainly used when we have an input file with a single dataset so that we can prevent the code from adding “1” to the name of the variables (In this case, indeed, Abinit complains if ndtset=1 is not specified and we don’t want ndtset=1 simply because the code will start to add _DS1_ to all the input and output files.

• with_structure – False if section with structure variables should not be printed.

• with_pseudos – False if JSON section with pseudo data should not be added.

• exclude – List of variable names that should be ignored.

property vars[source]

Dictionary with variables.

exception BasicAbinitInputError[source]

Bases: Exception

Base error class for exceptions raised by BasicAbinitInput.

class BasicMultiDataset(structure, pseudos, pseudo_dir='', ndtset=1)[source]

Bases: object

This object is essentially a list of BasicAbinitInput objects. that provides an easy-to-use interface to apply global changes to the the inputs stored in the objects.

Let’s assume for example that multi contains two BasicAbinitInput objects and we want to set ecut to 1 in both dictionaries. The direct approach would be:

for inp in multi:

inp.set_vars(ecut=1)

or alternatively:

for i in range(multi.ndtset):

multi[i].set_vars(ecut=1)

BasicMultiDataset provides its own implementaion of __getattr__ so that one can simply use:

multi.set_vars(ecut=1)

multi.get(“ecut”) returns a list of values. It’s equivalent to:

[inp[“ecut”] for inp in multi]

Note that if “ecut” is not present in one of the input of multi, the corresponding entry is set to None. A default value can be specified with:

multi.get(“paral_kgb”, 0)

Warning

BasicMultiDataset does not support calculations done with different sets of pseudopotentials. The inputs can have different crystalline structures (as long as the atom types are equal) but each input in BasicMultiDataset must have the same set of pseudopotentials.

Parameters
• structure – file with the structure, |Structure| object or dictionary with ABINIT geo variable Accepts also list of objects that can be converted to Structure object. In this case, however, ndtset must be equal to the length of the list.

• pseudos – String or list of string with the name of the pseudopotential files.

• pseudo_dir – Name of the directory where the pseudopotential files are located.

• ndtset – Number of datasets.

Error[source]

alias of BasicAbinitInputError

addnew_from(dtindex)[source]

Add a new entry in the multidataset by copying the input with index dtindex.

append(abinit_input)[source]

Add a |BasicAbinitInput| to the list.

deepcopy()[source]

Deep copy of the BasicMultiDataset.

extend(abinit_inputs)[source]

Extends self with a list of |BasicAbinitInput| objects.

classmethod from_inputs(inputs)[source]

Build object from a list of BasicAbinitInput objects.

property has_same_structures[source]

True if all inputs in BasicMultiDataset are equal.

property isnc[source]

True if norm-conserving calculation.

property ispaw[source]

True if PAW calculation.

property ndtset[source]

Number of inputs in self.

property pseudos[source]

Pseudopotential objects.

classmethod replicate_input(input, ndtset)[source]

Construct a multidataset with ndtset from the BasicAbinitInput input.

split_datasets()[source]

Return list of |BasicAbinitInput| objects..

to_string(with_pseudos=True)[source]

String representation i.e. the input file read by Abinit.

Parameters

with_pseudos – False if JSON section with pseudo data should not be added.

write(filepath='run.abi')[source]

Write ndset input files to disk. The name of the file is constructed from the dataset index e.g. run0.abi

class ShiftMode(value)[source]

Bases: enum.Enum

Class defining the mode to be used for the shifts. G: Gamma centered M: Monkhorst-Pack ((0.5, 0.5, 0.5)) S: Symmetric. Respects the chksymbreak with multiple shifts O: OneSymmetric. Respects the chksymbreak with a single shift (as in ‘S’ if a single shift is given, gamma

centered otherwise.

GammaCentered = 'G'[source]
MonkhorstPack = 'M'[source]
OneSymmetric = 'O'[source]
Symmetric = 'S'[source]
classmethod from_object(obj)[source]

Returns an instance of ShiftMode based on the type of object passed. Converts strings to ShiftMode depending on the iniital letter of the string. G for GammaCenterd, M for MonkhorstPack, S for Symmetric, O for OneSymmetric. Case insensitive.

as_structure(obj)[source]

Convert obj into a Structure. Accepts:

• Structure object.

• Filename

• Dictionaries (MSONable format or dictionaries with abinit variables).

calc_shiftk(structure, symprec=0.01, angle_tolerance=5)[source]

Find the values of shiftk and nshiftk appropriated for the sampling of the Brillouin zone.

When the primitive vectors of the lattice do NOT form a FCC or a BCC lattice, the usual (shifted) Monkhorst-Pack grids are formed by using nshiftk=1 and shiftk 0.5 0.5 0.5 . This is often the preferred k point sampling. For a non-shifted Monkhorst-Pack grid, use nshiftk=1 and shiftk 0.0 0.0 0.0, but there is little reason to do that.

When the primitive vectors of the lattice form a FCC lattice, with rprim:

0.0 0.5 0.5
0.5 0.0 0.5
0.5 0.5 0.0


the (very efficient) usual Monkhorst-Pack sampling will be generated by using nshiftk= 4 and shiftk:

0.5 0.5 0.5
0.5 0.0 0.0
0.0 0.5 0.0
0.0 0.0 0.5


When the primitive vectors of the lattice form a BCC lattice, with rprim:

-0.5  0.5  0.5
0.5 -0.5  0.5
0.5  0.5 -0.5


the usual Monkhorst-Pack sampling will be generated by using nshiftk= 2 and shiftk:

 0.25  0.25  0.25
-0.25 -0.25 -0.25


However, the simple sampling nshiftk=1 and shiftk 0.5 0.5 0.5 is excellent.

For hexagonal lattices with hexagonal axes, e.g. rprim:

 1.0  0.0       0.0
-0.5  sqrt(3)/2 0.0
0.0  0.0       1.0


one can use nshiftk= 1 and shiftk 0.0 0.0 0.5 In rhombohedral axes, e.g. using angdeg 3*60., this corresponds to shiftk 0.5 0.5 0.5, to keep the shift along the symmetry axis.

Returns

Suggested value of shiftk.

ebands_input(structure, pseudos, kppa=None, nscf_nband=None, ndivsm=15, ecut=None, pawecutdg=None, scf_nband=None, accuracy='normal', spin_mode='polarized', smearing='fermi_dirac:0.1 eV', charge=0.0, scf_algorithm=None, dos_kppa=None)[source]

Returns a |BasicMultiDataset| object for band structure calculations.

Parameters
• structure|Structure| object.

• pseudos – List of filenames or list of |Pseudo| objects or |PseudoTable| object.

• kppa – Defines the sampling used for the SCF run. Defaults to 1000 if not given.

• nscf_nband – Number of bands included in the NSCF run. Set to scf_nband + 10 if None.

• ndivsm – Number of divisions used to sample the smallest segment of the k-path. if 0, only the GS input is returned in multi[0].

• ecut – cutoff energy in Ha (if None, ecut is initialized from the pseudos according to accuracy)

• pawecutdg – cutoff energy in Ha for PAW double-grid (if None, pawecutdg is initialized from the pseudos according to accuracy)

• scf_nband – Number of bands for SCF run. If scf_nband is None, nband is automatically initialized from the list of pseudos, the structure and the smearing option.

• accuracy – Accuracy of the calculation.

• spin_mode – Spin polarization.

• smearing – Smearing technique.

• charge – Electronic charge added to the unit cell.

• scf_algorithm – Algorithm used for solving of the SCF cycle.

• dos_kppa – Scalar or List of integers with the number of k-points per atom to be used for the computation of the DOS (None if DOS is not wanted).

gs_input(structure, pseudos, kppa=None, ecut=None, pawecutdg=None, scf_nband=None, accuracy='normal', spin_mode='polarized', smearing='fermi_dirac:0.1 eV', charge=0.0, scf_algorithm=None)[source]

Returns a |BasicAbinitInput| for ground-state calculation.

Parameters
• structure|Structure| object.

• pseudos – List of filenames or list of |Pseudo| objects or |PseudoTable| object.

• kppa – Defines the sampling used for the SCF run. Defaults to 1000 if not given.

• ecut – cutoff energy in Ha (if None, ecut is initialized from the pseudos according to accuracy)

• pawecutdg – cutoff energy in Ha for PAW double-grid (if None, pawecutdg is initialized from the pseudos according to accuracy)

• scf_nband – Number of bands for SCF run. If scf_nband is None, nband is automatically initialized from the list of pseudos, the structure and the smearing option.

• accuracy – Accuracy of the calculation.

• spin_mode – Spin polarization.

• smearing – Smearing technique.

• charge – Electronic charge added to the unit cell.

• scf_algorithm – Algorithm used for solving of the SCF cycle.

ion_ioncell_relax_input(structure, pseudos, kppa=None, nband=None, ecut=None, pawecutdg=None, accuracy='normal', spin_mode='polarized', smearing='fermi_dirac:0.1 eV', charge=0.0, scf_algorithm=None, shift_mode='Monkhorst-pack')[source]

Returns a |BasicMultiDataset| for a structural relaxation. The first dataset optmizes the atomic positions at fixed unit cell. The second datasets optimizes both ions and unit cell parameters.

Parameters
• structure|Structure| object.

• pseudos – List of filenames or list of |Pseudo| objects or |PseudoTable| object.

• kppa – Defines the sampling used for the Brillouin zone.

• nband – Number of bands included in the SCF run.

• accuracy – Accuracy of the calculation.

• spin_mode – Spin polarization.

• smearing – Smearing technique.

• charge – Electronic charge added to the unit cell.

• scf_algorithm – Algorithm used for the solution of the SCF cycle.

num_valence_electrons(structure, pseudos)[source]

Returns the number of valence electrons.

Parameters

pseudos – List of |Pseudo| objects or list of filenames.