Thermal Power · Schema

Thermal Power Plant Record

Operational data record for a thermal power generation facility, including generation output, fuel consumption, and heat rate metrics.

EnergyThermal PowerPower GenerationElectricityCoalNatural GasNuclear

Properties

Name Type Description
period string Time period of the record in YYYY-MM format.
plantCode string EIA plant identifier code.
plantName string Name of the power plant.
state string US state abbreviation where the plant is located.
fuel2002 string EIA fuel type code (e.g., NG for natural gas, COL for coal, DFO for distillate fuel oil, NUC for nuclear).
fuelTypeDescription string Human-readable fuel type description.
generation number Net electricity generation in megawatthours (MWh).
totalConsumption number Total fuel consumption in physical units.
heatContent number Heat content of fuel consumed in million British Thermal Units (MMBtu).
heatRate number Heat rate in BTU per net kWh generated. Lower values indicate higher efficiency.
capacityMW number Nameplate generating capacity in megawatts (MW).
primeMover string Prime mover type code.
sectorId string Sector identifier (1=Electric utility, 2=IPP non-CHP, 3=IPP CHP, 4=Commercial non-CHP, 5=Commercial CHP, 6=Industrial non-CHP, 7=Industrial CHP).
View JSON Schema on GitHub

JSON Schema

thermal-power-plant-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/api-evangelist/thermal-power/blob/main/json-schema/thermal-power-plant-schema.json",
  "title": "Thermal Power Plant Record",
  "description": "Operational data record for a thermal power generation facility, including generation output, fuel consumption, and heat rate metrics.",
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "description": "Time period of the record in YYYY-MM format.",
      "pattern": "^\\d{4}(-\\d{2})?$"
    },
    "plantCode": {
      "type": "string",
      "description": "EIA plant identifier code."
    },
    "plantName": {
      "type": "string",
      "description": "Name of the power plant."
    },
    "state": {
      "type": "string",
      "description": "US state abbreviation where the plant is located.",
      "pattern": "^[A-Z]{2}$"
    },
    "fuel2002": {
      "type": "string",
      "description": "EIA fuel type code (e.g., NG for natural gas, COL for coal, DFO for distillate fuel oil, NUC for nuclear)."
    },
    "fuelTypeDescription": {
      "type": "string",
      "description": "Human-readable fuel type description."
    },
    "generation": {
      "type": "number",
      "description": "Net electricity generation in megawatthours (MWh).",
      "minimum": 0
    },
    "totalConsumption": {
      "type": "number",
      "description": "Total fuel consumption in physical units.",
      "minimum": 0
    },
    "heatContent": {
      "type": "number",
      "description": "Heat content of fuel consumed in million British Thermal Units (MMBtu).",
      "minimum": 0
    },
    "heatRate": {
      "type": "number",
      "description": "Heat rate in BTU per net kWh generated. Lower values indicate higher efficiency.",
      "minimum": 0
    },
    "capacityMW": {
      "type": "number",
      "description": "Nameplate generating capacity in megawatts (MW).",
      "minimum": 0
    },
    "primeMover": {
      "type": "string",
      "description": "Prime mover type code.",
      "enum": ["ST", "GT", "IC", "CA", "CS", "CT", "OT"]
    },
    "sectorId": {
      "type": "string",
      "description": "Sector identifier (1=Electric utility, 2=IPP non-CHP, 3=IPP CHP, 4=Commercial non-CHP, 5=Commercial CHP, 6=Industrial non-CHP, 7=Industrial CHP)."
    }
  }
}