out_ferc1__yearly_all_plants

package: pudl

Annual time series of plants reported in the steam, small generators, hydro, and pumped storage tables.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 402, 404, 406 and 408)

Primary key:

record_id

Usage Warnings

  • Not all columns are originally reported in all of the input plant tables. Expect nulls.

  • FERC does not restrict respondents to report unique and non-duplicative plant records. There are sporadic instances of respondents reporting portions of plants and then the total plant (ex: unit 1, unit 2 and total). Use caution when aggregating.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is a concatenation of the following plant tables:

  • core_ferc1__yearly_steam_plants_sched402

  • core_ferc1__yearly_hydroelectric_plants_sched406

  • core_ferc1__yearly_small_plants_sched410

  • core_ferc1__yearly_pumped_storage_plants_sched408

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_id_pudl

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

plant_id_ferc1

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

plant_name_ferc1

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

asset_retirement_cost

Asset retirement cost (USD).

avg_num_employees

The average number of employees assigned to each plant.

capacity_factor

Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.).

capacity_mw

Total installed (nameplate) capacity, in megawatts.

capex_annual_addition

Annual capital addition into capex_total.

capex_annual_addition_rolling

Year-to-date capital addition into capex_total.

capex_annual_per_kw

Annual capital addition into capex_total per kw.

capex_annual_per_mw

Annual capital addition into capex_total per MW.

capex_annual_per_mw_rolling

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

capex_annual_per_mwh

Annual capital addition into capex_total per MWh.

capex_annual_per_mwh_rolling

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

capex_equipment

Cost of plant: equipment (USD).

capex_land

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

capex_per_mw

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

capex_structures

Cost of plant: structures and improvements (USD).

capex_total

Total cost of plant (USD).

capex_wo_retirement_total

Total cost of plant (USD) without retirements.

construction_type

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

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

installation_year

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

net_generation_mwh

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

not_water_limited_capacity_mw

Plant capacity in MW when not limited by condenser water.

opex_allowances

Allowances.

opex_boiler

Maintenance of boiler (or reactor) plant.

opex_coolants

Cost of coolants and water (nuclear plants only)

opex_electric

Production expenses: electric expenses (USD).

opex_engineering

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

opex_fuel

Production expenses: fuel (USD).

fuel_cost_per_mwh

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

opex_misc_power

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

Maintenance of miscellaneous steam (or nuclear) plant.

opex_nonfuel_per_mwh

Investments in non-fuel production expenses per Mwh.

opex_operations

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

opex_per_mwh

Total production expenses (USD per MWh generated).

opex_plant

Production expenses: maintenance of electric plant (USD).

opex_production_total

Total operating expenses.

opex_rents

Production expenses: rents (USD).

opex_steam

Steam expenses.

opex_steam_other

Steam from other sources.

opex_structures

Production expenses: maintenance of structures (USD).

opex_total_nonfuel

Total production expenses, excluding fuel (USD).

opex_transfer

Steam transferred (Credit).

peak_demand_mw

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

Net plant capability in megawatts.

plant_hours_connected_while_generating

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

plant_type

Type of plant.

record_id

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.

water_limited_capacity_mw

Plant capacity in MW when limited by condenser water.

fuel_cost_per_mmbtu

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

fuel_type

Type of fuel.

license_id_ferc1

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

opex_maintenance

Production expenses: Maintenance (USD).

opex_total

Total production expenses, excluding fuel (USD).

capex_facilities

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

capex_roads

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

net_capacity_adverse_conditions_mw

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

net_capacity_favorable_conditions_mw

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

opex_dams

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

opex_generation_misc

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

Production expenses: hydraulic expenses (USD).

opex_misc_plant

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

opex_water_for_power

Production expenses: water for power (USD).

ferc_license_id

The FERC license ID of a project.

capex_equipment_electric

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

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

capex_wheels_turbines_generators

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

energy_used_for_pumping_mwh

Energy used for pumping, in megawatt-hours.

net_load_mwh

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

opex_production_before_pumping

Total production expenses before pumping (USD).

opex_pumped_storage

Production expenses: pumped storage (USD).

opex_pumping

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

out_ferc1__yearly_rate_base

package: pudl

Annual time series of granular accounting data consisting of what utilities can typically include in their rate bases.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 110, 118, 200, 204 219 and 320)

Primary key:

This table has no primary key.

Usage Warnings

  • The data from these xbrl_factoid tables contains nested totals and subtotals - making aggregations difficult. We used FERC 1's reported calculations to determine the most granular, non-duplicative records. The reported calculations are not always perfect - we've corrected many of them, but errors could still exist.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is derived from seven FERC Form 1 accounting tables with nested calculations. We reconciled these nested calculations and then identified the most granular data across the tables. Here are the three direct upstream inputs - the two detailed tables have several core_ferc1 inputs each:

  • out_ferc1__yearly_detailed_balance_sheet_assets

  • out_ferc1__yearly_detailed_balance_sheet_liabilities

  • core_ferc1__yearly_operating_expenses_sched320

We applied slight modifications to three columns (utility_type, plant_function & plant_status) as compared to the originally reported values in our core tables. The modifications were applied to either provide more specificity (i.e. we converted some total utility_type's into electric) or to condense similar categories for easier analysis (i.e. creating a hydraulic_production plant_function by combining hydraulic_production_conventional and hydraulic_production_pumped_storage). See pudl.output.ferc1.Exploder for more details. This table was made entirely with support and direction from RMI.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

utility_type

Listing of utility plant types.

plant_function

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

plant_status

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

xbrl_factoid

The name of type of value which is a derivative of the XBRL fact name.

ending_balance

Account balance at end of year.

utility_type_other

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).

rate_base_category

A category of asset or liability that RMI compiled to use as a shorthand for various types of utility assets. These tags were compiled manually based on the xbrl_factoid and sometimes varies based on the utility_type, plant_function or plant_status as well.

ferc_account

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.

row_type_xbrl

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

record_id

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.

is_disaggregated_utility_type

Indicates whether or not records with null or total values in the utility_type column were disaggregated. See documentation for process: pudl.output.ferc1.disaggregate_null_or_total_tag

is_disaggregated_in_rate_base

Indicates whether or not records with null values in the in_rate_base column were disaggregated. See documentation for process: pudl.output.ferc1.disaggregate_null_or_total_tag

table_name

The name of the PUDL database table where a given record originated from.

out_ferc714__georeferenced_respondents

package: pudl

Annual summary of demand and other information about FERC-714 respondents.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report

Primary key:

respondent_id_ferc714, report_date

Usage Warnings

  • Contains information from multiple raw inputs.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table differs from out_ferc714__summarized_demand in that it also includes a geometry column describing the respondent's service territory in each year. These service territories are based on the counties that the corresponding EIA-861 respondent reported serving in that year. There is sometimes ambiguity as to whether a FERC-714 respondent should be interpreted as an individual utility or a balancing authority. The respodent_type column indicates which type of entity has been assumed in determining the service territory from EIA-861 data.

Columns
report_date

Date reported.

respondent_id_ferc714

PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.

geometry

Geospatial representation of the feature.

eia_code

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_type

Whether a respondent to the FERC form 714 is a utility or a balancing authority.

respondent_name_ferc714

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

balancing_authority_id_eia

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

balancing_authority_code_eia

EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.

balancing_authority_name_eia

Name of the balancing authority.

utility_id_eia

The EIA Utility Identification number.

utility_name_eia

The name of the utility.

population

County population, sourced from Census DP1 data.

area_km2

County area in km2.

demand_annual_mwh

Annual electricity demand in a given report year.

