pymatgen.structure_prediction.volume_predictor module

class DLSVolumePredictor(cutoff=4.0)[source]

Bases: object

Data-mined lattice scaling (DLS) scheme that relies on data-mined bond lengths to predict the crystal volume of a given structure.

Parameters:cutoff (float) – cutoff radius added to site radius for finding site pairs. Necessary to increase only if your initial structure guess is extremely bad (atoms way too far apart). In all other instances, increasing cutoff gives same answer but takes more time.
get_predicted_structure(structure, icsd_vol=False)[source]

Given a structure, returns back the structure scaled to predicted volume. :param structure: structure w/unknown volume :type structure: Structure

Returns:a Structure object with predicted volume
predict(structure, icsd_vol=False)[source]

Given a structure, returns the predicted volume.

Parameters:
  • structure (Structure) – a crystal structure with an unknown volume.
  • icsd_vol (bool) – True if the input structure’s volume comes from ICSD.
Returns:

a float value of the predicted volume.

class RLSVolumePredictor(check_isostructural=True, radii_type='ionic-atomic', use_bv=True)[source]

Bases: object

Reference lattice scaling (RLS) scheme that predicts the volume of a structure based on a known crystal structure.

Parameters:
  • check_isostructural – Whether to test that the two structures are isostructural. This algo works best for isostructural compounds. Defaults to True.
  • radii_type (str) – Types of radii to use. You can specify “ionic” (only uses ionic radii), “atomic” (only uses atomic radii) or “ionic-atomic” (uses either ionic or atomic radii, with a preference for ionic where possible).
  • use_bv (bool) – Whether to use BVAnalyzer to determine oxidation states if not present.
get_predicted_structure(structure, ref_structure)[source]

Given a structure, returns back the structure scaled to predicted volume. :param structure: structure w/unknown volume :type structure: Structure :param ref_structure: A reference structure with a similar

structure but different species.
Returns:a Structure object with predicted volume
predict(structure, ref_structure)[source]

Given a structure, returns the predicted volume. :param structure: structure w/unknown volume :type structure: Structure :param ref_structure: A reference structure with a similar

structure but different species.
Returns:a float value of the predicted volume
is_ox(structure)[source]