Impacted substances

class ImpactedSubstance(reference_type, reference_value, max_percentage_amount_in_material, legislation_threshold)

Represents a substance impacted by a legislation.

This object includes two categories of attributes:

• The reference to the substance in Granta MI. These attributes are all populated if data for them exists in Granta MI.

• The amount of the substance in the parent item and the threshold above which it is impacted.

Examples

>>> result: MaterialImpactedSubstancesQueryResult
>>> substance = result.impacted_substances[4]
>>> print(f"{substance.cas_number}: {substance.max_percentage_amount_in_material}")
1333-86-4: 20.0 %

property record_history_identity: int | None

Record history identity.

property record_history_guid: str | None

Record history GUID.

property record_guid: str | None

Record GUID.

property database_key: str | None

The database key for the database that contains the record.

This property is only populated if the record is in a different database to the one specified in BomAnalyticsClient.set_database_details(). Supported by MI Restricted Substances and Sustainability Reports 2026 R1 or later.

Added in version 2.4.

property identity: str | None

Item unique identifier.

This property is only populated on BoM query results and is equal to the id attribute of the corresponding input BoM item. If no id has been defined on the BoM item, a unique auto-generated value is assigned during analysis.

property external_identity: str | None

Item external identity.

This property is only populated on BoM query results and is equal to the <ExternalIdentity> element of the corresponding input BoM item.

property name: str | None

Item name.

This property is only populated on BoM query results and is equal to the <Name> element of the corresponding input BoM item.

property cas_number: str | None

CAS number.

property ec_number: str | None

EC number.

property chemical_name: str | None

Chemical name.

property equivalent_references: list[SubstanceReference] | None

Other substance records which are defined as being equivalent to this record.

Only populated if this record is a substitute for a record in a different database during analysis via a cross-database link.

Added in version 2.4.

property max_percentage_amount_in_material: float | None

Maximum percentage of this substance that occurs in the parent material. In the case where a range is specified in the declaration, only the maximum is reported here. None means that the percentage amount has not been specified, not that the amount is 0 %.

property legislation_threshold: float | None

Substance concentration threshold over which the material is non-compliant with the legislation. None means that the threshold has not been specified, not that the threshold is 0 %.