out_ferc714__respondents_with_fips

package: pudl

Annual respondents with the county FIPS IDs for their service territories.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report

Primary key:

This table has no primary key. Note that the state and county FIPS columns can be null. Otherwise the natural primary key would be: ['respondent_id_ferc714', 'report_date', 'county_id_fips']. The state FIPS code is not part of the primary key because the first two digits of the county FIPS code indicate the state.

Usage Warnings

  • Contains information from multiple raw inputs.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
eia_code

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_type

Whether a respondent to the FERC form 714 is a utility or a balancing authority.

respondent_id_ferc714

PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.

respondent_name_ferc714

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

report_date

Date reported.

balancing_authority_id_eia

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

balancing_authority_code_eia

EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.

balancing_authority_name_eia

Name of the balancing authority.

utility_id_eia

The EIA Utility Identification number.

utility_name_eia

The name of the utility.

state

Two letter US state abbreviation.

county

County name.

state_id_fips

Two digit state FIPS code.

county_id_fips

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

out_ferc714__summarized_demand

package: pudl

Summarized demand statistics and FERC-714 respondent attributes by respondent-year.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report

Primary key:

respondent_id_ferc714, report_date

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_date

Date reported.

respondent_id_ferc714

PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.

demand_annual_mwh

Annual electricity demand in a given report year.

population

County population, sourced from Census DP1 data.

area_km2

County area in km2.

population_density_km2

Average population per sq. km area of a service territory.

demand_annual_per_capita_mwh

Per-capita annual demand, averaged using Census county-level population estimates.

demand_density_mwh_km2

Annual demand per km2 of a given service territory.

eia_code

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_type

Whether a respondent to the FERC form 714 is a utility or a balancing authority.

respondent_name_ferc714

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

balancing_authority_id_eia

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

balancing_authority_code_eia

EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.

balancing_authority_name_eia

Name of the balancing authority.

utility_id_eia

The EIA Utility Identification number.

utility_name_eia

The name of the utility.

out_ferc1__yearly_detailed_income_statements

package: pudl

Annual time series of granular, de-duplicated accounting data of utilities' income statements.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 114, 300, 320 and 336)

Primary key:

This table has no primary key.

Usage Warnings

  • The data from these xbrl_factoid tables contains nested totals and subtotals - making aggregations difficult. We used FERC 1's reported calculations to determine the most granular, non-duplicative records. The reported calculations are not always perfect - we've corrected many of them, but errors could still exist.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is derived from four FERC Form 1 accounting tables with nested calculations:

  • core_ferc1__yearly_income_statements_sched114

  • core_ferc1__yearly_depreciation_summary_sched336

  • core_ferc1__yearly_operating_expenses_sched320

  • core_ferc1__yearly_operating_revenues_sched300

We reconciled the nested calculations within these tables and then identified the most granular data across the tables. We applied slight modifications to two columns (utility_type & plant_function) as compared to the originally reported values in our core tables. The modifications were applied to either provide more specificity (i.e. we converted some total utility_type's into electric) or to condense similar categories for easier analysis (i.e. creating a hydraulic_production plant_function by combining hydraulic_production_conventional and hydraulic_production_pumped_storage). See pudl.output.ferc1.Exploder for more details. This table was made entirely with support and direction from RMI.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

xbrl_factoid

The name of type of value which is a derivative of the XBRL fact name.

utility_type

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

plant_function

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

revenue_requirement_technology

The technology type associated with components of a utility's revenue requirement. These categories were manually compiled by RMI utility accounting experts based on the xbrl_factoid and sometimes vary based on the utility_type or plant_function as well. This column is intended to be used to aggregate this table.

dollar_value

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

in_revenue_requirement

Whether or not a record from the detailed income statement data is typically included in a utility's revenue requirement. This flag was manually compiled by RMI utility accounting experts based on the xbrl_factoid and sometimes varies based on the utility_type or plant_function.

revenue_requirement_category

The category of revenue requirement associated with each component of utility'sincome statements. These categories were manually compiled by RMI utility accounting experts based on the xbrl_factoid and sometimes vary based on the utility_type or plant_function. This column is intended to be used to aggregate this table.

table_name

The name of the PUDL database table where a given record originated from.

out_ferc1__yearly_cash_flows_sched120

package: pudl

Annual time series of utility cash flow.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 120)

Primary key:

utility_id_ferc1, report_year, amount_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

amount_type

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

amount

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

balance

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

row_type_xbrl

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

out_ferc1__yearly_depreciation_by_function_sched219

package: pudl

Annual time series of ending balances in accumulated provision for depreciation of electric utility plant.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section B)

Primary key:

utility_id_ferc1, report_year, depreciation_type, plant_function, plant_status, utility_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric utility plant refers to FERC Account 108. Section B includes the Balances at End of Year According to Functional Classification (plant_function).

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

depreciation_type

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

plant_function

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

plant_status

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

utility_type

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

ending_balance

Account balance at end of year.

record_id

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.

balance

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

row_type_xbrl

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

out_ferc1__yearly_depreciation_changes_sched219

package: pudl

Annual time series of changes in accumulated provision for depreciation of electric utility plant.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section A)

Primary key:

utility_id_ferc1, report_year, depreciation_type, plant_status, utility_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric utility plant refers to FERC Account 108.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

depreciation_type

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

plant_status

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

utility_type

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

dollar_value

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

record_id

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.

balance

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

ferc_account

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.

row_type_xbrl

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

out_ferc1__yearly_depreciation_factors_sched336

package: pudl

Annual time series of factors used in estimating depreciation charges.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section C)

Primary key:

This table has no primary key. This table is too unstructured to have a primary key.

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • Contains columns which may appear categorical, but are actually free text.

  • The rate and percentage (pct) columns are reported either as values between 0-1 or 0-100. It is often consistent within a given utility-year but use caution when comparing value across different utilities and even the same utility filing in a different year.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table contains details at a variety of levels of granularity.There are many free-form text fields in this table which results in respondents filling out this table very differently from each other or from year to year. We recommend using this table carefully with one utility-year at a time - not attempting to perform analysis across long time-series or across utilities without much caution and cleaning. This table only contains information from Section C: Factors Used in Estimating Depreciation Charges.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

depreciation_factors

Label of the factor of depreciation factors. This field contains is an unstructured, free-form strings. It often includes FERC account IDs, sometimes includes plant names and sometimes includes headers indicating the beginning of a new section - such as a plant or asset type header which is followed by sub-components like FERC account IDs or plant names depending on the section.

depreciable_plant_base

Depreciable plant balance (depreciable base) to which rates are applied.

net_salvage_pct

Percentage representing the estimated value of utility plant at the end of its service life. Be aware that the formatting of this column is not expected to be standard - expect some values between 0-1 and some between 0-100.

depreciation_rate

Depreciation rate applied to utility plant balance.Be aware that the formatting of this column is not expected to be standard - expect some values between 0-1 and some between 0-100.

mortality_curve_type

Description of the type of mortality curve selected in plant mortality studies prepared to assist in estimating average service lives.

order_num

This field is defined in FERC-XBRL documentation as a field that is used to sequence a table.FERC-XBRL documentation notes: 'This field is added to a table to control ordering of the items on the table.'FERC's documentation also notes that this field should always be an integer - although there are many instances of floating point values which seem to increment by decimal points. Nonetheless, this field can be used to help understand the original order of the table. This field did not exist prior to FERC publishing Form 1 as XBRL and thus is always null prior to 2021.

account_num

Account number(s) in connection with factors used in estimating depreciation charges.

service_life_avg

