# Data dictionary

**All records are fictional.** Keep the raw files unchanged and build your analysis separately. `rules.json` defines the population and assumptions. Blank, zero and unknown are not interchangeable.

## facilities.csv

One facility and its stated reporting boundary.

| Field | Meaning |
|---|---|
| `facility_id` | Stable facility identity. |
| `region` | Join key to a fictional factor, not a real geographic emissions region. |
| `in_scope` | Literal true/false. Excluded facilities do not belong to the expected grid. |

## activity.csv

One facility-month source record, plus one retry and out-of-boundary records.

| Field | Meaning |
|---|---|
| `record_id` | Unique source record identity. |
| `facility_id` | Parent facility. |
| `month` | Activity month, YYYY-MM. |
| `quantity` | Nonnegative electricity quantity; blank is missing, never zero. |
| `unit` | kWh or MWh. Use the supplied conversion before applying a per-kWh factor. |
| `quality` | metered, estimated or missing. Estimates must remain identifiable in the subtotal. |

## fictional_factors.csv

One invented arithmetic factor per fictional region.

| Field | Meaning |
|---|---|
| `region` | Exact factor join key. |
| `kg_co2e_per_kwh` | Invented kilograms CO2e per kWh, not a real-world factor. |
| `use_limit` | FICTIONAL_ARITHMETIC_ONLY. Do not use for inventory compliance, assurance or a real emissions estimate. |