Skip to content

Structures

Structure Converters

This module hosts converter classes for common structure file and object formats. All converters are linked directly for conversion into the simmate.toolkit.base_data_types.structure.Structure class. Note, in the majority of cases, you can have Simmate attempt to figure out the file/object format you have. Using these converters directly is really only needed for advanced use or speed optimization:

Example dynamic use:

from simmate.toolkit import Structure

structure1 = Structure.from_dynamic("example.cif")

structure2 = Structure.from_dynamic("POSCAR")

structure3 = Structure.from_dynamic(
    {"database_table": "MITStaticEnergy", "database_id": 1}
)

If you'd like to convert between formats (such as CIF --> POSCAR), you should treat this a two-step process:

from simmate.toolkit import Structure

# STEP 1: convert to simmate
structure = Structure.from_dynamic("example.cif")

# STEP 2: convert to desired format
structure.to(fmt="poscar", filename="POSCAR")

Other Converters

This module does not host all file-converters that Simmate has. Others can be found in the apps module, where they are associated with a specific program. For example, the converter for POSCAR files is directly from the VASP software -- therefore, you can find the POSCAR converter in the vasp.inputs.poscar module. Here is a list of other structure converters for reference:

  • POSCAR (simmate.apps.vasp.inputs.poscar)