Estimated average service life of utility plant. The original DBF data was reported as years while the XBRL data was reported as strings in this time duration format: PnYnMnDTnHnMnS. PUDL converts these string time durations into years.

remaining_life_avg

Estimated weighted average of remaining life of utility plant assets.The original DBF data was reported as years while the XBRL data was reported as strings in this time duration format: PnYnMnDTnHnMnS. PUDL converts these string time durations into years.

out_ferc1__yearly_depreciation_summary_sched336

package: pudl

Annual time series of depreciation and amortization of electric plant.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section A)

Primary key:

utility_id_ferc1, report_year, plant_function, ferc_account_label

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric Plant refers to FERC Accounts 403, 404, and 405. This table only contains information from Section A: Summary of depreciation and amortization changes.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_function

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

ferc_account_label

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

ferc_account

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.

utility_type

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

dollar_value

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

out_ferc1__yearly_detailed_balance_sheet_assets

package: pudl

Annual time series of granular, de-duplicated accounting data of utilities' balance sheet assets.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 110, 200, 204 and 219)

Primary key:

This table has no primary key.

Usage Warnings

  • The data from these xbrl_factoid tables contains nested totals and subtotals - making aggregations difficult. We used FERC 1's reported calculations to determine the most granular, non-duplicative records. The reported calculations are not always perfect - we've corrected many of them, but errors could still exist.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is derived from four FERC Form 1 accounting tables with nested calculations:

  • core_ferc1__yearly_balance_sheet_assets_sched110

  • core_ferc1__yearly_utility_plant_summary_sched200

  • core_ferc1__yearly_plant_in_service_sched204

  • core_ferc1__yearly_depreciation_by_function_sched219

We reconciled the nested calculations within these tables and then identified the most granular data across the tables. We applied slight modifications to three columns (utility_type, plant_function & plant_status) as compared to the originally reported values in our core tables. The modifications were applied to either provide more specificity (i.e. we converted some total utility_type's into electric) or to condense similar categories for easier analysis (i.e. creating a hydraulic_production plant_function by combining hydraulic_production_conventional and hydraulic_production_pumped_storage). See pudl.output.ferc1.Exploder for more details. This table was made entirely with support and direction from RMI.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

xbrl_factoid

The name of type of value which is a derivative of the XBRL fact name.

utility_type

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

plant_function

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

plant_status

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

ending_balance

Account balance at end of year.

utility_type_other

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).

in_rate_base

Whether or not a record from the detailed FERC1 accounting tables should be considered allowable in a utility's rate base based on utility accounting standards. This flag was manually compiled by RMI utility accounting experts based on the xbrl_factoid and sometimes varies based on the utility_type, plant_status or plant_function.

rate_base_category

A category of asset or liability that RMI compiled to use as a shorthand for various types of utility assets. These tags were compiled manually based on the xbrl_factoid and sometimes varies based on the utility_type, plant_function or plant_status as well.

table_name

The name of the PUDL database table where a given record originated from.

out_ferc1__yearly_detailed_balance_sheet_liabilities

package: pudl

Annual time series of granular, de-duplicated accounting data of utilities' balance sheet liabilities.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110 and 118)

Primary key:

This table has no primary key.

Usage Warnings

  • The data from these xbrl_factoid tables contains nested totals and subtotals - making aggregations difficult. We used FERC 1's reported calculations to determine the most granular, non-duplicative records. The reported calculations are not always perfect - we've corrected many of them, but errors could still exist.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is derived from two FERC Form 1 accounting tables with nested calculations:

  • core_ferc1__yearly_balance_sheet_liabilities_sched110

  • core_ferc1__yearly_retained_earnings_sched118

We reconciled the nested calculations within these tables and then identified the most granular data across the tables. We applied slight modifications to three columns (utility_type, plant_function & plant_status) as compared to the originally reported values in our core tables. The modifications were applied to either provide more specificity (i.e. we converted some total utility_type's into electric) or to condense similar categories for easier analysis (i.e. creating a hydraulic_production plant_function by combining hydraulic_production_conventional and hydraulic_production_pumped_storage). See pudl.output.ferc1.Exploder for more details. This table was made entirely with support and direction from RMI.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

xbrl_factoid

The name of type of value which is a derivative of the XBRL fact name.

utility_type

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

ending_balance

Account balance at end of year.

in_rate_base

Whether or not a record from the detailed FERC1 accounting tables should be considered allowable in a utility's rate base based on utility accounting standards. This flag was manually compiled by RMI utility accounting experts based on the xbrl_factoid and sometimes varies based on the utility_type, plant_status or plant_function.

rate_base_category

A category of asset or liability that RMI compiled to use as a shorthand for various types of utility assets. These tags were compiled manually based on the xbrl_factoid and sometimes varies based on the utility_type, plant_function or plant_status as well.

table_name

The name of the PUDL database table where a given record originated from.

out_ferc1__yearly_energy_dispositions_sched401

package: pudl

Annual time series of dispositions of electric energy sold, exchanged, or stored.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)

Primary key:

utility_id_ferc1, report_year, energy_disposition_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric Energy Account, dispositions only. Schedule 401a. Electricity utilities delivered to end users, internal losses, etc.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

energy_disposition_type

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.

row_type_xbrl

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

energy_mwh

Sources and uses of energy in MWh.

record_id

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.

out_ferc1__yearly_energy_sources_sched401

package: pudl

Annual time series of sources of electric energy generated or purchased, exchanged and wheeled.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)

Primary key:

utility_id_ferc1, report_year, energy_source_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric Energy Account, sources only. Schedule 401a. Amount of electricity the utility obtained from each of several sources.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

energy_source_type

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.

row_type_xbrl

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

energy_mwh

Sources and uses of energy in MWh.

record_id

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.

out_ferc1__yearly_hydroelectric_plants_sched406

package: pudl

Annual time series of plant statistics for large hydroelectric generating plants.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 406)

Primary key:

record_id The best approximation for primary keys for this table would be: report_year, utility_id_ferc1, plant_name_ferc1. FERC does not publish plant IDs. The main identifying column is plant_name_ferc1 but that is a free-form string field and there are duplicate records.

Usage Warnings

  • The plant_type and construction_type are standardized into categorical values from free-form strings.

  • FERC does not restrict respondents to report unique and non-duplicative plant records. There are sporadic instances of respondents reporting portions of plants and then the total plant (ex: unit 1, unit 2 and total). Use caution when aggregating.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Large plants have an installed nameplate capacity of more than 10 MW.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_name_ferc1

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

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.

asset_retirement_cost

Asset retirement cost (USD).

avg_num_employees

The average number of employees assigned to each plant.

capacity_factor

Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.).

capacity_mw

Total installed (nameplate) capacity, in megawatts.

capex_equipment

Cost of plant: equipment (USD).

capex_facilities

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

capex_land

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

capex_per_mw

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

capex_roads

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

capex_structures

Cost of plant: structures and improvements (USD).

capex_total

Total cost of plant (USD).

construction_type

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

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

installation_year

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

net_capacity_adverse_conditions_mw

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

net_capacity_favorable_conditions_mw

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

net_generation_mwh

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

opex_dams

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

opex_electric

Production expenses: electric expenses (USD).

opex_engineering

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

opex_generation_misc

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

Production expenses: hydraulic expenses (USD).

opex_misc_plant

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

opex_operations

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

opex_per_mwh

Total production expenses (USD per MWh generated).

opex_plant

Production expenses: maintenance of electric plant (USD).

opex_rents

Production expenses: rents (USD).

opex_structures

Production expenses: maintenance of structures (USD).

opex_total

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

Total production expenses, excluding fuel (USD).

