build_summary_docs

emmet.builders.materials.summary.build_summary_docs(input_documents, **kwargs)

Generate summary documents from input property documents.

Transforms a list of SummaryBuilderInputs into corresponding SummaryDoc instances by merging property summary documents and property shim documents for each material. Each SummaryDoc aggregates fields from all provided property summaries and tracks which properties are available via the has_props mapping.

Caller is responsible for creating SummaryBuilderInputs instances within their data pipeline context.

Return type:

Iterator[SummaryDoc]

Parameters:

input_documents (list[SummaryBuilderInputs])

Args:

input_documents: List of SummaryBuilderInputs documents to process.

Returns:

Iterator[SummaryDoc]