{
  "output_unit": "billion 2026 international dollars (PPP), annual output",
  "input_units": "Per-shortage unit column governs requirement, supply, shortfall and excess fields.",
  "time_horizon": {
    "baseline_year": 2026,
    "target_year": 2035,
    "years": 9
  },
  "joins": {
    "layer_id": "layers.layer_id",
    "shortage_id": "shortages.shortage_id",
    "variant": "Use shortage_id + variant together to join own_blocks to variants.",
    "scenario": "Scenario IDs are groupings and are not unique within an input."
  },
  "empty_values": "Blank CSV cells are null in JSON.",
  "datasets": {
    "layers": {
      "description": "The 19 accounting layers and their bridge from 2026 output to the 2035 target.",
      "rows": 19,
      "csv": "data/layers_v4.csv",
      "columns": {
        "layer_id": "Layer identifier. C01-C15 are named output categories and U1-U4 are retained accounting categories.",
        "layer": "Plain-English layer name.",
        "target": "Chosen 2035 sector target in billion 2026 international dollars, under the selected doubling scenario and spending mix. Not a forecast.",
        "target_label": "S/E/A evidence classification for target.",
        "today": "2026 annual output estimate in billion 2026 international dollars.",
        "today_label": "S/E/A evidence classification for today.",
        "on_course": "Conditional 2035 baseline projection in billion 2026 international dollars. Depends on trend, adoption and input assumptions.",
        "on_course_label": "S/E/A evidence classification for on_course.",
        "growth": "Conditional baseline projection minus today's estimate, in billion 2026 international dollars.",
        "growth_label": "S/E/A evidence classification for growth.",
        "tier1": "Calculated gap above on_course within the selected historical-benchmark comparison, capped by the chosen target. Billion 2026 international dollars; not predicted growth.",
        "tier1_label": "S/E/A evidence classification for tier1.",
        "tier2": "Calculated remaining gap beyond on_course + tier1 under the chosen target mix. Billion 2026 international dollars; not a forecast. target = today + growth + tier1 + tier2.",
        "tier2_label": "S/E/A evidence classification for tier2.",
        "src": "Source file or provenance reference. Original source tokens are retained in the upstream tables."
      }
    },
    "shortages": {
      "description": "All 23 tested inputs and buyer constraints, with their own base output blocks, ranges, labels and tests.",
      "rows": 23,
      "csv": "data/shortages_v4.csv",
      "columns": {
        "shortage_id": "Input or demand-constraint identifier. BUY-* refers to a buyer constraint on the named layer.",
        "shortage": "Plain-English input or buyer-constraint name.",
        "category": "Input category used in the brief.",
        "unit": "Native unit for input requirements and supplies. This can differ from the output unit.",
        "need_2035": "Input needed at the full target under this alternative, in the row's native unit.",
        "supply_on_course": "Input supply on course, in its native unit. Demand rows use output buyers would absorb.",
        "supply_precedent": "Input supply at the selected precedent, in its native unit.",
        "share_met_on_course": "On-course supply divided by the full-target requirement. A fraction, which may exceed 1.",
        "share_met_precedent": "Precedent supply divided by the full-target requirement. A fraction, which may exceed 1.",
        "short_at_precedent": "Maximum of zero and need minus precedent supply, in the input's native unit.",
        "short_on_course": "Maximum of zero and need minus on-course supply, in the input's native unit.",
        "blocked_tier2": "Tier-2 output removed from the target economy at precedent input supply, in billion PPP dollars.",
        "blocked_tier1": "Output removed from the on-course-plus-tier-1 economy at on-course input supply, in billion PPP dollars.",
        "blocked_tier1_beyond_precedent": "Diagnostic tier-1 output still blocked when tested at precedent supply.",
        "tier1_competing_with_tier2": "Tier-1 output removed while attempting the full target, recorded separately from the counted block.",
        "blocked_total": "blocked_tier1 plus blocked_tier2 for this shortage alone, in billion PPP dollars.",
        "excess_not_absorbed_on_course": "Remaining input shortfall after all eligible tier-1 output is removed, in native input units.",
        "excess_not_absorbed_precedent": "Remaining input shortfall after eligible target-gap output is removed, in native input units.",
        "blocked_low": "Smallest blocked_total across this shortage's tested alternatives, in billion PPP dollars.",
        "blocked_high": "Largest blocked_total across this shortage's tested alternatives, in billion PPP dollars.",
        "n_alternatives": "Number of evaluated cases beyond the base case.",
        "verdict": "Conditional robustness verdict. See the terminology and limitations.",
        "depends_on": "Production assumption or missing alternative that affects the verdict.",
        "label": "Evidence classification S, E or A.",
        "status": "TESTED or UNTESTED as assigned by v4 from its evidence labels.",
        "test": "Proposed test to improve an assumed input or rate.",
        "growth_needed_pa": "Annual input growth needed from 2026 to 2035, expressed as a fraction.",
        "growth_precedent_pa": "Annual input growth implied by precedent supply, expressed as a fraction.",
        "times_faster": "Required annual growth rate divided by the precedent annual growth rate.",
        "fastest_precedent": "Description of the historical comparison carried from the input table.",
        "main_layer": "Layer with this shortage's largest combined base tier-1 and tier-2 block.",
        "src": "Source file or provenance reference. Original source tokens are retained in the upstream tables."
      }
    },
    "rows": {
      "description": "The 35 positive layer-and-tier gaps and the largest base shortage credited against each one.",
      "rows": 35,
      "csv": "data/rows_v4.csv",
      "columns": {
        "layer_id": "Layer identifier. C01-C15 are named output categories and U1-U4 are retained accounting categories.",
        "layer": "Plain-English layer name.",
        "tier": "1 for the within-precedent gap or 2 for the beyond-precedent gap.",
        "missing_bn": "Positive missing output in a layer-and-tier row, in billion PPP dollars.",
        "missing_label": "S/E/A evidence classification for missing.",
        "binds_first": "ID of the shortage with the largest base block in the row. Lower need coverage breaks ties.",
        "binds_first_name": "Name of the shortage credited as the largest block.",
        "binds_first_category": "Category of the credited shortage.",
        "binds_first_blocks_bn": "Output credited to the leading shortage in this row, in billion PPP dollars.",
        "binds_first_label": "S/E/A evidence classification for binds_first.",
        "binds_first_verdict": "Robustness verdict of the credited shortage.",
        "others": "Other base shortages affecting the row, with their individually blocked amounts.",
        "n_shortages": "Number of base shortages with a positive block in the row.",
        "explained_bn": "Largest individual base shortage block in the row, capped at its missing amount.",
        "unexplained_bn": "Row missing amount minus the largest individual base shortage block.",
        "why": "Generated explanation of the row or selection."
      }
    },
    "unexplained": {
      "description": "The residual amounts after the largest shortage is credited within each layer and tier.",
      "rows": 10,
      "csv": "data/unexplained_v4.csv",
      "columns": {
        "layer_id": "Layer identifier. C01-C15 are named output categories and U1-U4 are retained accounting categories.",
        "layer": "Plain-English layer name.",
        "tier": "1 for the within-precedent gap or 2 for the beyond-precedent gap.",
        "unexplained_bn": "Row missing amount minus the largest individual base shortage block.",
        "label": "Evidence classification S, E or A.",
        "note": "Explanatory note retained from the calculation."
      }
    },
    "own_blocks": {
      "description": "Each shortage's blocked output by alternative, layer and tier. Constraints overlap across shortage IDs.",
      "rows": 427,
      "csv": "data/own_blocks_v4.csv",
      "columns": {
        "shortage_id": "Input or demand-constraint identifier. BUY-* refers to a buyer constraint on the named layer.",
        "variant": "Alternative within a shortage. Join with shortage_id to identify a specific calculation.",
        "layer_id": "Layer identifier. C01-C15 are named output categories and U1-U4 are retained accounting categories.",
        "tier": "1 for the within-precedent gap or 2 for the beyond-precedent gap.",
        "blocked_bn": "Output blocked in this shortage/variant/layer/tier cell, in billion PPP dollars."
      }
    },
    "variants": {
      "description": "Every evaluated production or demand alternative with its requirement, supplies and blocked output.",
      "rows": 77,
      "csv": "data/variants_v4.csv",
      "columns": {
        "shortage_id": "Input or demand-constraint identifier. BUY-* refers to a buyer constraint on the named layer.",
        "variant": "Alternative within a shortage. Join with shortage_id to identify a specific calculation.",
        "scenario": "Reported scenario grouping. Multiple variants can share a scenario ID.",
        "way_of_producing": "Description of the production or demand alternative.",
        "src": "Source file or provenance reference. Original source tokens are retained in the upstream tables.",
        "label": "Evidence classification S, E or A.",
        "need_2035": "Input needed at the full target under this alternative, in the row's native unit.",
        "supply_on_course": "Input supply on course, in its native unit. Demand rows use output buyers would absorb.",
        "supply_precedent": "Input supply at the selected precedent, in its native unit.",
        "blocked_tier2": "Tier-2 output removed from the target economy at precedent input supply, in billion PPP dollars.",
        "blocked_tier1": "Output removed from the on-course-plus-tier-1 economy at on-course input supply, in billion PPP dollars.",
        "blocked_total": "blocked_tier1 plus blocked_tier2 for this shortage alone, in billion PPP dollars.",
        "binds": "Whether this alternative blocks more than the model's numerical tolerance."
      }
    },
    "ranking": {
      "description": "Base ordering, seven reported scenario orderings, evidence groupings and selection flags.",
      "rows": 20,
      "csv": "data/ranking_v4.csv",
      "columns": {
        "shortage_id": "Input or demand-constraint identifier. BUY-* refers to a buyer constraint on the named layer.",
        "shortage": "Plain-English input or buyer-constraint name.",
        "category": "Input category used in the brief.",
        "unit": "Native unit for input requirements and supplies. This can differ from the output unit.",
        "need_2035": "Input needed at the full target under this alternative, in the row's native unit.",
        "supply_on_course": "Input supply on course, in its native unit. Demand rows use output buyers would absorb.",
        "supply_precedent": "Input supply at the selected precedent, in its native unit.",
        "share_met_on_course": "On-course supply divided by the full-target requirement. A fraction, which may exceed 1.",
        "share_met_precedent": "Precedent supply divided by the full-target requirement. A fraction, which may exceed 1.",
        "short_at_precedent": "Maximum of zero and need minus precedent supply, in the input's native unit.",
        "short_on_course": "Maximum of zero and need minus on-course supply, in the input's native unit.",
        "blocked_tier2": "Tier-2 output removed from the target economy at precedent input supply, in billion PPP dollars.",
        "blocked_tier1": "Output removed from the on-course-plus-tier-1 economy at on-course input supply, in billion PPP dollars.",
        "blocked_tier1_beyond_precedent": "Diagnostic tier-1 output still blocked when tested at precedent supply.",
        "tier1_competing_with_tier2": "Tier-1 output removed while attempting the full target, recorded separately from the counted block.",
        "blocked_total": "blocked_tier1 plus blocked_tier2 for this shortage alone, in billion PPP dollars.",
        "excess_not_absorbed_on_course": "Remaining input shortfall after all eligible tier-1 output is removed, in native input units.",
        "excess_not_absorbed_precedent": "Remaining input shortfall after eligible target-gap output is removed, in native input units.",
        "blocked_low": "Smallest blocked_total across this shortage's tested alternatives, in billion PPP dollars.",
        "blocked_high": "Largest blocked_total across this shortage's tested alternatives, in billion PPP dollars.",
        "n_alternatives": "Number of evaluated cases beyond the base case.",
        "verdict": "Conditional robustness verdict. See the terminology and limitations.",
        "depends_on": "Production assumption or missing alternative that affects the verdict.",
        "label": "Evidence classification S, E or A.",
        "status": "TESTED or UNTESTED as assigned by v4 from its evidence labels.",
        "test": "Proposed test to improve an assumed input or rate.",
        "growth_needed_pa": "Annual input growth needed from 2026 to 2035, expressed as a fraction.",
        "growth_precedent_pa": "Annual input growth implied by precedent supply, expressed as a fraction.",
        "times_faster": "Required annual growth rate divided by the precedent annual growth rate.",
        "fastest_precedent": "Description of the historical comparison carried from the input table.",
        "main_layer": "Layer with this shortage's largest combined base tier-1 and tier-2 block.",
        "src": "Source file or provenance reference. Original source tokens are retained in the upstream tables.",
        "group_label": "S/E/A evidence classification for group.",
        "group_solid": "Robustness group used by the ranking.",
        "rank_all": "Base rank when shortages are ordered by their own blocked output.",
        "rank_S0": "Rank in reported scenario S0. Ties share their smallest rank.",
        "blocked_S0": "Own output blocked in reported scenario S0, in billion 2026 PPP dollars.",
        "rank_S1": "Rank in reported scenario S1. Ties share their smallest rank.",
        "blocked_S1": "Own output blocked in reported scenario S1, in billion 2026 PPP dollars.",
        "rank_S2": "Rank in reported scenario S2. Ties share their smallest rank.",
        "blocked_S2": "Own output blocked in reported scenario S2, in billion 2026 PPP dollars.",
        "rank_S3": "Rank in reported scenario S3. Ties share their smallest rank.",
        "blocked_S3": "Own output blocked in reported scenario S3, in billion 2026 PPP dollars.",
        "rank_S4": "Rank in reported scenario S4. Ties share their smallest rank.",
        "blocked_S4": "Own output blocked in reported scenario S4, in billion 2026 PPP dollars.",
        "rank_S5": "Rank in reported scenario S5. Ties share their smallest rank.",
        "blocked_S5": "Own output blocked in reported scenario S5, in billion 2026 PPP dollars.",
        "rank_S6": "Rank in reported scenario S6. Ties share their smallest rank.",
        "blocked_S6": "Own output blocked in reported scenario S6, in billion 2026 PPP dollars.",
        "rank_changes": "Whether rank differs among the seven reported scenario columns.",
        "rank_in_label_group": "Position among shortages sharing the evidence group.",
        "rank_in_solid_group": "Position among shortages sharing the robustness group.",
        "pick": "Whether the shortage is one of the six selected entries."
      }
    },
    "picks": {
      "description": "The six selected shortages and the generated rationale for each selection.",
      "rows": 6,
      "csv": "data/picks_v4.csv",
      "columns": {
        "shortage_id": "Input or demand-constraint identifier. BUY-* refers to a buyer constraint on the named layer.",
        "shortage": "Plain-English input or buyer-constraint name.",
        "category": "Input category used in the brief.",
        "main_layer": "Layer with this shortage's largest combined base tier-1 and tier-2 block.",
        "rule": "Selection-rule outcome recorded by the model.",
        "blocked_total": "blocked_tier1 plus blocked_tier2 for this shortage alone, in billion PPP dollars.",
        "blocked_low": "Smallest blocked_total across this shortage's tested alternatives, in billion PPP dollars.",
        "blocked_high": "Largest blocked_total across this shortage's tested alternatives, in billion PPP dollars.",
        "verdict": "Conditional robustness verdict. See the terminology and limitations.",
        "label": "Evidence classification S, E or A.",
        "solid_se": "Whether the pick has verdict SOLID and evidence label S or E.",
        "rank_all": "Base rank when shortages are ordered by their own blocked output.",
        "why": "Generated explanation of the row or selection."
      }
    },
    "agents": {
      "description": "The research streams' reused or repaired headline figures and their source paths.",
      "rows": 13,
      "csv": "data/agents_v4.csv",
      "columns": {
        "key": "Identifier for the research-agent headline.",
        "value": "Research-agent headline value. Its meaning and unit are given by what.",
        "label": "Evidence classification S, E or A.",
        "src": "Source file or provenance reference. Original source tokens are retained in the upstream tables.",
        "what": "Description of the headline value, including its unit where needed."
      }
    },
    "demand": {
      "description": "Demand at the assumed 2035 prices for the five largest target layers.",
      "rows": 5,
      "csv": "data/demand_v4.csv",
      "columns": {
        "layer_id": "Layer identifier. C01-C15 are named output categories and U1-U4 are retained accounting categories.",
        "layer": "Plain-English layer name.",
        "today": "2026 annual output estimate in billion 2026 international dollars.",
        "target": "Chosen 2035 sector target in billion 2026 international dollars, under the selected doubling scenario and spending mix. Not a forecast.",
        "extra_output": "Missing tier-1 plus tier-2 output for this layer, in billion PPP dollars.",
        "income_ratio": "Target total world output divided by today's total output.",
        "income_elasticity": "Power applied to the income ratio in the demand calculation.",
        "income_elasticity_label": "S/E/A evidence classification for income_elasticity.",
        "income_elasticity_src": "Source or provenance reference for income_elasticity.",
        "price_ratio_2035": "2035 product price divided by its starting price.",
        "price_ratio_src": "Source or provenance reference for price_ratio.",
        "price_elasticity": "Power applied to the price ratio in the demand calculation.",
        "price_elasticity_src": "Source or provenance reference for price_elasticity.",
        "demand_2035": "Modelled quantity demanded, expressed as output valued in billion 2026 PPP dollars.",
        "demand_label": "S/E/A evidence classification for demand.",
        "buyers_short": "Maximum of zero and target minus modelled demand, in billion PPP dollars.",
        "verdict": "Conditional robustness verdict. See the terminology and limitations.",
        "income_elasticity_other_windows": "Income-response estimates from the other historical windows."
      }
    },
    "searches": {
      "description": "The two external searches recorded by the v4 calculation.",
      "rows": 2,
      "csv": "data/searches_v4.csv",
      "columns": {
        "id": "Identifier of the source search or scenario.",
        "query": "Recorded search text used during the v4 analysis.",
        "source": "Bibliographic source as recorded by the model.",
        "url": "Original source URL.",
        "value_low": "Lower sourced endpoint used for an alternative.",
        "value_high": "Upper sourced endpoint used for an alternative.",
        "label": "Evidence classification S, E or A.",
        "used_for": "How the recorded source was used in the model."
      }
    },
    "checks": {
      "description": "The committed model-check results. The methods page explains where those checks relax the brief.",
      "rows": 14,
      "csv": "data/checks_v4.csv",
      "columns": {
        "check": "Invariant or rule evaluated by the model checker.",
        "ok": "Boolean result of the committed check, using the rules implemented in check.py.",
        "detail": "Evidence or diagnostic text for the check."
      }
    },
    "scenarios": {
      "description": "Names for the seven scenario IDs used by the published ranking.",
      "rows": 7,
      "csv": "data/scenarios_v4.csv",
      "columns": {
        "id": "Identifier of the source search or scenario.",
        "scenario": "Reported scenario grouping. Multiple variants can share a scenario ID."
      }
    }
  }
}