opex_water_for_power

Production expenses: water for power (USD).

peak_demand_mw

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

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

plant_id_pudl

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

plant_type

Type of plant.

project_num

FERC Licensed Project Number.

out_ferc1__yearly_income_statements_sched114

package: pudl

Annual time series of utility income statements.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 114)

Primary key:

utility_id_ferc1, report_year, utility_type, income_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

utility_type

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

income_type

Type of income reported in core_ferc1__yearly_income_statements_sched114 table.

dollar_value

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

balance

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

ferc_account

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.

row_type_xbrl

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

out_ferc1__yearly_operating_expenses_sched320

package: pudl

Annual time series of operating and maintenance costs associated with producing electricity.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 320)

Primary key:

utility_id_ferc1, report_year, expense_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

dollar_value

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

expense_type

The type of expense.

utility_type

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

record_id

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.

ferc_account

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.

row_type_xbrl

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

out_ferc1__yearly_operating_revenues_sched300

package: pudl

Annual time series of utilities' electric operating revenues.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 300)

Primary key:

utility_id_ferc1, report_year, revenue_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table includes only the structured 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.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

record_id

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.

revenue_type

Label describing types of revenues.

dollar_value

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

sales_mwh

Quantity of electricity sold in MWh.

avg_customers_per_month

Average number of customers per month.

ferc_account

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.

utility_type

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

row_type_xbrl

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

out_ferc1__yearly_plant_in_service_sched204

package: pudl

Annual time series of utilities' balances and changes to FERC Electric Plant in Service accounts.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 204)

Primary key:

utility_id_ferc1, report_year, ferc_account_label

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

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.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

utility_type

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

plant_status

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

record_id

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.

additions

Cost of acquisition of items classified within the account.

adjustments

Cost of adjustments to the account.

ending_balance

Account balance at end of year.

ferc_account

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

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

retirements

Cost of disposal of items classified within the account.

row_type_xbrl

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

starting_balance

Account balance at beginning of year.

transfers

Cost of transfers into (out of) the account.

out_ferc1__yearly_retained_earnings_sched118

package: pudl

Annual time series of utilities' statements of retained earnings.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 118)

Primary key:

utility_id_ferc1, report_year, earnings_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

record_id

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.

earnings_type

Label describing types of earnings.

starting_balance

Account balance at beginning of year.

ending_balance

Account balance at end of year.

balance

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

ferc_account

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.

row_type_xbrl

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

utility_type

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

out_ferc1__yearly_small_plants_sched410

package: pudl

Annual time series of 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.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 410)

Primary key:

record_id The best approximation for primary keys for this table would be: report_year, utility_id_ferc1, plant_name_ferc1. FERC does not publish plant IDs. The main identifying column is plant_name_ferc1 but that is a free-form string field and there are duplicate records.

Usage Warnings

  • FERC does not restrict respondents to report unique and non-duplicative plant records. There are sporadic instances of respondents reporting portions of plants and then the total plant (ex: unit 1, unit 2 and total). Use caution when aggregating.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

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.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_id_pudl

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

plant_name_ferc1

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

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.

capacity_mw

Total installed (nameplate) capacity, in megawatts.

capex_per_mw

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

capex_total

Total cost of plant (USD).

construction_year

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

fuel_cost_per_mmbtu

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

fuel_type

Type of fuel.

license_id_ferc1

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

net_generation_mwh

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

opex_fuel

Production expenses: fuel (USD).

opex_maintenance

Production expenses: Maintenance (USD).

opex_operations

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

opex_total

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

Total production expenses, excluding fuel (USD).

peak_demand_mw

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_type

Type of plant.

out_ferc1__yearly_steam_plants_sched402

package: pudl

Annual time series of plant statistics for steam plants with a capacity of 25+ MW, internal combustion and gas-turbine plants of 10+ MW, and all nuclear plants.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)

Primary key:

record_id The best approximation for primary keys for this table would be: report_year, utility_id_ferc1, plant_name_ferc1. FERC does not publish plant IDs. The main identifying column is plant_name_ferc1 but that is a free-form string field and there are duplicate records.

Usage Warnings

  • FERC does not restrict respondents to report unique and non-duplicative plant records. There are sporadic instances of respondents reporting portions of plants and then the total plant (ex: unit 1, unit 2 and total). Use caution when aggregating.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_id_pudl

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

plant_id_ferc1

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

plant_name_ferc1

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

asset_retirement_cost

Asset retirement cost (USD).

avg_num_employees

The average number of employees assigned to each plant.

capacity_factor

Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.).

capacity_mw

Total installed (nameplate) capacity, in megawatts.

capex_annual_addition

Annual capital addition into capex_total.

capex_annual_addition_rolling

Year-to-date capital addition into capex_total.

capex_annual_per_kw

Annual capital addition into capex_total per kw.

capex_annual_per_mw

Annual capital addition into capex_total per MW.

capex_annual_per_mw_rolling

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

capex_annual_per_mwh

Annual capital addition into capex_total per MWh.

capex_annual_per_mwh_rolling

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

capex_equipment

Cost of plant: equipment (USD).

capex_land

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

capex_per_mw

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

capex_structures

Cost of plant: structures and improvements (USD).

capex_total

Total cost of plant (USD).

capex_wo_retirement_total

Total cost of plant (USD) without retirements.

construction_type

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

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

installation_year

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

net_generation_mwh

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

not_water_limited_capacity_mw

Plant capacity in MW when not limited by condenser water.

opex_allowances

Allowances.

opex_boiler

Maintenance of boiler (or reactor) plant.

opex_coolants

Cost of coolants and water (nuclear plants only)

opex_electric

Production expenses: electric expenses (USD).

opex_engineering

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

opex_fuel

Production expenses: fuel (USD).

opex_fuel_per_mwh

Production expenses: fuel (USD) per megawatt-hour (Mwh).

opex_misc_power

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

Maintenance of miscellaneous steam (or nuclear) plant.

opex_nonfuel_per_mwh

Investments in non-fuel production expenses per Mwh.

opex_operations

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

opex_per_mwh

Total production expenses (USD per MWh generated).

opex_plants

Maintenance of electrical plant.

opex_production_total

Total operating expenses.

opex_rents

Production expenses: rents (USD).

opex_steam

Steam expenses.

opex_steam_other

Steam from other sources.

opex_structures

Production expenses: maintenance of structures (USD).

opex_total_nonfuel

Total production expenses, excluding fuel (USD).

opex_transfer

Steam transferred (Credit).

peak_demand_mw

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

Net plant capability in megawatts.

plant_hours_connected_while_generating

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

plant_type

Type of plant.

record_id

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.

water_limited_capacity_mw

Plant capacity in MW when limited by condenser water.

out_ferc1__yearly_transmission_lines_sched422

package: pudl

Annual time series of statistics about transmission lines.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 422)

Primary key:

This table has no primary key. Each record of this table is supposed to represent one stretch of a transmission line, but there are no IDs and many nulls in the fields which would nominally distinguish unique transmission lines.

Usage Warnings

  • Contains columns which may appear categorical, but are actually free text.

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Information describing transmission lines, the cost of lines, annual operating and capital expenses, etc. This table includes transmission lines having nominal voltage of 132 kilovolts or greater. Transmission lines below these voltages are required to be reported in group totals only for each voltage.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

start_point

The starting point of a transmission line.

end_point

The end point of a transmission line.

operating_voltage_kv

The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines.

designed_voltage_kv

Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines

supporting_structure_type

Supporting structure of the transmission line.

transmission_line_length_miles

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).

transmission_line_and_structures_length_miles

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).

