{
  "anchors": [
    {
      "about": "5-digit Census county FIPS, zero-padded string.",
      "format": "fips5",
      "kind": "geography",
      "name": "county_fips",
      "scope": "universal"
    },
    {
      "about": "2-letter state/jurisdiction code (PD-003).",
      "format": "usps_state",
      "kind": "geography",
      "name": "state",
      "scope": "universal"
    },
    {
      "about": "Decimal degrees, WGS84. Carried on detail records for joining/mapping \u2014 not a filter or group_by key.",
      "format": "latitude",
      "kind": "geography",
      "name": "lat",
      "scope": "universal"
    },
    {
      "about": "Decimal degrees, WGS84. Carried on detail records for joining/mapping \u2014 not a filter or group_by key.",
      "format": "longitude",
      "kind": "geography",
      "name": "lon",
      "scope": "universal"
    },
    {
      "about": "EIA plant code; joins within the EIA family.",
      "format": "positive_int",
      "kind": "entity",
      "name": "eia_plant_id",
      "scope": "opportunistic"
    },
    {
      "about": "EIA generator id, unique within a plant.",
      "format": "short_code",
      "kind": "entity",
      "name": "generator_id",
      "scope": "opportunistic"
    },
    {
      "about": "EIA-reported BA code; source-reported, not a validated footprint (PD-002/009).",
      "format": "ba_code",
      "kind": "entity",
      "name": "balancing_authority_code",
      "scope": "opportunistic"
    }
  ],
  "capability": "power.capacity",
  "codebooks": {
    "balancing_authority_code": {
      "codes": {
        "AEC": {
          "label": "PowerSouth Energy Cooperative"
        },
        "AECI": {
          "label": "Associated Electric Cooperative, Inc."
        },
        "AESO": {
          "label": "Alberta Electric System Operator"
        },
        "AVA": {
          "label": "Avista Corporation"
        },
        "AVRN": {
          "label": "Avangrid Renewables, LLC"
        },
        "AZPS": {
          "label": "Arizona Public Service Company"
        },
        "BANC": {
          "label": "Balancing Authority of Northern California"
        },
        "BCHA": {
          "label": "British Columbia Hydro and Power Authority"
        },
        "BHBA": {
          "label": "Black Hills Energy"
        },
        "BPAT": {
          "label": "Bonneville Power Administration"
        },
        "CEN": {
          "label": "Centro Nacional de Control de Energia"
        },
        "CFE": {
          "label": "Comision Federal de Electricidad"
        },
        "CHPD": {
          "label": "Public Utility District No. 1 of Chelan County"
        },
        "CISO": {
          "label": "California Independent System Operator"
        },
        "CPLE": {
          "label": "Duke Energy Progress East"
        },
        "CPLW": {
          "label": "Duke Energy Progress West"
        },
        "DEAA": {
          "label": "Arlington Valley, LLC"
        },
        "DOPD": {
          "label": "PUD No. 1 of Douglas County"
        },
        "DUK": {
          "label": "Duke Energy Carolinas"
        },
        "EEI": {
          "label": "Electric Energy, Inc."
        },
        "EPE": {
          "label": "El Paso Electric Company"
        },
        "ERCO": {
          "label": "Electric Reliability Council of Texas, Inc."
        },
        "FMPP": {
          "label": "Florida Municipal Power Pool"
        },
        "FPC": {
          "label": "Duke Energy Florida, Inc."
        },
        "FPL": {
          "label": "Florida Power & Light Co."
        },
        "GCPD": {
          "label": "Public Utility District No. 2 of Grant County, Washington"
        },
        "GLHB": {
          "label": "GridLiance"
        },
        "GRID": {
          "label": "Gridforce Energy Management, LLC"
        },
        "GRIF": {
          "label": "Griffith Energy, LLC"
        },
        "GRMA": {
          "label": "Gila River Power, LLC"
        },
        "GVL": {
          "label": "Gainesville Regional Utilities"
        },
        "GWA": {
          "label": "NaturEner Power Watch, LLC"
        },
        "HGMA": {
          "label": "New Harquahala Generating Company, LLC"
        },
        "HQT": {
          "label": "Hydro-Quebec TransEnergie"
        },
        "HST": {
          "label": "City of Homestead"
        },
        "IESO": {
          "label": "Ontario IESO"
        },
        "IID": {
          "label": "Imperial Irrigation District"
        },
        "IPCO": {
          "label": "Idaho Power Company"
        },
        "ISNE": {
          "label": "ISO New England"
        },
        "JEA": {
          "label": "JEA"
        },
        "LDWP": {
          "label": "Los Angeles Department of Water and Power"
        },
        "LGEE": {
          "label": "Louisville Gas and Electric Company and Kentucky Utilities Company"
        },
        "MHEB": {
          "label": "Manitoba Hydro"
        },
        "MISO": {
          "label": "Midcontinent Independent System Operator, Inc."
        },
        "NBSO": {
          "label": "New Brunswick System Operator"
        },
        "NEVP": {
          "label": "Nevada Power Company"
        },
        "NSB": {
          "label": "Utilities Commission of New Smyrna Beach"
        },
        "NWMT": {
          "label": "NorthWestern Corporation"
        },
        "NYIS": {
          "label": "New York Independent System Operator"
        },
        "OVEC": {
          "label": "Ohio Valley Electric Corporation"
        },
        "PACE": {
          "label": "PacifiCorp East"
        },
        "PACW": {
          "label": "PacifiCorp West"
        },
        "PGE": {
          "label": "Portland General Electric Company"
        },
        "PJM": {
          "label": "PJM Interconnection, LLC"
        },
        "PNM": {
          "label": "Public Service Company of New Mexico"
        },
        "PSCO": {
          "label": "Public Service Company of Colorado"
        },
        "PSEI": {
          "label": "Puget Sound Energy, Inc."
        },
        "SC": {
          "label": "South Carolina Public Service Authority"
        },
        "SCEG": {
          "label": "Dominion Energy South Carolina, Inc."
        },
        "SCL": {
          "label": "Seattle City Light"
        },
        "SEC": {
          "label": "Seminole Electric Cooperative"
        },
        "SEPA": {
          "label": "Southeastern Power Administration"
        },
        "SIKE": {
          "label": "Sikeston Board Of Municipal Utilities"
        },
        "SOCO": {
          "label": "Southern Company Services, Inc. - Trans"
        },
        "SPA": {
          "label": "Southwestern Power Administration"
        },
        "SPC": {
          "label": "Saskatchewan Power Corporation"
        },
        "SRP": {
          "label": "Salt River Project Agricultural Improvement and Power District"
        },
        "SWPP": {
          "label": "Southwest Power Pool"
        },
        "SWPW": {
          "label": "Southwest Power Pool West Balancing Authority Area"
        },
        "TAL": {
          "label": "City of Tallahassee"
        },
        "TEC": {
          "label": "Tampa Electric Company"
        },
        "TEPC": {
          "label": "Tucson Electric Power"
        },
        "TIDC": {
          "label": "Turlock Irrigation District"
        },
        "TPWR": {
          "label": "City of Tacoma, Department of Public Utilities, Light Division"
        },
        "TVA": {
          "label": "Tennessee Valley Authority"
        },
        "WACM": {
          "label": "Western Area Power Administration - Rocky Mountain Region"
        },
        "WALC": {
          "label": "Western Area Power Administration - Desert Southwest Region"
        },
        "WAUE": {
          "label": "Western Area Power Administration - Upper Great Plains East"
        },
        "WAUW": {
          "label": "Western Area Power Administration - Upper Great Plains West"
        },
        "WWA": {
          "label": "NaturEner Wind Watch, LLC"
        },
        "YAD": {
          "label": "Alcoa Power Generating, Inc. - Yadkin Division"
        }
      },
      "coverage": "partial_for_eia860m",
      "note": "EIA-860M reports this BA code on the generator row. exascale.build preserves it as source-reported data; it is not an independently validated physical BA-footprint assignment or corrected grid-operator attribution. EIA-860M can emit BA codes outside the EIA-930 reference table; missing labels are preserved as source-reported codes. A balancing authority is not a state. ERCO (ERCOT) lies wholly within Texas and covers ~90% of its load, but state=TX is the larger jurisdiction \u2014 it also includes non-ERCOT El Paso (WECC), the Panhandle (SPP), and East Texas (MISO), a material (~20%+) difference. Use balancing_authority_code for a grid and state for a jurisdiction; they are not interchangeable. When a phrase like 'the Texas grid' is ambiguous between the two, report both readings rather than guessing one (PD-009).",
      "semantics": "source_reported_eia860m_generator_row_assignment",
      "source": "EIA-930 reference table BAs sheet."
    },
    "energy_source_code": {
      "codes": {
        "AB": {
          "label": "Agricultural By-Products"
        },
        "ANT": {
          "label": "Anthracite Coal"
        },
        "BFG": {
          "label": "Blast Furnace Gas"
        },
        "BIT": {
          "label": "Bituminous Coal"
        },
        "BLQ": {
          "label": "Black Liquor"
        },
        "DFO": {
          "label": "Distillate Fuel Oil (including diesel, No. 1, No. 2, and No. 4 fuel oils)"
        },
        "GEO": {
          "label": "Geothermal"
        },
        "H2": {
          "label": "Hydrogen"
        },
        "JF": {
          "label": "Jet Fuel"
        },
        "KER": {
          "label": "Kerosene"
        },
        "LFG": {
          "label": "Landfill Gas"
        },
        "LIG": {
          "label": "Lignite Coal"
        },
        "MSW": {
          "label": "Municipal Solid Waste"
        },
        "MWH": {
          "label": "Electricity used for energy storage"
        },
        "NG": {
          "label": "Natural Gas"
        },
        "NUC": {
          "label": "Nuclear (including Uranium, Plutonium, and Thorium)"
        },
        "OBG": {
          "label": "Other Biomass Gas (including digester gas, methane, and other biomass gases; specify in SCHEDULE 7)"
        },
        "OBL": {
          "label": "Other Biomass Liquids (specify in SCHEDULE 7)"
        },
        "OBS": {
          "label": "Other Biomass Solids (specify in SCHEDULE 7)"
        },
        "OG": {
          "label": "Other Gas (specify in SCHEDULE 7)"
        },
        "OTH": {
          "label": "Specify in SCHEDULE 7"
        },
        "PC": {
          "label": "Petroleum Coke"
        },
        "PG": {
          "label": "Gaseous Propane"
        },
        "PUR": {
          "label": "Purchased Steam"
        },
        "RC": {
          "label": "Refined Coal"
        },
        "RFO": {
          "label": "Residual Fuel Oil (incl. Nos. 5 & 6 fuel oils, and bunker C fuel oil)"
        },
        "SGC": {
          "label": "Coal-Derived Synthesis Gas"
        },
        "SGP": {
          "label": "Synthesis Gas from Petroleum Coke"
        },
        "SLW": {
          "label": "Sludge Waste"
        },
        "SUB": {
          "label": "Subbituminous Coal"
        },
        "SUN": {
          "label": "Solar"
        },
        "TDF": {
          "label": "Tire-derived Fuels"
        },
        "WAT": {
          "label": "Pumping Energy for Reversible (Pumped Storage) Hydroelectric Turbine"
        },
        "WC": {
          "label": "Waste/Other Coal (incl. anthracite culm, bituminous gob, fine coal, lignite waste, waste coal)"
        },
        "WDL": {
          "label": "Wood Waste Liquids excluding Black Liquor (including red liquor, sludge wood, spent sulfite liquor, and other wood-based liquids)"
        },
        "WDS": {
          "label": "Wood/Wood Waste Solids (incl. paper pellets, railroad ties, utility poles, wood chips, bark, and wood waste solids)"
        },
        "WH": {
          "label": "Waste heat not directly attributed to a fuel source (WH should only be reported when the fuel source is undetermined, and for combined cycle steam turbines that do not have supplemental firing.)"
        },
        "WND": {
          "label": "Wind"
        },
        "WO": {
          "label": "Waste/Other Oil (including crude oil, liquid butane, liquid propane, naphtha, oil waste, re-refined motor oil, sludge oil, tar oil, or other petroleum-based liquid wastes)"
        }
      },
      "coverage": "complete_for_validated_eia860m_energy_source_codes",
      "source": "EIA energy source and prime mover code workbook, plus reviewed EIA-860M addendum."
    },
    "prime_mover_code": {
      "codes": {
        "BA": {
          "label": "Energy Storage, Battery"
        },
        "BT": {
          "label": "Turbines Used in a Binary Cycle (including those used for geothermal applications)"
        },
        "CA": {
          "label": "Combined Cycle Steam Part"
        },
        "CC": {
          "label": "Combined Cycle Total Unit (use only for plants/generators that are in planning stage, for which specific generator details cannot be provided)"
        },
        "CE": {
          "label": "Energy Storage, Compressed Air"
        },
        "CP": {
          "label": "Energy Storage, Concentrated Solar Power"
        },
        "CS": {
          "label": "Combined Cycle Single Shaft (combustion turbine and steam turbine share a single generator)"
        },
        "CT": {
          "label": "Combined Cycle Combustion Turbine Part"
        },
        "ES": {
          "label": "Energy Storage, Other (specify in SCHEDULE 7)"
        },
        "FC": {
          "label": "Fuel Cell"
        },
        "FW": {
          "label": "Energy Storage, Flywheel"
        },
        "GT": {
          "label": "Combustion (Gas) Turbine (does not include the combustion turbine part of a combined cycle; see code CT, below)"
        },
        "HA": {
          "label": "Hydrokinetic, Axial Flow Turbine"
        },
        "HB": {
          "label": "Hydrokinetic, Wave Buoy"
        },
        "HK": {
          "label": "Hydrokinetic, Other (specify in SCHEDULE 7)"
        },
        "HY": {
          "label": "Hydroelectric Turbine (includes turbines associated with delivery of water by pipeline)"
        },
        "IC": {
          "label": "Internal Combustion Engine (diesel, piston, reciprocating)"
        },
        "OT": {
          "label": "Other (specify in SCHEDULE 7)"
        },
        "PS": {
          "label": "Energy Storage, Reversible Hydraulic Turbine (Pumped Storage)"
        },
        "PV": {
          "label": "Photovoltaic"
        },
        "ST": {
          "label": "Steam Turbine, including nuclear, geothermal and solar steam (does not include combined cycle)"
        },
        "WS": {
          "label": "Wind Turbine, Offshore"
        },
        "WT": {
          "label": "Wind Turbine, Onshore"
        }
      },
      "coverage": "complete_for_validated_eia860m_prime_mover_codes",
      "source": "EIA energy source and prime mover code workbook."
    },
    "status_code": {
      "codes_by_lifecycle": {
        "operating": {
          "OA": {
            "label": "Out of service but expected to return to service in next calendar year"
          },
          "OP": {
            "label": "Operating"
          },
          "OS": {
            "label": "Out of service and NOT expected to return to service in next calendar year"
          },
          "SB": {
            "label": "Standby/Backup: available for service but not normally used"
          }
        },
        "planned": {
          "L": {
            "label": "Regulatory approvals pending. Not under construction"
          },
          "OT": {
            "label": "Other"
          },
          "P": {
            "label": "Planned for installation, but regulatory approvals not initiated"
          },
          "T": {
            "label": "Regulatory approvals received. Not under construction"
          },
          "TS": {
            "label": "Construction complete, but not yet in commercial operation"
          },
          "U": {
            "label": "Under construction, less than or equal to 50 percent complete"
          },
          "V": {
            "label": "Under construction, more than 50 percent complete"
          }
        }
      },
      "coverage": "lifecycle_specific",
      "source": "Reviewed EIA-860M status strings by lifecycle sheet."
    }
  },
  "data_point": {
    "does_not_answer": [
      "electricity supplied",
      "generation MWh",
      "real-time dispatch",
      "capacity factor as a standalone number (use query_capacity_factor_v1)",
      "battery storage throughput or duration",
      "deliverable capacity",
      "accredited capacity",
      {
        "interconnection-queue / requested capacity \u2014 projects pending in an ISO queue, not yet built (use the relevant ISO's queue tool": "query_power_interconnection_queue_v1 for MISO, query_power_interconnection_queue_pjm_v1 / query_power_interconnection_queue_pjm_cycle_v1 for PJM, query_power_interconnection_queue_caiso_v1 for CAISO)"
      },
      "probability that planned generators will be built",
      "data-center load or industrial demand"
    ],
    "grain": "generator_snapshot",
    "id": "power.capacity",
    "note": "Capacity (MW) and generation (MWh) are different data points, never interchangeable: capacity is a stock \u2014 what installed generators COULD produce at full output \u2014 while generation is a flow \u2014 what they actually DID produce over a stated period (PD-001/PD-006). For a bare 'how much power' question with no MW/MWh signal and no could/did signal, surface BOTH readings \u2014 installed capacity (power.capacity) and net generation (power.generation) \u2014 rather than answering with one.",
    "product_spec": "blocks/power_capacity/card.md",
    "represented_fact": "EIA-860M reports generator capacity by lifecycle, location, fuel, technology, status, and snapshot date.",
    "source_basis": [
      "energy.eia.eia860m"
    ],
    "source_decisions": [
      "docs/sources/energy/eia/eia860m/source-decision.md"
    ]
  },
  "input": {
    "canonical_filters": {
      "battery_storage": {
        "description": "Planned, operating, retired, or canceled battery storage capacity represented by this primitive.",
        "energy_capacity_policy": "`nameplate_energy_mwh` is only represented when the source row provides it. Do not derive MWh from MW unless the answer clearly labels the duration assumption outside exascale represented facts.",
        "params": {
          "technology": "Batteries"
        },
        "scope_note": "Use `technology = Batteries` as the user-facing canonical battery storage filter. `prime_mover_code = BA` and `energy_source_code = MWH` remain valid source-coded filters and may return different scopes.",
        "source_semantics": {
          "energy_source_code": "MWH",
          "prime_mover_code": "BA",
          "technology": "Batteries"
        }
      }
    },
    "controls": [
      "include_records",
      "include_evidence",
      "limit",
      "included_in_default_us_metrics",
      "order_by",
      "top_n",
      "order",
      "rollup_other"
    ],
    "date_range_params": [
      "operating_date_from",
      "operating_date_to",
      "planned_operation_date_from",
      "planned_operation_date_to",
      "planned_retirement_date_from",
      "planned_retirement_date_to",
      "retirement_date_from",
      "retirement_date_to"
    ],
    "date_ranges": [
      "operating_date",
      "planned_operation_date",
      "planned_retirement_date",
      "retirement_date"
    ],
    "field_metadata": {
      "state": {
        "answer_label": "state/jurisdiction",
        "counting_definition": "A count of grouped `state` values is a count of state-level jurisdiction codes, not a count of U.S. states; 51 values can mean 50 states plus DC.",
        "definition": "The EIA-860M `Plant State` value for the generator's plant. Values are two-letter U.S. state, District of Columbia, or territory/jurisdiction codes when present.",
        "display_name": "Plant state/jurisdiction code",
        "semantics": "source_reported_eia860m_plant_state_or_jurisdiction_code",
        "source_field": "Plant State"
      }
    },
    "filters": [
      "lifecycle",
      "as_of",
      "state",
      "county_fips",
      "balancing_authority_code",
      "energy_source_code",
      "fuel_group",
      "prime_mover_code",
      "technology",
      "status_code",
      "eia_plant_id",
      "generator_id",
      "operating_year",
      "planned_operation_year",
      "planned_retirement_year",
      "retirement_year"
    ],
    "fuel_groups": {
      "description": "Canonical multi-code fuel filter. Pass `fuel_group=<name>` (one name or a list) to total a fuel that spans several energy_source_code values; it expands server-side to the exact code set below. Prefer this over energy_source_code for fuel totals \u2014 an agent assembling the codes itself can undercount (e.g. biomass by ~40%). Conflicts with an explicit energy_source_code filter. Also a `group_by` dimension: `group_by=[\"fuel_group\"]` breaks a result into one bucket per fuel in a single query (coal as one row, not six codes); base fuels only \u2014 meta-groups like `fossil` stay filter-only. With that group_by, set `rollup_other=true` to fold the ungrouped tail (minor/unclassified energy_source_code values) into one `(other)` bucket for a tidy mix; storage (`MWH`) stays its own row (PD-004).",
      "groups": {
        "biomass": {
          "codes": [
            "AB",
            "BLQ",
            "LFG",
            "MSW",
            "OBG",
            "OBL",
            "OBS",
            "SLW",
            "WDL",
            "WDS"
          ],
          "label": "Biomass"
        },
        "coal": {
          "codes": [
            "ANT",
            "BIT",
            "LIG",
            "SUB",
            "RC",
            "WC"
          ],
          "label": "Coal"
        },
        "fossil": {
          "codes": [
            "ANT",
            "BIT",
            "LIG",
            "SUB",
            "RC",
            "WC",
            "NG",
            "DFO",
            "RFO",
            "KER",
            "JF",
            "WO",
            "PC"
          ],
          "composed_of": [
            "coal",
            "natural_gas",
            "petroleum"
          ],
          "label": "Fossil (coal + natural gas + petroleum)"
        },
        "geothermal": {
          "codes": [
            "GEO"
          ],
          "label": "Geothermal"
        },
        "hydro": {
          "codes": [
            "WAT"
          ],
          "label": "Hydro (includes pumped storage)"
        },
        "natural_gas": {
          "codes": [
            "NG"
          ],
          "label": "Natural gas"
        },
        "nuclear": {
          "codes": [
            "NUC"
          ],
          "label": "Nuclear"
        },
        "petroleum": {
          "codes": [
            "DFO",
            "RFO",
            "KER",
            "JF",
            "WO",
            "PC"
          ],
          "label": "Petroleum"
        },
        "solar": {
          "codes": [
            "SUN"
          ],
          "label": "Solar"
        },
        "wind": {
          "codes": [
            "WND"
          ],
          "label": "Wind"
        },
        "wood": {
          "codes": [
            "WDS",
            "WDL",
            "BLQ"
          ],
          "label": "Wood and wood waste"
        }
      }
    },
    "group_by": [
      "lifecycle",
      "state",
      "county_fips",
      "balancing_authority_code",
      "energy_source_code",
      "fuel_group",
      "prime_mover_code",
      "technology",
      "status_code",
      "operating_year",
      "planned_operation_year",
      "planned_retirement_year",
      "retirement_year"
    ],
    "ranking": {
      "no_ranking": "Omit order_by and top_n to return all groups in group-key order.",
      "order": {
        "default": "desc",
        "valid_values": [
          "desc",
          "asc"
        ]
      },
      "order_by": {
        "accepts": "one of output.metrics",
        "note": "Ranks the groups by a metric (a measure). Not a group_by dimension \u2014 rows already come back grouped by each group_by field.",
        "requires": [
          "group_by"
        ],
        "valid_values": [
          "nameplate_mw",
          "net_summer_mw",
          "net_winter_mw",
          "generator_count",
          "distinct_plant_count",
          "source_record_count"
        ]
      },
      "top_n": {
        "note": "Keeps the top N groups by order_by; the rest fold into one (other) remainder (additive metrics sum into it, non-additive ones are nulled) so the result still reconciles to summary.totals.",
        "requires": [
          "group_by",
          "order_by"
        ],
        "type": "positive integer"
      }
    }
  },
  "output": {
    "aggregate_citation_fields": [
      "source_id",
      "publisher",
      "source_url",
      "source_file",
      "raw_file_sha256",
      "as_of",
      "source_view",
      "source_rows_count",
      "source_rows_sample",
      "verify",
      "lineage_filter"
    ],
    "citation_fields": [
      "source_id",
      "source_url",
      "source_file",
      "sheet",
      "source_row",
      "raw_file_sha256",
      "as_of"
    ],
    "detail_fields": [
      "source_id",
      "report_month",
      "as_of",
      "lifecycle",
      "sheet_name",
      "region_scope",
      "included_in_default_us_metrics",
      "source_record_key",
      "source_row_number",
      "eia_entity_id",
      "entity_name",
      "eia_plant_id",
      "plant_name",
      "generator_id",
      "unit_code",
      "state",
      "county",
      "county_fips",
      "balancing_authority_code",
      "lat",
      "lon",
      "sector",
      "technology",
      "energy_source_code",
      "prime_mover_code",
      "nameplate_mw",
      "net_summer_mw",
      "net_winter_mw",
      "nameplate_energy_mwh",
      "dc_net_capacity_mw",
      "status_raw",
      "status_code",
      "operating_year",
      "operating_month",
      "operating_date",
      "planned_operation_year",
      "planned_operation_month",
      "planned_operation_date",
      "planned_retirement_year",
      "planned_retirement_month",
      "planned_retirement_date",
      "retirement_year",
      "retirement_month",
      "retirement_date",
      "raw_file_sha256",
      "citation"
    ],
    "metric_groups": {
      "capacity_mw": [
        "nameplate_mw",
        "net_summer_mw",
        "net_winter_mw"
      ],
      "entities": [
        "distinct_plant_count"
      ],
      "records": [
        "generator_count",
        "source_record_count"
      ]
    },
    "metric_metadata": {
      "distinct_plant_count": {
        "additive_across_groups": false,
        "aggregation": "count_distinct",
        "authoritative_total_path": "summary.totals.distinct_plant_count",
        "category": "entities",
        "definition": "Count of distinct EIA plant IDs within the current result scope.",
        "description": "Distinct EIA plant IDs contributing to the current row or summary scope.",
        "display_name": "Distinct plant count",
        "display_precision": "Integer.",
        "grain": "result scope",
        "null_handling": "Always an integer count.",
        "rollup_behavior": "distinct_entity_count_not_additive",
        "row_metric_path": "rows[].metrics.distinct_plant_count",
        "source_fields": [
          "eia_plant_id"
        ],
        "unit": "count"
      },
      "generator_count": {
        "additive_across_groups": true,
        "aggregation": "count source records",
        "authoritative_total_path": "summary.totals.generator_count",
        "category": "records",
        "definition": "Count of normalized generator records within the current result scope.",
        "description": "Number of generator records contributing to the row or total.",
        "display_name": "Generator count",
        "display_precision": "Integer.",
        "grain": "generator record",
        "null_handling": "Always an integer count.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.generator_count",
        "source_fields": [
          "source_record_key"
        ],
        "unit": "count"
      },
      "nameplate_mw": {
        "additive_across_groups": true,
        "aggregation": "sum",
        "authoritative_total_path": "summary.totals.nameplate_mw",
        "category": "capacity_mw",
        "definition": "Sum of EIA-reported generator nameplate capacity within the current result scope.",
        "description": "Sum of EIA-reported generator nameplate capacity.",
        "display_name": "Nameplate capacity",
        "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.",
        "grain": "generator record",
        "null_handling": "Null source values are ignored by the sum; a matched group with only null source values returns null; an empty-query summary returns zero.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.nameplate_mw",
        "source_fields": [
          "nameplate_mw"
        ],
        "unit": "MW"
      },
      "net_summer_mw": {
        "additive_across_groups": true,
        "aggregation": "sum",
        "authoritative_total_path": "summary.totals.net_summer_mw",
        "category": "capacity_mw",
        "definition": "Sum of EIA-reported generator net summer capacity within the current result scope.",
        "description": "Sum of EIA-reported net summer capacity.",
        "display_name": "Net summer capacity",
        "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.",
        "grain": "generator record",
        "null_handling": "Null source values are ignored by the sum; a matched group with only null source values returns null; an empty-query summary returns zero.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.net_summer_mw",
        "source_fields": [
          "net_summer_mw"
        ],
        "unit": "MW"
      },
      "net_winter_mw": {
        "additive_across_groups": true,
        "aggregation": "sum",
        "authoritative_total_path": "summary.totals.net_winter_mw",
        "category": "capacity_mw",
        "definition": "Sum of EIA-reported generator net winter capacity within the current result scope.",
        "description": "Sum of EIA-reported net winter capacity.",
        "display_name": "Net winter capacity",
        "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.",
        "grain": "generator record",
        "null_handling": "Null source values are ignored by the sum; a matched group with only null source values returns null; an empty-query summary returns zero.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.net_winter_mw",
        "source_fields": [
          "net_winter_mw"
        ],
        "unit": "MW"
      },
      "source_record_count": {
        "additive_across_groups": true,
        "aggregation": "count source records",
        "authoritative_total_path": "summary.totals.source_record_count",
        "category": "records",
        "definition": "Count of normalized source rows contributing to the current result scope.",
        "description": "Number of normalized EIA-860M source rows contributing to the value.",
        "display_name": "Source record count",
        "display_precision": "Integer.",
        "grain": "source row",
        "null_handling": "Always an integer count.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.source_record_count",
        "source_fields": [
          "source_record_key"
        ],
        "unit": "count"
      }
    },
    "metrics": [
      "nameplate_mw",
      "net_summer_mw",
      "net_winter_mw",
      "generator_count",
      "distinct_plant_count",
      "source_record_count"
    ],
    "summary_fields": [
      "group_count",
      "totals"
    ]
  },
  "primitive": "query_power_capacity_v1",
  "status": "available"
}
