SummaryDoc

class emmet.core.summary.SummaryDoc(**data)

Bases: PropertyDoc

Summary information about materials and their properties, useful for materials screening studies and searching.

Parameters:

  • builder_meta (EmmetMeta | None)

  • nsites (int | None)

  • elements (list[Annotated[ElementTypeVar, BeforeValidator(func=~emmet.core.types.pymatgen_types.element_adapter.<lambda>, json_schema_input_type=PydanticUndefined), WrapSerializer(func=~emmet.core.types.pymatgen_types.element_adapter.<lambda>, return_type=str, when_used=always)]] | None)

  • nelements (int | None)

  • composition (Annotated[CompositionTypeVar, BeforeValidator(func=~emmet.core.types.pymatgen_types.composition_adapter.<lambda>, json_schema_input_type=PydanticUndefined), WrapSerializer(func=~emmet.core.types.pymatgen_types.composition_adapter.<lambda>, return_type=dict[str, float], when_used=always)] | None)

  • composition_reduced (Annotated[CompositionTypeVar, BeforeValidator(func=~emmet.core.types.pymatgen_types.composition_adapter.<lambda>, json_schema_input_type=PydanticUndefined), WrapSerializer(func=~emmet.core.types.pymatgen_types.composition_adapter.<lambda>, return_type=dict[str, float], when_used=always)] | None)

  • formula_pretty (str | None)

  • formula_anonymous (str | None)

  • chemsys (str | None)

  • volume (float | None)

  • density (float | None)

  • density_atomic (float | None)

  • symmetry (SymmetryData | None)

  • material_id (Annotated[MPID | AlphaID, BeforeValidator(func=~emmet.core.types.typing._fault_tolerant_id_serde, json_schema_input_type=PydanticUndefined), PlainSerializer(func=~emmet.core.types.typing.<lambda>, return_type=PydanticUndefined, when_used=always)] | None)

  • deprecated (bool)

  • deprecation_reasons (list[DeprecationMessage | str] | None)

  • last_updated (Annotated[datetime, BeforeValidator(func=~emmet.core.utils.convert_datetime, json_schema_input_type=PydanticUndefined)])

  • origins (list[PropertyOrigin] | None)

  • warnings (list[str])

  • structure (Annotated[StructureTypeVar, BeforeValidator(func=~emmet.core.types.pymatgen_types.structure_adapter.pop_empty_structure_keys, json_schema_input_type=PydanticUndefined), WrapSerializer(func=~emmet.core.types.pymatgen_types.structure_adapter.<lambda>, return_type=~emmet.core.types.pymatgen_types.structure_adapter.TypedStructureDict, when_used=always)])

  • property_name (str)

  • task_ids (list[Annotated[MPID | AlphaID, BeforeValidator(func=~emmet.core.types.typing._fault_tolerant_id_serde, json_schema_input_type=PydanticUndefined), PlainSerializer(func=~emmet.core.types.typing.<lambda>, return_type=PydanticUndefined, when_used=always)]])

  • uncorrected_energy_per_atom (float | None)

  • energy_per_atom (float | None)

  • formation_energy_per_atom (float | None)

  • energy_above_hull (float | None)

  • is_stable (bool)

  • equilibrium_reaction_energy_per_atom (float | None)

  • decomposes_to (list[DecompositionProduct] | None)

  • xas (list[XASSearchData] | None)

  • grain_boundaries (list[GBSearchData] | None)

  • band_gap (float | None)

  • cbm (float | None)

  • vbm (float | None)

  • efermi (float | None)

  • is_gap_direct (bool | None)

  • is_metal (bool | None)

  • es_source_calc_id (Annotated[MPID | AlphaID, BeforeValidator(func=~emmet.core.types.typing._fault_tolerant_id_serde, json_schema_input_type=PydanticUndefined), PlainSerializer(func=~emmet.core.types.typing.<lambda>, return_type=PydanticUndefined, when_used=always)] | None)

  • bandstructure (BandstructureData | None)

  • dos (DosData | None)

  • dos_energy_up (float | None)

  • dos_energy_down (float | None)

  • is_magnetic (bool | None)

  • ordering (str | None)

  • total_magnetization (float | None)

  • total_magnetization_normalized_vol (float | None)

  • total_magnetization_normalized_formula_units (float | None)

  • num_magnetic_sites (int | None)

  • num_unique_magnetic_sites (int | None)

  • types_of_magnetic_species (list[Annotated[ElementTypeVar, BeforeValidator(func=~emmet.core.types.pymatgen_types.element_adapter.<lambda>, json_schema_input_type=PydanticUndefined), WrapSerializer(func=~emmet.core.types.pymatgen_types.element_adapter.<lambda>, return_type=str, when_used=always)]] | None)

  • bulk_modulus (dict[str, float] | None)

  • shear_modulus (dict[str, float] | None)

  • universal_anisotropy (float | None)

  • homogeneous_poisson (float | None)

  • e_total (float | None)

  • e_ionic (float | None)

  • e_electronic (float | None)

  • n (float | None)

  • e_ij_max (float | None)

  • weighted_surface_energy_EV_PER_ANG2 (float | None)

  • weighted_surface_energy (float | None)

  • weighted_work_function (float | None)

  • surface_anisotropy (float | None)

  • shape_factor (float | None)

  • has_reconstructed (bool | None)

  • possible_species (list[str] | None)

  • has_props (dict[str, bool] | None)

  • theoretical (bool)

  • database_IDs (dict[str, list[str]])

classmethod from_docs(material_id=None, **docs)

Converts a bunch of summary docs into a SummaryDoc

Return type:

Self

Parameters:

  • material_id (IdentifierType | None)

  • docs (dict[str, dict])

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].