num_transmission_circuits

Number of circuits in a transmission line.

conductor_size_and_material

Size of transmission conductor and material of the transmission line.

capex_land

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

capex_other

Other costs associated with the plant (USD).

capex_total

Total cost of plant (USD).

opex_operations

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

opex_maintenance

Production expenses: Maintenance (USD).

opex_rents

Production expenses: rents (USD).

opex_total

Total production expenses, excluding fuel (USD).

out_ferc714__hourly_estimated_state_demand

package: pudl

Hourly time series of estimated electricity demand for each state, scaled such that it matches the total electricity sales by state reported in EIA 861.

Most-recent data:

2024

Processing:

Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.

Source:

FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report

Primary key:

state_id_fips, datetime_utc

Usage Warnings

  • Contains estimated values.

  • Contains information from multiple raw inputs.

  • Large table; do not attempt to open with Excel.

  • Contains information from multiple raw inputs.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table uses hourly electricity demand and information about service territories to estimate the total hourly electricity demand for each US state. Hourly demand is drawn from the FERC 714, which reports at the balancing authority and utility level. Service territories for utilities and balancing authorities are inferred from information in the EIA 861, including the counties served by each utility and the utilities that make up each balancing authority.

This table uses the total electricity sales by state reported in the EIA 861 as a scaling factor to ensure that the magnitude of electricity sales is roughly correct, and obtains the shape of the demand curve from the hourly planning area demand reported in the FERC 714.

This table includes the state FIPS codes - see out_censusdp1tract__states for additional information about FIPS state codes.

Columns
state_id_fips

Two digit state FIPS code.

datetime_utc

Date and time converted to Coordinated Universal Time (UTC).

demand_mwh

Electricity demand (energy) within a given timeframe.

scaled_demand_mwh

Estimated electricity demand scaled by the total sales within a state.

out_ferc714__hourly_planning_area_demand

package: pudl

Hourly time series of electricity demand by planning area.

Most-recent data:

2024

Processing:

Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.

Source:

FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report (Part III, Schedule 2a)

Primary key:

respondent_id_ferc714, datetime_utc

Usage Warnings

  • Contains rows where missing values were imputed.

  • The datetime_utc timestamps have been cleaned due to inconsistent datetime reporting. See core_ferc714__hourly_planning_area_demand for additional details.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is based on core_ferc714__hourly_planning_area_demand, but adds imputed demand values where the original data was missing or anomalous. Codes explaining why values have been imputed can be found in the core_pudl__codes_imputation_reasons table.

Columns
respondent_id_ferc714

PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.

respondent_id_ferc714_csv

FERC Form 714 respondent ID from CSV reported data - published from years: 2006-2020. This ID is linked to the newer years of reported XBRL data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as respondent_id. Note that this ID does not correspond to FERC respondent IDs from other forms.

respondent_id_ferc714_xbrl

FERC Form 714 respondent ID from XBRL reported data - published from years: 2021-present. This ID is linked to the older years of reported CSV data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as entity_id. Note that this ID does not correspond to FERC respondent IDs from other forms.

report_date

Date reported.

datetime_utc

Date and time converted to Coordinated Universal Time (UTC).

timezone

IANA timezone name

demand_reported_mwh

Originally reported electricity demand, calculated by taking the net generation within the BA and subtracting the interchange with adjacent BAs.

demand_imputed_pudl_mwh

Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed in PUDL.

demand_imputed_pudl_mwh_imputation_code

Code describing why a demand value was flagged for imputation.

out_ferc1__yearly_balance_sheet_assets_sched110

package: pudl

Annual time series of utility assets and other debits.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110)

Primary key:

utility_id_ferc1, report_year, asset_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

record_id

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.

asset_type

Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.

balance

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

ending_balance

Account balance at end of year.

ferc_account

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.

row_type_xbrl

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

starting_balance

Account balance at beginning of year.

utility_type

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

out_ferc1__yearly_balance_sheet_liabilities_sched110

package: pudl

Annual time series of utility liabilities and other credits.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110)

Primary key:

utility_id_ferc1, report_year, liability_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

starting_balance

Account balance at beginning of year.

ending_balance

Account balance at end of year.

liability_type

Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.

balance

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

ferc_account

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.

row_type_xbrl

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

utility_type

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

out_ferc1__yearly_other_regulatory_assets_sched232

package: pudl

Annual time series of utilities' other regulatory assets, including rate order docket number.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 232)

Primary key:

This table has no primary key. Respondents are able to enter any number of assets across many rows. There are no IDs or set fields enforced in the original table.

Usage Warnings

  • Contains columns which may appear categorical, but are actually free text.

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

description

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

additional_description

Additional free-form description column. In most instances, the values in this column are exactly the same as the description column,but it differs from the standard description enough that we kept both columns. This field did not exist prior to FERC publishing Form 1 as XBRL and thus is always null prior to 2021.

ending_balance

Account balance at end of year.

starting_balance

Account balance at beginning of year.

debits

The increase (decrease) during the period in the value of other assets resulting from the ratemaking actions of regulatory agencies.

credits_written_off_recovered

Recovered amount of divestiture of other assets lacking physical substance resulting from the ratemaking actions of regulatory agencies.

account_detail

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

out_ferc1__yearly_other_regulatory_liabilities_sched278

package: pudl

Annual time series of utilities' other regulatory liabilities, including rate order docket number.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 278)

Primary key:

This table has no primary key. Respondents are able to enter any number of liabilities across many rows. There are no IDs or set fields enforced in the original table.

Usage Warnings

  • Contains columns which may appear categorical, but are actually free text.

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

description

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

ending_balance

Account balance at end of year.

starting_balance

Account balance at beginning of year.

increase_in_other_regulatory_liabilities

The increase during the reporting period of other regulatory liabilities.

account_detail

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

decrease_in_other_regulatory_liabilities

The decrease during the reporting period of other regulatory liabilities.

out_ferc1__yearly_pumped_storage_plants_sched408

package: pudl

Annual time series of plant statistics for hydroelectric pumped storage plants with an installed nameplate capacity of 10+ MW.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 408)

Primary key:

record_id The best approximation for primary keys for this table would be: report_year, utility_id_ferc1, plant_name_ferc1. FERC does not publish plant IDs. The main identifying column is plant_name_ferc1 but that is a free-form string field and there are duplicate records.

Usage Warnings

  • FERC does not restrict respondents to report unique and non-duplicative plant records. There are sporadic instances of respondents reporting portions of plants and then the total plant (ex: unit 1, unit 2 and total). Use caution when aggregating.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

As reported in Schedule 408 of FERC Form 1.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_name_ferc1

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

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.

asset_retirement_cost

Asset retirement cost (USD).

avg_num_employees

The average number of employees assigned to each plant.

capacity_factor

Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.).

capacity_mw

Total installed (nameplate) capacity, in megawatts.

capex_equipment_electric

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

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

capex_facilities

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

capex_land

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

capex_per_mw

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

capex_roads

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

capex_structures

Cost of plant: structures and improvements (USD).

capex_total

Total cost of plant (USD).

capex_wheels_turbines_generators

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

construction_type

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

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

energy_used_for_pumping_mwh

Energy used for pumping, in megawatt-hours.

installation_year

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

net_generation_mwh

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

net_load_mwh

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

opex_dams

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

opex_electric

Production expenses: electric expenses (USD).

opex_engineering

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

opex_generation_misc

Production expenses: miscellaneous power generation expenses (USD).

opex_misc_plant

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

opex_operations

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

opex_per_mwh

Total production expenses (USD per MWh generated).

opex_plant

