{
  "flatland_ir_version": 1,
  "ir": {
    "name": "Home energy use",
    "version": 1,
    "currency": "USD",
    "mode": "vector",
    "periods": {
      "start": "2027-01",
      "end": "2028-12",
      "grain": "monthly"
    },
    "drivers": {
      "heating_kwh": {
        "label": "Heating and cooling electricity (kWh)",
        "category": "assumption",
        "type": "Count",
        "value": [
          1250, 1150, 950, 750, 650, 800, 1100, 1200, 850, 700, 900, 1200, 1250, 1150, 950, 750,
          650, 800, 1100, 1200, 850, 700, 900, 1200
        ],
        "role": "fixed",
        "description": "A fictional seasonal profile before changes; repeated for the second year.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "name": "heating_kwh"
      },
      "other_kwh": {
        "label": "Other electricity (kWh per month)",
        "category": "assumption",
        "type": "Count",
        "value": 350,
        "role": "fixed",
        "description": "Lighting, cooking and other uses, held constant.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "name": "other_kwh"
      },
      "demand_factor": {
        "label": "Heating and cooling demand multiplier",
        "category": "assumption",
        "type": "Ratio",
        "value": 1,
        "role": "force",
        "description": "One uncertain multiplier for both years; this is not a weather simulation.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "range": [0.8, 1.25],
        "range_guess": true,
        "behaviour": "level",
        "name": "demand_factor"
      },
      "electricity_rate": {
        "label": "Electricity rate (USD per kWh)",
        "category": "assumption",
        "type": "Currency",
        "value": 0.22,
        "role": "force",
        "description": "An invented rate held for both years. It is not a quote from a utility.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "range": [0.16, 0.3],
        "range_guess": true,
        "behaviour": "level",
        "name": "electricity_rate"
      },
      "monthly_fee": {
        "label": "Fixed utility fee (USD per month)",
        "category": "assumption",
        "type": "Currency",
        "value": 15,
        "role": "fixed",
        "description": "",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "name": "monthly_fee"
      },
      "sealing_spend": {
        "label": "Air sealing project cost (USD)",
        "category": "assumption",
        "type": "Currency",
        "value": 300,
        "role": "lever",
        "description": "A one-time project completed before the first month.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "range": [0, 1200],
        "range_guess": true,
        "step": 100,
        "name": "sealing_spend"
      },
      "half_cost": {
        "label": "Project cost for half of maximum savings (USD)",
        "category": "assumption",
        "type": "Currency",
        "value": 400,
        "role": "fixed",
        "description": "An invented diminishing-return relationship, not a contractor estimate.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "name": "half_cost"
      },
      "maximum_reduction": {
        "label": "Maximum air sealing reduction",
        "category": "assumption",
        "type": "Percentage",
        "value": 0.35,
        "role": "fixed",
        "description": "The upper limit of the illustrative response formula, not a promised saving.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "name": "maximum_reduction"
      },
      "setting_reduction": {
        "label": "Heating and cooling use reduced by settings",
        "category": "assumption",
        "type": "Percentage",
        "value": 0.05,
        "role": "lever",
        "description": "The assumed effect of thermostat and usage changes. Comfort and health limits must be assessed separately.",
        "source": "Fictional teaching assumption; replace with your own evidence.",
        "range": [0, 0.15],
        "range_guess": true,
        "step": 0.025,
        "name": "setting_reduction"
      },
      "sealing_reduction": {
        "label": "Air sealing reduction",
        "category": "computed",
        "type": "Percentage",
        "formula": "maximum_reduction * (sealing_spend / (sealing_spend + half_cost))",
        "description": "",
        "temporality": "flow",
        "name": "sealing_reduction"
      },
      "energy_kwh": {
        "label": "Electricity used (kWh per month)",
        "category": "computed",
        "type": "Count",
        "formula": "other_kwh + heating_kwh * demand_factor * (1 - sealing_reduction) * (1 - setting_reduction)",
        "description": "",
        "temporality": "flow",
        "name": "energy_kwh"
      },
      "monthly_bill": {
        "label": "Electricity bill (USD per month)",
        "category": "computed",
        "type": "Currency",
        "formula": "energy_kwh * electricity_rate + monthly_fee",
        "description": "",
        "temporality": "flow",
        "name": "monthly_bill"
      },
      "total_cost": {
        "label": "Energy and project cost to date (USD)",
        "category": "computed",
        "type": "Currency",
        "formula": "cumsum(monthly_bill) + sealing_spend",
        "description": "",
        "temporality": "stock",
        "name": "total_cost"
      }
    },
    "scenarios": {
      "base": {},
      "No changes": {
        "sealing_spend": 0,
        "setting_reduction": 0
      },
      "More use and higher rates": {
        "demand_factor": 1.2,
        "electricity_rate": 0.28
      }
    },
    "metadata": {
      "created_at": "2026-11-01T00:00:00Z",
      "description": "Fictional teaching model. All values, response formulas and uncertainty ranges are invented to make the relationships inspectable; they are not observations, forecasts or recommendations."
    },
    "authored_specs": {
      "goal": {
        "name": "goal",
        "kind": "goal",
        "version": 1,
        "target": "total_cost",
        "condition": "<= 7000",
        "aggregation": "value",
        "floors": []
      }
    }
  }
}
