DEMITONMethodGitHub

Research / Sources / Schemas and history

Schemas and history

Every record here is checked against a JSON Schema, and every schema carries a semantic version: MAJOR when a change can make an existing record invalid, MINOR when it only adds, PATCH for wording. CI refuses a change whose version bump is too small (METHOD.md Section 10). Below is each schema as it stands and every version it has been.

What the codes mean

Every source says where its evidence is from and which part of construction it covers, in two fields on the source schema, jurisdictions and industries. A finding inherits both from its source. The schema types them as lists of codes; the codes each list accepts come from two published standards.

Jurisdictions: ISO 3166

Countries use ISO 3166-1 two-letter codes (AU, NZ). States and regions use ISO 3166-2 codes (AU-QLD): all eight Australian states and territories and all seventeen New Zealand regions are accepted. GLOBAL marks a source that claims no geographic limit, and unknown one where the place could not be determined. When you filter by a state you also get its country's figures and the global ones. The accepted list is vocab/jurisdictions.json. Demiton's obligation library files its obligations under the same codes; the obligation library by place shows how many it holds for each state and region, including the ones where it holds none.

CodePlaceSources
NZNew Zealand97 of 217
AUAustralia72 of 217
AU-QLDQueensland16 of 217
AU-NSWNew South Wales7 of 217
GLOBALNo jurisdictional limit is claimed7 of 217
AU-VICVictoria5 of 217
USUnited States3 of 217
unknownCould not be determined3 of 217
GBUnited Kingdom2 of 217
CXChristmas Island1 of 217
CACanada1 of 217
NZ-WGNWellington1 of 217
AU-TASTasmania1 of 217
NZ-BOPBay of Plenty1 of 217
BEBelgium1 of 217
SGSingapore1 of 217
AU-WAWestern Australia1 of 217

Industries: ISIC Rev.4, section F

Industries use the United Nations' International Standard Industrial Classification (ISIC Rev.4), section F (Construction), and its three divisions. ALL marks a source that is not industry-specific, and unknown one where the industry could not be determined. A source can also record the industry in its own words, in the optional industry_as_published, so a mapping to ISIC can be checked against what the source actually said; 11 of 217 do so far. The accepted list is vocab/industries.json.

CodeIndustrySources
FConstruction, not further specified (ISIC Rev.4 section F)106 of 217
F41Construction of buildings23 of 217
F42Civil engineering62 of 217
F43Specialised construction activities2 of 217
ALLNot industry-specific31 of 217
unknownCould not be determined1 of 217

Filtering by a division, such as civil engineering, also returns figures for construction in general (F) and figures that are not industry-specific.

Source 1.0.0

sources/<slug>.md: where a figure came from, and how it was read · source.schema.json

16 fields at 1.0.0
FieldTypeRequiredAllowed values
titlestringyes
organisationstringyes
organisation_idstring
yearintegeryes
published_instring
urlstring
free_copy_urlstring
source_typeone ofyespeer-reviewed, working-paper, regulator, court, industry-body, research-institute, vendor, press
methodone ofyessurvey, records, official-statistics, model, case-study, legal-text, estimate, unknown
accessone ofyesprimary, secondary
read_viastring
read_onstringyes
locationstringyes
jurisdictionslist of stringyes
industrieslist of stringyes
industry_as_publishedstring

Versions

Finding 3.0.0

diseases/<disease>/<metric>.yaml and context/<metric>.yaml: one figure · finding.schema.json

41 fields at 3.0.0
FieldTypeRequiredAllowed values
labelstringyes
exposure_valuenumber or nullyes
exposure_unitone ofyesratio_of_contract, ratio_of_other, per_wet_day, per_incident, none
denominatorone ofbudget_at_decision, budget_at_announcement, construction_cost, amount_claimed, arbitration_cost, total_injury_cost, overrun_additional_cost, annual_capital_budget
currencystring
price_yearinteger
exposure_basisstringyes
exposure_kindone ofyescontractor_loss, derived_contractor_loss, money_at_stake, owner_side, societal, context
confidenceone ofyeshigh, moderate, low
exposure_rangeobject
exposure_range.lownumberyes
exposure_range.highnumberyes
exposure_range.kindone ofyesconfidence_interval, reported_min_max, scenario, across_studies
derivationone ofyesas_published, calculated
calculationstring
sourceslist of yes
consideredlist of records
considered[].sourceyes
considered[].reasonstringyes
sample_notestringyes
caveatstringyes
statusone ofyescurrent, disputed, withdrawn
dispute_urlstring
withdrawn_reasonstring
historylist of records
history[].exposure_valuenumber or null
history[].exposure_unitstring
history[].denominatorstring
history[].exposure_rangeobject
history[].exposure_kindstring
history[].confidencestring
history[].is_headlineboolean
history[].changed_onstringyes
history[].change_urlstring
history[].reasonstringyes
subtypestring
statisticone ofmean, median, pooled_ratio, total, single_case, modelled, none, unknown
sample_sizeobject
sample_size.nintegeryes
sample_size.unitone ofyesprojects, respondents, organisations, decisions, awards, contracts, cases, years, other
sample_size.notestring

Versions

Protection 1.0.0

protections/<disease>/<mechanism>.yaml: evidence that a protection matters · protection.schema.json

9 fields at 1.0.0
FieldTypeRequiredAllowed values
labelstringyes
claimstringyes
sourcesfinding: sourcesyes
consideredfinding: considered
confidenceone ofyeshigh, moderate, low
caveatstringyes
statusone ofyescurrent, disputed, withdrawn
dispute_urlstring
withdrawn_reasonstring

Versions