Production expenses: maintenance of electric plant (USD).

opex_production_before_pumping

Total production expenses before pumping (USD).

opex_pumped_storage

Production expenses: pumped storage (USD).

opex_pumping

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

opex_rents

Production expenses: rents (USD).

opex_structures

Production expenses: maintenance of structures (USD).

opex_total

Total production expenses, excluding fuel (USD).

opex_total_nonfuel

Total production expenses, excluding fuel (USD).

opex_water_for_power

Production expenses: water for power (USD).

peak_demand_mw

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

Net plant capability in megawatts.

plant_hours_connected_while_generating

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

plant_id_pudl

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

project_num

FERC Licensed Project Number.

out_ferc1__yearly_purchased_power_and_exchanges_sched326

package: pudl

Annual time series of 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.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 326)

Primary key:

This table has no primary key. The primary key for this table would be record_id, however a small number of these values are duplicated in 2021, 2022, and 2024.

Usage Warnings

  • Contains columns which may appear categorical, but are actually free text.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table has data about inter-utility power purchases. This includes how much electricity was purchased, how much it cost, and who it was purchased from. Unfortunately the field describing which other utility the power was being bought from (seller_name) is poorly standardized, making it difficult to correlate with other data.

Purchased Power is considered FERC Account 555 according to FERC's Uniform System of Accounts. Reported on pages 326-327 of FERC Form 1.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

seller_name

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

record_id

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.

billing_demand_mw

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

coincident_peak_demand_mw

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

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

demand_charges

Demand charges (USD).

energy_charges

Energy charges (USD).

non_coincident_peak_demand_mw

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

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

purchase_type_code

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

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_storage_mwh

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

purchased_other_than_storage_mwh

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

received_mwh

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

tariff

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

total_settlement

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.

out_ferc1__yearly_sales_by_rate_schedules_sched304

package: pudl

Annual time series of utilities' electric sales from all rate schedules in effect throughout the year.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 304)

Primary key:

This table has no primary key.

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • Values in rate_schedule_description are free-form strings.

  • Data prior to 2021 does not include information in columns: rate_schedule_type and billing_status.

  • Units of revenue_per_kwh are suspected to include a mix of dollars and possibly cents.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

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 across 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_schedule_type = "residential" or any other rate schedule 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 possibility 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 apart. 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.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

rate_schedule_type

Categorization of rate schedule type.

billing_status

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.

rate_schedule_description

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

sales_mwh

Quantity of electricity sold in MWh.

dollar_value

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

avg_customers_per_month

Average number of customers per month.

kwh_per_customer

kWh per customer.

revenue_per_kwh

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

record_id

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.

out_ferc1__yearly_steam_plants_fuel_sched402

package: pudl

Annual time series of 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.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)

Primary key:

record_id

Usage Warnings

  • The fuel_type_code_pudl is inferred from a free-form string field.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table is a subset of the steam plant table reported on page 402 of FERC Form 1.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_id_pudl

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

plant_name_ferc1

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

fuel_consumed_mmbtu

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

Total cost of consumed fuel.

fuel_consumed_units

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

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

fuel_cost_per_unit_burned

Average cost of fuel consumed in the report year per reported fuel unit (USD).

fuel_cost_per_unit_delivered

Average cost of fuel delivered in the report year per reported fuel unit (USD).

fuel_mmbtu_per_unit

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

fuel_type_code_pudl

Simplified fuel type code used in PUDL

fuel_units

Reported unit of measure for fuel.

record_id

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.

out_ferc1__yearly_utility_plant_summary_sched200

package: pudl

Annual time series of utility plant and accumulated provisions for depreciation, amortization and depletion of utility plant assets.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 200)

Primary key:

utility_id_ferc1, report_year, utility_type, utility_plant_asset_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

utility_type

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

utility_type_other

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).

utility_plant_asset_type

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.

row_type_xbrl

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

ending_balance

Account balance at end of year.

record_id

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.

out_pudl__yearly_assn_eia_ferc1_plant_parts

package: pudl

Annual Association table providing connections between power plant data reported in FERC Form 1 and any available EIA data related to the plant parts covered by each FERC Form 1 record.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

The Public Utility Data Liberation (PUDL) Project

Primary key:

record_id_ferc1

Usage Warnings

  • Data has been drawn from several EIA sources which are not always consistent with each other, and PUDL chooses the most consistent or relevant value to facilitate cross-referencing even if that means some values will differ from the raw sources. See Harvesting for details, and see Entity Resolution Methodology for a fuller conceptual overview.

  • Contains information from multiple raw inputs.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table 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, out_eia__yearly_plant_parts. The EIA data in each record represents an aggregation of several slices of an EIA plant, across both physical characteristics and utility ownership.

This table inherits canonicalized values for generators and plants. EIA reports many attributes in many different tables across EIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL collects all instances of these values and and chooses a canonical value. By default, PUDL chooses the most consistently reported value of a given attribute as long as it is at least 70% of the given instances reported. If an attribute was reported inconsistently across the original EIA tables, then it will show up as a null value. See /methodology/entity_resolution for a conceptual overview of this process.

Columns
record_id_ferc1

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.

record_id_eia

Identifier for EIA plant parts analysis records.

match_type

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.

plant_name_ppe

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

plant_part

The part of the plant a record corresponds to.

report_year

Four-digit year in which the data was reported.

report_date

Date reported.

ownership_record_type

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

plant_name_eia

Plant name.

plant_id_eia

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

generator_id

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

unit_id_pudl

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.

prime_mover_code

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

energy_source_code_1

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

technology_description

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

ferc_acct_name

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

generator_operating_year

Year a generator went into service.

utility_id_eia

The EIA Utility Identification number.

utility_id_pudl

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

true_gran

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

appro_part_label

Plant part of the associated true granularity record.

appro_record_id_eia

EIA record ID of the associated true granularity record.

record_count

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

fraction_owned

Proportion of generator ownership attributable to this utility.

ownership_dupe

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

operational_status

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

The operating status of the asset using PUDL categories.

plant_id_pudl

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

total_fuel_cost_eia

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

fuel_cost_per_mmbtu_eia

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

net_generation_mwh_eia

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

capacity_mw_eia

Total installed (nameplate) capacity, in megawatts.

capacity_factor_eia

Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.).

total_mmbtu_eia

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

unit_heat_rate_mmbtu_per_mwh_eia

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

fuel_type_code_pudl_eia

Simplified fuel type code used in PUDL

installation_year_eia

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

plant_part_id_eia

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

utility_id_ferc1

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_name_ferc1

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

plant_id_ferc1

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

plant_name_ferc1

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

asset_retirement_cost

Asset retirement cost (USD).

avg_num_employees

The average number of employees assigned to each plant.

capacity_factor_ferc1

Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.).

capacity_mw_ferc1

Total installed (nameplate) capacity, in megawatts.

capex_annual_addition

Annual capital addition into capex_total.

capex_annual_addition_rolling

Year-to-date capital addition into capex_total.

capex_annual_per_kw

Annual capital addition into capex_total per kw.

capex_annual_per_mw

Annual capital addition into capex_total per MW.

capex_annual_per_mw_rolling

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

capex_annual_per_mwh

Annual capital addition into capex_total per MWh.

capex_annual_per_mwh_rolling

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

capex_equipment

Cost of plant: equipment (USD).

capex_land

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

capex_per_mw

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

capex_structures

Cost of plant: structures and improvements (USD).

capex_total

Total cost of plant (USD).

capex_wo_retirement_total

Total cost of plant (USD) without retirements.

construction_type

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

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

construction_year_ferc1

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

installation_year_ferc1

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

