Materials
INFO
Material is a refactored object from v2.2, for what is now a Nested Material in v2.3 of the Standard. Materials were previously part of Substances and known as Special Conditions.
Structure
Materials exist as an array of Material objects listed with the key of Materials and are structured as follows:
[ // Start of "Materials" array
{
"Name": "<string>",
"Condition": "<object>",
"Min": "<float>",
"Max": "<float>",
"AlternateOf": "<object>",
"Recycle": "<string>",
"Nano": "<bool>",
"Role": "<string>",
"Notes": "<string>"
}
...
]Name
- type:
<string> - Nullable:
false
Condition
- type:
<object> - Nullable:
false - related: 1 of 6 Special Conditions
Condition always returns all six keys below. Exactly one of them holds an object — the Special Condition that applies to this Material — and the other five are null.
"Condition": {
"BiologicalMaterial": "<object>",
"GeologicalMaterial": "<object>",
"ElectronicComponent": "<object>",
"MixedRecycledContent": "<object>",
"MetalAlloy": "<object>",
"MinorFastener": "<object>"
}| Key | Nullable | Structure of the object |
|---|---|---|
| BiologicalMaterial | true | Biological |
| GeologicalMaterial | true | Geological |
| ElectronicComponent | true | Electronics |
| MixedRecycledContent | true | Mixed Content |
| MetalAlloy | true | Metal Alloys |
| MinorFastener | true | Fasteners |
TIP
To resolve which Special Condition applies, walk the six keys and take the first non-null one. Do not assume a particular key is populated — every Material uses the same six-key wrapper regardless of its condition.
Min
- type:
<float> - Nullable:
false
Max
- type:
<float> - Nullable:
true
AlternateOf
- type:
<object> - Nullable:
true - related: Material
- default:
null|string
CAUTION
AlternateOf for a Materials is now a reference to a primary Material within the same Nested Material.
Recycle
- type:
<string> - Nullable:
true - default:
null - Definition:
Recycled content type reported for the material. Null for the majority of materials.
Nano
- type:
<bool> - Nullable:
false
Role
- type:
<string> - Nullable:
false
Notes
- type:
<string> - Nullable:
true
INFO
Locations are reported on the Nested Material, not on the Material. A Material object has no Locations key.