PUDL Data Dictionary#

The following data tables have been cleaned and transformed by our ETL process.

out_eia860__yearly_emissions_control_equipment#

The cost, type, operating status, retirement date, and install year of emissions control equipment reported to EIA. Includes control ids for sulfur dioxide (SO2), particulate matter, mercury, nitrogen oxide (NOX), and acid (HCl) gas monitoring. The denormalized version contains plant name, utility id, pudl id, and utility name columns. Browse or query this table in Datasette.

Field Name

Type

Description

acid_gas_control

boolean

Indicates whether the emissions control equipment controls acid (HCl) gas.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

emission_control_equipment_cost

number

The total cost to install a piece of emission control equipment.

emission_control_equipment_type_code

string

Short code indicating the type of emission control equipment installed.

emission_control_id_pudl

number

A PUDL-generated ID used to distinguish emission control units in the same report year and plant id. This ID should not be used to track units over time or between plants.

emission_control_operating_date

date

The date a piece of emissions control equipment began operating. Derived from month and year columns in the raw data.

emission_control_retirement_date

date

The expected or actual retirement date for a piece of emissions control equipment. Derived from month and year columns in the raw data.

mercury_control_id_eia

string

Mercury control identification number. This ID is not a unique identifier.

nox_control_id_eia

string

Nitrogen oxide control identification number. This ID is not a unique identifier.

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_code

string

The operating status of the asset.

particulate_control_id_eia

string

Particulate matter control identification number. This ID is not a unique identifier.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_year

integer

Four-digit year in which the data was reported.

so2_control_id_eia

string

Sulfur dioxide control identification number. This ID is not a unique identifier.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia860__yearly_ownership#

Generator Ownership, reported in EIA-860 Schedule 4. Includes only jointly or third-party owned generators. Denormalized to include plant and utility names and other associated IDs. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

fraction_owned

number

Proportion of generator ownership attributable to this utility.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

owner_city

string

City of owner.

owner_country

string

Three letter ISO-3166 country code.

owner_state

string

Two letter ISO-3166 political subdivision code.

owner_street_address

string

Steet address of owner.

owner_utility_id_eia

integer

The EIA utility Identification number for the owner company that is responsible for the day-to-day operations of the generator, not the operator utility.

owner_utility_name_eia

string

The name of the EIA owner utility.

owner_zip_code

string

Zip code of owner.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

out_eia861__compiled_geometry_balancing_authorities#

County-level spatial data for EIA861 balancing authorities. Browse or query this table in Datasette.

Field Name

Type

Description

area_km2

number

County area in km2.

balancing_authority_id_eia

integer

EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.

county

string

County name.

county_id_fips

string

County ID from the Federal Information Processing Standard Publication 6-4.

county_name_census

string

County name as specified in Census DP1 Data.

population

number

County population, sourced from Census DP1 data.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

state_id_fips

string

Two digit state FIPS code.

out_eia861__compiled_geometry_utilities#

County-level spatial data for EIA861 utilities. Browse or query this table in Datasette.

Field Name

Type

Description

area_km2

number

County area in km2.

county

string

County name.

county_id_fips

string

County ID from the Federal Information Processing Standard Publication 6-4.

county_name_census

string

County name as specified in Census DP1 Data.

population

number

County population, sourced from Census DP1 data.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

state_id_fips

string

Two digit state FIPS code.

utility_id_eia

integer

The EIA Utility Identification number.

out_eia923__boiler_fuel#

EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3.

Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units.

This table provides better coverage of the entire fleet of generators than the core_eia923__monthly_generation_fuel table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex.

Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

boiler_id

string

Alphanumeric boiler ID.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__fuel_receipts_costs#

Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A.

Each record describes an individual fuel delivery. There can be multiple deliveries of the same type of fuel from the same supplier to the same plant in a single month, so the table has no natural primary key.

There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units.

Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices.

Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

bulk_agg_fuel_cost_per_mmbtu

number

Fuel cost per mmbtu reported in the EIA bulk electricity data. This is an aggregate average fuel price for a whole state, region, month, sector, etc. Used to fill in missing fuel prices.

chlorine_content_ppm

number

For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.

coalmine_county_id_fips

string

County ID from the Federal Information Processing Standard Publication 6-4. This is the county where the coal mine is located.

contract_expiration_date

date

Date contract expires.Format: MMYY.

contract_type_code

string

Purchase type under which receipts occurred in the reporting month. C: Contract, NC: New Contract, S: Spot Purchase, T: Tolling Agreement.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_group_code

string

Fuel groups used in the Electric Power Monthly

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_received_units

number

Quanity of fuel received in tons, barrel, or Mcf.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

mercury_content_ppm

number

Mercury content in parts per million (ppm) to the nearest 0.001 ppm.

mine_id_msha

integer

MSHA issued mine identifier.

mine_name

string

Coal mine name.

mine_state

string

State where the coal mine is located. Two letter abbreviation.

mine_type_code

string

Type of coal mine.

moisture_content_pct

number

For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent.

natural_gas_delivery_contract_type_code

string

Contract type for natrual gas delivery service:

natural_gas_transport_code

string

Contract type for natural gas transportation service.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

primary_transportation_mode_code

string

Transportation mode for the longest distance transported.

report_date

date

Date reported.

secondary_transportation_mode_code

string

Transportation mode for the second longest distance transported.

state

string

Two letter US state abbreviation.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

supplier_name

string

Company that sold the fuel to the plant or, in the case of Natural Gas, pipline owner.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__generation#

EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3.

Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the core_eia923__monthly_generation_fuel appears in this table due to the different reporting requirements imposed on different types and sizes of generators.

Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations.

Note that a small number of respondents only report annual net generation, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__generation_fuel_combined#

EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3.

Denormalized, combined data from the core_eia923__monthly_generation_fuel and core_eia923__monthly_generation_fuel_nuclear with nuclear generation aggregated from the nuclear generation unit level up to the plant prime mover level, so as to be compatible with fossil fuel generation data. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_for_electricity_units

number

Consumption for electric generation of the fuel type in physical unit.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_aer

string

A partial aggregation of the reported fuel type codes into larger categories used by EIA in, for example, the Annual Energy Review (AER). Two or three letter alphanumeric.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__monthly_boiler_fuel#

EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3.

Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units.

This table provides better coverage of the entire fleet of generators than the core_eia923__monthly_generation_fuel table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex.

Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

boiler_id

string

Alphanumeric boiler ID.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__monthly_fuel_receipts_costs#

Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A.

Each record describes an individual fuel delivery. There can be multiple deliveries of the same type of fuel from the same supplier to the same plant in a single month, so the table has no natural primary key.

There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units.

Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices.

Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

chlorine_content_ppm

number

For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_received_units

number

Quanity of fuel received in tons, barrel, or Mcf.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

mercury_content_ppm

number

Mercury content in parts per million (ppm) to the nearest 0.001 ppm.

moisture_content_pct

number

For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__monthly_generation#

EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3.

Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the core_eia923__monthly_generation_fuel appears in this table due to the different reporting requirements imposed on different types and sizes of generators.

Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations.

Note that a small number of respondents only report annual net generation, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__monthly_generation_fuel_by_generator#

Monthly estimated net generation and fuel consumption by generator. Based on allocating net electricity generation and fuel consumption reported in the EIA-923 generation and generation_fuel tables to individual generators. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__monthly_generation_fuel_by_generator_energy_source#

Monthly estimated net generation and fuel consumption associated with each combination of generator, energy source, and prime mover. First, the net electricity generation and fuel consumption reported in the EIA-923 generation fuel are allocated to individual generators. Then, these allocations are aggregated to unique generator, prime mover, and energy source code combinations. This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity. Browse or query this table in Datasette.

Field Name

Type

Description

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

energy_source_code_num

string

Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

out_eia923__monthly_generation_fuel_combined#

EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3.

Denormalized, combined data from the core_eia923__monthly_generation_fuel and core_eia923__monthly_generation_fuel_nuclear with nuclear generation aggregated from the nuclear generation unit level up to the plant prime mover level, so as to be compatible with fossil fuel generation data. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_for_electricity_units

number

Consumption for electric generation of the fuel type in physical unit.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__yearly_boiler_fuel#

EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3.

Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units.

This table provides better coverage of the entire fleet of generators than the core_eia923__monthly_generation_fuel table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex.

Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

boiler_id

string

Alphanumeric boiler ID.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__yearly_fuel_receipts_costs#

Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A.

Each record describes an individual fuel delivery. There can be multiple deliveries of the same type of fuel from the same supplier to the same plant in a single month, so the table has no natural primary key.

There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units.

Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices.

Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

chlorine_content_ppm

number

For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_received_units

number

Quanity of fuel received in tons, barrel, or Mcf.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

mercury_content_ppm

number

Mercury content in parts per million (ppm) to the nearest 0.001 ppm.

moisture_content_pct

number

For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__yearly_generation#

EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3.

Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the core_eia923__monthly_generation_fuel appears in this table due to the different reporting requirements imposed on different types and sizes of generators.

Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations.

Note that a small number of respondents only report annual net generation, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__yearly_generation_fuel_by_generator#

Yearly estimated net generation and fuel consumption by generator. Based on allocating net electricity generation and fuel consumption reported in the EIA-923 generation and generation_fuel tables to individual generators. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia923__yearly_generation_fuel_by_generator_energy_source#

Yearly estimated net generation and fuel consumption associated with each combination of generator, energy source, and prime mover. First, the net electricity generation and fuel consumption reported in the EIA-923 generation fuel are allocated to individual generators. Then, these allocations are aggregated to unique generator, prime mover, and energy source code combinations. This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity. Browse or query this table in Datasette.

Field Name

Type

Description

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

energy_source_code_num

string

Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

out_eia923__yearly_generation_fuel_by_generator_energy_source_owner#

Yearly estimated net generation and fuel consumption for each generator, associated with each combination of generator, energy source, prime mover, and owner. First, the net electricity generation and fuel consumption reported in the EIA-923 generation fuel are allocated to individual generators. Then, these allocations are aggregated to unique generator, prime mover, energy source code, and owner combinations. Note that the utility_id_eia in this table refers to the OWNER of the generator, not the operator. This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

energy_source_code_num

string

Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record.

fraction_owned

number

Proportion of generator ownership attributable to this utility.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

ownership_record_type

string

Whether each generator record is for one owner or represents a total of all ownerships.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

utility_id_eia

integer

The EIA Utility Identification number.

out_eia923__yearly_generation_fuel_combined#

EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3.

Denormalized, combined data from the core_eia923__monthly_generation_fuel and core_eia923__monthly_generation_fuel_nuclear with nuclear generation aggregated from the nuclear generation unit level up to the plant prime mover level, so as to be compatible with fossil fuel generation data. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_for_electricity_units

number

Consumption for electric generation of the fuel type in physical unit.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia__monthly_generators#

Monthly all generator attributes including calculated capacity factor, heat rate, fuel cost per MMBTU and fuel cost. Browse or query this table in Datasette.

Field Name

Type

Description

associated_combined_heat_power

boolean

Indicates whether the generator is associated with a combined heat and power system

bga_source

string

The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections).

bypass_heat_recovery

boolean

Can this generator operate while bypassing the heat recovery steam generator?

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

carbon_capture

boolean

Indicates whether the generator uses carbon capture technology.

city

string

Name of the city.

cofire_fuels

boolean

Can the generator co-fire fuels?.

county

string

County name.

current_planned_generator_operating_date

date

The most recently updated effective date on which the generator is scheduled to start operation

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

deliver_power_transgrid

boolean

Indicate whether the generator can deliver power to the transmission grid.

distributed_generation

boolean

Whether the generator is considered distributed generation

duct_burners

boolean

Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas

energy_source_1_transport_1

string

Primary mode of transport for energy source 1.

energy_source_1_transport_2

string

Secondary mode of transport for energy source 1.

energy_source_1_transport_3

string

Tertiary mode of transport for energy source 1.

energy_source_2_transport_1

string

Primary mode of transport for energy source 2.

energy_source_2_transport_2

string

Secondary mode of transport for energy source 2.

energy_source_2_transport_3

string

Tertiary mode of transport for energy source 2.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

energy_source_code_2

string

The code representing the second most predominant type of energy that fuels the generator

energy_source_code_3

string

The code representing the third most predominant type of energy that fuels the generator

energy_source_code_4

string

The code representing the fourth most predominant type of energy that fuels the generator

energy_source_code_5

string

The code representing the fifth most predominant type of energy that fuels the generator

energy_source_code_6

string

The code representing the sixth most predominant type of energy that fuels the generator

energy_storage_capacity_mwh

number

Energy storage capacity in MWh (e.g. for batteries).

ferc_qualifying_facility

boolean

Indicatates whether or not a generator is a qualifying FERC cogeneation facility.

fluidized_bed_tech

boolean

Indicates whether the generator uses fluidized bed technology

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_date

date

Date the generator began commercial operation.

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

latitude

number

Latitude of the plant's location, in degrees.

longitude

number

Longitude of the plant's location, in degrees.

minimum_load_mw

number

The minimum load at which the generator can operate at continuosuly.

multiple_fuels

boolean

Can the generator burn multiple fuels?

nameplate_power_factor

number

The nameplate power factor of the generator.

net_capacity_mwdc

number

Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

operating_switch

string

Indicates whether the fuel switching generator can switch when operating

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_code

string

The operating status of the asset.

original_planned_generator_operating_date

date

The date the generator was originally scheduled to be operational

other_combustion_tech

boolean

Indicates whether the generator uses other combustion technologies

other_modifications_date

date

Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete.

other_planned_modifications

boolean

Indicates whether there are there other modifications planned for the generator.

owned_by_non_utility

boolean

Whether any part of generator is owned by a nonutilty

ownership_code

string

Identifies the ownership for each generator.

planned_derate_date

date

Planned effective month that the generator is scheduled to enter operation after the derate modification.

planned_energy_source_code_1

string

New energy source code for the planned repowered generator.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

planned_modifications

boolean

Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years.

planned_net_summer_capacity_derate_mw

number

Decrease in summer capacity expected to be realized from the derate modification to the equipment.

planned_net_summer_capacity_uprate_mw

number

Increase in summer capacity expected to be realized from the modification to the equipment.

planned_net_winter_capacity_derate_mw

number

Decrease in winter capacity expected to be realized from the derate modification to the equipment.

planned_net_winter_capacity_uprate_mw

number

Increase in winter capacity expected to be realized from the uprate modification to the equipment.

planned_new_capacity_mw

number

The expected new namplate capacity for the generator.

planned_new_prime_mover_code

string

New prime mover for the planned repowered generator.

planned_repower_date

date

Planned effective date that the generator is scheduled to enter operation after the repowering is complete.

planned_uprate_date

date

Planned effective date that the generator is scheduled to enter operation after the uprate modification.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

previously_canceled

boolean

Indicates whether the generator was previously reported as indefinitely postponed or canceled

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

pulverized_coal_tech

boolean

Indicates whether the generator uses pulverized coal technology

reactive_power_output_mvar

number

Reactive Power Output (MVAr)

report_date

date

Date reported.

rto_iso_lmp_node_id

string

The designation used to identify the price node in RTO/ISO Locational Marginal Price reports

rto_iso_location_wholesale_reporting_id

string

The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report

solid_fuel_gasification

boolean

Indicates whether the generator is part of a solid fuel gasification system

startup_source_code_1

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_2

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_3

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_4

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

state

string

Two letter US state abbreviation.

stoker_tech

boolean

Indicates whether the generator uses stoker technology

street_address

string

Physical street address.

subcritical_tech

boolean

Indicates whether the generator uses subcritical technology

summer_capacity_estimate

boolean

Whether the summer capacity value was an estimate

summer_capacity_mw

number

The net summer capacity.

summer_estimated_capability_mw

number

EIA estimated summer capacity (in MWh).

supercritical_tech

boolean

Indicates whether the generator uses supercritical technology

switch_oil_gas

boolean

Indicates whether the generator switch between oil and natural gas.

syncronized_transmission_grid

boolean

Indicates whether standby generators (SB status) can be synchronized to the grid.

technology_description

string

High level description of the technology used by the generator to produce electricity.

time_cold_shutdown_full_load_code

string

The minimum amount of time required to bring the unit to full load from shutdown.

timezone

string

IANA timezone name

topping_bottoming_code

string

If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

turbines_inverters_hydrokinetics

integer

Number of wind turbines, or hydrokinetic buoys.

turbines_num

integer

Number of wind turbines, or hydrokinetic buoys.

ultrasupercritical_tech

boolean

Indicates whether the generator uses ultra-supercritical technology

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

uprate_derate_completed_date

date

The date when the uprate or derate was completed.

uprate_derate_during_year

boolean

Was an uprate or derate completed on this generator during the reporting year?

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

winter_capacity_estimate

boolean

Whether the winter capacity value was an estimate

winter_capacity_mw

number

The net winter capacity.

winter_estimated_capability_mw

number

EIA estimated winter capacity (in MWh).

zip_code

string

Five digit US Zip Code.

out_eia__yearly_boilers#

Denormalized table containing all EIA boiler attributes. Browse or query this table in Datasette.

Field Name

Type

Description

air_flow_100pct_load_cubic_feet_per_minute

number

Total air flow including excess air at 100 percent load, reported at standard temperature and pressure (i.e. 68 F and one atmosphere pressure).

boiler_fuel_code_1

string

The code representing the most predominant type of energy that fuels the boiler.

boiler_fuel_code_2

string

The code representing the second most predominant type of energy that fuels the boiler.

boiler_fuel_code_3

string

The code representing the third most predominant type of energy that fuels the boiler.

boiler_fuel_code_4

string

The code representing the fourth most predominant type of energy that fuels the boiler.

boiler_id

string

Alphanumeric boiler ID.

boiler_manufacturer

string

Name of boiler manufacturer.

boiler_manufacturer_code

string

EIA short code for boiler manufacturer.

boiler_operating_date

date

Date the boiler began or is planned to begin commercial operation.

boiler_retirement_date

date

Date of the scheduled or effected retirement of the boiler.

boiler_status

string

EIA short code identifying boiler operational status.

boiler_type

string

EIA short code indicating the standards under which the boiler is operating as described in the U.S. EPA regulation under 40 CFR.

city

string

Name of the city.

compliance_year_mercury

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for mercury emissions.

compliance_year_nox

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for nitrogen oxide emissions.

compliance_year_particulate

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for particulate matter emissions.

compliance_year_so2

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for sulfur dioxide emissions.

county

string

County name.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

efficiency_100pct_load

number

Boiler efficiency percentage when burning at 100 percent load to the nearest 0.1 percent.

efficiency_50pct_load

number

Boiler efficiency percentage when burning at 50 percent load to the nearest 0.1 percent.

firing_rate_using_coal_tons_per_hour

number

Design firing rate at maximum continuous steam flow for coal to the nearest 0.1 ton per hour.

firing_rate_using_gas_mcf_per_hour

number

Design firing rate at maximum continuous steam flow for gas to the nearest 0.1 cubic feet per hour.

firing_rate_using_oil_bbls_per_hour

number

Design firing rate at maximum continuous steam flow for pet coke to the nearest 0.1 barrels per hour.

firing_rate_using_other_fuels

number

Design firing rate at maximum continuous steam flow for energy sources other than coal, petroleum, or natural gas.

firing_type_1

string

EIA short code indicating the type of firing used by this boiler.

firing_type_2

string

EIA short code indicating the type of firing used by this boiler.

firing_type_3

string

EIA short code indicating the type of firing used by this boiler.

fly_ash_reinjection

boolean

Indicates whether the boiler is capable of re-injecting fly ash.

hrsg

boolean

indicates if the boiler is a heat recovery steam generator (HRSG).

latitude

number

Latitude of the plant's location, in degrees.

longitude

number

Longitude of the plant's location, in degrees.

max_steam_flow_1000_lbs_per_hour

number

Maximum continuous steam flow at 100 percent load.

mercury_control_existing_strategy_1

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_2

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_3

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_4

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_5

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_6

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_proposed_strategy_1

string

Proposed strategy to comply with the most stringent mercury regulation.

mercury_control_proposed_strategy_2

string

Proposed strategy to comply with the most stringent mercury regulation.

mercury_control_proposed_strategy_3

string

Proposed strategy to comply with the most stringent mercury regulation.

new_source_review

boolean

Indicates whether the boiler is subject to New Source Review requirements.

new_source_review_date

date

Month of issued New Source Review permit.

new_source_review_permit

string

New Source Review permit number.

nox_control_existing_caaa_compliance_strategy_1

string

Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_existing_caaa_compliance_strategy_2

string

Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_existing_caaa_compliance_strategy_3

string

Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_existing_strategy_1

string

Existing strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_existing_strategy_2

string

Existing strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_existing_strategy_3

string

Existing strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_manufacturer

string

Name of nitrogen oxide control manufacturer.

nox_control_manufacturer_code

string

Code indicating the nitrogen oxide control burner manufacturer.

nox_control_out_of_compliance_strategy_1

string

If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance.

nox_control_out_of_compliance_strategy_2

string

If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance.

nox_control_out_of_compliance_strategy_3

string

If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance.

nox_control_planned_caaa_compliance_strategy_1

string

Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_planned_caaa_compliance_strategy_2

string

Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_planned_caaa_compliance_strategy_3

string

Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_proposed_strategy_1

string

Proposed strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_proposed_strategy_2

string

Proposed strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_proposed_strategy_3

string

Proposed strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_status_code

string

Nitrogen oxide control status code.

particulate_control_out_of_compliance_strategy_1

string

If boiler is not in compliance with particulate matter regulations, strategy for compliance.

particulate_control_out_of_compliance_strategy_2

string

If boiler is not in compliance with particulate matter regulations, strategy for compliance.

particulate_control_out_of_compliance_strategy_3

string

If boiler is not in compliance with particulate matter regulations, strategy for compliance.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

regulation_mercury

string

Most stringent type of statute or regulation code under which the boiler is operating for mercury control standards.

regulation_nox

string

EIA short code for most stringent type of statute or regulation code under which the boiler is operating for nitrogen oxide control standards.

regulation_particulate

string

EIA short code for most stringent type of statute or regulation code under which the boiler is operating for particulate matter control standards.

regulation_so2

string

EIA short code for most stringent type of statute or regulation code under which the boiler is operating for sulfur dioxide control standards.

report_date

date

Date reported.

so2_control_existing_caaa_compliance_strategy_1

string

Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_existing_caaa_compliance_strategy_2

string

Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_existing_caaa_compliance_strategy_3

string

Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_existing_strategy_1

string

Existing strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_existing_strategy_2

string

Existing strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_existing_strategy_3

string

Existing strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_out_of_compliance_strategy_1

string

If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance.

so2_control_out_of_compliance_strategy_2

string

If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance.

