Skip to content

Construction JSON contract

A construction set page lists every context of the set with its exports in release 2.4.0:

  • Detailed (5.0.0): the source assemblies, materials, component assignments, foundation ground methods, fixed reference infiltration, mass accounting, provenance and, from release 2.0.0, the PNNL prototype alternates.
  • Unified (4.0.0): precomputed archetype shares and simplified ordinary components. Every commercial set has one, the IECC commercial sets from release 1.6.0 (ADR 0045), and so do the ResStock dwellings' sets.
  • Source model constructions (2.0.0): the IDF-derived envelopes of the IECC residential and manufactured-housing prototypes, one document per climate and foundation or location. One document serves both representations; the site index names it as both detailed and unified.

Each document is complete and standalone: library and evidence references are resolved by the exporter. The page shows the detailed fields shared by every context once, then each context's own fields and components; assemblies and materials link to the template library page. On the largest sets the context fields load when asked for, from the same store document the page would otherwise inline; each context's download is the complete document either way.

Contracts: consumer contracts of release 1.0.0, release 1.1.0 and the release notes in docs/. The exporter reads releases 2.0.0, 2.1.0, 2.2.0, 2.3.0, 2.4.0:

python -m scripts.atlas_exports --release 2.4.0 --construction SET --context KEY --representation detailed

Downloads carry the same canonical SHA-256 as program exports (Program JSON contract).