net_generation_mwh_ferc1

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

not_water_limited_capacity_mw

Plant capacity in MW when not limited by condenser water.

opex_allowances

Allowances.

opex_boiler

Maintenance of boiler (or reactor) plant.

opex_coolants

Cost of coolants and water (nuclear plants only)

opex_electric

Production expenses: electric expenses (USD).

opex_engineering

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

opex_fuel

Production expenses: fuel (USD).

fuel_cost_per_mwh_eia

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

fuel_cost_per_mwh_ferc1

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

opex_misc_power

Miscellaneous steam (or nuclear) expenses.

opex_misc_steam

Maintenance of miscellaneous steam (or nuclear) plant.

opex_nonfuel_per_mwh

Investments in non-fuel production expenses per Mwh.

opex_operations

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

opex_per_mwh

Total production expenses (USD per MWh generated).

opex_plant

Production expenses: maintenance of electric plant (USD).

opex_production_total

Total operating expenses.

opex_rents

Production expenses: rents (USD).

opex_steam

Steam expenses.

opex_steam_other

Steam from other sources.

opex_structures

Production expenses: maintenance of structures (USD).

opex_total_nonfuel

Total production expenses, excluding fuel (USD).

opex_transfer

Steam transferred (Credit).

peak_demand_mw

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

Net plant capability in megawatts.

plant_hours_connected_while_generating

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

plant_type

Type of plant.

water_limited_capacity_mw

Plant capacity in MW when limited by condenser water.

fuel_cost_per_mmbtu_ferc1

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

fuel_type

Type of fuel.

license_id_ferc1

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

opex_maintenance

Production expenses: Maintenance (USD).

opex_total

Total production expenses, excluding fuel (USD).

capex_facilities

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

capex_roads

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

net_capacity_adverse_conditions_mw

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

net_capacity_favorable_conditions_mw

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

opex_dams

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

opex_generation_misc

Production expenses: miscellaneous power generation expenses (USD).

opex_hydraulic

Production expenses: hydraulic expenses (USD).

opex_misc_plant

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

opex_water_for_power

Production expenses: water for power (USD).

ferc_license_id

The FERC license ID of a project.

capex_equipment_electric

Cost of plant: accessory electric equipment (USD).

capex_equipment_misc

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

capex_wheels_turbines_generators

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

energy_used_for_pumping_mwh

Energy used for pumping, in megawatt-hours.

net_load_mwh

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

opex_production_before_pumping

Total production expenses before pumping (USD).

opex_pumped_storage

Production expenses: pumped storage (USD).

opex_pumping

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

total_fuel_cost_ferc1

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

total_mmbtu_ferc1

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

fuel_type_code_pudl_ferc1

Simplified fuel type code used in PUDL

unit_heat_rate_mmbtu_per_mwh_ferc1

Fuel content per unit of electricity generated. Calculated from FERC reported fuel consumption and net generation.

out_ferc1__yearly_steam_plants_fuel_by_plant_sched402

package: pudl

Annual time series of FERC fuel data by plant.

Most-recent data:

2024

Processing:

Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)

Primary key:

report_year, utility_id_ferc1, plant_name_ferc1

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
report_year

Four-digit year in which the data was reported.

utility_id_ferc1

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

FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.

utility_id_ferc1_xbrl

FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.

utility_id_pudl

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

utility_name_ferc1

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

plant_id_pudl

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

plant_name_ferc1

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

coal_fraction_cost

Coal cost as a percentage of overall fuel cost.

coal_fraction_mmbtu

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

fuel_cost

Total fuel cost for plant (in $USD).

fuel_mmbtu

Total heat content for plant (in MMBTU).

gas_fraction_cost

Natural gas cost as a percentage of overall fuel cost.

gas_fraction_mmbtu

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

nuclear_fraction_cost

Nuclear cost as a percentage of overall fuel cost.

nuclear_fraction_mmbtu

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

oil_fraction_cost

Oil cost as a percentage of overall fuel cost.

oil_fraction_mmbtu

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

primary_fuel_by_cost

Primary fuel for plant as a percentage of cost.

primary_fuel_by_mmbtu

Primary fuel for plant as a percentage of heat content.

waste_fraction_cost

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

waste_fraction_mmbtu

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

core_ferc__codes_accounts

package: pudl

Code table containing descriptions of categorical codes for account numbers from the FERC Uniform System of Accounts for Electric Plant.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC -- Mix of multiple FERC Forms

Primary key:

ferc_account_id

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

These codes are 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).

Columns
ferc_account_id

Account identifier from FERC's Uniform System of Accounts for Electric Plant. Includes higher level labeled categories.

ferc_account_description

Description of the FERC account.

core_ferc__entity_companies

package: pudl

Entity table containing static information about the companies that submit required filings to FERC.

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC -- Mix of multiple FERC Forms

Primary key:

company_id_ferc

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
company_id_ferc

The Company Identifier (CID) obtained through FERC's Company Registration system.

company_name

The name of the FERC-reporting organization or company.

program

The specific program or initiative associated with the FERC organization, which can provide context for the company's activities.

company_website

The website URL of the company, which can provide additional information about the organization.

street_address

Physical street address.

address_2

Second line of the address.

city

Name of the city.

state

Two letter US state abbreviation.

zip_code

Five digit US Zip Code.

zip_code_4

Four digit US Zip Code suffix.

core_ferc1__yearly_identification_certification

package: pudl

Annual time series of respondent identification and corporate officer certification information.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Part I and II)

Primary key:

utility_id_ferc1, report_year, report_filing_type

Usage Warnings

  • Contains columns which may appear categorical, but are actually free text.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table contains information identifying a utility's contact information, addresses and individuals responsible for accounting and certification. Note that the entity_id_gleif field does not conform to the expected format and largely includes the names of respondents.

Columns
utility_id_ferc1

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.

report_year

Four-digit year in which the data was reported.

record_id

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.

utility_name_ferc1

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

prior_utility_name_ferc1

Former name of the responding utility, when it changed within the last year.

name_change_date

Date of last name change of the company.

company_id_ferc

The Company Identifier (CID) obtained through FERC's Company Registration system.

entity_id_gleif

Legal Entity Identification Number issued by Global Legal Entity Identifier Foundation (GLEIF). The Legal Entity Identifier (LEI) is a 20-character, alpha-numeric code based on the ISO 17442 standard developed by the International Organization for Standardization (ISO).

contact_name

Name of contact person for the respondent.

contact_title

Title of contact person for the respondent.

contact_email

Email for contact identified in contact_name.

contact_address

Street address for contact identified in contact_name.

contact_phone

Phone number for contact identified in contact_name.

contact_city

City for contact identified in contact_name.

contact_state

State for contact identified in contact_name.

contact_zip

Zip code for contact identified in contact_name.

office_street_address

Street address of principal office at end of period.

office_city

City of principal office at end of period.

office_state

State of principal office at end of period.

office_zip

Zipcode of principal office at end of period.

attestation_name

Name of person signing the corporate officer's certification.

attestation_title

Title of person signing the corporate officer's certification.

attestation_date

Date that corporate officer's certification was signed.

attestation_signature

Signature of corporate officer to certify the report.

filing_software_vendor_name

Name of software company used for creating the instance file submitted. If the filer created the submission, is null

report_filing_type

Type of report submitted: O (original) or R (revision).

filing_date

Date on which the filing was submitted.

core_ferc714__respondent_id

package: pudl

Respondent identification.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report (Part I, Schedule 1)

Primary key:

respondent_id_ferc714

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
respondent_id_ferc714

PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.

respondent_id_ferc714_csv