so2_control_out_of_compliance_strategy_3

string

If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance.

so2_control_planned_caaa_compliance_strategy_1

string

Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_planned_caaa_compliance_strategy_2

string

Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_planned_caaa_compliance_strategy_3

string

Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_proposed_strategy_1

string

Proposed strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_proposed_strategy_2

string

Proposed strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_proposed_strategy_3

string

Proposed strategy to comply with the most stringent sulfur dioxide regulation.

standard_nox_rate

number

Numeric value for the unit of measurement specified for nitrogen oxide.

standard_particulate_rate

number

Numeric value for the unit of measurement specified for particulate matter.

standard_so2_percent_scrubbed

number

The percent of sulfur dioxide to be scrubbed specified by the most stringent sulfur dioxide regulation.

standard_so2_rate

number

Numeric value for the unit of measurement specified for sulfur dioxide.

state

string

Two letter US state abbreviation.

street_address

string

Physical street address.

timezone

string

IANA timezone name

turndown_ratio

number

The turndown ratio for the boiler.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

unit_nox

string

Numeric value for the unit of measurement specified for nitrogen oxide.

unit_particulate

string

Numeric value for the unit of measurement specified for particulate matter.

unit_so2

string

Numeric value for the unit of measurement specified for sulfur dioxide.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

waste_heat_input_mmbtu_per_hour

number

Design waste-heat input rate at maximum continuous steam flow where a waste-heat boiler is a boiler that receives all or a substantial portion of its energy input from the noncumbustible exhaust gases of a separate fuel-burning process (MMBtu per hour).

wet_dry_bottom

string

Wet or Dry Bottom where Wet Bottom is defined as slag tanks that are installed at furnace throat to contain and remove molten ash from the furnace, and Dry Bottom is defined as having no slag tanks at furnace throat area, throat area is clear, and bottom ash drops through throat to bottom ash water hoppers.

zip_code

string

Five digit US Zip Code.

out_eia__yearly_generators#

Yearly all generator attributes including calculated capacity factor, heat rate, fuel cost per MMBTU and fuel cost. Browse or query this table in Datasette.

Field Name

Type

Description

associated_combined_heat_power

boolean

Indicates whether the generator is associated with a combined heat and power system

bga_source

string

The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections).

bypass_heat_recovery

boolean

Can this generator operate while bypassing the heat recovery steam generator?

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

carbon_capture

boolean

Indicates whether the generator uses carbon capture technology.

city

string

Name of the city.

cofire_fuels

boolean

Can the generator co-fire fuels?.

county

string

County name.

current_planned_generator_operating_date

date

The most recently updated effective date on which the generator is scheduled to start operation

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

deliver_power_transgrid

boolean

Indicate whether the generator can deliver power to the transmission grid.

distributed_generation

boolean

Whether the generator is considered distributed generation

duct_burners

boolean

Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas

energy_source_1_transport_1

string

Primary mode of transport for energy source 1.

energy_source_1_transport_2

string

Secondary mode of transport for energy source 1.

energy_source_1_transport_3

string

Tertiary mode of transport for energy source 1.

energy_source_2_transport_1

string

Primary mode of transport for energy source 2.

energy_source_2_transport_2

string

Secondary mode of transport for energy source 2.

energy_source_2_transport_3

string

Tertiary mode of transport for energy source 2.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

energy_source_code_2

string

The code representing the second most predominant type of energy that fuels the generator

energy_source_code_3

string

The code representing the third most predominant type of energy that fuels the generator

energy_source_code_4

string

The code representing the fourth most predominant type of energy that fuels the generator

energy_source_code_5

string

The code representing the fifth most predominant type of energy that fuels the generator

energy_source_code_6

string

The code representing the sixth most predominant type of energy that fuels the generator

energy_storage_capacity_mwh

number

Energy storage capacity in MWh (e.g. for batteries).

ferc_qualifying_facility

boolean

Indicatates whether or not a generator is a qualifying FERC cogeneation facility.

fluidized_bed_tech

boolean

Indicates whether the generator uses fluidized bed technology

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_date

date

Date the generator began commercial operation.

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

latitude

number

Latitude of the plant's location, in degrees.

longitude

number

Longitude of the plant's location, in degrees.

minimum_load_mw

number

The minimum load at which the generator can operate at continuosuly.

multiple_fuels

boolean

Can the generator burn multiple fuels?

nameplate_power_factor

number

The nameplate power factor of the generator.

net_capacity_mwdc

number

Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

operating_switch

string

Indicates whether the fuel switching generator can switch when operating

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_code

string

The operating status of the asset.

original_planned_generator_operating_date

date

The date the generator was originally scheduled to be operational

other_combustion_tech

boolean

Indicates whether the generator uses other combustion technologies

other_modifications_date

date

Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete.

other_planned_modifications

boolean

Indicates whether there are there other modifications planned for the generator.

owned_by_non_utility

boolean

Whether any part of generator is owned by a nonutilty

ownership_code

string

Identifies the ownership for each generator.

planned_derate_date

date

Planned effective month that the generator is scheduled to enter operation after the derate modification.

planned_energy_source_code_1

string

New energy source code for the planned repowered generator.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

planned_modifications

boolean

Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years.

planned_net_summer_capacity_derate_mw

number

Decrease in summer capacity expected to be realized from the derate modification to the equipment.

planned_net_summer_capacity_uprate_mw

number

Increase in summer capacity expected to be realized from the modification to the equipment.

planned_net_winter_capacity_derate_mw

number

Decrease in winter capacity expected to be realized from the derate modification to the equipment.

planned_net_winter_capacity_uprate_mw

number

Increase in winter capacity expected to be realized from the uprate modification to the equipment.

planned_new_capacity_mw

number

The expected new namplate capacity for the generator.

planned_new_prime_mover_code

string

New prime mover for the planned repowered generator.

planned_repower_date

date

Planned effective date that the generator is scheduled to enter operation after the repowering is complete.

planned_uprate_date

date

Planned effective date that the generator is scheduled to enter operation after the uprate modification.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

previously_canceled

boolean

Indicates whether the generator was previously reported as indefinitely postponed or canceled

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

pulverized_coal_tech

boolean

Indicates whether the generator uses pulverized coal technology

reactive_power_output_mvar

number

Reactive Power Output (MVAr)

report_date

date

Date reported.

rto_iso_lmp_node_id

string

The designation used to identify the price node in RTO/ISO Locational Marginal Price reports

rto_iso_location_wholesale_reporting_id

string

The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report

solid_fuel_gasification

boolean

Indicates whether the generator is part of a solid fuel gasification system

startup_source_code_1

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_2

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_3

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_4

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

state

string

Two letter US state abbreviation.

stoker_tech

boolean

Indicates whether the generator uses stoker technology

street_address

string

Physical street address.

subcritical_tech

boolean

Indicates whether the generator uses subcritical technology

summer_capacity_estimate

boolean

Whether the summer capacity value was an estimate

summer_capacity_mw

number

The net summer capacity.

summer_estimated_capability_mw

number

EIA estimated summer capacity (in MWh).

supercritical_tech

boolean

Indicates whether the generator uses supercritical technology

switch_oil_gas

boolean

Indicates whether the generator switch between oil and natural gas.

syncronized_transmission_grid

boolean

Indicates whether standby generators (SB status) can be synchronized to the grid.

technology_description

string

High level description of the technology used by the generator to produce electricity.

time_cold_shutdown_full_load_code

string

The minimum amount of time required to bring the unit to full load from shutdown.

timezone

string

IANA timezone name

topping_bottoming_code

string

If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

turbines_inverters_hydrokinetics

integer

Number of wind turbines, or hydrokinetic buoys.

turbines_num

integer

Number of wind turbines, or hydrokinetic buoys.

ultrasupercritical_tech

boolean

Indicates whether the generator uses ultra-supercritical technology

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

uprate_derate_completed_date

date

The date when the uprate or derate was completed.

uprate_derate_during_year

boolean

Was an uprate or derate completed on this generator during the reporting year?

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

winter_capacity_estimate

boolean

Whether the winter capacity value was an estimate

winter_capacity_mw

number

The net winter capacity.

winter_estimated_capability_mw

number

EIA estimated winter capacity (in MWh).

zip_code

string

Five digit US Zip Code.

out_eia__yearly_generators_by_ownership#

A mega table of all EIA generators with ownership integrated. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_eoy_mw

number

Total end of year installed (nameplate) capacity for a plant part, in megawatts.

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

ferc_acct_name

string

Name of FERC account, derived from technology description and prime mover code.

fraction_owned

number

Proportion of generator ownership attributable to this utility.

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_date

date

Date the generator began commercial operation.

generator_operating_year

integer

Year a generator went into service.

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_pudl

string

The operating status of the asset using PUDL categories.

ownership_record_type

string

Whether each generator record is for one owner or represents a total of all ownerships.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

technology_description

string

High level description of the technology used by the generator to produce electricity.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia__yearly_plant_parts#

Output table with the aggregation of all EIA plant parts. For use with matching to FERC 1.

Practically speaking, a plant is a collection of generator(s). There are many attributes of generators (i.e. prime mover, primary fuel source, technology type). We can use these generator attributes to group generator records into larger aggregate records which we call "plant parts". A plant part is a record which corresponds to a particular collection of generators that all share an identical attribute and utility owner. E.g. all of the generators with unit_id=2, or all of the generators with coal as their primary fuel source.

The EIA data about power plants (from EIA 923 and 860) is reported in tables with records that correspond to mostly generators and plants. Other datasets (cough cough FERC1) are less well organized and include plants, generators and other plant parts all in the same table without any clear labels. This plant part table is an attempt to create records corresponding to many different plant parts in order to connect specific slices of EIA plants to other datasets.

Because generators are often owned by multiple utilities, another dimension of this plant part table involves generating two records for each owner: one for the portion of the plant part they own and one for the plant part as a whole. The portion records are labeled in the ownership_record_type column as owned and the total records are labeled as total.

This table includes A LOT of duplicative information about EIA plants. It is primarily meant for use as an input into the record linkage between FERC1 plants and EIA. Browse or query this table in Datasette.

Field Name

Type

Description

appro_part_label

string

Plant part of the associated true granularity record.

appro_record_id_eia

string

EIA record ID of the associated true granularity record.

capacity_eoy_mw

number

Total end of year installed (nameplate) capacity for a plant part, in megawatts.

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

construction_year

integer

Year the plant's oldest still operational unit was built.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

ferc1_generator_agg_id

integer

ID dynamically assigned by PUDL to EIA records with multiple matches to a single FERC ID in the FERC-EIA manual matching process.

ferc_acct_name

string

Name of FERC account, derived from technology description and prime mover code.

fraction_owned

number

Proportion of generator ownership attributable to this utility.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_year

integer

Year a generator went into service.

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

installation_year

integer

Year the plant's most recently built unit was installed.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_pudl

string

The operating status of the asset using PUDL categories.

ownership_dupe

boolean

Whether a plant part record has a duplicate record with different ownership status.

ownership_record_type

string

Whether each generator record is for one owner or represents a total of all ownerships.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_id_report_year

string

PUDL plant ID and report year of the record.

plant_name_eia

string

Plant name.

plant_name_ppe

string

Derived plant name that includes EIA plant name and other strings associated with ID and PK columns of the plant part.

plant_part

string

The part of the plant a record corresponds to.

plant_part_id_eia

string

Contains EIA plant ID, plant part, ownership, and EIA utility id

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

record_count

integer

Number of distinct generator IDs that partcipated in the aggregation for a plant part list record.

record_id_eia

string

Identifier for EIA plant parts analysis records.

report_date

date

Date reported.

report_year

integer

Four-digit year in which the data was reported.

technology_description

string

High level description of the technology used by the generator to produce electricity.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

true_gran

boolean

Indicates whether a plant part list record is associated with the highest priority plant part for all identical records.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

out_eia__yearly_plants#

Denormalized table containing all EIA plant attributes. Browse or query this table in Datasette.

Field Name

Type

Description

ash_impoundment

boolean

Is there an ash impoundment (e.g. pond, reservoir) at the plant?

ash_impoundment_lined

boolean

If there is an ash impoundment at the plant, is the impoundment lined?

ash_impoundment_status

string

If there is an ash impoundment at the plant, the ash impoundment status as of December 31 of the reporting year.

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

balancing_authority_code_eia_consistent_rate

number

Percentage consistency of balancing authority code across entity records.

balancing_authority_name_eia

string

Name of the balancing authority.

city

string

Name of the city.

county

string

County name.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

datum

string

Geodetic coordinate system identifier (e.g. NAD27, NAD83, or WGS84).

energy_storage

boolean

Indicates if the facility has energy storage capabilities.

ferc_cogen_docket_no

string

The docket number relating to the FERC cogenerator status. See FERC Form 556.

ferc_cogen_status

boolean

Indicates whether the plant has FERC qualifying facility cogenerator status. See FERC Form 556.

ferc_exempt_wholesale_generator

boolean

Indicates whether the plant has FERC qualifying facility exempt wholesale generator status

ferc_exempt_wholesale_generator_docket_no

string

The docket number relating to the FERC qualifying facility exempt wholesale generator status.

ferc_qualifying_facility_docket_no

string

The docket number relating to the FERC qualifying facility cogenerator status. See FERC Form 556.

ferc_small_power_producer

boolean

Indicates whether the plant has FERC qualifying facility small power producer status. See FERC Form 556.

ferc_small_power_producer_docket_no

string

The docket number relating to the FERC qualifying facility small power producer status. See FERC Form 556.

grid_voltage_1_kv

number

Plant's grid voltage at point of interconnection to transmission or distibution facilities

grid_voltage_2_kv

number

Plant's grid voltage at point of interconnection to transmission or distibution facilities

grid_voltage_3_kv

number

Plant's grid voltage at point of interconnection to transmission or distibution facilities

iso_rto_code

string

The code of the plant's ISO or RTO. NA if not reported in that year.

latitude

number

Latitude of the plant's location, in degrees.

liquefied_natural_gas_storage

boolean

Indicates if the facility have the capability to store the natural gas in the form of liquefied natural gas.

longitude

number

Longitude of the plant's location, in degrees.

natural_gas_local_distribution_company

string

Names of Local Distribution Company (LDC), connected to natural gas burning power plants.

natural_gas_pipeline_name_1

string

The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility.

natural_gas_pipeline_name_2

string

The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility.

natural_gas_pipeline_name_3

string

The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility.

natural_gas_storage

boolean

Indicates if the facility have on-site storage of natural gas.

nerc_region

string

NERC region in which the plant is located

net_metering

boolean

Did this plant have a net metering agreement in effect during the reporting year? (Only displayed for facilities that report the sun or wind as an energy source). This field was only reported up until 2015

pipeline_notes

string

Additional owner or operator of natural gas pipeline.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

primary_purpose_id_naics

integer

North American Industry Classification System (NAICS) code that best describes the primary purpose of the reporting plant

regulatory_status_code

string

Indicates whether the plant is regulated or non-regulated.

report_date

date

Date reported.

reporting_frequency_code

string

Code that specifies what time period data has to be reported (i.e. monthly data or annual totals) and how often the power plant reports this data to EIA. See reporting_frequencies_eia for more details.

sector_id_eia

integer

EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status

sector_name_eia

string

EIA assigned sector name, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status

service_area

string

Service area in which plant is located; for unregulated companies, it's the electric utility with which plant is interconnected

state

string

Two letter US state abbreviation.

street_address

string

Physical street address.

timezone

string

IANA timezone name

transmission_distribution_owner_id

integer

EIA-assigned code for owner of transmission/distribution system to which the plant is interconnected.

transmission_distribution_owner_name

string

Name of the owner of the transmission or distribution system to which the plant is interconnected.

transmission_distribution_owner_state

string

State location for owner of transmission/distribution system to which the plant is interconnected.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

water_source

string

Name of water source associated with the plant.

zip_code

string

Five digit US Zip Code.

out_eia__yearly_utilities#

Denormalized table containing all EIA utility attributes. Browse or query this table in Datasette.

Field Name

Type

Description

address_2

string

Second line of the address.

attention_line

string

Mail attention name of the operator/owner.

city

string

Name of the city.

contact_firstname

string

First name of utility contact 1.

contact_firstname_2

string

First name of utility contact 2.

contact_lastname

string

Last name of utility contact 1.

contact_lastname_2

string

Last name of utility contact 2.

contact_title

string

Title of of utility contact 1.

contact_title_2

string

Title of utility contact 2.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

entity_type

string

Entity type of principal owner.

phone_extension

string

Phone extension for utility contact 1

phone_extension_2

string

Phone extension for utility contact 2

phone_number

string

Phone number for utility contact 1.

phone_number_2

string

Phone number for utility contact 2.

plants_reported_asset_manager

boolean

Is the reporting entity an asset manager of power plants reported on Schedule 2 of the form?

plants_reported_operator

boolean

Is the reporting entity an operator of power plants reported on Schedule 2 of the form?

plants_reported_other_relationship

boolean

Does the reporting entity have any other relationship to the power plants reported on Schedule 2 of the form?

plants_reported_owner

boolean

Is the reporting entity an owner of power plants reported on Schedule 2 of the form?

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

street_address

string

Physical street address.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

zip_code

string

Five digit US Zip Code.

zip_code_4

string

Four digit US Zip Code suffix.

out_ferc1__yearly_all_plants#

Denormalized table combining the steam, small generators, hydro, and pumped storage tables from FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_annual_addition

number

Annual capital addition into capex_total.

capex_annual_addition_rolling

number

Year-to-date capital addition into capex_total.

capex_annual_per_kw

number

Annual capital addition into capex_total per kw.

capex_annual_per_mw

number

Annual capital addition into capex_total per MW.

capex_annual_per_mw_rolling

number

Year-to-date capital addition into capex_total per MW.

capex_annual_per_mwh

number

Annual capital addition into capex_total per MWh.

capex_annual_per_mwh_rolling

number

Year-to-date capital addition into capex_total per MWh.

capex_equipment

number

Cost of plant: equipment (USD).

capex_equipment_electric

number

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

number

Cost of plant: miscellaneous power plant equipment (USD).

capex_facilities

number

