{
  "schema": "causal-showcase-manifest/1",
  "slug": "grid-demand-response",
  "version": "1.0",
  "title": "Demand Response and Grid Resilience",
  "question": "Which buildings should reduce or shift load, at what time and incentive, to prevent a grid constraint without unacceptable customer impact?",
  "lastValidated": "2026-11-18",
  "evidence": "Reviewed",
  "scenario": {
    "params": [
      {
        "key": "share",
        "label": "Buildings targeted",
        "min": 0,
        "max": 60,
        "step": 5,
        "default": 0,
        "unit": "%"
      },
      {
        "key": "incentive",
        "label": "Rebate per kWh shifted",
        "min": 0,
        "max": 1,
        "step": 0.1,
        "default": 0.3,
        "unit": "$/kWh"
      },
      {
        "key": "battery",
        "label": "Battery dispatch",
        "min": 0,
        "max": 20,
        "step": 2,
        "default": 0,
        "unit": "MW"
      }
    ],
    "alternatives": [
      {
        "name": "No action",
        "description": "Serve the forecast load without a demand-response event.",
        "params": {
          "share": 0,
          "incentive": 0.3,
          "battery": 0
        }
      },
      {
        "name": "Uniform rebate",
        "description": "Offer the same rebate to every eligible building.",
        "params": {
          "share": 60,
          "incentive": 0.3,
          "battery": 0
        }
      },
      {
        "name": "Targeted rebate",
        "description": "Higher rebate to the buildings with the largest estimated response.",
        "params": {
          "share": 35,
          "incentive": 0.5,
          "battery": 0
        }
      },
      {
        "name": "Thermostat pre-cooling",
        "description": "Pre-cool a subset of buildings with a small battery reserve.",
        "params": {
          "share": 30,
          "incentive": 0.3,
          "battery": 6
        }
      },
      {
        "name": "Battery dispatch",
        "description": "Discharge distributed batteries only.",
        "params": {
          "share": 0,
          "incentive": 0.3,
          "battery": 20
        }
      },
      {
        "name": "Combined policy",
        "description": "Recommended: targeted rebates plus moderate battery dispatch.",
        "params": {
          "share": 40,
          "incentive": 0.4,
          "battery": 10
        }
      }
    ],
    "metrics": [
      {
        "key": "overload",
        "label": "Feeder overload probability",
        "unit": "%",
        "base": 18,
        "sd": 2.5,
        "higherIsBetter": false,
        "sensitivity": {
          "share": -0.22,
          "incentive": -6,
          "battery": -0.5
        },
        "constraint": {
          "max": 5,
          "label": "Limit 5%"
        }
      },
      {
        "key": "peak",
        "label": "Peak load",
        "unit": "MW",
        "base": 142,
        "sd": 3,
        "higherIsBetter": false,
        "sensitivity": {
          "share": -0.18,
          "incentive": -4,
          "battery": -0.8
        }
      },
      {
        "key": "cost",
        "label": "Incentive and dispatch cost",
        "unit": "k$",
        "base": 5,
        "sd": 4,
        "higherIsBetter": false,
        "sensitivity": {
          "share": 2.2,
          "incentive": 60,
          "battery": 1.5
        }
      },
      {
        "key": "comfort",
        "label": "Comfort impact index",
        "unit": "pts",
        "base": 0.5,
        "sd": 0.2,
        "higherIsBetter": false,
        "sensitivity": {
          "share": 0.04,
          "incentive": 1.2,
          "battery": 0
        }
      }
    ],
    "objective": "Keep feeder overload probability under 5% at the lowest incentive cost, with acceptable comfort impact.",
    "runs": 2000
  },
  "technical": {
    "dag": [
      [
        "Weather",
        "Enrollment"
      ],
      [
        "Weather",
        "Load"
      ],
      [
        "Tariff history",
        "Enrollment"
      ],
      [
        "Tariff history",
        "Load"
      ],
      [
        "Building state",
        "Enrollment"
      ],
      [
        "Building state",
        "Load"
      ],
      [
        "Rebate",
        "Enrollment"
      ],
      [
        "Enrollment",
        "Load"
      ],
      [
        "Load",
        "Feeder flow"
      ],
      [
        "Feeder flow",
        "Overload"
      ]
    ],
    "estimand": "CATE(c) = E[Load(rebate) − Load(no rebate) | class = c, event window], kWh per building",
    "assumptions": [
      "No unmeasured confounding after weather, tariff history and building state",
      "Response stable within the eligible incentive range",
      "Feeder topology and capacity records are correct",
      "Comfort model valid only for represented building classes"
    ],
    "equations": [
      "T(t+1) = T(t) + (Q_gain − Q_cool(t)) / C_thermal",
      "Flow_e = Σ_{b downstream of e} Load_b − Battery_b",
      "P(Flow_e > Cap_e) ≤ 0.05 for every feeder e"
    ],
    "engines": {
      "Causal": "causal-core 3.4.1",
      "Digital twins": "twin-runtime 2.8.0",
      "ABM": "agentflow 1.9.3",
      "System dynamics": "stockflow 3.0.4",
      "Network": "graph-prop 1.7.2",
      "Monte Carlo": "mc-sampler 4.0.0",
      "Optimization": "policy-opt 2.2.5"
    },
    "seed": 20261108,
    "validation": [
      {
        "name": "Held-out load MAPE",
        "value": "4.1%"
      },
      {
        "name": "Rebound timing error",
        "value": "12 min"
      },
      {
        "name": "Negative-control response",
        "value": "0.02 kWh (ns)"
      }
    ]
  },
  "provenance": {
    "authors": [
      "Platform Education Team"
    ],
    "reviewers": [
      "Grid Operations Review",
      "Causal Methods Review Board"
    ],
    "rights": "CC BY 4.0. Synthetic data generated by the platform.",
    "sourceData": "Synthetic smart-meter intervals, weather, tariffs, customer attributes, feeder topology, capacity limits, solar forecasts and event participation (seed 20261108). No household-level traces.",
    "changelog": [
      {
        "version": "1.0",
        "date": "2026-11-18",
        "note": "Initial publication from the extended catalog specification (packages 8 to 20)."
      }
    ]
  },
  "exportedAt": "2026-11-18T23:20:18.649Z"
}