FERC Form 714 respondent ID from CSV reported data - published from years: 2006-2020. This ID is linked to the newer years of reported XBRL data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as respondent_id. Note that this ID does not correspond to FERC respondent IDs from other forms.

respondent_id_ferc714_xbrl

FERC Form 714 respondent ID from XBRL reported data - published from years: 2021-present. This ID is linked to the older years of reported CSV data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as entity_id. Note that this ID does not correspond to FERC respondent IDs from other forms.

respondent_name_ferc714

Name of the utility, balancing area authority, or planning authority responding to FERC Form 714.

eia_code

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.

core_ferc1__codes_power_purchase_types

package: pudl

Code table containing descriptions of categorical codes for electric power purchase types.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities

Primary key:

code

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
code

Originally reported short code.

label

Longer human-readable code using snake_case

description

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

core_pudl__assn_ferc1_pudl_plants

package: pudl

Association table providing connections between FERC 1 plants and their manually assigned PUDL plant IDs.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

The Public Utility Data Liberation (PUDL) Project

Primary key:

utility_id_ferc1, plant_name_ferc1

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

FERC does not assign IDs to plants, so each FERC 1 plant is identified by a utility_id_ferc1 and a plant_name_ferc1.

Columns
utility_id_ferc1

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.

plant_name_ferc1

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_id_pudl

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

core_pudl__assn_ferc1_pudl_utilities

package: pudl

Association table providing connections between PUDL utility IDs and PUDL-assigned FERC1 utility IDs.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

The Public Utility Data Liberation (PUDL) Project

Primary key:

utility_id_ferc1

Usage Warnings

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table maps two manually assigned utility IDs: a PUDL ID and a FERC1 ID. The PUDL IDs link EIA and FERC1 utilities. The PUDL FERC1 IDs link records from older DBF respondent IDs and new XBRL entity IDs via core_pudl__assn_ferc1_dbf_pudl_utilities and core_pudl__assn_ferc1_xbrl_pudl_utilities respectively. This table is generated from a table stored in the PUDL repository: src/package_data/glue/utility_id_pudl.csv

Columns
utility_id_ferc1

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_name_ferc1

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

utility_id_pudl

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

core_ferc1__yearly_cash_flows_sched120

package: pudl

Annual time series of utility cash flow.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 120)

Primary key:

utility_id_ferc1, report_year, amount_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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.

amount_type

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

amount

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

balance

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

row_type_xbrl

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

core_ferc1__yearly_depreciation_by_function_sched219

package: pudl

Annual time series of ending balances in accumulated provision for depreciation of electric utility plant.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section B)

Primary key:

utility_id_ferc1, report_year, depreciation_type, plant_function, plant_status, utility_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric utility plant refers to FERC Account 108. Section B includes the Balances at End of Year According to Functional Classification (plant_function).

Columns
utility_id_ferc1

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.

report_year

Four-digit year in which the data was reported.

depreciation_type

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

plant_function

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

plant_status

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

utility_type

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

ending_balance

Account balance at end of year.

record_id

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.

balance

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

row_type_xbrl

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

core_ferc1__yearly_depreciation_changes_sched219

package: pudl

Annual time series of changes in accumulated provision for depreciation of electric utility plant.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section A)

Primary key:

utility_id_ferc1, report_year, depreciation_type, plant_status, utility_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric utility plant refers to FERC Account 108.

Columns
utility_id_ferc1

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.

report_year

Four-digit year in which the data was reported.

depreciation_type

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

plant_status

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

utility_type

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

dollar_value

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

record_id

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.

balance

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

ferc_account

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.

row_type_xbrl

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

core_ferc1__yearly_depreciation_factors_sched336

package: pudl

Annual time series of factors used in estimating depreciation charges.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section C)

Primary key:

This table has no primary key. This table is too unstructured to have a primary key.

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • Contains columns which may appear categorical, but are actually free text.

  • The rate and percentage (pct) columns are reported either as values between 0-1 or 0-100. It is often consistent within a given utility-year but use caution when comparing value across different utilities and even the same utility filing in a different year.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

This table contains details at a variety of levels of granularity.There are many free-form text fields in this table which results in respondents filling out this table very differently from each other or from year to year. We recommend using this table carefully with one utility-year at a time - not attempting to perform analysis across long time-series or across utilities without much caution and cleaning. This table only contains information from Section C: Factors Used in Estimating Depreciation Charges.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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.

depreciation_factors

Label of the factor of depreciation factors. This field contains is an unstructured, free-form strings. It often includes FERC account IDs, sometimes includes plant names and sometimes includes headers indicating the beginning of a new section - such as a plant or asset type header which is followed by sub-components like FERC account IDs or plant names depending on the section.

depreciable_plant_base

Depreciable plant balance (depreciable base) to which rates are applied.

net_salvage_pct

Percentage representing the estimated value of utility plant at the end of its service life. Be aware that the formatting of this column is not expected to be standard - expect some values between 0-1 and some between 0-100.

depreciation_rate

Depreciation rate applied to utility plant balance.Be aware that the formatting of this column is not expected to be standard - expect some values between 0-1 and some between 0-100.

mortality_curve_type

Description of the type of mortality curve selected in plant mortality studies prepared to assist in estimating average service lives.

order_num

This field is defined in FERC-XBRL documentation as a field that is used to sequence a table.FERC-XBRL documentation notes: 'This field is added to a table to control ordering of the items on the table.'FERC's documentation also notes that this field should always be an integer - although there are many instances of floating point values which seem to increment by decimal points. Nonetheless, this field can be used to help understand the original order of the table. This field did not exist prior to FERC publishing Form 1 as XBRL and thus is always null prior to 2021.

account_num

Account number(s) in connection with factors used in estimating depreciation charges.

service_life_avg

Estimated average service life of utility plant. The original DBF data was reported as years while the XBRL data was reported as strings in this time duration format: PnYnMnDTnHnMnS. PUDL converts these string time durations into years.

remaining_life_avg

Estimated weighted average of remaining life of utility plant assets.The original DBF data was reported as years while the XBRL data was reported as strings in this time duration format: PnYnMnDTnHnMnS. PUDL converts these string time durations into years.

core_ferc1__yearly_depreciation_summary_sched336

package: pudl

Annual time series of depreciation and amortization of electric plant.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section A)

Primary key:

utility_id_ferc1, report_year, plant_function, ferc_account_label

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric Plant refers to FERC Accounts 403, 404, and 405. This table only contains information from Section A: Summary of depreciation and amortization changes.

Columns
record_id

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

Four-digit year in which the data was reported.

utility_id_ferc1

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.

plant_function

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

ferc_account_label

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

ferc_account

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.

dollar_value

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

utility_type

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

row_type_xbrl

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

core_ferc1__yearly_energy_dispositions_sched401

package: pudl

Annual time series of dispositions of electric energy sold, exchanged, or stored.

Most-recent data:

2024

Processing:

Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.

Source:

FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)

Primary key:

utility_id_ferc1, report_year, energy_disposition_type

Usage Warnings

  • Some columns contain subtotals; use caution when choosing columns to aggregate.

  • FERC data is notoriously difficult to extract cleanly, and often contains free-form strings, non-labeled total rows and lack of IDs. See Notable Irregularities for details.

Additional Details

Electric Energy Account, dispositions only. Schedule 401a. Electricity utilities delivered to end users, internal losses, etc.

Columns
utility_id_ferc1

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.

report_year

Four-digit year in which the data was reported.

energy_disposition_type

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.

row_type_xbrl

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

energy_mwh

Sources and uses of energy in MWh.

record_id

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.