Cost of plant: reservoirs, dams, and waterways (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_roads

number

Cost of plant: roads, railroads, and bridges (USD).

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

capex_wheels_turbines_generators

number

Cost of plant: water wheels, turbines, and generators (USD).

capex_wo_retirement_total

number

Total cost of plant (USD) without retirements.

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

energy_used_for_pumping_mwh

number

Energy used for pumping, in megawatt-hours.

ferc_license_id

string

The FERC license ID of a project.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type

string

Type of fuel.

installation_year

integer

Year the plant's most recently built unit was installed.

license_id_ferc1

integer

FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible.

net_capacity_adverse_conditions_mw

number

Net plant capability under the least favorable operating conditions, in megawatts.

net_capacity_favorable_conditions_mw

number

Net plant capability under the most favorable operating conditions, in megawatts.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

net_load_mwh

number

Net output for load (net generation - energy used for pumping) in megawatt-hours.

not_water_limited_capacity_mw

number

Plant capacity in MW when not limited by condenser water.

opex_allowances

number

Allowances.

opex_boiler

number

Maintenance of boiler (or reactor) plant.

opex_coolants

number

Cost of coolants and water (nuclear plants only)

opex_dams

number

Production expenses: maintenance of reservoirs, dams, and waterways (USD).

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_fuel

number

Production expenses: fuel (USD).

opex_generation_misc

number

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

number

Production expenses: hydraulic expenses (USD).

opex_maintenance

number

Production expenses: Maintenance (USD).

opex_misc_plant

number

Production expenses: maintenance of miscellaneous hydraulic plant (USD).

opex_misc_power

number

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

number

Maintenance of miscellaneous steam (or nuclear) plant.

opex_nonfuel_per_mwh

number

Investments in non-fuel production expenses per Mwh.

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plant

number

Production expenses: maintenance of electric plant (USD).

opex_production_before_pumping

number

Total production expenses before pumping (USD).

opex_production_total

number

Total operating expenses.

opex_pumped_storage

number

Production expenses: pumped storage (USD).

opex_pumping

number

Production expenses: We are here to PUMP YOU UP! (USD).

opex_rents

number

Production expenses: rents (USD).

opex_steam

number

Steam expenses.

opex_steam_other

number

Steam from other sources.

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

number

Total production expenses, excluding fuel (USD).

opex_transfer

number

Steam transferred (Credit).

opex_water_for_power

number

Production expenses: water for power (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_capability_mw

number

Net plant capability in megawatts.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_id_ferc1

integer

Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

water_limited_capacity_mw

number

Plant capacity in MW when limited by condenser water.

out_ferc1__yearly_balance_sheet_assets_sched110#

Denormalized table that contains FERC balance sheet asset information. Browse or query this table in Datasette.

Field Name

Type

Description

asset_type

string

Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_balance_sheet_liabilities_sched110#

Denormalized table that contains FERC balance sheet liability information. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

liability_type

string

Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_cash_flows_sched120#

Denormalized table that contains FERC cash flow information. Browse or query this table in Datasette.

Field Name

Type

Description

amount

number

Reported amount of dollars. This could be a balance or a change in value.

amount_type

string

Label describing the type of amount being reported. This could be a balance or a change in value.

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_depreciation_by_function_sched219#

Denormalized accumulated provision for depreciation of electric utility plant (Account 108). Schedule 219 Section B: Functional plant classifications. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

depreciation_type

string

Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.

ending_balance

number

Account balance at end of year.

plant_function

string

Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).

plant_status

string

Utility plant financial status (in service, future, leased, total).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_depreciation_changes_sched219#

Denormalized table that contains FERC electric plant depreciation changes information. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

depreciation_type

string

Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

plant_status

string

Utility plant financial status (in service, future, leased, total).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_depreciation_summary_sched336#

Denormalized table that contains FERC depreciation amortization information. Browse or query this table in Datasette.

Field Name

Type

Description

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

ferc_account_label

string

Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.

plant_function

string

Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_energy_dispositions_sched401#

Denormalized table that contains FERC electric energy dispositions information. Browse or query this table in Datasette.

Field Name

Type

Description

energy_disposition_type

string

Type of energy disposition reported in the core_ferc1__yearly_energy_dispositions_sched401. Dispositions include sales to customers, re-sales of energy, energy used internally, losses, etc.

energy_mwh

number

Sources and uses of energy in MWh.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_energy_sources_sched401#

Denormalized table that contains FERC electric energy sources information. Browse or query this table in Datasette.

Field Name

Type

Description

energy_mwh

number

Sources and uses of energy in MWh.

energy_source_type

string

Type of energy source reported in the core_ferc1__yearly_energy_sources_sched401 table. There are three groups of energy sources: generation, power exchanges and transmission.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_hydroelectric_plants_sched406#

Denormalized table that contains small plant information from FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_equipment

number

Cost of plant: equipment (USD).

capex_facilities

number

Cost of plant: reservoirs, dams, and waterways (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_roads

number

Cost of plant: roads, railroads, and bridges (USD).

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

installation_year

integer

Year the plant's most recently built unit was installed.

net_capacity_adverse_conditions_mw

number

Net plant capability under the least favorable operating conditions, in megawatts.

net_capacity_favorable_conditions_mw

number

Net plant capability under the most favorable operating conditions, in megawatts.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

opex_dams

number

Production expenses: maintenance of reservoirs, dams, and waterways (USD).

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_generation_misc

number

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

number

Production expenses: hydraulic expenses (USD).

opex_misc_plant

number

Production expenses: maintenance of miscellaneous hydraulic plant (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plant

number

Production expenses: maintenance of electric plant (USD).

opex_rents

number

Production expenses: rents (USD).

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

number

Total production expenses, excluding fuel (USD).

opex_water_for_power

number

Production expenses: water for power (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

project_num

integer

FERC Licensed Project Number.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_income_statements_sched114#

Denormalized table that contains FERC income statement information. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

income_type

string

Type of income reported in income_statement_ferc1 table.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_operating_expenses_sched320#

Denormalized table that contains FERC electric operating expense information. Browse or query this table in Datasette.

Field Name

Type

Description

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

expense_type

string

The type of expense.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_operating_revenues_sched300#

Denormalized table that contains FERC electric operating revenue information. Browse or query this table in Datasette.

Field Name

Type

Description

avg_customers_per_month

number

Average number of customers per month.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

revenue_type

string

Label describing types of revenues.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

sales_mwh

number

Quantity of electricity sold in MWh.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_other_regulatory_liabilities_sched278#

Denormalized table that contains FERC other regulatory liabilities information. Browse or query this table in Datasette.

Field Name

Type

Description

account_detail

string

Description of the account number credited from making debit adjustment to other regulatory liabilities.

decrease_in_other_regulatory_liabilities

number

The decrease during the reporting period of other regulatory liabilities.

description

string

Long human-readable description of the meaning of a code/label.

ending_balance

number

Account balance at end of year.

increase_in_other_regulatory_liabilities

number

The increase during the reporting period of other regulatory liabilities.

report_year

integer

Four-digit year in which the data was reported.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_plant_in_service_sched204#

Denormalized table of FERC Form 1 Electric Plant in Service data. Browse or query this table in Datasette.

Field Name

Type

Description

additions

number

Cost of acquisition of items classified within the account.

adjustments

number

Cost of adjustments to the account.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

ferc_account_label

string

Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.

plant_status

string

Utility plant financial status (in service, future, leased, total).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

retirements

number

Cost of disposal of items classified within the account.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

transfers

number

Cost of transfers into (out of) the account.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_pumped_storage_plants_sched408#

Denormalized table that contains pumped storage plant information from FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_equipment_electric

number

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

number

Cost of plant: miscellaneous power plant equipment (USD).

capex_facilities

number

Cost of plant: reservoirs, dams, and waterways (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_roads

number

Cost of plant: roads, railroads, and bridges (USD).

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

capex_wheels_turbines_generators

number

Cost of plant: water wheels, turbines, and generators (USD).

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

energy_used_for_pumping_mwh

number

Energy used for pumping, in megawatt-hours.

installation_year

integer

Year the plant's most recently built unit was installed.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

net_load_mwh

number

Net output for load (net generation - energy used for pumping) in megawatt-hours.

opex_dams

number

Production expenses: maintenance of reservoirs, dams, and waterways (USD).

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_generation_misc

number

Production expenses: miscellaneous power generation expenses (USD).

opex_misc_plant

number

Production expenses: maintenance of miscellaneous hydraulic plant (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plant

number

Production expenses: maintenance of electric plant (USD).

opex_production_before_pumping

number

Total production expenses before pumping (USD).

opex_pumped_storage

number

Production expenses: pumped storage (USD).

opex_pumping

number

Production expenses: We are here to PUMP YOU UP! (USD).

opex_rents

number

Production expenses: rents (USD).

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

number

Total production expenses, excluding fuel (USD).

opex_water_for_power

number

Production expenses: water for power (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_capability_mw

number

Net plant capability in megawatts.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

project_num

integer

FERC Licensed Project Number.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_purchased_power_and_exchanges_sched326#

Denormalized table of FERC Form 1 Purchased Power data. Browse or query this table in Datasette.

Field Name

Type

Description

billing_demand_mw

number

Monthly average billing demand (for requirements purchases, and any transactions involving demand charges). In megawatts.

coincident_peak_demand_mw

number

Average monthly coincident peak (CP) demand (for requirements purchases, and any transactions involving demand charges). Monthly CP demand is the metered demand during the hour (60-minute integration) in which the supplier's system reaches its monthly peak. In megawatts.

delivered_mwh

number

Gross megawatt-hours delivered in power exchanges and used as the basis for settlement.

demand_charges

number

Demand charges (USD).

energy_charges

number

Energy charges (USD).

non_coincident_peak_demand_mw

number

Average monthly non-coincident peak (NCP) demand (for requirements purhcases, and any transactions involving demand charges). Monthly NCP demand is the maximum metered hourly (60-minute integration) demand in a month. In megawatts.

other_charges

number

Other charges, including out-of-period adjustments (USD).

purchase_type_code

string

Categorization based on the original contractual terms and conditions of the service. Must be one of 'requirements', 'long_firm', 'intermediate_firm', 'short_firm', 'long_unit', 'intermediate_unit', 'electricity_exchange', 'other_service', or 'adjustment'. Requirements service is ongoing high reliability service, with load integrated into system resource planning. 'Long term' means 5+ years. 'Intermediate term' is 1-5 years. 'Short term' is less than 1 year. 'Firm' means not interruptible for economic reasons. 'unit' indicates service from a particular designated generating unit. 'exchange' is an in-kind transaction.

purchased_mwh

number

Megawatt-hours shown on bills rendered to the respondent. Includes both electricity purchased for storage and non-storage purposes, which were lumped together prior to 2021.

purchased_other_than_storage_mwh

number

Number of megawatt hours purchased during the period for other than energy storage.

purchased_storage_mwh

number

Number of megawatt hours purchased during the period for energy storage.

received_mwh

number

Gross megawatt-hours received in power exchanges and used as the basis for settlement.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

seller_name

string

Name of the seller, or the other party in an exchange transaction.

tariff

string

FERC Rate Schedule Number or Tariff. (Note: may be incomplete if originally reported on multiple lines.)

total_settlement

number

Sum of demand, energy, and other charges (USD). For power exchanges, the settlement amount for the net receipt of energy. If more energy was delivered than received, this amount is negative.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_retained_earnings_sched118#

Denormalized table that contains FERC retained earnings information. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

earnings_type

string

Label describing types of earnings.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

out_ferc1__yearly_sales_by_rate_schedules_sched304#

Denormalized table that contains FERC electricity sales by rate schedule information. Browse or query this table in Datasette.

Field Name

Type

Description

avg_customers_per_month

number

Average number of customers per month.

billing_status

string

Whether an amount is billed, unbilled, or both. Billed amounts pertain to the exchange of energy and unbilled amounts pertain to other sources of revenue such as contracts with peaker plants to keep them on standby or charging rent to host cell antennas on transmission towers.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

kwh_per_customer

number

kWh per customer.

rate_schedule_description

string

Free-form description of what the rate schedule name is. Not standardized. Often a sub-category of rate_schedule_type.

rate_schedule_type

string

Categorization of rate schedule type.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

revenue_per_kwh

number

The amount of revenue per kWh by rate schedule aquired in the given report year.

sales_mwh

number

Quantity of electricity sold in MWh.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_small_plants_sched410#

Denormalized table that contains small plant information from FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_total

number

Total cost of plant (USD).

construction_year

integer

Year the plant's oldest still operational unit was built.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_type

string

Type of fuel.

license_id_ferc1

integer

FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

opex_fuel

number

Production expenses: fuel (USD).

opex_maintenance

number

Production expenses: Maintenance (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

number

Total production expenses, excluding fuel (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_steam_plants_fuel_by_plant_sched402#

A table summarizing FERC fuel data by plant, using FERC Form 1 data. Browse or query this table in Datasette.

Field Name

Type

Description

coal_fraction_cost

number

Coal cost as a percentage of overall fuel cost.

coal_fraction_mmbtu

number

Coal heat content as a percentage of overall fuel heat content (mmBTU).

fuel_cost

number

Total fuel cost for plant (in $USD).

fuel_mmbtu

number

Total heat content for plant (in MMBtu).

gas_fraction_cost

number

Natural gas cost as a percentage of overall fuel cost.

gas_fraction_mmbtu

number

Natural gas heat content as a percentage of overall fuel heat content (MMBtu).

nuclear_fraction_cost

number

Nuclear cost as a percentage of overall fuel cost.

nuclear_fraction_mmbtu

number

Nuclear heat content as a percentage of overall fuel heat content (MMBtu).

oil_fraction_cost

number

Oil cost as a percentage of overall fuel cost.

oil_fraction_mmbtu

number

Oil heat content as a percentage of overall fuel heat content (MMBtu).

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

primary_fuel_by_cost

string

Primary fuel for plant as a percentage of cost.

primary_fuel_by_mmbtu

string

Primary fuel for plant as a percentage of heat content.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

waste_fraction_cost

number

Waste-heat cost as a percentage of overall fuel cost.

waste_fraction_mmbtu

number

Waste-heat heat content as a percentage of overall fuel heat content (MMBtu).

out_ferc1__yearly_steam_plants_fuel_sched402#

Denormalized table that contains fuel information from FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_total_cost

number

Total cost of consumed fuel.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_unit_burned

number

Average cost of fuel consumed in the report year per reported fuel unit (USD).

fuel_cost_per_unit_delivered

number

Average cost of fuel delivered in the report year per reported fuel unit (USD).

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_units

string

Reported unit of measure for fuel.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_steam_plants_sched402#

Denormalized table that contains steam plant information from FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_annual_addition

number

Annual capital addition into capex_total.

capex_annual_addition_rolling

number

Year-to-date capital addition into capex_total.

capex_annual_per_kw

number

Annual capital addition into capex_total per kw.

capex_annual_per_mw

number

Annual capital addition into capex_total per MW.

capex_annual_per_mw_rolling

number

Year-to-date capital addition into capex_total per MW.

capex_annual_per_mwh

number

Annual capital addition into capex_total per MWh.

capex_annual_per_mwh_rolling

number

Year-to-date capital addition into capex_total per MWh.

capex_equipment

number

Cost of plant: equipment (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

capex_wo_retirement_total

number

Total cost of plant (USD) without retirements.

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

installation_year

integer

Year the plant's most recently built unit was installed.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

not_water_limited_capacity_mw

number

Plant capacity in MW when not limited by condenser water.

opex_allowances

number

Allowances.

opex_boiler

number

Maintenance of boiler (or reactor) plant.

opex_coolants

number

Cost of coolants and water (nuclear plants only)

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_fuel

number

Production expenses: fuel (USD).

opex_fuel_per_mwh

number

Production expenses: fuel (USD) per megawatt-hour (Mwh).

opex_misc_power

number

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

number

Maintenance of miscellaneous steam (or nuclear) plant.

opex_nonfuel_per_mwh

number

Investments in non-fuel production expenses per Mwh.

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plants

number

Maintenance of electrical plant.

opex_production_total

number

Total operating expenses.

opex_rents

number

Production expenses: rents (USD).

opex_steam

number

Steam expenses.

opex_steam_other

number

Steam from other sources.

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total_nonfuel

number

Total production expenses, excluding fuel (USD).

opex_transfer

number

Steam transferred (Credit).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_capability_mw

number

Net plant capability in megawatts.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_id_ferc1

integer

Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

water_limited_capacity_mw

number

Plant capacity in MW when limited by condenser water.

out_ferc1__yearly_transmission_lines_sched422#

Denormalized table that contains FERC transmission statistics information. Browse or query this table in Datasette.

Field Name

Type

Description

capex_land

number

Cost of plant: land and land rights (USD).

capex_other

number

Other costs associated with the plant (USD).

capex_total

number

Total cost of plant (USD).

conductor_size_and_material

string

Size of transmission conductor and material of the transmission line.

designed_voltage_kv

number

Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines

end_point

string

The end point of a transmission line.

num_transmission_circuits

integer

Number of circuits in a transmission line.

operating_voltage_kv

number

The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines.

opex_maintenance

number

Production expenses: Maintenance (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_rents

number

Production expenses: rents (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

start_point

string

The starting point of a transmission line.

supporting_structure_type

string

Supporting structure of the transmission line.

transmission_line_and_structures_length_miles

number

Length (in pole miles or circuit miles (if transmission lines are underground)) for lines that are agrregated with other lines / structures (whose cost are aggregated and combined with other structures).

transmission_line_length_miles

number

Length (in pole miles or circuit miles (if transmission lines are underground)) for lines that are stand alone structures (whose cost are reported on a stand-alone basis).

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

out_ferc1__yearly_utility_plant_summary_sched200#

Denormalized table that contains FERC utility plant summary information. Browse or query this table in Datasette.

Field Name

Type

Description

ending_balance

number

Account balance at end of year.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

utility_plant_asset_type

string

Type of utility plant asset reported in the core_ferc1__yearly_utility_plant_summary_sched200 table. Assets include those leased to others, held for future use, construction work-in-progress and details of accumulated depreciation.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

utility_type_other

string

Freeform description of type of utility reported in one of the other three other utility_type sections in the core_ferc1__yearly_utility_plant_summary_sched200 table. This field is reported only in the DBF reporting years (1994-2020).

out_ferc714__hourly_estimated_state_demand#

Estimated hourly electricity demand for each state, scaled such that it matches the total electricity sales by state reported in EIA 861. Browse or query this table in Datasette.

Field Name

Type

Description

demand_mwh

number

Electricity demand (energy) within a given timeframe.

scaled_demand_mwh

number

Estimated electricity demand scaled by the total sales within a state.

state_id_fips

string

Two digit state FIPS code.

utc_datetime

datetime

Date and time converted to Coordinated Universal Time (UTC).

out_ferc714__hourly_planning_area_demand#

Hourly electricity demand by planning area. FERC Form 714, Part III, Schedule 2a. Browse or query this table in Datasette.

Field Name

Type

Description

demand_mwh

number

Electricity demand (energy) within a given timeframe.

report_date

date

Date reported.

respondent_id_ferc714

integer

FERC Form 714 respondent ID. Note that this ID does not correspond to FERC respondent IDs from other forms.

timezone

string

IANA timezone name

utc_datetime

datetime

Date and time converted to Coordinated Universal Time (UTC).

out_ferc714__respondents_with_fips#

Annual respondents with the county FIPS IDs for their service territories. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

balancing_authority_id_eia

integer

EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.

balancing_authority_name_eia

string

Name of the balancing authority.

county

string

County name.

county_id_fips

string

County ID from the Federal Information Processing Standard Publication 6-4.

eia_code

integer

EIA utility or balancing area authority ID associated with this FERC Form 714 respondent. Note that many utilities are also balancing authorities and in many cases EIA uses the same integer ID to identify a utility in its role as a balancing authority AND as a utility, but there is no requirement that these IDs be the same, and in a number of cases they are different.

report_date

date

Date reported.

respondent_id_ferc714

integer

FERC Form 714 respondent ID. Note that this ID does not correspond to FERC respondent IDs from other forms.

respondent_name_ferc714

string

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

respondent_type

string

Whether a respondent to the FERC form 714 is a utility or a balancing authority.

state

string

Two letter US state abbreviation.

state_id_fips

string

Two digit state FIPS code.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

out_ferc714__summarized_demand#

Compile FERC 714 annualized, categorized respondents and summarize values. Browse or query this table in Datasette.

Field Name

Type

Description

area_km2

number

County area in km2.

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

balancing_authority_id_eia

integer

EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.

balancing_authority_name_eia

string

Name of the balancing authority.

demand_annual_mwh

number

Annual electricity demand in a given report year.

demand_annual_per_capita_mwh

number

Per-capita annual demand, averaged using Census county-level population estimates.

demand_density_mwh_km2

number

Annual demand per km2 of a given service territory.

eia_code

integer

EIA utility or balancing area authority ID associated with this FERC Form 714 respondent. Note that many utilities are also balancing authorities and in many cases EIA uses the same integer ID to identify a utility in its role as a balancing authority AND as a utility, but there is no requirement that these IDs be the same, and in a number of cases they are different.

population

number

County population, sourced from Census DP1 data.

population_density_km2

number

Average population per sq. km area of a service territory.

report_date

date

Date reported.

respondent_id_ferc714

integer

FERC Form 714 respondent ID. Note that this ID does not correspond to FERC respondent IDs from other forms.

respondent_name_ferc714

string

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

respondent_type

string

Whether a respondent to the FERC form 714 is a utility or a balancing authority.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

out_pudl__yearly_assn_eia_ferc1_plant_parts#

This table links power plant data reported in FERC Form 1 to related EIA data. It answers the question "What EIA data reported about plants or generators should be associated with a given plant record found in the FERC Form 1."

Each record in this table corresponds to a single FERC Form 1 record reported in one of several tables describing power plants (large steam, hydro, small, etc.). These FERC records can correspond to an entire plant, individual generators within a plant, all generators in a plant with the same prime mover type, or just the respondent's ownership share of any of those categories (or other categories). Furthermore, the same utility may report the same plant in different ways in different years.

The EIA data associated with each FERC plant record comes from our Plant Parts EIA table. The EIA data in each record represents an aggregation of several slices of an EIA plant, across both physical characteristics and utility ownership. Browse or query this table in Datasette.

Field Name

Type

Description

appro_part_label

string

Plant part of the associated true granularity record.

appro_record_id_eia

string

EIA record ID of the associated true granularity record.

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_factor_eia

number

Fraction of potential generation that was actually reported for a plant part.

capacity_factor_ferc1

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw_eia

number

Total installed (nameplate) capacity, in megawatts.

capacity_mw_ferc1

number

Total installed (nameplate) capacity, in megawatts.

capex_annual_addition

number

Annual capital addition into capex_total.

capex_annual_addition_rolling

number

Year-to-date capital addition into capex_total.

capex_annual_per_kw

number

Annual capital addition into capex_total per kw.

capex_annual_per_mw

number

Annual capital addition into capex_total per MW.

capex_annual_per_mw_rolling

number

Year-to-date capital addition into capex_total per MW.

capex_annual_per_mwh

number

Annual capital addition into capex_total per MWh.

capex_annual_per_mwh_rolling

number

Year-to-date capital addition into capex_total per MWh.

capex_equipment

number

Cost of plant: equipment (USD).

capex_equipment_electric

number

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

number

Cost of plant: miscellaneous power plant equipment (USD).

capex_facilities

number

Cost of plant: reservoirs, dams, and waterways (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_roads

number

Cost of plant: roads, railroads, and bridges (USD).

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

capex_wheels_turbines_generators

number

Cost of plant: water wheels, turbines, and generators (USD).

capex_wo_retirement_total

number

Total cost of plant (USD) without retirements.

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year_eia

integer

Year the plant's oldest still operational unit was built.

construction_year_ferc1

integer

Year the plant's oldest still operational unit was built.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

energy_used_for_pumping_mwh

number

Energy used for pumping, in megawatt-hours.

ferc_acct_name

string

Name of FERC account, derived from technology description and prime mover code.

ferc_license_id

string

The FERC license ID of a project.

fraction_owned

number

Proportion of generator ownership attributable to this utility.

fuel_cost_per_mmbtu_eia

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mmbtu_ferc1

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh_eia

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_cost_per_mwh_ferc1

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type

string

Type of fuel.

fuel_type_code_pudl_eia

string

Simplified fuel type code used in PUDL

fuel_type_code_pudl_ferc1

string

Simplified fuel type code used in PUDL

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_year

integer

Year a generator went into service.

installation_year_eia

integer

Year the plant's most recently built unit was installed.

installation_year_ferc1

integer

Year the plant's most recently built unit was installed.

license_id_ferc1

integer

FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible.

match_type

string

Indicates the source and validation of the match between EIA and FERC. Match types include matches was generated from the model, verified by the training data, overridden by the training data, etc.

net_capacity_adverse_conditions_mw

number

Net plant capability under the least favorable operating conditions, in megawatts.

net_capacity_favorable_conditions_mw

number

Net plant capability under the most favorable operating conditions, in megawatts.

net_generation_mwh_eia

number

Net electricity generation for the specified period in megawatt-hours (MWh).

net_generation_mwh_ferc1

number

Net electricity generation for the specified period in megawatt-hours (MWh).

net_load_mwh

number

Net output for load (net generation - energy used for pumping) in megawatt-hours.

not_water_limited_capacity_mw

number

Plant capacity in MW when not limited by condenser water.

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_pudl

string

The operating status of the asset using PUDL categories.

opex_allowances

number

Allowances.

opex_boiler

number

Maintenance of boiler (or reactor) plant.

opex_coolants

number

Cost of coolants and water (nuclear plants only)

opex_dams

number

Production expenses: maintenance of reservoirs, dams, and waterways (USD).

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_fuel

number

Production expenses: fuel (USD).

opex_generation_misc

number

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

number

Production expenses: hydraulic expenses (USD).

opex_maintenance

number

Production expenses: Maintenance (USD).

opex_misc_plant

number

Production expenses: maintenance of miscellaneous hydraulic plant (USD).

opex_misc_power

number

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

number

Maintenance of miscellaneous steam (or nuclear) plant.

opex_nonfuel_per_mwh

number

Investments in non-fuel production expenses per Mwh.

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plant

number

Production expenses: maintenance of electric plant (USD).

opex_production_before_pumping

number

Total production expenses before pumping (USD).

opex_production_total

number

Total operating expenses.

opex_pumped_storage

number

Production expenses: pumped storage (USD).

opex_pumping

number

Production expenses: We are here to PUMP YOU UP! (USD).

opex_rents

number

Production expenses: rents (USD).

opex_steam

number

Steam expenses.

opex_steam_other

number

Steam from other sources.

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

number

Total production expenses, excluding fuel (USD).

opex_transfer

number

Steam transferred (Credit).

opex_water_for_power

number

Production expenses: water for power (USD).

ownership_dupe

boolean

Whether a plant part record has a duplicate record with different ownership status.

ownership_record_type

string

Whether each generator record is for one owner or represents a total of all ownerships.

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_capability_mw

number

Net plant capability in megawatts.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_ferc1

integer

Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_name_ppe

string

Derived plant name that includes EIA plant name and other strings associated with ID and PK columns of the plant part.

plant_part

string

The part of the plant a record corresponds to.

plant_part_id_eia

string

Contains EIA plant ID, plant part, ownership, and EIA utility id

plant_type

string

Type of plant.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

record_count

integer

Number of distinct generator IDs that partcipated in the aggregation for a plant part list record.

record_id_eia

string

Identifier for EIA plant parts analysis records.

record_id_ferc1

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_date

date

Date reported.

report_year

integer

Four-digit year in which the data was reported.

technology_description

string

High level description of the technology used by the generator to produce electricity.

total_fuel_cost_eia

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_fuel_cost_ferc1

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu_eia

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

total_mmbtu_ferc1

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

true_gran

boolean

Indicates whether a plant part list record is associated with the highest priority plant part for all identical records.

unit_heat_rate_mmbtu_per_mwh_eia

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_heat_rate_mmbtu_per_mwh_ferc1

number

Fuel content per unit of electricity generated. Calculated from FERC reported fuel consumption and net generation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

water_limited_capacity_mw

number

Plant capacity in MW when limited by condenser water.

core_eia860__assn_boiler_cooling#

A table that links EIA boiler IDs to EIA cooling system IDs. Browse or query this table in Datasette.

Field Name

Type

Description

boiler_id

string

Alphanumeric boiler ID.

cooling_id_eia

string

EIA Identification code for cooling system (if multiple cooling systems are not distinguished by separate IDs, the word 'PLANT' is listed to encompass the cooling system for the entire plant)

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

core_eia860__assn_boiler_generator#

Associations between boilers and generators as reported in EIA-860 Schedule 6, Part A. Augmented with various heuristics within PUDL. Browse or query this table in Datasette.

Field Name

Type

Description

bga_source

string

The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections).

boiler_generator_assn_type_code

string

Indicates whether boiler associations with generator during the year were actual or theoretical. Only available before 2013.

boiler_id

string

Alphanumeric boiler ID.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

steam_plant_type_code

integer

Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details.

unit_id_eia

string

EIA-assigned unit identification code.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

core_eia860__assn_boiler_stack_flue#

A table that links EIA boiler IDs to EIA stack and/or flue system IDs. Browse or query this table in Datasette.

Field Name

Type

Description

boiler_id

string

Alphanumeric boiler ID.

flue_id_eia

string

The flue identification value reported to EIA. The flue is a duct, pipe, or opening that transports exhast gases through the stack. This field was reported in conjunction with stack_id_eia until 2013 when stack_flue_id_eia took their place.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

stack_flue_id_eia

string

The stack or flue identification value reported to EIA. This denotes the place where emissions from the combusion process are released into the atmosphere. Prior to 2013, this was reported as stack_id_eia and flue_id_eia.

stack_flue_id_pudl

string

A stack and/or flue identification value created by PUDL for use as part of the primary key for the stack flue equipment and boiler association tables. For 2013 and onward, this value is equal to the value for stack_flue_id_eia. Prior to 2013, this value is equal to the value for stack_id_eia and the value for flue_id_eia seperated by an underscore or just the stack_flue_eia in cases where flue_id_eia is NA.

stack_id_eia

string

The stack identification value reported to EIA. Stacks or chimneys are the place where emissions from the combustion process are released into the atmosphere. This field was reported in conjunction with flue_id_eia until 2013 when stack_flue_id_eia took their place.

core_eia860__assn_yearly_boiler_emissions_control_equipment#

A table that links EIA boiler IDs to emissions control IDs for NOx, SO2, mercury, and particulate monitoring. The relationship between the IDs is sometimes many to many. Browse or query this table in Datasette.

Field Name

Type

Description

boiler_id

string

Alphanumeric boiler ID.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

emission_control_id_eia

string

The emission control ID used to collect SO2, NOx, particulate, and mercury emissions data. This column should be used in conjunction with emissions_control_type as it's not guaranteed to be unique.

emission_control_id_type

string

The type of emissions control id: SO2, NOx, particulate, or mercury.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

core_eia860__scd_boilers#

Annually varying boiler attributes, compiled from across all EIA-860 data. Browse or query this table in Datasette.

Field Name

Type

Description

air_flow_100pct_load_cubic_feet_per_minute

number

Total air flow including excess air at 100 percent load, reported at standard temperature and pressure (i.e. 68 F and one atmosphere pressure).

boiler_fuel_code_1

string

The code representing the most predominant type of energy that fuels the boiler.

boiler_fuel_code_2

string

The code representing the second most predominant type of energy that fuels the boiler.

boiler_fuel_code_3

string

The code representing the third most predominant type of energy that fuels the boiler.

boiler_fuel_code_4

string

The code representing the fourth most predominant type of energy that fuels the boiler.

boiler_id

string

Alphanumeric boiler ID.

boiler_operating_date

date

Date the boiler began or is planned to begin commercial operation.

boiler_retirement_date

date

Date of the scheduled or effected retirement of the boiler.

boiler_status

string

EIA short code identifying boiler operational status.

boiler_type

string

EIA short code indicating the standards under which the boiler is operating as described in the U.S. EPA regulation under 40 CFR.

compliance_year_mercury

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for mercury emissions.

compliance_year_nox

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for nitrogen oxide emissions.

compliance_year_particulate

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for particulate matter emissions.

compliance_year_so2

integer

Year boiler was or is expected to be in compliance with federal, state and/or local regulations for sulfur dioxide emissions.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

efficiency_100pct_load

number

Boiler efficiency percentage when burning at 100 percent load to the nearest 0.1 percent.

efficiency_50pct_load

number

Boiler efficiency percentage when burning at 50 percent load to the nearest 0.1 percent.

firing_rate_using_coal_tons_per_hour

number

Design firing rate at maximum continuous steam flow for coal to the nearest 0.1 ton per hour.

firing_rate_using_gas_mcf_per_hour

number

Design firing rate at maximum continuous steam flow for gas to the nearest 0.1 cubic feet per hour.

firing_rate_using_oil_bbls_per_hour

number

Design firing rate at maximum continuous steam flow for pet coke to the nearest 0.1 barrels per hour.

firing_rate_using_other_fuels

number

Design firing rate at maximum continuous steam flow for energy sources other than coal, petroleum, or natural gas.

firing_type_1

string

EIA short code indicating the type of firing used by this boiler.

firing_type_2

string

EIA short code indicating the type of firing used by this boiler.

firing_type_3

string

EIA short code indicating the type of firing used by this boiler.

fly_ash_reinjection

boolean

Indicates whether the boiler is capable of re-injecting fly ash.

hrsg

boolean

indicates if the boiler is a heat recovery steam generator (HRSG).

max_steam_flow_1000_lbs_per_hour

number

Maximum continuous steam flow at 100 percent load.

mercury_control_existing_strategy_1

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_2

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_3

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_4

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_5

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_existing_strategy_6

string

Existing strategy to comply with the most stringent mercury regulation.

mercury_control_proposed_strategy_1

string

Proposed strategy to comply with the most stringent mercury regulation.

mercury_control_proposed_strategy_2

string

Proposed strategy to comply with the most stringent mercury regulation.

mercury_control_proposed_strategy_3

string

Proposed strategy to comply with the most stringent mercury regulation.

new_source_review

boolean

Indicates whether the boiler is subject to New Source Review requirements.

new_source_review_date

date

Month of issued New Source Review permit.

new_source_review_permit

string

New Source Review permit number.

nox_control_existing_caaa_compliance_strategy_1

string

Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_existing_caaa_compliance_strategy_2

string

Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_existing_caaa_compliance_strategy_3

string

Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_existing_strategy_1

string

Existing strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_existing_strategy_2

string

Existing strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_existing_strategy_3

string

Existing strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_manufacturer

string

Name of nitrogen oxide control manufacturer.

nox_control_manufacturer_code

string

Code indicating the nitrogen oxide control burner manufacturer.

nox_control_out_of_compliance_strategy_1

string

If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance.

nox_control_out_of_compliance_strategy_2

string

If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance.

nox_control_out_of_compliance_strategy_3

string

If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance.

nox_control_planned_caaa_compliance_strategy_1

string

Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_planned_caaa_compliance_strategy_2

string

Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_planned_caaa_compliance_strategy_3

string

Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990.

nox_control_proposed_strategy_1

string

Proposed strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_proposed_strategy_2

string

Proposed strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_proposed_strategy_3

string

Proposed strategy to comply with the most stringent nitrogen oxide regulation.

nox_control_status_code

string

Nitrogen oxide control status code.

particulate_control_out_of_compliance_strategy_1

string

If boiler is not in compliance with particulate matter regulations, strategy for compliance.

particulate_control_out_of_compliance_strategy_2

string

If boiler is not in compliance with particulate matter regulations, strategy for compliance.

particulate_control_out_of_compliance_strategy_3

string

If boiler is not in compliance with particulate matter regulations, strategy for compliance.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

regulation_mercury

string

Most stringent type of statute or regulation code under which the boiler is operating for mercury control standards.

regulation_nox

string

EIA short code for most stringent type of statute or regulation code under which the boiler is operating for nitrogen oxide control standards.

regulation_particulate

string

EIA short code for most stringent type of statute or regulation code under which the boiler is operating for particulate matter control standards.

regulation_so2

string

EIA short code for most stringent type of statute or regulation code under which the boiler is operating for sulfur dioxide control standards.

report_date

date

Date reported.

so2_control_existing_caaa_compliance_strategy_1

string

Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_existing_caaa_compliance_strategy_2

string

Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_existing_caaa_compliance_strategy_3

string

Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_existing_strategy_1

string

Existing strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_existing_strategy_2

string

Existing strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_existing_strategy_3

string

Existing strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_out_of_compliance_strategy_1

string

If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance.

so2_control_out_of_compliance_strategy_2

string

If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance.

so2_control_out_of_compliance_strategy_3

string

If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance.

so2_control_planned_caaa_compliance_strategy_1

string

Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_planned_caaa_compliance_strategy_2

string

Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_planned_caaa_compliance_strategy_3

string

Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990.

so2_control_proposed_strategy_1

string

Proposed strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_proposed_strategy_2

string

Proposed strategy to comply with the most stringent sulfur dioxide regulation.

so2_control_proposed_strategy_3

string

Proposed strategy to comply with the most stringent sulfur dioxide regulation.

standard_nox_rate

number

Numeric value for the unit of measurement specified for nitrogen oxide.

standard_particulate_rate

number

Numeric value for the unit of measurement specified for particulate matter.

standard_so2_percent_scrubbed

number

The percent of sulfur dioxide to be scrubbed specified by the most stringent sulfur dioxide regulation.

standard_so2_rate

number

Numeric value for the unit of measurement specified for sulfur dioxide.

turndown_ratio

number

The turndown ratio for the boiler.

unit_nox

string

Numeric value for the unit of measurement specified for nitrogen oxide.

unit_particulate

string

Numeric value for the unit of measurement specified for particulate matter.

unit_so2

string

Numeric value for the unit of measurement specified for sulfur dioxide.

waste_heat_input_mmbtu_per_hour

number

Design waste-heat input rate at maximum continuous steam flow where a waste-heat boiler is a boiler that receives all or a substantial portion of its energy input from the noncumbustible exhaust gases of a separate fuel-burning process (MMBtu per hour).

wet_dry_bottom

string

Wet or Dry Bottom where Wet Bottom is defined as slag tanks that are installed at furnace throat to contain and remove molten ash from the furnace, and Dry Bottom is defined as having no slag tanks at furnace throat area, throat area is clear, and bottom ash drops through throat to bottom ash water hoppers.

core_eia860__scd_emissions_control_equipment#

The cost, type, operating status, retirement date, and install year of emissions control equipment reported to EIA. Includes control ids for sulfur dioxide (SO2), particulate matter, mercury, nitrogen oxide (NOX), and acid (HCl) gas monitoring. Browse or query this table in Datasette.

Field Name

Type

Description

acid_gas_control

boolean

Indicates whether the emissions control equipment controls acid (HCl) gas.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

emission_control_equipment_cost

number

The total cost to install a piece of emission control equipment.

emission_control_equipment_type_code

string

Short code indicating the type of emission control equipment installed.

emission_control_id_pudl

number

A PUDL-generated ID used to distinguish emission control units in the same report year and plant id. This ID should not be used to track units over time or between plants.

emission_control_operating_date

date

The date a piece of emissions control equipment began operating. Derived from month and year columns in the raw data.

emission_control_retirement_date

date

The expected or actual retirement date for a piece of emissions control equipment. Derived from month and year columns in the raw data.

mercury_control_id_eia

string

Mercury control identification number. This ID is not a unique identifier.

nox_control_id_eia

string

Nitrogen oxide control identification number. This ID is not a unique identifier.

operational_status_code

string

The operating status of the asset.

particulate_control_id_eia

string

Particulate matter control identification number. This ID is not a unique identifier.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_year

integer

Four-digit year in which the data was reported.

so2_control_id_eia

string

Sulfur dioxide control identification number. This ID is not a unique identifier.

core_eia860__scd_generators#

Annually varying generator attributes compiled from across EIA-860 and EIA-923 data. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

carbon_capture

boolean

Indicates whether the generator uses carbon capture technology.

cofire_fuels

boolean

Can the generator co-fire fuels?.

current_planned_generator_operating_date

date

The most recently updated effective date on which the generator is scheduled to start operation

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

deliver_power_transgrid

boolean

Indicate whether the generator can deliver power to the transmission grid.

distributed_generation

boolean

Whether the generator is considered distributed generation

energy_source_1_transport_1

string

Primary mode of transport for energy source 1.

energy_source_1_transport_2

string

Secondary mode of transport for energy source 1.

energy_source_1_transport_3

string

Tertiary mode of transport for energy source 1.

energy_source_2_transport_1

string

Primary mode of transport for energy source 2.

energy_source_2_transport_2

string

Secondary mode of transport for energy source 2.

energy_source_2_transport_3

string

Tertiary mode of transport for energy source 2.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

energy_source_code_2

string

The code representing the second most predominant type of energy that fuels the generator

energy_source_code_3

string

The code representing the third most predominant type of energy that fuels the generator

energy_source_code_4

string

The code representing the fourth most predominant type of energy that fuels the generator

energy_source_code_5

string

The code representing the fifth most predominant type of energy that fuels the generator

energy_source_code_6

string

The code representing the sixth most predominant type of energy that fuels the generator

energy_storage_capacity_mwh

number

Energy storage capacity in MWh (e.g. for batteries).

ferc_qualifying_facility

boolean

Indicatates whether or not a generator is a qualifying FERC cogeneation facility.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

minimum_load_mw

number

The minimum load at which the generator can operate at continuosuly.

multiple_fuels

boolean

Can the generator burn multiple fuels?

nameplate_power_factor

number

The nameplate power factor of the generator.

net_capacity_mwdc

number

Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_code

string

The operating status of the asset.

other_modifications_date

date

Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete.

other_planned_modifications

boolean

Indicates whether there are there other modifications planned for the generator.

owned_by_non_utility

boolean

Whether any part of generator is owned by a nonutilty

ownership_code

string

Identifies the ownership for each generator.

planned_derate_date

date

Planned effective month that the generator is scheduled to enter operation after the derate modification.

planned_energy_source_code_1

string

New energy source code for the planned repowered generator.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

planned_modifications

boolean

Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years.

planned_net_summer_capacity_derate_mw

number

Decrease in summer capacity expected to be realized from the derate modification to the equipment.

planned_net_summer_capacity_uprate_mw

number

Increase in summer capacity expected to be realized from the modification to the equipment.

planned_net_winter_capacity_derate_mw

number

Decrease in winter capacity expected to be realized from the derate modification to the equipment.

planned_net_winter_capacity_uprate_mw

number

Increase in winter capacity expected to be realized from the uprate modification to the equipment.

planned_new_capacity_mw

number

The expected new namplate capacity for the generator.

planned_new_prime_mover_code

string

New prime mover for the planned repowered generator.

planned_repower_date

date

Planned effective date that the generator is scheduled to enter operation after the repowering is complete.

planned_uprate_date

date

Planned effective date that the generator is scheduled to enter operation after the uprate modification.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

reactive_power_output_mvar

number

Reactive Power Output (MVAr)

report_date

date

Date reported.

startup_source_code_1

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_2

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_3

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_4

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

summer_capacity_estimate

boolean

Whether the summer capacity value was an estimate

summer_capacity_mw

number

The net summer capacity.

summer_estimated_capability_mw

number

EIA estimated summer capacity (in MWh).

switch_oil_gas

boolean

Indicates whether the generator switch between oil and natural gas.

syncronized_transmission_grid

boolean

Indicates whether standby generators (SB status) can be synchronized to the grid.

technology_description

string

High level description of the technology used by the generator to produce electricity.

time_cold_shutdown_full_load_code

string

The minimum amount of time required to bring the unit to full load from shutdown.

turbines_inverters_hydrokinetics

integer

Number of wind turbines, or hydrokinetic buoys.

turbines_num

integer

Number of wind turbines, or hydrokinetic buoys.

uprate_derate_completed_date

date

The date when the uprate or derate was completed.

uprate_derate_during_year

boolean

Was an uprate or derate completed on this generator during the reporting year?

utility_id_eia

integer

The EIA Utility Identification number.

winter_capacity_estimate

boolean

Whether the winter capacity value was an estimate

winter_capacity_mw

number

The net winter capacity.

winter_estimated_capability_mw

number

EIA estimated winter capacity (in MWh).

core_eia860__scd_ownership#

Generator Ownership, reported in EIA-860 Schedule 4. Includes only jointly or third-party owned generators. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

fraction_owned

number

Proportion of generator ownership attributable to this utility.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

owner_city

string

City of owner.

owner_country

string

Three letter ISO-3166 country code.

owner_state

string

Two letter ISO-3166 political subdivision code.

owner_street_address

string

Steet address of owner.

owner_utility_id_eia

integer

The EIA utility Identification number for the owner company that is responsible for the day-to-day operations of the generator, not the operator utility.

owner_utility_name_eia

string

The name of the EIA owner utility.

owner_zip_code

string

Zip code of owner.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

core_eia860__scd_plants#

Annually varying plant attributes, compiled from across all EIA-860 and EIA-923 data. Browse or query this table in Datasette.

Field Name

Type

Description

ash_impoundment

boolean

Is there an ash impoundment (e.g. pond, reservoir) at the plant?

ash_impoundment_lined

boolean

If there is an ash impoundment at the plant, is the impoundment lined?

ash_impoundment_status

string

If there is an ash impoundment at the plant, the ash impoundment status as of December 31 of the reporting year.

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

balancing_authority_name_eia

string

Name of the balancing authority.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

datum

string

Geodetic coordinate system identifier (e.g. NAD27, NAD83, or WGS84).

energy_storage

boolean

Indicates if the facility has energy storage capabilities.

ferc_cogen_docket_no

string

The docket number relating to the FERC cogenerator status. See FERC Form 556.

ferc_cogen_status

boolean

Indicates whether the plant has FERC qualifying facility cogenerator status. See FERC Form 556.

ferc_exempt_wholesale_generator

boolean

Indicates whether the plant has FERC qualifying facility exempt wholesale generator status

ferc_exempt_wholesale_generator_docket_no

string

The docket number relating to the FERC qualifying facility exempt wholesale generator status.

ferc_qualifying_facility_docket_no

string

The docket number relating to the FERC qualifying facility cogenerator status. See FERC Form 556.

ferc_small_power_producer

boolean

Indicates whether the plant has FERC qualifying facility small power producer status. See FERC Form 556.

ferc_small_power_producer_docket_no

string

The docket number relating to the FERC qualifying facility small power producer status. See FERC Form 556.

grid_voltage_1_kv

number

Plant's grid voltage at point of interconnection to transmission or distibution facilities

grid_voltage_2_kv

number

Plant's grid voltage at point of interconnection to transmission or distibution facilities

grid_voltage_3_kv

number

Plant's grid voltage at point of interconnection to transmission or distibution facilities

iso_rto_code

string

The code of the plant's ISO or RTO. NA if not reported in that year.

liquefied_natural_gas_storage

boolean

Indicates if the facility have the capability to store the natural gas in the form of liquefied natural gas.

natural_gas_local_distribution_company

string

Names of Local Distribution Company (LDC), connected to natural gas burning power plants.

natural_gas_pipeline_name_1

string

The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility.

natural_gas_pipeline_name_2

string

The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility.

natural_gas_pipeline_name_3

string

The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility.

natural_gas_storage

boolean

Indicates if the facility have on-site storage of natural gas.

nerc_region

string

NERC region in which the plant is located

net_metering

boolean

Did this plant have a net metering agreement in effect during the reporting year? (Only displayed for facilities that report the sun or wind as an energy source). This field was only reported up until 2015

pipeline_notes

string

Additional owner or operator of natural gas pipeline.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

primary_purpose_id_naics

integer

North American Industry Classification System (NAICS) code that best describes the primary purpose of the reporting plant

regulatory_status_code

string

Indicates whether the plant is regulated or non-regulated.

report_date

date

Date reported.

reporting_frequency_code

string

Code that specifies what time period data has to be reported (i.e. monthly data or annual totals) and how often the power plant reports this data to EIA. See reporting_frequencies_eia for more details.

sector_id_eia

integer

EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status

sector_name_eia

string

EIA assigned sector name, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status

service_area

string

Service area in which plant is located; for unregulated companies, it's the electric utility with which plant is interconnected

transmission_distribution_owner_id

integer

EIA-assigned code for owner of transmission/distribution system to which the plant is interconnected.

transmission_distribution_owner_name

string

Name of the owner of the transmission or distribution system to which the plant is interconnected.

transmission_distribution_owner_state

string

State location for owner of transmission/distribution system to which the plant is interconnected.

utility_id_eia

integer

The EIA Utility Identification number.

water_source

string

Name of water source associated with the plant.

core_eia860__scd_utilities#

Annually varying utility attributes, compiled from all EIA data. Browse or query this table in Datasette.

Field Name

Type

Description

address_2

string

Second line of the address.

attention_line

string

Mail attention name of the operator/owner.

city

string

Name of the city.

contact_firstname

string

First name of utility contact 1.

contact_firstname_2

string

First name of utility contact 2.

contact_lastname

string

Last name of utility contact 1.

contact_lastname_2

string

Last name of utility contact 2.

contact_title

string

Title of of utility contact 1.

contact_title_2

string

Title of utility contact 2.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

entity_type

string

Entity type of principal owner.

phone_extension

string

Phone extension for utility contact 1

phone_extension_2

string

Phone extension for utility contact 2

phone_number

string

Phone number for utility contact 1.

phone_number_2

string

Phone number for utility contact 2.

plants_reported_asset_manager

boolean

Is the reporting entity an asset manager of power plants reported on Schedule 2 of the form?

plants_reported_operator

boolean

Is the reporting entity an operator of power plants reported on Schedule 2 of the form?

plants_reported_other_relationship

boolean

Does the reporting entity have any other relationship to the power plants reported on Schedule 2 of the form?

plants_reported_owner

boolean

Is the reporting entity an owner of power plants reported on Schedule 2 of the form?

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

street_address

string

Physical street address.

utility_id_eia

integer

The EIA Utility Identification number.

zip_code

string

Five digit US Zip Code.

zip_code_4

string

Four digit US Zip Code suffix.

core_eia860m__changelog_generators#

This table is a changelog of the monthly reported EIA-860M data. EIA-860M includes generator tables with the most up-to-date catalog of EIA generators and their operational status and other generator characteristics. EIA-860M is reported monthly, although for the vast majority of the generators nothing changes month-to- month. This table is a changelog of that monthly reported generator data. There is a record corresponding to the first instance of a generator and associated characteristics with a report_date column and a valid_until_date column. Whenever any of the reported EIA-860M data was changed for a record, there will be a new changelog record with a new report_date. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

county

string

County name.

current_planned_generator_operating_date

date

The most recently updated effective date on which the generator is scheduled to start operation

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

energy_storage_capacity_mwh

number

Energy storage capacity in MWh (e.g. for batteries).

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

latitude

number

Latitude of the plant's location, in degrees.

longitude

number

Longitude of the plant's location, in degrees.

net_capacity_mwdc

number

Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_code

string

The operating status of the asset.

planned_derate_date

date

Planned effective month that the generator is scheduled to enter operation after the derate modification.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

planned_net_summer_capacity_derate_mw

number

Decrease in summer capacity expected to be realized from the derate modification to the equipment.

planned_net_summer_capacity_uprate_mw

number

Increase in summer capacity expected to be realized from the modification to the equipment.

planned_uprate_date

date

Planned effective date that the generator is scheduled to enter operation after the uprate modification.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_name_eia

string

Plant name.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

sector_id_eia

integer

EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status

state

string

Two letter US state abbreviation.

summer_capacity_mw

number

The net summer capacity.

technology_description

string

High level description of the technology used by the generator to produce electricity.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

valid_until_date

date

The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date.

winter_capacity_mw

number

The net winter capacity.

core_eia861__assn_balancing_authority#

Association table showing which combinations of state, balancing authority, and utilities were observed in the data each year. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_id_eia

integer

EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__assn_utility#

Association table indicating which states each utility reported data for by year. Browse or query this table in Datasette.

Field Name

Type

Description

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_advanced_metering_infrastructure#

The data contain number of meters from automated meter readings (AMR) and advanced metering infrastructure (AMI) by state, sector, and balancing authority. The energy served (in megawatthours) for AMI systems is provided. Form EIA-861 respondents also report the number of standard meters (non AMR/AMI) in their system. Historical Changes: We started collecting the number of standard meters in 2013. The monthly survey collected these data from January 2011 to January 2017. Browse or query this table in Datasette.

Field Name

Type

Description

advanced_metering_infrastructure

integer

Number of meters that measure and record usage data at a minimum, in hourly intervals and provide usage data at least daily to energy companies and may also provide data to consumers. Data are used for billing and other purposes. Advanced meters include basic hourly interval meters and extend to real-time meters with built-in two-way communication capable of recording and transmitting instantaneous data.

automated_meter_reading

integer

Number of meters that collect data for billing purposes only and transmit this data one way, usually from the customer to the distribution utility.

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

daily_digital_access_customers

integer

Number of customers able to access daily energy usage through a webportal or other electronic means.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

direct_load_control_customers

integer

Number of customers with direct load control: a A demand response activity by which the program sponsor remotely shuts down or cycles a customer’s electrical equipment (e.g. air conditioner, water heater) on short notice.

energy_served_ami_mwh

number

Amount of energy served through AMI meters. AMI meters can transmit data in both directions, between the delivery entity and the customer.

entity_type

string

Entity type of principal owner.

home_area_network

integer

Number of AMI meters with home area network (HAN) gateway enabled.

non_amr_ami

integer

Number of non-AMR/AMI meters. Usually electromechanical or solid state meters measuring aggregated kWh where data are manually retrieved over monthly billing cycles for billing purposes only. Standard meters may also include functions to measure time-of-use and/or demand with data manually retrieved over monthly billing cycles.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_balancing_authority#

Annual entity table for balancing authorities. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

balancing_authority_id_eia

integer

EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.

balancing_authority_name_eia

string

Name of the balancing authority.

report_date

date

Date reported.

core_eia861__yearly_demand_response#

Energy demand response programs by state, sector, and balancing authority. We collect data for the number of customers enrolled, energy savings, potential and actual peak savings, and associated costs.

The EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. Browse or query this table in Datasette.

Field Name

Type

Description

actual_peak_demand_savings_mw

number

Demand reduction actually achieved by demand response activities. Measured at the time of the company's annual system peak hour.

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

customer_incentives_cost

number

Total cost of customer incentives in a given report year. Customer incentives are the total financial value provided to a customer for program participation, whether, for example, cash payment, or lowered tariff rates relative to non-participants, in-kind services (e.g. design work), or other benefits directly provided to the customer for their program participation.

customers

number

Number of customers.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_savings_mwh

number

The energy savings incurred in a given reporting year by participation in demand response programs.

other_costs

number

Additional costs.

potential_peak_demand_savings_mw

number

The total demand savings that could occur at the time of the system peak hour assuming all demand response is called.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_demand_response_water_heater#

The number of grid connected water heaters enrolled in demand response programs. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

water_heater

integer

The number of grid-enabled water heaters added to the respondent's program this year - if the respondent has DSM program for grid-enabled water heaters (as defined by DOE’s Office of Energy Efficiency and Renewable Energy).

core_eia861__yearly_demand_side_management_ee_dr#

The impact of energy efficiency and load management programs on total energy sold (MWh) and peak demand (MW) by customer class. Includes incremental effects (from new programs and new participants) as well as total annual effects (all programs and participants in a given year) and potential effects (anticipated peak reduction for load management programs). Also includes the cost of DSM programs and the number of customers enrolled in price-responsive and time-responsive programs.

The raw EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. Browse or query this table in Datasette.

Field Name

Type

Description

annual_indirect_program_cost

number

Costs that have not been included in any program category, but could be meaningfully identified with operating the company’s DSM programs (e.g., Administrative, Marketing, Monitoring & Evaluation, Company-Earned Incentives, Other).

annual_total_cost

number

The sum of direct program costs, indirect program costs, and incentive payments associated with utility demand side management programs.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_efficiency_annual_actual_peak_reduction_mw

number

The peak reduction incurred in a given reporting year by all participants in efficiency programs.

energy_efficiency_annual_cost

number

The sum of actual direct costs, incentive payments, and indirect costs incurred in a given reporting year from energy efficiency programs.

energy_efficiency_annual_effects_mwh

number

The change in energy use incurred in a given reporting year by all participants in energy efficiency programs.

energy_efficiency_annual_incentive_payment

number

The cost of incentive payments incurred in a given reporting year from energy efficiency programs. Incentives are the total financial value provided to a customer for program participation, whether cash payment, in-kind services (e.g. design work), or other benefits directly provided customer for their program participation.

energy_efficiency_incremental_actual_peak_reduction_mw

number

The peak reduction incurred in a given reporting year by new participants in existing energy efficiency programs and all participants in new energy efficiency programs.

energy_efficiency_incremental_effects_mwh

number

The change in energy use incurred in a given reporting year by new participants in existing energy efficiency programs and all participants in new energy efficiency programs.

load_management_annual_actual_peak_reduction_mw

number

The peak reduction incurred in a given reporting year by all participants in load management programs.

load_management_annual_cost

number

The sum of actual direct costs, incentive payments, and indirect costs incurred in a given reporting year from load management programs.

load_management_annual_effects_mwh

number

The change in energy use incurred in a given reporting year by all participants in load management programs.

load_management_annual_incentive_payment

number

The cost of incentive payments incurred in a given reporting year from load management programs. Incentives are the total financial value provided to a customer for program participation, whether cash payment, in-kind services (e.g. design work), or other benefits directly provided customer for their program participation.

load_management_annual_potential_peak_reduction_mw

number

The potential amount of peak reduction that could be incurred in a given reporting year by all participants in load management programs.

load_management_incremental_actual_peak_reduction_mw

number

The peak reduction incurred in a given reporting year by new participants in existing load management programs and all participants in new load management programs.

load_management_incremental_effects_mwh

number

The change in energy use incurred in a given reporting year by new participants in existing load management programs and all participants in new load managment programs.

load_management_incremental_potential_peak_reduction_mw

number

The potential amount of peak reduction that could be incurred in a given reporting year by new participants in existing load management programs and all participants in new load management programs.

nerc_region

string

NERC region in which the plant is located

price_responsiveness_customers

integer

The number of customers participating in the respondent's incentive-based demand response programs.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

time_responsiveness_customers

integer

The number of cusomters participating in the respondent's time-based rate programs.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_demand_side_management_misc#

Miscellaneous information from the EIA861 DSM table. Includes boolean fields about whether the energy savings estimates/calculations were independently verified and whether the utility runs time and or price responsive programs. Also contains information on whether any of the respondent's DSM activities are reported under another company, and if so which one.

The raw EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_savings_estimates_independently_verified

boolean

Whether savings estimates are based on a forecast or the report of one or more independent evaluators.

energy_savings_independently_verified

boolean

Whether reported energy savings were verified through an independent evaluation.

entity_type

string

Entity type of principal owner.

major_program_changes

boolean

Whether there have been any major changes to the respondent's demand-side management programs (e.g., terminated programs, new information or financing programs, or a shift to programs with dual load building objectives and energy efficiency objectives), program tracking procedures, or reporting methods that affect the comparison of demand-side management data reported on this schedule to data from previous years.

nerc_region

string

NERC region in which the plant is located

price_responsive_programs

boolean

Whether the respondent operates any incentive-based demand response programs (e.g., market incentives, financial incentives, direct load control, interruptible programs, demand bidding/buyback, emergency demand response, capacity market programs, and ancillary service market programs).

report_date

date

Date reported.

reported_as_another_company

string

The name of the company if a respondent's demand-side management activities are reported on Schedule 6 of another company’s form.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

time_responsive_programs

boolean

Whether the respondent operates any time-based rate programs (e.g., real-time pricing, critical peak pricing, variable peak pricing and time-of-use rates administered through a tariff).

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_demand_side_management_sales#

Electricity sales for resale and to ultimate customer.

The raw EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

nerc_region

string

NERC region in which the plant is located

report_date

date

Date reported.

sales_for_resale_mwh

number

The amount of electricity sold for resale purposes. This entry should include sales for resale to power marketers (reported separately in previous years), full and partial requirements customers, firm power customers and nonfirm customers.

sales_to_ultimate_consumers_mwh

number

The amount of electricity sold to customers purchasing electricity for their own use and not for resale.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_distributed_generation_fuel#

Information on the energy sources used for utility or customer-owned distributed generation capacity.

The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

estimated_or_actual_fuel_data

string

Whether the reported fuel data is estimated or actual.

fuel_class

string

Fuel types specific to EIA 861 distributed generation table: ['gas', 'oil', 'other', 'renewable', 'water', 'wind', 'wood']

fuel_pct

number

Percent of fuel

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_distributed_generation_misc#

Information on the capacity of utility or customer-owned distributed generation. Includes the number of generators, whether the capacity is esimated or actual, the amount of backup capacity, and how much capacity is from generators with less than 1 MW of nameplate capacity.

The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. Browse or query this table in Datasette.

Field Name

Type

Description

backup_capacity_mw

number

The total nameplate capacity of generators that are used only for emergency backup service.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

distributed_generation_owned_capacity_mw

number

Amount of distributed generation capacity owned by the respondent.

estimated_or_actual_capacity_data

string

Whether the reported capacity data is estimated or actual.

generators_num_less_1_mw

integer

Total number of generators less than 1 MW.

generators_number

integer

Total number of generators

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

total_capacity_less_1_mw

number

The total amount of capacity from generators with less than 1 MW of nameplate capacity.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_distributed_generation_tech#

Information on the technology used for utility or customer-owned distributed generation.

The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

estimated_or_actual_tech_data

string

Whether the reported technology data is estimated or actual.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

tech_class

string

Type of technology specific to EIA 861 distributed generation and net generation tables: ['backup', 'chp_cogen', 'combustion_turbine', 'fuel_cell', 'hydro', 'internal_combustion', 'other', 'pv', 'steam', 'storage_pv', 'all_storage', 'total', 'virtual_pv', 'wind'].

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_distribution_systems#

The number of distribution circuits and circuits with voltage optimization by state. Browse or query this table in Datasette.

Field Name

Type

Description

circuits_with_voltage_optimization

integer

Number of distribution circuits that employ voltage/VAR optimization (VVO).

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

distribution_circuits

integer

Total number of distribution circuits.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_dynamic_pricing#

The number of customers enrolled in dynamic pricing programs by state, sector, and balancing authority. Respondents check if one or more customers are enrolled in time-of-use pricing, real time pricing, variable peak pricing, critical peak pricing, and critical peak rebates. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

critical_peak_pricing

boolean

Whether customers are participating in critical peak pricing, a program in which rate and/or price structure is designed to encourage reduced consumption during periods of high wholesale market prices or system contingencies, by imposing a pre-specified high rate or price for a limited number of days or hours.

critical_peak_rebate

boolean

Whether customers are participating in critical peak rebates, a program in which rate and/or price structure is designed to encourage reduced consumption during periods of high wholesale market prices or system contingencies, by providing a rebate to the customer on a limited number of days and for a limited number of hours, at the request of the energy provider.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

customers

number

Number of customers.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

real_time_pricing

boolean

Whether the respondent has customers participating in a real time pricing (RTP) program. RTP is a program of rate and price structure in which the retail price for electricity typically fluctuates hourly or more often, to reflect changes in the wholesale price of electricity on either a day- ahead or hour-ahead basis.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

time_of_use_pricing

boolean

Whether the respondent has customers participating in a time-of-use pricing programs (TOU). TOU is a program in which customers pay different prices at different times of the day. On-peak prices are higher and off-peak prices are lower than a “standard” rate. Price schedule is fixed and predefined, based on season, day of week, and time of day.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

variable_peak_pricing

boolean

Whether the respondent has customers participating in a variable peak pricing program (VPP). VPP is a program in which a form of TOU pricing allows customers to purchase their generation supply at prices set on a daily basis with varying on-peak and constant off-peak rates. Under the VPP program, the on-peak price for each weekday becomes available the previous day (typically late afternoon) and the customer is billed for actual consumption during the billing cycle at these prices.

core_eia861__yearly_energy_efficiency#

Incremental energy savings, peak demand savings, weighted average life cycle, and associated costs for the reporting year and life cycle of energy efficiency programs.

The EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

customer_incentives_incremental_cost

number

The cost of customer incentives resulting from new participants in existing energy efficiency programs and all participants in new energy efficiency programs. Customer incentives are the total financial value provided to a customer for program participation, whether, for example, cash payment, or lowered tariff rates relative to non-participants, in-kind services (e.g. design work), or other benefits directly provided to the customer for their program participation.

customer_incentives_incremental_life_cycle_cost

number

All anticipated costs of the customer incentives including reporting year incremental costs and all future costs. Customer incentives are the total financial value provided to a customer for program participation, whether, for example, cash payment, or lowered tariff rates relative to non-participants, in-kind services (e.g. design work), or other benefits directly provided to the customer for their program participation.

customer_other_costs_incremental_life_cycle_cost

number

All anticipated costs other than customer incentives. Includes reporting year incremental costs and all future costs.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

incremental_energy_savings_mwh

number

energy savings in the given report year resulting from new participants in existing demand response programs and all participants in new demand response programs.

incremental_life_cycle_energy_savings_mwh

number

The estimated total changes in energy use for incremental programs and participants over the life of the programs. DSM programs have a useful life, and the net effects of these programs will diminish over time. Considers the useful life of energy efficiency technology by accounting for building demolition, equipment degradation, and program attrition.

incremental_life_cycle_peak_reduction_mw

number

The estimated total changes in peak load for incremental programs and participants over the life of the programs. DSM programs have a useful life, and the net effects of these programs will diminish over time. Considers the useful life of energy efficiency technology by accounting for building demolition, equipment degradation, and program attrition.

incremental_peak_reduction_mw

number

The peak reduction incurred in a given reporting year by new participants in existing energy efficiency programs and all participants in new energy efficiency programs.

other_costs_incremental_cost

number

Costs resulting from new participants in existing energy efficiency programs and all participants in new energy efficiency programs that aren't directly associated with customer incentives.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

weighted_average_life_years

number

The weighted average life of the respondent's portfolio of energy efficiency programs.

core_eia861__yearly_green_pricing#

Green pricing program revenue, sales, and customer count by sector and state. Browse or query this table in Datasette.

Field Name

Type

Description

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

customers

number

Number of customers.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

green_pricing_revenue

number

The money derived from premium green pricing rate of the respondent'sprogram.

rec_revenue

number

Amount of revenue collected from Renewable Energy Certificates (RECs).

rec_sales_mwh

number

Amount of sales collected from Renewable Energy Certificates (RECs).

report_date

date

Date reported.

sales_mwh

number

Quantity of electricity sold in MWh.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_mergers#

Information about utility mergers and acquisitions. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

entity_type

string

Entity type of principal owner.

merge_address

string

Address of new parent company.

merge_city

string

City of new parent company.

merge_company

string

Name of the company merged with or acquired.

merge_date

date

Date of merger or acquisition.

merge_state

string

Two letter US state abbreviations and three letter ISO-3166-1 country codes for international mines.

new_parent

string

Name of the new parent company post merger.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

zip_code

string

Five digit US Zip Code.

zip_code_4

string

Four digit US Zip Code suffix.

core_eia861__yearly_net_metering_customer_fuel_class#

The amount of energy sold to back to the grid. From 2007 - 2009 the data are reported as a lump sum of total energy dispatched by sector. After 2009, the data are broken down by sector and technology type. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

customers

number

Number of customers.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

sold_to_utility_mwh

number

The amount of electric energy sold back to the utility through the net metering application.

state

string

Two letter US state abbreviation.

tech_class

string

Type of technology specific to EIA 861 distributed generation and net generation tables: ['backup', 'chp_cogen', 'combustion_turbine', 'fuel_cell', 'hydro', 'internal_combustion', 'other', 'pv', 'steam', 'storage_pv', 'all_storage', 'total', 'virtual_pv', 'wind'].

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_net_metering_misc#

The PV current flow type for net metered capacity. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

pv_current_flow_type

string

Current flow type for photovoltaics: AC or DC

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_non_net_metering_customer_fuel_class#

The amount of non-net metered distributed generation by sector and technology type.

The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

tech_class

string

Type of technology specific to EIA 861 distributed generation and net generation tables: ['backup', 'chp_cogen', 'combustion_turbine', 'fuel_cell', 'hydro', 'internal_combustion', 'other', 'pv', 'steam', 'storage_pv', 'all_storage', 'total', 'virtual_pv', 'wind'].

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_non_net_metering_misc#

Information on the capacity of utility or customer-owned distributed generation. Includes the number of generators, pv current flow type, backup capacity and utility owned capacity.

The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. Browse or query this table in Datasette.

Field Name

Type

Description

backup_capacity_mw

number

The total nameplate capacity of generators that are used only for emergency backup service.

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

generators_number

integer

Total number of generators

pv_current_flow_type

string

Current flow type for photovoltaics: AC or DC

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_owned_capacity_mw

number

Total non-net-metered capacity owned by the respondent.

core_eia861__yearly_operational_data_misc#

The annual megawatt hours (MWH) for all a utility's sources of electricity and disposition of electricity listed. Sources include: net generation purchases from electricity suppliers, exchanges received, exchanges delivered, exchanges net, wheeled recieved, wheeled delivered, wheeled net, transmission by others, and losses. Browse or query this table in Datasette.

Field Name

Type

Description

consumed_by_facility_mwh

number

The amount of electricity used by the facility.

consumed_by_respondent_without_charge_mwh

number

The amount of electricity used by the electric utility in its electric and other departments without charge.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

data_observed

boolean

Is the value observed (True) or imputed (False).

entity_type

string

Entity type of principal owner.

exchange_energy_delivered_mwh

number

The amount of exchange energy delivered. Does not include power delivered as part of a tolling arrangement.

exchange_energy_received_mwh

number

The amount of exchange energy received. Does not include power received through tolling arrangements.

furnished_without_charge_mwh

number

The amount of electricity furnished by the electric utility without charge, such as to a municipality under a franchise agreement or for street and highway lighting.

nerc_region

string

NERC region in which the plant is located

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

net_power_exchanged_mwh

number

The net amount of energy exchanged. Net exchange is the difference between the amount of exchange received and the amount of exchange delivered. This entry should not include wholesale energy purchased from or sold to regulated companies or unregulated companies for other systems.

net_wheeled_power_mwh

number

The difference between the amount of energy entering the respondent's system (wheeled received) for transmission through the respondent's system and the amount of energy leaving the respondent's system (wheeled delievered). Wheeled net represents the energy losses on the respondent's system associated with the wheeling of energy for other systems.

report_date

date

Date reported.

retail_sales_mwh

number

MWh of sales to end-use customers in areas where the customer has been given the legal right to select a power supplier other than the traditional, vertically integrated electric utility.

sales_for_resale_mwh

number

The amount of electricity sold for resale purposes. This entry should include sales for resale to power marketers (reported separately in previous years), full and partial requirements customers, firm power customers and nonfirm customers.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

summer_peak_demand_mw

number

The maximum hourly summer load (for the months of June through September) based on net energy for the system during the reporting year. Net energy for the system is the sum of energy an electric utility needs to satisfy their service area and includes full and partial wholesale requirements customers, and the losses experienced in delivery. The maximum hourly load is determined by the interval in which the 60-minute integrated demand is the greatest.

total_disposition_mwh

number

Sum of all disposition of electricity listed. Includes sales to ultimate customers, sales for resale, energy furnished without charge, energy consumed by respondent without charge and total energy losses.

total_energy_losses_mwh

number

The total amount of electricity lost from transmission, distribution, and/or unaccounted for. Should be expressed as a positive number.

total_sources_mwh

number

Sum of all sources of electricity listed. Includes net generation, purchases from electricity suppliers, net exchanges (received - delivered), net wheeled (received - delivered), transmission by others, and losses.

transmission_by_other_losses_mwh

number

The amount of energy losses associated with the wheeling of electricity provided to the respondent's system by other utilities. Transmission by others, losses should always be a negative value.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

wheeled_power_delivered_mwh

number

The total amount of energy leaving the respondent's system that was transmitted through the respondent's system for delivery to other systems. If wheeling delivered is not precisely known, the value is an estimate based on the respondent's system's known percentage of losses for wheeling transactions.

wheeled_power_received_mwh

number

The total amount of energy entering the respondent's system from other systems for transmission through the respondent's system (wheeling) for delivery to other systems. Does not include energy purchased or exchanged for consumption within the respondent's system, which was wheeled to the respondent by others.

wholesale_power_purchases_mwh

number

Purchases from electricity suppliers.

winter_peak_demand_mw

number

The maximum hourly winter load (for the months of January through March) based on net energy for the system during the reporting year. Net energy for the system is the sum of energy an electric utility needs to satisfy their service area and includes full and partial wholesale requirements customers, and the losses experienced in delivery. The maximum hourly load is determined by the interval in which the 60-minute integrated demand is the greatest.

core_eia861__yearly_operational_data_revenue#

A utility's revenue by type of electric operating revenue. Includes electric operating revenue From sales to ultimate customers, revenue from unbundled (delivery) customers, revenue from sales for resale, electric credits/other adjustments, revenue from transmission, other electric operating revenue, and total electric operating revenue. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

nerc_region

string

NERC region in which the plant is located

report_date

date

Date reported.

revenue

number

Amount of revenue.

revenue_class

string

Source of revenue: ['credits_or_adjustments', 'delivery_customers', 'other', 'retail_sales', 'sales_for_resale', 'total', 'transmission', 'unbundled']

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_reliability#

Standardized metrics of electricity system reliability and outage impacts. Includes the system average interruption duration index (SAIDI), system average interruption frequency index (SAIFI), and customer average interruption duration index (CAIDI) aka SAIDI/SAIFI with and without major event days and loss of service. Includes the standard (IEEE/other) and other relevant information. Browse or query this table in Datasette.

Field Name

Type

Description

caidi_w_major_event_days_minus_loss_of_service_minutes

number

Average number of minutes per interruption (SAIDI/SAIFI) including major event days and excluding reliability events caused by a loss of supply.

caidi_w_major_event_days_minutes

number

Average number of minutes per interruption (SAIDI/SAIFI) including major event days.

caidi_wo_major_event_days_minutes

number

Average number of minutes per interruption (SAIDI/SAIFI) excluding major event days.

customers

number

Number of customers.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

entity_type

string

Entity type of principal owner.

highest_distribution_voltage_kv

number

The highest voltage that's part of the distribution system.

inactive_accounts_included

boolean

Whether the respondent includes inactive accounts in its definition of customers used to determine SAIDI and SAIFI.

momentary_interruption_definition

string

How the respondent defines momentary service interruptions: less than 1 min, equal to or less than 5 min, or some other way.

outages_recorded_automatically

boolean

Whether the information about customer outages is recorded automatically.

report_date

date

Date reported.

saidi_w_major_event_days_minus_loss_of_service_minutes

number

Cumulative duration (minutes) of interruption for the average customer during the report year including major event days and excluding reliability events caused by a loss of supply.

saidi_w_major_event_days_minutes

number

Cumulative duration (minutes) of interruption for the average customer during the report year including major event days.

saidi_wo_major_event_days_minutes

number

Cumulative duration (minutes) of interruption for the average customer during the report year excluding major event days.

saifi_w_major_event_days_customers

number

Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year including major event days.

saifi_w_major_event_days_minus_loss_of_service_customers

number

Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year including major event days and excluding reliability events caused by a loss of supply.

saifi_wo_major_event_days_customers

number

Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year excluding major event days.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

standard

string

Whether the respondent calculates SAIDI/SAIFI, and major event days according to the IEEE or an Other standard.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_sales#

Annual electricity sales to ultimate customers broken down by utility, balancing authority, state, and customer class. Browse or query this table in Datasette.

Field Name

Type

Description

balancing_authority_code_eia

string

EIA short code identifying a balancing authority.

business_model

string

Business model.

customer_class

string

High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation'].

customers

number

Number of customers.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

data_observed

boolean

Is the value observed (True) or imputed (False).

entity_type

string

Entity type of principal owner.

report_date

date

Date reported.

sales_mwh

number

Quantity of electricity sold in MWh.

sales_revenue

number

Revenue from electricity sold.

service_type

string

The type of service the respondent provides to a given customer class.Bundled: both energy and delivery; energy: just the energy consumed; delivery: just the billing and energy delivery services.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_service_territory#

County FIPS codes for counties composing utility service territories. Browse or query this table in Datasette.

Field Name

Type

Description

county

string

County name.

county_id_fips

string

County ID from the Federal Information Processing Standard Publication 6-4.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

report_date

date

Date reported.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

state_id_fips

string

Two digit state FIPS code.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia861__yearly_utility_data_misc#

A table of boolean values indicating what kind of business activities each utility engages in

This includes whether they operate alternative fuel vehicles, whether they provide transmission, distribution, or generation services (bundled or unbundled), and whether they engage in wholesale and/or retail markets. Browse or query this table in Datasette.

Field Name

Type

Description

alternative_fuel_vehicle_2_activity

boolean

Whether the utility plants to operate alternative-fueled vehicles this coming year.

alternative_fuel_vehicle_activity

boolean

Whether the utility operates alternative-fueled vehicles during the year.

bundled_activity

boolean

Whether a utility engaged in combined utility services (electricity plus other services such as gas, water, etc. in addition to electric services) during the year.

buying_distribution_activity

boolean

Whether a utility bought any distribution on other electrical systems during the year.

buying_transmission_activity

boolean

Whether a utility bought any transmission services on other electrical systems during the year.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

distribution_activity

boolean

Whether a utility engaged in any distribution using owned/leased electrical wires during the year.

entity_type

string

Entity type of principal owner.

generation_activity

boolean

Whether a utility utilized generation from company owned plant during the year.

nerc_region

string

NERC region in which the plant is located

operates_generating_plant

boolean

Whether the respondent operated at least one generating plant during the reporting period.

report_date

date

Date reported.

retail_marketing_activity

boolean

Whether a utility engaged in retail power marketing during the year.

short_form

boolean

Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency.

state

string

Two letter US state abbreviation.

transmission_activity

boolean

Whether a utility engaged in any transmission activities during the year.

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

wholesale_marketing_activity

boolean

Whether a utility engages in wholesale power marketing during the year.

core_eia861__yearly_utility_data_nerc#

The NERC regions that a utiltiy operates in. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

nerc_region

string

NERC region in which the plant is located

nerc_regions_of_operation

string

All the regional entities within the North American Electric Reliability Corporation (NERC) in which the respodent conducts operations.

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia861__yearly_utility_data_rto#

The RTOs that a utility operates in. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

nerc_region

string

NERC region in which the plant is located

report_date

date

Date reported.

rtos_of_operation

string

The ISOs/RTOs, in which the respondent conducts operations.

state

string

Two letter US state abbreviation.

utility_id_eia

integer

The EIA Utility Identification number.

core_eia923__entity_coalmine#

Attributes of coal mines reporting deliveries in the Fuel Receipts and Costs table, via EIA-923 Schedule 2, Part C.

This table is produced during the transformation of fuel delivery data, in order to produce a better normalized database. The same coalmines report many individual deliveries, and repeating their attributes many times in the fuel receipts and costs table is duplicative. Unfortunately the coalmine attributes do not generally use a controlled vocabulary or well defined IDs and so in practice there are many distinct records in this table that correspond to the same mines in reality.

We have not yet taken the time to rigorously clean this data, but it could be linked with both Mining Safety and Health Administration (MSHA) and USGS data to provide more insight into where coal is coming from, and what the employment and geological context is for those supplies. Browse or query this table in Datasette.

Field Name

Type

Description

county_id_fips

string

County ID from the Federal Information Processing Standard Publication 6-4.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

mine_id_msha

integer

MSHA issued mine identifier.

mine_id_pudl

integer

Dynamically assigned PUDL mine identifier.

mine_name

string

Coal mine name.

mine_type_code

string

Type of coal mine.

state

string

Two letter US state abbreviation.

core_eia923__monthly_boiler_fuel#

EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3.

Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units.

This table provides better coverage of the entire fleet of generators than the core_eia923__monthly_generation_fuel table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex.

Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

boiler_id

string

Alphanumeric boiler ID.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

core_eia923__monthly_fuel_receipts_costs#

Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A.

Each record describes an individual fuel delivery. There can be multiple deliveries of the same type of fuel from the same supplier to the same plant in a single month, so the table has no natural primary key.

There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units.

Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices.

Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. Browse or query this table in Datasette.

Field Name

Type

Description

ash_content_pct

number

Ash content percentage by weight to the nearest 0.1 percent.

chlorine_content_ppm

number

For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.

contract_expiration_date

date

Date contract expires.Format: MMYY.

contract_type_code

string

Purchase type under which receipts occurred in the reporting month. C: Contract, NC: New Contract, S: Spot Purchase, T: Tolling Agreement.

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_group_code

string

Fuel groups used in the Electric Power Monthly

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_received_units

number

Quanity of fuel received in tons, barrel, or Mcf.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

mercury_content_ppm

number

Mercury content in parts per million (ppm) to the nearest 0.001 ppm.

mine_id_pudl

integer

Dynamically assigned PUDL mine identifier.

moisture_content_pct

number

For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent.

natural_gas_delivery_contract_type_code

string

Contract type for natrual gas delivery service:

natural_gas_transport_code

string

Contract type for natural gas transportation service.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

primary_transportation_mode_code

string

Transportation mode for the longest distance transported.

report_date

date

Date reported.

secondary_transportation_mode_code

string

Transportation mode for the second longest distance transported.

sulfur_content_pct

number

Sulfur content percentage by weight to the nearest 0.01 percent.

supplier_name

string

Company that sold the fuel to the plant or, in the case of Natural Gas, pipline owner.

core_eia923__monthly_generation#

EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3.

Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the core_eia923__monthly_generation_fuel appears in this table due to the different reporting requirements imposed on different types and sizes of generators.

Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations.

Note that a small number of respondents only report annual net generation, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

core_eia923__monthly_generation_fuel#

EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3.

Monthly electricity generation and fuel consumption reported for each combination of fuel and prime mover within a plant. This data can't be easily linked to individual boilers, generators, and generation units, but it is provides the most complete coverage of fuel consumption and electricity generation for the entire generation fleet. We use the primary fuels and prime movers reported for each generator along with their capacities to attribute fuel consumption and generation when it isn't directly reported in the core_eia923__monthly_generation and core_eia923__monthly_boiler_fuel tables in order to calculate capacity factors, heat rates, and the marginal cost of electricity.

The table makes a distinction between all fuel consumed and fuel consumed for electricity generation because some units are also combined heat and power (CHP) units, and also provide high temperature process heat at the expense of net electricity generation.

Note that a small number of respondents only report annual fuel consumption and net generation, and all of it is reported in December. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_for_electricity_units

number

Consumption for electric generation of the fuel type in physical unit.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_aer

string

A partial aggregation of the reported fuel type codes into larger categories used by EIA in, for example, the Annual Energy Review (AER). Two or three letter alphanumeric.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

core_eia923__monthly_generation_fuel_nuclear#

EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3.

Monthly electricity generation and fuel consumption reported for each combination of fuel and prime mover within a nuclear generation unit. This data is originally reported alongside similar information for fossil fuel plants, but the nuclear data is reported by (nuclear) generation unit rather than fuel type and prime mover, and so has a different primary key. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

energy_source_code

string

A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

fuel_consumed_for_electricity_units

number

Consumption for electric generation of the fuel type in physical unit.

fuel_consumed_mmbtu

number

Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_aer

string

A partial aggregation of the reported fuel type codes into larger categories used by EIA in, for example, the Annual Energy Review (AER). Two or three letter alphanumeric.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

nuclear_unit_id

string

For nuclear plants only, the unit number .One digit numeric. Nuclear plants are the only type of plants for which data are shown explicitly at the generating unit level.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

core_eia__codes_averaging_periods#

A coding table describing the averaging period specified by emissions statutes and regulation for in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_balancing_authorities#

A coding table describing balancing authorities in EIA-860 and EIA-923. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_boiler_generator_assn_types#

A coding table describing different types of boiler-generator associations in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_boiler_status#

A coding table describing different types of boiler status in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_boiler_types#

A coding table describing different types of boiler regulatory types in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_coalmine_types#

A coding table describing different types of coalmines reported as fuel sources in the EIA-923. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_contract_types#

A coding table describing the various types of fuel supply contracts reported in EIA-923. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_cooling_system_types#

A coding table for cooling system types. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_cooling_tower_types#

A coding table for cooling tower types. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_cooling_water_sources#

A coding table describing different types of cooling water sources in EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_cooling_water_types#

A coding table for cooling water types. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_emission_control_equipment_types#

A coding table describing the type of emissions control equipment installed on a boiler. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_energy_sources#

Codes and metadata pertaining to energy sources reported to EIA. Compiled from EIA-860 instructions and EIA-923 file layout spreadsheets. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

fuel_derived_from

string

Original fuel from which this refined fuel was derived.

fuel_group_eia

string

High level fuel group defined in the 2021-2023 EIA Form 860 instructions, Table 28.

fuel_phase

string

Physical phase of matter of the fuel.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_units

string

Reported unit of measure for fuel.

label

string

Longer human-readable code using snake_case

max_fuel_mmbtu_per_unit

number

Maximum heat content per physical unit of fuel in MMBtu.

min_fuel_mmbtu_per_unit

number

Minimum heat content per physical unit of fuel in MMBtu.

core_eia__codes_environmental_equipment_manufacturers#

A coding table describing manufacturers of boilers and environmental control equipment in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_firing_types#

A coding table describing different boiler firing types in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_fuel_transportation_modes#

Long descriptions of the fuel transportation modes reported in the EIA-860 and EIA-923. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_fuel_types_aer#

Descriptive labels for aggregated fuel types used in the Annual Energy Review. See EIA-923 Fuel Code table for additional information. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

core_eia__codes_mercury_compliance_strategies#

A coding table describing different compliance strategies used to control mercury in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_momentary_interruptions#

A coding table for utility definitions of momentary service interruptions. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_nox_compliance_strategies#

A coding table describing different compliance strategies used to control nitrogen oxide in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_nox_control_status#

A coding table describing the operational status of nitrogen oxide control units associated with boilers in the EIA-860 data. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_nox_units#

A coding table describing different units of measurement for nitrogen oxide in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_operational_status#

Codes and metadata pertaining to operational status reported to EIA. Compiled from EIA-860 instructions and EIA-923 file layout spreadsheets. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

core_eia__codes_particulate_compliance_strategies#

A coding table describing different compliance strategies used to control particulate matter in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_particulate_units#

A coding table describing different units of measurement for particulate matter in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_prime_movers#

Long descriptions explaining the short prime mover codes reported in the EIA-860 and EIA-923. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_regulations#

A coding table describing the different levels of statutes and codes under which boilers operate in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_reporting_frequencies#

A coding table describing different types of reporting frequencies in plants in the EIA-923. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_sector_consolidated#

Long descriptions for the EIA consolidated NAICS sector codes. Codes and descriptions taken from the EIA-923 File Layout spreadsheet. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_so2_compliance_strategies#

A coding table describing different compliance strategies used to control sulfur dioxide in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_so2_units#

A coding table describing different units of measurement for sulfur dioxide in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_steam_plant_types#

A coding table describing different types of steam plants in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__codes_wet_dry_bottom#

A coding table describing whether boiler has a wet or dry bottom in the EIA-860. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_eia__entity_boilers#

Static boiler attributes compiled from the EIA-860 and EIA-923 data. Browse or query this table in Datasette.

Field Name

Type

Description

boiler_id

string

Alphanumeric boiler ID.

boiler_manufacturer

string

Name of boiler manufacturer.

boiler_manufacturer_code

string

EIA short code for boiler manufacturer.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

core_eia__entity_generators#

Static generator attributes compiled from across the EIA-860 and EIA-923 data. Browse or query this table in Datasette.

Field Name

Type

Description

associated_combined_heat_power

boolean

Indicates whether the generator is associated with a combined heat and power system

bypass_heat_recovery

boolean

Can this generator operate while bypassing the heat recovery steam generator?

duct_burners

boolean

Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas

fluidized_bed_tech

boolean

Indicates whether the generator uses fluidized bed technology

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_date

date

Date the generator began commercial operation.

operating_switch

string

Indicates whether the fuel switching generator can switch when operating

original_planned_generator_operating_date

date

The date the generator was originally scheduled to be operational

other_combustion_tech

boolean

Indicates whether the generator uses other combustion technologies

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

previously_canceled

boolean

Indicates whether the generator was previously reported as indefinitely postponed or canceled

pulverized_coal_tech

boolean

Indicates whether the generator uses pulverized coal technology

rto_iso_lmp_node_id

string

The designation used to identify the price node in RTO/ISO Locational Marginal Price reports

rto_iso_location_wholesale_reporting_id

string

The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report

solid_fuel_gasification

boolean

Indicates whether the generator is part of a solid fuel gasification system

stoker_tech

boolean

Indicates whether the generator uses stoker technology

subcritical_tech

boolean

Indicates whether the generator uses subcritical technology

supercritical_tech

boolean

Indicates whether the generator uses supercritical technology

topping_bottoming_code

string

If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle

ultrasupercritical_tech

boolean

Indicates whether the generator uses ultra-supercritical technology

core_eia__entity_plants#

Static plant attributes, compiled from across all EIA-860 and EIA-923 data. Browse or query this table in Datasette.

Field Name

Type

Description

city

string

Name of the city.

county

string

County name.

latitude

number

Latitude of the plant's location, in degrees.

longitude

number

Longitude of the plant's location, in degrees.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_name_eia

string

Plant name.

state

string

Two letter US state abbreviation.

street_address

string

Physical street address.

timezone

string

IANA timezone name

zip_code

string

Five digit US Zip Code.

core_eia__entity_utilities#

Static attributes of utilities, compiled from all EIA data. Browse or query this table in Datasette.

Field Name

Type

Description

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

core_eia__yearly_fuel_receipts_costs_aggs#

Aggregated fuel receipts and costs from the EIA bulk electricty data. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_agg

string

Category of fuel aggregation in EIA bulk electricity data.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_received_mmbtu

number

Aggregated fuel receipts, in MMBtu, in EIA bulk electricity data.

geo_agg

string

Category of geographic aggregation in EIA bulk electricity data.

report_date

date

Date reported.

sector_agg

string

Category of sectoral aggregation in EIA bulk electricity data.

temporal_agg

string

Category of temporal aggregation in EIA bulk electricity data.

core_epa__assn_eia_epacamd#

This crosswalk table comes from the EPA's Github repo camd-eia-crosswalk: https://github.com/USEPA/camd-eia-crosswalk. It's purpose is to connect EPA units with EIA plants, boilers, and generators. The camd-eia-crosswalk README and our Data Source documentation page on EPA Hourly Continuous Emission Monitoring System (CEMS) depict the complicated relationship between EIA and EPA data, specifically the nature of EPA vs. EIA "units" and the level of granularity that one can connect the two sources.

The crosswalk table is generated using EIA data from 2018 meaning that any plants that have shifted before or since then aren't accurately reflected in the data. We're hoping to create a temporal version of the crosswalk at some point.

Our version of the crosswalk clarifies some of the column names and removes unmatched rows. The pudl.etl.glue_assets.core_epa__assn_eia_epacamd() function doc strings explain what changes are made from the EPA's version. Browse or query this table in Datasette.

Field Name

Type

Description

boiler_id

string

Alphanumeric boiler ID.

emissions_unit_id_epa

string

Emissions (smokestack) unit monitored by EPA CEMS.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_id_epa

string

Generator ID used by the EPA.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_epa

integer

The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia.

report_year

integer

Four-digit year in which the data was reported.

core_epa__assn_eia_epacamd_subplant_ids#

This table is an augmented version of the core_epa__assn_eia_epacamd crosswalk table which initally comes from the EPA's Github repo camd-eia- crosswalk: https://github.com/USEPA/camd-eia-crosswalk. It's purpose is to connect EPA units with EIA units, and generators.

This table identifies subplants within plant_ids, which are the smallest coherent units for aggregation. plant_id refers to a legal entity that often contains multiple distinct power plants, even of different technology or fuel types.

EPA CEMS data combines information from several parts of a power plant: * emissions from smokestacks * fuel use from combustors * electricty production from generators But smokestacks, combustors, and generators can be connected in complex, many- to-many relationships. This complexity makes attribution difficult for, as an example, allocating pollution to energy producers. Furthermore, heterogeneity within plant_ids make aggregation to the parent entity difficult or inappropriate.

This table inherits from the EPA's crosswalk, the ID's from EPA CAMD core_epacems__hourly_emissions table itself, the core_eia860__assn_boiler_generator table and the core_eia860__scd_generators table. While the core_epa__assn_eia_epacamd table is the core backbone of the table, EPA CAMD id's ensure there is complete coverage of EPA CAMD reporting units. The EIA 860 table addition ensures there is also complete coverage of those units as well.

For more information about the how this subplant_id is made, see the documentation for pudl.etl.glue_assets.make_subplant_ids and pudl.etl.glue_assets.update_subplant_ids from: https://catalystcoop-pudl.readthedocs.io/en/latest/autoapi/index.html

But by analyzing the relationships between combustors and generators, as provided in the core_epa__assn_eia_epacamd crosswalk, we can identify distinct power plants. These are the smallest coherent units of aggregation.

This table does not have primary keys because the primary keys would have been: plant_id_eia, generator_id, subplant_id and emissions_unit_id_epa, but there are some null records in the generator_id column because ~2 percent of all EPA CAMD records are not successfully mapped to EIA generators. Browse or query this table in Datasette.

Field Name

Type

Description

emissions_unit_id_epa

string

Emissions (smokestack) unit monitored by EPA CEMS.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_epa

integer

The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia.

subplant_id

integer

Sub-plant ID links EPA CEMS emissions units to EIA units.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

core_epacems__hourly_emissions#

Hourly emissions and plant operational data reported via Continuous Emissions Monitoring Systems as required by 40 CFR Part 75. Browse or query this table in Datasette.

Field Name

Type

Description

co2_mass_measurement_code

string

Identifies whether the reported value of emissions was measured, calculated, or measured and substitute.

co2_mass_tons

number

Carbon dioxide emissions in short tons.

emissions_unit_id_epa

string

Emissions (smokestack) unit monitored by EPA CEMS.

gross_load_mw

number

Average power in megawatts delivered during time interval measured.

heat_content_mmbtu

number

The energy contained in fuel burned, measured in million BTU.

nox_mass_lbs

number

NOx emissions in pounds.

nox_mass_measurement_code

string

Identifies whether the reported value of emissions was measured, calculated, or measured and substitute.

operating_datetime_utc

datetime

Date and time measurement began (UTC).

operating_time_hours

number

Length of time interval measured.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_epa

integer

The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia.

so2_mass_lbs

number

Sulfur dioxide emissions in pounds.

so2_mass_measurement_code

string

Identifies whether the reported value of emissions was measured, calculated, or measured and substitute.

state

string

Two letter US state abbreviation.

steam_load_1000_lbs

number

Total steam pressure produced by a unit during the reported hour.

year

integer

Year the data was reported in, used for partitioning EPA CEMS.

core_ferc1__codes_power_purchase_types#

Coding table defining different types of electricity power purchases. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

label

string

Longer human-readable code using snake_case

core_ferc1__yearly_balance_sheet_assets_sched110#

Comparative Balance Sheet (Assets and Other Debits). Schedule 110. Browse or query this table in Datasette.

Field Name

Type

Description

asset_type

string

Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_balance_sheet_liabilities_sched110#

Comparative balance sheet (liabilities and other credits) Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

liability_type

string

Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_cash_flows_sched120#

The structured portion of the FERC1 cash flow table - Schedule 120. Browse or query this table in Datasette.

Field Name

Type

Description

amount

number

Reported amount of dollars. This could be a balance or a change in value.

amount_type

string

Label describing the type of amount being reported. This could be a balance or a change in value.

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_depreciation_by_function_sched219#

Accumulated provision for depreciation of electric utility plant (Account 108). Schedule 219 Section B: Functional plant classifications. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

depreciation_type

string

Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.

ending_balance

number

Account balance at end of year.

plant_function

string

Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).

plant_status

string

Utility plant financial status (in service, future, leased, total).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_depreciation_changes_sched219#

Accumulated provision for depreciation of electric utility plant (Account 108). Schedule 219 Section A: balances and changes during year. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

depreciation_type

string

Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

plant_status

string

Utility plant financial status (in service, future, leased, total).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_depreciation_summary_sched336#

Depreciation and Amortization of Electric Plant (Account 403, 404, 405) Section A: Summary of depreciation and amortization changes. Schedule 336a of FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

ferc_account_label

string

Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.

plant_function

string

Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_energy_dispositions_sched401#

Electric Energy Account, dispositions only. Schedule 401a. Electricity utilities delived to end users, internal losses, etc. Browse or query this table in Datasette.

Field Name

Type

Description

energy_disposition_type

string

Type of energy disposition reported in the core_ferc1__yearly_energy_dispositions_sched401. Dispositions include sales to customers, re-sales of energy, energy used internally, losses, etc.

energy_mwh

number

Sources and uses of energy in MWh.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_energy_sources_sched401#

Electric Energy Account, sources only. Schedule 401a. Amount of electricity the utility obtained from each of several sources, by year. Browse or query this table in Datasette.

Field Name

Type

Description

energy_mwh

number

Sources and uses of energy in MWh.

energy_source_type

string

Type of energy source reported in the core_ferc1__yearly_energy_sources_sched401 table. There are three groups of energy sources: generation, power exchanges and transmission.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_hydroelectric_plants_sched406#

Hydroelectric generating plant statistics for large plants. Large plants have an installed nameplate capacity of more than 10 MW. As reported on FERC Form 1, Schedule 406 (pages 406-407), and extracted from the f1_hydro table in FERC's FoxPro database. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_equipment

number

Cost of plant: equipment (USD).

capex_facilities

number

Cost of plant: reservoirs, dams, and waterways (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_roads

number

Cost of plant: roads, railroads, and bridges (USD).

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

installation_year

integer

Year the plant's most recently built unit was installed.

net_capacity_adverse_conditions_mw

number

Net plant capability under the least favorable operating conditions, in megawatts.

net_capacity_favorable_conditions_mw

number

Net plant capability under the most favorable operating conditions, in megawatts.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

opex_dams

number

Production expenses: maintenance of reservoirs, dams, and waterways (USD).

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_generation_misc

number

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

number

Production expenses: hydraulic expenses (USD).

opex_misc_plant

number

Production expenses: maintenance of miscellaneous hydraulic plant (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plant

number

Production expenses: maintenance of electric plant (USD).

opex_rents

number

Production expenses: rents (USD).

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_water_for_power

number

Production expenses: water for power (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

project_num

integer

FERC Licensed Project Number.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_income_statements_sched114#

Statement of Income. Schedule 114. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

income_type

string

Type of income reported in income_statement_ferc1 table.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_operating_expenses_sched320#

Operating and maintenance costs associated with producing electricty, reported in Schedule 320 of FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

expense_type

string

The type of expense.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_operating_revenues_sched300#

Electric operating revenues - The structed part of schedule 300.There are a number of revenue_type's that do not have sales_mwh,or avg_customers_per_month provided, in which case these columnswill be NULL. Browse or query this table in Datasette.

Field Name

Type

Description

avg_customers_per_month

number

Average number of customers per month.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

revenue_type

string

Label describing types of revenues.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

sales_mwh

number

Quantity of electricity sold in MWh.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_other_regulatory_liabilities_sched278#

Other regulatory liabilities, including rate order docket number. Browse or query this table in Datasette.

Field Name

Type

Description

account_detail

string

Description of the account number credited from making debit adjustment to other regulatory liabilities.

decrease_in_other_regulatory_liabilities

number

The decrease during the reporting period of other regulatory liabilities.

description

string

Long human-readable description of the meaning of a code/label.

ending_balance

number

Account balance at end of year.

increase_in_other_regulatory_liabilities

number

The increase during the reporting period of other regulatory liabilities.

report_year

integer

Four-digit year in which the data was reported.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_plant_in_service_sched204#

Balances and changes to FERC Electric Plant in Service accounts, as reported on FERC Form 1, Schedule 204. Data originally from the f1_plant_in_srvce table in FERC's FoxPro database. Account numbers correspond to the FERC Uniform System of Accounts for Electric Plant, which is defined in Code of Federal Regulations (CFR) Title 18, Chapter I, Subchapter C, Part 101. (See e.g. https://www.law.cornell.edu/cfr/text/18/part-101). Each FERC respondent reports starting and ending balances for each account annually. Balances are organization wide, and are not broken down on a per-plant basis. End of year balance should equal beginning year balance plus the sum of additions, retirements, adjustments, and transfers. Browse or query this table in Datasette.

Field Name

Type

Description

additions

number

Cost of acquisition of items classified within the account.

adjustments

number

Cost of adjustments to the account.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

ferc_account_label

string

Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.

plant_status

string

Utility plant financial status (in service, future, leased, total).

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

retirements

number

Cost of disposal of items classified within the account.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

transfers

number

Cost of transfers into (out of) the account.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_pumped_storage_plants_sched408#

Generating plant statistics for hydroelectric pumped storage plants with an installed nameplate capacity of 10+ MW. As reported in Scheudle 408 of FERC Form 1 and extracted from the f1_pumped_storage table in FERC's Visual FoxPro Database. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_equipment_electric

number

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

number

Cost of plant: miscellaneous power plant equipment (USD).

capex_facilities

number

Cost of plant: reservoirs, dams, and waterways (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_roads

number

Cost of plant: roads, railroads, and bridges (USD).

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

capex_wheels_turbines_generators

number

Cost of plant: water wheels, turbines, and generators (USD).

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

energy_used_for_pumping_mwh

number

Energy used for pumping, in megawatt-hours.

installation_year

integer

Year the plant's most recently built unit was installed.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

net_load_mwh

number

Net output for load (net generation - energy used for pumping) in megawatt-hours.

opex_dams

number

Production expenses: maintenance of reservoirs, dams, and waterways (USD).

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_generation_misc

number

Production expenses: miscellaneous power generation expenses (USD).

opex_misc_plant

number

Production expenses: maintenance of miscellaneous hydraulic plant (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plant

number

Production expenses: maintenance of electric plant (USD).

opex_production_before_pumping

number

Total production expenses before pumping (USD).

opex_pumped_storage

number

Production expenses: pumped storage (USD).

opex_pumping

number

Production expenses: We are here to PUMP YOU UP! (USD).

opex_rents

number

Production expenses: rents (USD).

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_total

number

Total production expenses, excluding fuel (USD).

opex_water_for_power

number

Production expenses: water for power (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_capability_mw

number

Net plant capability in megawatts.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

project_num

integer

FERC Licensed Project Number.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_purchased_power_and_exchanges_sched326#

Purchased Power (Account 555) including power exchanges (transactions involving a balancing of debits and credits for energy, capacity, etc.) and any settlements for imbalanced exchanges. Reported on pages 326-327 of FERC Form 1. Extracted from the f1_purchased_pwr table in FERC's Visual FoxPro database. Browse or query this table in Datasette.

Field Name

Type

Description

billing_demand_mw

number

Monthly average billing demand (for requirements purchases, and any transactions involving demand charges). In megawatts.

coincident_peak_demand_mw

number

Average monthly coincident peak (CP) demand (for requirements purchases, and any transactions involving demand charges). Monthly CP demand is the metered demand during the hour (60-minute integration) in which the supplier's system reaches its monthly peak. In megawatts.

delivered_mwh

number

Gross megawatt-hours delivered in power exchanges and used as the basis for settlement.

demand_charges

number

Demand charges (USD).

energy_charges

number

Energy charges (USD).

non_coincident_peak_demand_mw

number

Average monthly non-coincident peak (NCP) demand (for requirements purhcases, and any transactions involving demand charges). Monthly NCP demand is the maximum metered hourly (60-minute integration) demand in a month. In megawatts.

other_charges

number

Other charges, including out-of-period adjustments (USD).

purchase_type_code

string

Categorization based on the original contractual terms and conditions of the service. Must be one of 'requirements', 'long_firm', 'intermediate_firm', 'short_firm', 'long_unit', 'intermediate_unit', 'electricity_exchange', 'other_service', or 'adjustment'. Requirements service is ongoing high reliability service, with load integrated into system resource planning. 'Long term' means 5+ years. 'Intermediate term' is 1-5 years. 'Short term' is less than 1 year. 'Firm' means not interruptible for economic reasons. 'unit' indicates service from a particular designated generating unit. 'exchange' is an in-kind transaction.

purchased_mwh

number

Megawatt-hours shown on bills rendered to the respondent. Includes both electricity purchased for storage and non-storage purposes, which were lumped together prior to 2021.

purchased_other_than_storage_mwh

number

Number of megawatt hours purchased during the period for other than energy storage.

purchased_storage_mwh

number

Number of megawatt hours purchased during the period for energy storage.

received_mwh

number

Gross megawatt-hours received in power exchanges and used as the basis for settlement.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

seller_name

string

Name of the seller, or the other party in an exchange transaction.

tariff

string

FERC Rate Schedule Number or Tariff. (Note: may be incomplete if originally reported on multiple lines.)

total_settlement

number

Sum of demand, energy, and other charges (USD). For power exchanges, the settlement amount for the net receipt of energy. If more energy was delivered than received, this amount is negative.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_retained_earnings_sched118#

Retained Earnings - The structed part of schedule 118. Browse or query this table in Datasette.

Field Name

Type

Description

balance

string

Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy.

earnings_type

string

Label describing types of earnings.

ending_balance

number

Account balance at end of year.

ferc_account

string

Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

starting_balance

number

Account balance at beginning of year.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

core_ferc1__yearly_sales_by_rate_schedules_sched304#

The pre-2021 data in this table (extracted from FoxProDB vs. XBRL) is extremely unstructured. Where the post-2020 data (from XBRL) sorts the data into rate schedule types: residential, industrial, commercial, public_lighting, public_authorities, railroads, interdepartmental, provision_for_rate_refund, commercial_and_industrial, total, and billing status: billed, unbilled, total, the pre-2021 data stuffs all of that information (if you're lucky) into the rate_schedule_description column. There's no point trying to parse through the pre 2021 rate_schedule_description column en masse because it's just too messy. The contents of rate_schedule_description often contain numbers and acronyms that have little to no meaning out of context. The table is structured somewhat like the FERC1 small generators table with headings about rate structure type also embedded into the rate_schedule_description column. To all who dare, beware.

This table is a combination of one pre-2021 (DBF) table and nine post-2020 (XBRL) tables–one for each rate schedule type plus totals–hence increase in data clarity post-2020. The rate_schedule_type and billing_status columns are only relevant for post-2020 data as they can be reliably parsed from each of the tables and incorporated into columns. The rate_schedule_description is supposed to contain sub-rate_schedule_type names for charges (Ex: Residential 1, Residential 2, etc.). However, the pre-2021 data contains a little bit of everything (or nothing) and the post-2020 has some totals or wonky data thrown in. That's to say, even when working with post-2020 data, be wary of aggregating the data. That's what the "total" rows are for.

The values that come from from the totals table are marked with the string "total" in the rate_schedule_description column. The totals table is a product of the transition to XBRL, so these distinguishable totals are only available for data post-2020 (otherwise you could try keyword searching for "total" in rate_schedule_description). The total table contains two types of totals, the utility totals accross all rate schedules in a given year (marked with rate_schedule_description = "total" and rate_schedule_type = "total") and each of the utility's individual rate schedule totals in a given year (marked with rate_schedule_description = "total" and rate_schdedule_type = "residential" or any other rate schdedule type).

The rate schedule based XBRL tables only report billed values whereas the total tables report billed, unbilled, and total values. (See the column description for more info on the difference between billed and unbilled). This is important to consider if you're endeavoring to compare the subtotal values with the total values. We have not attempted to fix or verify any subtotals or totals that don't add up.

Another important note is the possability of unit discrepancies in certain columns. The revenue_per_kwh column does not specify reporting units, and closer inspection of the data reveals two clear peaks approximate two orders of magnitude appart. This indicates that values may be reported in both dollars and cents. However, because the price of energy per kwh varies so much regionally, we cannot guarantee which is which and have not put any cleaning mechanisms in place to account for this. Browse or query this table in Datasette.

Field Name

Type

Description

avg_customers_per_month

number

Average number of customers per month.

billing_status

string

Whether an amount is billed, unbilled, or both. Billed amounts pertain to the exchange of energy and unbilled amounts pertain to other sources of revenue such as contracts with peaker plants to keep them on standby or charging rent to host cell antennas on transmission towers.

dollar_value

number

Dollar value of reported income, expense, asset, or liability.

kwh_per_customer

number

kWh per customer.

rate_schedule_description

string

Free-form description of what the rate schedule name is. Not standardized. Often a sub-category of rate_schedule_type.

rate_schedule_type

string

Categorization of rate schedule type.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

revenue_per_kwh

number

The amount of revenue per kWh by rate schedule aquired in the given report year.

sales_mwh

number

Quantity of electricity sold in MWh.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_small_plants_sched410#

The generating plant statistics for internal combustion plants, gas turbine-plants, conventional hydro plants, and pumped storage plants with less than 10 MW installed nameplate capacity and steam plants with less than 25 MW installed nameplate capacity. As reported on FERC Form 1 Schedule 410 (pages 410-411) and extracted from the FERC Visual FoxPro and XBRL. See our pudl.extract.ferc1.TABLE_NAME_MAP_FERC1 for links to the raw tables.

The raw version of this table is more like a digitized PDF than an actual data table. The rows contain lots of information in addition to what the columns might suggest. For instance, a single column may contain header rows, note rows, and total rows. This extraneous information is useful, but it prevents proper analysis when mixed in with the rest of the values data in the column. We employ a couple of data transformations to extract these rows from the data and preserve some of the information they contain (fuel type, plant type, FERC license, or general notes about the plant) in separate columns. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_total

number

Total cost of plant (USD).

construction_year

integer

Year the plant's oldest still operational unit was built.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_type

string

Type of fuel.

license_id_ferc1

integer

FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

opex_fuel

number

Production expenses: fuel (USD).

opex_maintenance

number

Production expenses: Maintenance (USD).

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_steam_plants_fuel_sched402#

Annual fuel cost and quantity for steam plants with a capacity of 25+ MW, internal combustion and gas-turbine plants of 10+ MW, and all nuclear plants. As reported on page 402 of FERC Form 1 and extracted from the f1_fuel table in FERC's FoxPro Database. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_consumed_units

number

Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_unit_burned

number

Average cost of fuel consumed in the report year per reported fuel unit (USD).

fuel_cost_per_unit_delivered

number

Average cost of fuel delivered in the report year per reported fuel unit (USD).

fuel_mmbtu_per_unit

number

Heat content of the fuel in millions of Btus per physical unit.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_units

string

Reported unit of measure for fuel.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_steam_plants_sched402#

Generating plant statistics for steam plants with a capacity of 25+ MW, internal combustion and gas-turbine plants of 10+ MW, and all nuclear plants. As reported in Schedule 402 of FERC Form 1 and extracted from the f1_gnrt_plant table in FERC's Visual FoxPro Database. Browse or query this table in Datasette.

Field Name

Type

Description

asset_retirement_cost

number

Asset retirement cost (USD).

avg_num_employees

number

The average number of employees assigned to each plant.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

capex_equipment

number

Cost of plant: equipment (USD).

capex_land

number

Cost of plant: land and land rights (USD).

capex_per_mw

number

Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.

capex_structures

number

Cost of plant: structures and improvements (USD).

capex_total

number

Total cost of plant (USD).

construction_type

string

Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.

construction_year

integer

Year the plant's oldest still operational unit was built.

installation_year

integer

Year the plant's most recently built unit was installed.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

not_water_limited_capacity_mw

number

Plant capacity in MW when not limited by condenser water.

opex_allowances

number

Allowances.

opex_boiler

number

Maintenance of boiler (or reactor) plant.

opex_coolants

number

Cost of coolants and water (nuclear plants only)

opex_electric

number

Production expenses: electric expenses (USD).

opex_engineering

number

Production expenses: maintenance, supervision, and engineering (USD).

opex_fuel

number

Production expenses: fuel (USD).

opex_misc_power

number

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

number

Maintenance of miscellaneous steam (or nuclear) plant.

opex_operations

number

Production expenses: operations, supervision, and engineering (USD).

opex_per_mwh

number

Total production expenses (USD per MWh generated).

opex_plants

number

Maintenance of electrical plant.

opex_production_total

number

Total operating expenses.

opex_rents

number

Production expenses: rents (USD).

opex_steam

number

Steam expenses.

opex_steam_other

number

Steam from other sources.

opex_structures

number

Production expenses: maintenance of structures (USD).

opex_transfer

number

Steam transferred (Credit).

peak_demand_mw

number

Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable.

plant_capability_mw

number

Net plant capability in megawatts.

plant_hours_connected_while_generating

number

Hours the plant was connected to load while generating in the report year.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

plant_type

string

Type of plant.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

water_limited_capacity_mw

number

Plant capacity in MW when limited by condenser water.

core_ferc1__yearly_transmission_lines_sched422#

Transmission Line Statistics. Schedule 422 of FERC Form 1. Information describing transmission lines, the cost of lines, annual operating and capital expenses, etc. Browse or query this table in Datasette.

Field Name

Type

Description

capex_land

number

Cost of Land and land rights for the transmission line.

capex_other

number

Construction and other costs for the transmission line.

capex_total

number

Total costs for the transmission line.

conductor_size_and_material

string

Size of transmission conductor and material of the transmission line.

designed_voltage_kv

number

Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines

end_point

string

The end point of a transmission line.

num_transmission_circuits

integer

Number of circuits in a transmission line.

operating_voltage_kv

number

The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines.

opex_maintenance

number

Maintenance expenses for the transmission line.

opex_operations

number

Operating expenses for the transmission line.

opex_rents

number

Rent expenses for the transmission line.

opex_total

number

Overall expenses for the transmission line.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

start_point

string

The starting point of a transmission line.

supporting_structure_type

string

Supporting structure of the transmission line.

transmission_line_and_structures_length_miles

number

Length (in pole miles or circuit miles (if transmission lines are underground)) for lines that are agrregated with other lines / structures (whose cost are aggregated and combined with other structures).

transmission_line_length_miles

number

Length (in pole miles or circuit miles (if transmission lines are underground)) for lines that are stand alone structures (whose cost are reported on a stand-alone basis).

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_ferc1__yearly_utility_plant_summary_sched200#

Summary of utility plant and accumulated provisions for depreciation, amortization and depletion of utilty plant assets reported annually at the end of the report year. Schedule 200 of FERC Form 1. Browse or query this table in Datasette.

Field Name

Type

Description

ending_balance

number

Account balance at end of year.

record_id

string

Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped.

report_year

integer

Four-digit year in which the data was reported.

row_type_xbrl

string

Indicates whether the value reported in the row is calculated, or uniquely reported within the table.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_plant_asset_type

string

Type of utility plant asset reported in the core_ferc1__yearly_utility_plant_summary_sched200 table. Assets include those leased to others, held for future use, construction work-in-progress and details of accumulated depreciation.

utility_type

string

Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.

utility_type_other

string

Freeform description of type of utility reported in one of the other three other utility_type sections in the core_ferc1__yearly_utility_plant_summary_sched200 table. This field is reported only in the DBF reporting years (1994-2020).

core_ferc714__respondent_id#

Respondent identification. FERC Form 714, Part I, Schedule 1. Browse or query this table in Datasette.

Field Name

Type

Description

eia_code

integer

EIA utility or balancing area authority ID associated with this FERC Form 714 respondent. Note that many utilities are also balancing authorities and in many cases EIA uses the same integer ID to identify a utility in its role as a balancing authority AND as a utility, but there is no requirement that these IDs be the same, and in a number of cases they are different.

respondent_id_ferc714

integer

FERC Form 714 respondent ID. Note that this ID does not correspond to FERC respondent IDs from other forms.

respondent_name_ferc714

string

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

core_ferc__codes_accounts#

Account numbers from the FERC Uniform System of Accounts for Electric Plant, which is defined in Code of Federal Regulations (CFR) Title 18, Chapter I, Subchapter C, Part 101. (See e.g. https://www.law.cornell.edu/cfr/text/18/part-101). Browse or query this table in Datasette.

Field Name

Type

Description

ferc_account_description

string

Description of the FERC account.

ferc_account_id

string

Account identifier from FERC's Uniform System of Accounts for Electric Plant. Includes higher level labeled categories.

core_pudl__assn_eia_pudl_plants#

Association between EIA Plant IDs and manually assigned PUDL Plant IDs Browse or query this table in Datasette.

Field Name

Type

Description

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

core_pudl__assn_eia_pudl_utilities#

Associations between the EIA Utility IDs and the manually assigned PUDL Utility IDs. Browse or query this table in Datasette.

Field Name

Type

Description

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

core_pudl__assn_ferc1_dbf_pudl_utilities#

This table maps the assign utility ID FERC1 to the native utility ID from the FERC1 DBF inputs - originally reported as respondent_id. Browse or query this table in Datasette.

Field Name

Type

Description

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_ferc1_dbf

integer

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

core_pudl__assn_ferc1_pudl_plants#

FERC 1 Plants and their associated manually assigned PUDL Plant IDs Browse or query this table in Datasette.

Field Name

Type

Description

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

core_pudl__assn_ferc1_pudl_utilities#

This table maps two manually assigned utility IDs: a PUDL ID and a FERC1 ID. The PUDL ID maps EIA and FERC1 utilities. The FERC1 ID maps the older DBF respondent IDs to new XBRL entity IDs. This table is generated from a table stored in the PUDL repository: src/package_data/glue/utility_id_pudl.csv Browse or query this table in Datasette.

Field Name

Type

Description

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

core_pudl__assn_ferc1_xbrl_pudl_utilities#

This table maps the assign utility ID FERC1 to the native utility ID from the FERC1 XBRL inputs - originally reported as entity_id. Browse or query this table in Datasette.

Field Name

Type

Description

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_ferc1_xbrl

string

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

core_pudl__assn_utilities_plants#

Associations between PUDL utility IDs and PUDL plant IDs. This table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx Browse or query this table in Datasette.

Field Name

Type

Description

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

core_pudl__codes_data_maturities#

Level of maturities of data records. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. Browse or query this table in Datasette.

Field Name

Type

Description

code

string

Originally reported short code.

description

string

Long human-readable description of the meaning of a code/label.

core_pudl__codes_datasources#

Static table defining codes associated with the data sources that PUDL integrates. Browse or query this table in Datasette.

Field Name

Type

Description

datasource

string

Code identifying a dataset available within PUDL.

doi

string

Unique digitial object identifier of Zenodo archive.

partitions

string

The data parititions used to generate this instance of the database.

pudl_version

string

The version of PUDL used to generate this database.

core_pudl__codes_subdivisions#

Various static attributes associated with states, provinces, and other sub- national political subdivisions. Browse or query this table in Datasette.

Field Name

Type

Description

country_code

string

Three letter ISO-3166 country code (e.g. USA or CAN).

country_name

string

Full country name (e.g. United States of America).

division_code_us_census

string

Three-letter US Census division code as it appears in the bulk electricity data published by the EIA. Note that EIA splits the Pacific division into distinct contiguous (CA, OR, WA) and non-contiguous (AK, HI) states. For reference see this US Census region and division map: https://www2.census.gov/geo/pdfs/maps-data/maps/reference/us_regdiv.pdf

division_name_us_census

string

Longer human readable name describing the US Census division.

is_epacems_state

boolean

Indicates whether the associated state reports data within the EPA's Continuous Emissions Monitoring System.

region_name_us_census

string

Human-readable name of a US Census region.

state_id_fips

string

Two digit state FIPS code.

subdivision_code

string

Two-letter ISO-3166 political subdivision code (e.g. US state or Canadian provice abbreviations like CA or AB).

subdivision_name

string

Full name of political subdivision (e.g. US state or Canadian province names like California or Alberta.

subdivision_type

string

ISO-3166 political subdivision type. E.g. state, province, outlying_area.

timezone_approx

string

IANA timezone name of the timezone which encompasses the largest portion of the population in the associated geographic area.

core_pudl__entity_plants_pudl#

Home table for PUDL assigned plant IDs. These IDs are manually generated each year when new FERC and EIA reporting is integrated, and any newly identified plants are added to the list with a new ID. Each ID maps to a power plant which is reported in at least one FERC or EIA data set. This table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx Browse or query this table in Datasette.

Field Name

Type

Description

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_pudl

string

Plant name, chosen arbitrarily from the several possible plant names available in the plant matching process. Included for human readability only.

core_pudl__entity_utilities_pudl#

Home table for PUDL assigned utility IDs. These IDs are manually generated each year when new FERC and EIA reporting is integrated, and any newly found utilities are added to the list with a new ID. Each ID maps to a power plant owning or operating entity which is reported in at least one FERC or EIA data set. This table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx Browse or query this table in Datasette.

Field Name

Type

Description

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_pudl

string

Utility name, chosen arbitrarily from the several possible utility names available in the utility matching process. Included for human readability only.

_out_eia__monthly_capacity_factor_by_generator#

Monthly estimates of generator capacity factor. Capacity factor is calculated based on reported generator capacity and the allocated net generation reported in the generation and generation fuel tables. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

_out_eia__monthly_derived_generator_attributes#

Monthly generator capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh. These calculations are based on the allocation of net generation reported on the basis of plant, prime mover and energy source to individual generators. Heat rates by generator-month are estimated by using allocated estimates for per-generator net generation and fuel consumption as well as the core_eia923__monthly_boiler_fuel table, which reports fuel consumed by boiler. Heat rates are necessary to estimate the amount of fuel consumed by a generation unit, and thus the fuel cost per MWh generated. Plant specific fuel prices are taken from the core_eia923__monthly_fuel_receipts_costs table, which only has ~70% coverage, leading to some generators with heat rate estimates still lacking fuel cost estimates. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

_out_eia__monthly_fuel_cost_by_generator#

Monthly estimate of per-generator fuel costs both per MMBTU and per MWh. These calculations are based on the allocation of net generation and fuel consumption as well as plant-level delivered fuel prices reported in the fuel receipts and cost table. The intermediary heat rate calculation depends on having the unit ID filled in, which means fuel cost coverage is low. The fuel costs are also currently aggregated to coarse fuel categories rather than using the more detailed energy source codes.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

_out_eia__monthly_heat_rate_by_generator#

Monthly heat rate estimates by generator. These are actually just generation unit level heat rates, which have been broadcast across all constituent generator IDs, since heat rates really only have a well-defined meaning in the context of a generation unit.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

_out_eia__monthly_heat_rate_by_unit#

Monthly heat rate estimates by generation unit. Generation units are identified by unit_id_pudl and are composed of a set of interconnected boilers and generators. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

_out_eia__plants_utilities#

Denormalized table containing all plant and utility IDs and names from EIA. Browse or query this table in Datasette.

Field Name

Type

Description

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

_out_eia__yearly_capacity_factor_by_generator#

Yearly estimates of generator capacity factor. Capacity factor is calculated based on reported generator capacity and the allocated net generation reported in the generation and generation fuel tables. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

_out_eia__yearly_derived_generator_attributes#

Yearly generator capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh. These calculations are based on the allocation of net generation reported on the basis of plant, prime mover and energy source to individual generators. Heat rates by generator-month are estimated by using allocated estimates for per-generator net generation and fuel consumption as well as the core_eia923__monthly_boiler_fuel table, which reports fuel consumed by boiler. Heat rates are necessary to estimate the amount of fuel consumed by a generation unit, and thus the fuel cost per MWh generated. Plant specific fuel prices are taken from the core_eia923__monthly_fuel_receipts_costs table, which only has ~70% coverage, leading to some generators with heat rate estimates still lacking fuel cost estimates. Browse or query this table in Datasette.

Field Name

Type

Description

capacity_factor

number

Fraction of potential generation that was actually reported for a plant part.

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

total_fuel_cost

number

Total annual reported fuel costs for the plant part. Includes costs from all fuels.

total_mmbtu

number

Total annual heat content of fuel consumed by a plant part record in the plant parts list.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

_out_eia__yearly_fuel_cost_by_generator#

Yearly estimate of per-generator fuel costs both per MMBTU and per MWh. These calculations are based on the allocation of net generation and fuel consumption as well as plant-level delivered fuel prices reported in the fuel receipts and cost table. The intermediary heat rate calculation depends on having the unit ID filled in, which means fuel cost coverage is low. The fuel costs are also currently aggregated to coarse fuel categories rather than using the more detailed energy source codes.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_cost_from_eiaapi

boolean

Indicates whether the fuel cost was derived from the EIA API.

fuel_cost_per_mmbtu

number

Average fuel cost per mmBTU of heat content in nominal USD.

fuel_cost_per_mwh

number

Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

report_date

date

Date reported.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

_out_eia__yearly_generators#

Denormalized table containing all EIA generator attributes. Browse or query this table in Datasette.

Field Name

Type

Description

associated_combined_heat_power

boolean

Indicates whether the generator is associated with a combined heat and power system

bga_source

string

The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections).

bypass_heat_recovery

boolean

Can this generator operate while bypassing the heat recovery steam generator?

capacity_mw

number

Total installed (nameplate) capacity, in megawatts.

carbon_capture

boolean

Indicates whether the generator uses carbon capture technology.

city

string

Name of the city.

cofire_fuels

boolean

Can the generator co-fire fuels?.

county

string

County name.

current_planned_generator_operating_date

date

The most recently updated effective date on which the generator is scheduled to start operation

data_maturity

string

Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.

deliver_power_transgrid

boolean

Indicate whether the generator can deliver power to the transmission grid.

distributed_generation

boolean

Whether the generator is considered distributed generation

duct_burners

boolean

Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas

energy_source_1_transport_1

string

Primary mode of transport for energy source 1.

energy_source_1_transport_2

string

Secondary mode of transport for energy source 1.

energy_source_1_transport_3

string

Tertiary mode of transport for energy source 1.

energy_source_2_transport_1

string

Primary mode of transport for energy source 2.

energy_source_2_transport_2

string

Secondary mode of transport for energy source 2.

energy_source_2_transport_3

string

Tertiary mode of transport for energy source 2.

energy_source_code_1

string

The code representing the most predominant type of energy that fuels the generator.

energy_source_code_2

string

The code representing the second most predominant type of energy that fuels the generator

energy_source_code_3

string

The code representing the third most predominant type of energy that fuels the generator

energy_source_code_4

string

The code representing the fourth most predominant type of energy that fuels the generator

energy_source_code_5

string

The code representing the fifth most predominant type of energy that fuels the generator

energy_source_code_6

string

The code representing the sixth most predominant type of energy that fuels the generator

energy_storage_capacity_mwh

number

Energy storage capacity in MWh (e.g. for batteries).

ferc_qualifying_facility

boolean

Indicatates whether or not a generator is a qualifying FERC cogeneation facility.

fluidized_bed_tech

boolean

Indicates whether the generator uses fluidized bed technology

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

generator_operating_date

date

Date the generator began commercial operation.

generator_retirement_date

date

Date of the scheduled or effected retirement of the generator.

latitude

number

Latitude of the plant's location, in degrees.

longitude

number

Longitude of the plant's location, in degrees.

minimum_load_mw

number

The minimum load at which the generator can operate at continuosuly.

multiple_fuels

boolean

Can the generator burn multiple fuels?

nameplate_power_factor

number

The nameplate power factor of the generator.

net_capacity_mwdc

number

Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.

operating_switch

string

Indicates whether the fuel switching generator can switch when operating

operational_status

string

The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860.

operational_status_code

string

The operating status of the asset.

original_planned_generator_operating_date

date

The date the generator was originally scheduled to be operational

other_combustion_tech

boolean

Indicates whether the generator uses other combustion technologies

other_modifications_date

date

Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete.

other_planned_modifications

boolean

Indicates whether there are there other modifications planned for the generator.

owned_by_non_utility

boolean

Whether any part of generator is owned by a nonutilty

ownership_code

string

Identifies the ownership for each generator.

planned_derate_date

date

Planned effective month that the generator is scheduled to enter operation after the derate modification.

planned_energy_source_code_1

string

New energy source code for the planned repowered generator.

planned_generator_retirement_date

date

Planned effective date of the scheduled retirement of the generator.

planned_modifications

boolean

Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years.

planned_net_summer_capacity_derate_mw

number

Decrease in summer capacity expected to be realized from the derate modification to the equipment.

planned_net_summer_capacity_uprate_mw

number

Increase in summer capacity expected to be realized from the modification to the equipment.

planned_net_winter_capacity_derate_mw

number

Decrease in winter capacity expected to be realized from the derate modification to the equipment.

planned_net_winter_capacity_uprate_mw

number

Increase in winter capacity expected to be realized from the uprate modification to the equipment.

planned_new_capacity_mw

number

The expected new namplate capacity for the generator.

planned_new_prime_mover_code

string

New prime mover for the planned repowered generator.

planned_repower_date

date

Planned effective date that the generator is scheduled to enter operation after the repowering is complete.

planned_uprate_date

date

Planned effective date that the generator is scheduled to enter operation after the uprate modification.

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_eia

string

Plant name.

previously_canceled

boolean

Indicates whether the generator was previously reported as indefinitely postponed or canceled

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

pulverized_coal_tech

boolean

Indicates whether the generator uses pulverized coal technology

reactive_power_output_mvar

number

Reactive Power Output (MVAr)

report_date

date

Date reported.

rto_iso_lmp_node_id

string

The designation used to identify the price node in RTO/ISO Locational Marginal Price reports

rto_iso_location_wholesale_reporting_id

string

The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report

solid_fuel_gasification

boolean

Indicates whether the generator is part of a solid fuel gasification system

startup_source_code_1

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_2

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_3

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

startup_source_code_4

string

The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator.

state

string

Two letter US state abbreviation.

stoker_tech

boolean

Indicates whether the generator uses stoker technology

street_address

string

Physical street address.

subcritical_tech

boolean

Indicates whether the generator uses subcritical technology

summer_capacity_estimate

boolean

Whether the summer capacity value was an estimate

summer_capacity_mw

number

The net summer capacity.

summer_estimated_capability_mw

number

EIA estimated summer capacity (in MWh).

supercritical_tech

boolean

Indicates whether the generator uses supercritical technology

switch_oil_gas

boolean

Indicates whether the generator switch between oil and natural gas.

syncronized_transmission_grid

boolean

Indicates whether standby generators (SB status) can be synchronized to the grid.

technology_description

string

High level description of the technology used by the generator to produce electricity.

time_cold_shutdown_full_load_code

string

The minimum amount of time required to bring the unit to full load from shutdown.

timezone

string

IANA timezone name

topping_bottoming_code

string

If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle

turbines_inverters_hydrokinetics

integer

Number of wind turbines, or hydrokinetic buoys.

turbines_num

integer

Number of wind turbines, or hydrokinetic buoys.

ultrasupercritical_tech

boolean

Indicates whether the generator uses ultra-supercritical technology

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

uprate_derate_completed_date

date

The date when the uprate or derate was completed.

uprate_derate_during_year

boolean

Was an uprate or derate completed on this generator during the reporting year?

utility_id_eia

integer

The EIA Utility Identification number.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_eia

string

The name of the utility.

winter_capacity_estimate

boolean

Whether the winter capacity value was an estimate

winter_capacity_mw

number

The net winter capacity.

winter_estimated_capability_mw

number

EIA estimated winter capacity (in MWh).

zip_code

string

Five digit US Zip Code.

_out_eia__yearly_heat_rate_by_generator#

Yearly heat rate estimates by generator. These are actually just generation unit level heat rates, which have been broadcast across all constituent generator IDs, since heat rates really only have a well-defined meaning in the context of a generation unit.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_type_code_pudl

string

Simplified fuel type code used in PUDL

fuel_type_count

integer

A count of how many different simple energy sources there are associated with a generator.

generator_id

string

Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

prime_mover_code

string

Code for the type of prime mover (e.g. CT, CG)

report_date

date

Date reported.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

_out_eia__yearly_heat_rate_by_unit#

Yearly heat rate estimates by generation unit. Generation units are identified by unit_id_pudl and are composed of a set of interconnected boilers and generators. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. Browse or query this table in Datasette.

Field Name

Type

Description

fuel_consumed_for_electricity_mmbtu

number

Total consumption of fuel to produce electricity, in physical unit, year to date.

net_generation_mwh

number

Net electricity generation for the specified period in megawatt-hours (MWh).

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

unit_heat_rate_mmbtu_per_mwh

number

Fuel content per unit of electricity generated. Coming from MCOE calculation.

unit_id_pudl

integer

Dynamically assigned PUDL unit id. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time.

_out_ferc1__yearly_plants_utilities#

Denormalized table that contains FERC plant and utility information. Browse or query this table in Datasette.

Field Name

Type

Description

plant_id_pudl

integer

A manually assigned PUDL plant ID. May not be constant over time.

plant_name_ferc1

string

Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.

utility_id_ferc1

integer

PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year.

utility_id_pudl

integer

A manually assigned PUDL utility ID. May not be stable over time.

utility_name_ferc1

string

Name of the responding utility, as it is reported in FERC Form 1. For human readability only.

_core_eia860__cooling_equipment#

Information about cooling equipment at generation facilities, from EIA-860 Schedule 6D.

Note: This table has been cleaned, but not harvested with other EIA 923 or 860 data. The same variables present in this table may show up in other _core tables in other years. Once this table has been harvested, it will be removed from the PUDL database. Browse or query this table in Datasette.

Field Name

Type

Description

chlorine_equipment_cost

number

Actual installed cost for the existing chlorine discharge control system or the anticipated cost to bring the chlorine discharge control system into commercial operation

chlorine_equipment_operating_date

date

Actual or projected in-service date for chlorine discharge control structures and equipment

cooling_equipment_total_cost

number

Actual installed cost for the existing system or the anticipated cost to bring the total system into commercial operation

cooling_id_eia

string

EIA Identification code for cooling system (if multiple cooling systems are not distinguished by separate IDs, the word 'PLANT' is listed to encompass the cooling system for the entire plant)

cooling_status_code

string

Operating status of cooling system

cooling_system_operating_date

date

The actual or projected in-service datetime of this cooling system

cooling_type_1

string

Type of cooling system

cooling_type_2

string

Type of cooling system

cooling_type_3

string

Type of cooling system

cooling_type_4

string

Type of cooling system

cooling_water_discharge

string

Name of river, lake, or water source that cooling water is discharged into

cooling_water_source

string

Name of river, lake, or water source that provides cooling water

county

string

County name.

intake_distance_shore_feet

number

Maximum distance from shore to intake

intake_distance_surface_feet

number

Average distance below water surface to intake

intake_rate_100pct_gallons_per_minute

number

Design cooling water flow rate at 100 percent load at in-take

outlet_distance_shore_feet

number

Maximum distance from shore to outlet

outlet_distance_surface_feet

number

Average distance below water surface to outlet

percent_dry_cooling

number

Percent of cooling load served by dry cooling components

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

plant_name_eia

string

Plant name.

plant_summer_capacity_mw

number

The plant summer capacity associated with the operating generators at the plant

pond_cost

number

Actual installed cost for the existing cooling ponds or the anticipated cost to bring the cooling ponds into commercial operation

pond_operating_date

date

Cooling ponds actual or projected in-service date

pond_surface_area_acres

number

Total surface area of cooling pond

pond_volume_acre_feet

number

Total volume of water in cooling pond

power_requirement_mw

number

Maximum power requirement for cooling towers at 100 percent load

report_date

date

Date reported.

state

string

Two letter US state abbreviation.

steam_plant_type_code

integer

Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details.

tower_cost

number

Actual installed cost for the existing cooling towers or the anticipated cost to bring the cooling towers into commercial operation

tower_operating_date

date

Cooling towers actual or projected in-service date

tower_type_1

string

Types of cooling towers at this plant

tower_type_2

string

Types of cooling towers at this plant

tower_type_3

string

Types of cooling towers at this plant

tower_type_4

string

Types of cooling towers at this plant

tower_water_rate_100pct_gallons_per_minute

number

Maximum design rate of water flow at 100 percent load for the cooling towers

utility_id_eia

integer

The EIA Utility Identification number.

utility_name_eia

string

The name of the utility.

water_source

string

Name of water source associated with the plant.

water_source_code

string

Type of cooling water source

water_type_code

string

Type of cooling water

_core_eia923__cooling_system_information#

EIA-923 Cooling System Information, from EIA-923 Schedule 8D.

Reports monthly information about cooling systems at generation facilities, mainly water volumes and temperatures. In 2008 and 2009, EIA only reports annual averages, but in later years all data is monthly.

Note: This table has been cleaned, but not harvested with other EIA 923 or 860 data. The same variables present in this table may show up in other _core tables in other years. Once this table has been harvested, it will be removed from the PUDL database. Browse or query this table in Datasette.

Field Name

Type

Description

annual_average_consumption_rate_gallons_per_minute

number

Annual average consumption rate of cooling water

annual_average_discharge_rate_gallons_per_minute

number

Annual average discharge rate of cooling water

annual_average_withdrawal_rate_gallons_per_minute

number

Annual average withdrawal rate of cooling water

annual_maximum_intake_summer_temperature_fahrenheit

number

Maximum cooling water temperature at intake during the summer

annual_maximum_intake_winter_temperature_fahrenheit

number

Maximum cooling water temperature at intake in winter

annual_maximum_outlet_summer_temperature_fahrenheit

number

Maximum cooling water temperature at outlet in summer

annual_maximum_outlet_winter_temperature_fahrenheit

number

Maximum cooling water temperature at outlet in winter

annual_total_chlorine_lbs

number

Amount of elemental chlorine added to cooling water annually. May be just the amount of chlorine-containing compound if schedule 9 is filled out.

cooling_id_eia

string

EIA Identification code for cooling system (if multiple cooling systems are not distinguished by separate IDs, the word 'PLANT' is listed to encompass the cooling system for the entire plant)

cooling_status_code

string

Operating status of cooling system

cooling_type

string

Type of cooling system

flow_rate_method

string

Calculation method for flow rates (actual or method of estimation)

monthly_average_consumption_rate_gallons_per_minute

number

Monthly average consumption rate of cooling water

monthly_average_discharge_rate_gallons_per_minute

number

Monthly average discharge rate of cooling water

monthly_average_discharge_temperature_fahrenheit

number

Average cooling water temperature at discharge point

monthly_average_diversion_rate_gallons_per_minute

number

Monthly average diversion rate of cooling water

monthly_average_intake_temperature_fahrenheit

number

Average cooling water temperature at intake point

monthly_average_withdrawal_rate_gallons_per_minute

number

Monthly average withdrawal rate of cooling water

monthly_maximum_discharge_temperature_fahrenheit

number

Maximum cooling water temperature at discharge

monthly_maximum_intake_temperature_fahrenheit

number

Maximum cooling water temperature at intake

monthly_total_chlorine_lbs

number

Amount of elemental chlorine added to cooling water monthly. May be just the amount of chlorine-containing compound if schedule 9 is filled out.

monthly_total_consumption_volume_gallons

number

Monthly volume of water consumed at consumption point (accurate to 0.1 million gal)

monthly_total_cooling_hours_in_service

integer

Total hours the system operated during the month

monthly_total_discharge_volume_gallons

number

Monthly volume of water discharged at discharge point (accurate to 0.1 million gal)

monthly_total_diversion_volume_gallons

number

Monthly volume of water diverted at diversion point (accurate to 0.1 million gal)

monthly_total_withdrawal_volume_gallons

number

Monthly volume of water withdrawn at withdrawal point (accurate to 0.1 million gal)

plant_id_eia

integer

The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.

report_date

date

Date reported.

temperature_method

string

Method for measurement of temperatures