core_eiaaeo__yearly_projected_electric_sales

package: pudl

Annual time series of projected electricity sales by region and customer class.

Most-recent data:

2026

Processing:

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

Source:

EIA Annual Energy Outlook (AEO)

Primary key:

report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, customer_class

Columns
report_year

Four-digit year in which the data was reported.

electricity_market_module_region_eiaaeo

AEO projection region.

model_case_eiaaeo

Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details.

projection_year

The year of the projected value.

customer_class

High level categorization of customer type (e.g., commercial, residential).

sales_mwh

Quantity of electricity sold in MWh.

core_eiaaeo__yearly_projected_energy_use_by_sector_and_type

package: pudl

Annual time series of projected energy use for commercial, electric power, industrial, residential, and transportation sectors, drawn from AEO Table 2.

Most-recent data:

2026

Processing:

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

Source:

EIA Annual Energy Outlook (AEO)

Primary key:

report_year, region_name_eiaaeo, model_case_eiaaeo, projection_year, energy_use_sector, energy_use_type

Usage Warnings

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

Additional Details

The series in Table 2 which track energy use by sector do not always define each type of use the same way across sectors. There is detailed information about what is included or excluded in each use type for each sector in the footnotes of the EIA's online AEO data browser:

https://www.eia.gov/outlooks/aeo/data/browser/#/?id=2-AEO2023

Use caution when aggregating across use types! Energy Use has a tricky system of subtotals, and summing all types within a sector will result in double-counting. Consult the EIA's data browser for visibility into which use types are subtotals, and what they contain: subtotal series are displayed indented, and include all lines above them which are one level out, up to the next indented line. Delivered Energy and Total are special cases which include those plus all subtotals above. In this way, "Delivered Energy" includes purchased electricity, renewable energy, and an array of fuels based on sector, and explicitly excludes electricity-related losses.

AEO Energy Use figures are variously referred to as delivered energy, energy consumption, energy use, and energy demand, depending on which use types are being discussed, and which org and which document is describing them. In PUDL we say energy use or energy consumption.

Columns
report_year

Four-digit year in which the data was reported.

region_name_eiaaeo

EIA AEO region for energy consumption. Includes US Census Divisions plus United States.

region_type_eiaaeo

Region type for EIA AEO energy consumption, indicating whether region_name_eiaaeo is a US Census Division or country (United States)

model_case_eiaaeo

Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details.

projection_year

The year of the projected value.

energy_use_sector

Sector for energy use figures in AEO Table 2. Similar to customer class, but with some missing and some extra values.

energy_use_type

Type of energy use, indicating the name of the series from AEO Table 2. Includes fuels, electricity, losses, and various subtotals; consult table documentation for aggregation guidelines.

energy_use_mmbtu

Energy use, in MMBTU; also referred to as energy consumption, energy demand, or delivered energy, depending on type.

core_eiaaeo__yearly_projected_generation_in_electric_sector_by_technology

package: pudl

Annual time series of projected generation capacity & total generation in the electric sector, broken out by technology.

Most-recent data:

2026

Processing:

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

Source:

EIA Annual Energy Outlook (AEO)

Primary key:

report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, technology_description_eiaaeo

Columns
report_year

Four-digit year in which the data was reported.

electricity_market_module_region_eiaaeo

AEO projection region.

model_case_eiaaeo

Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details.

projection_year

The year of the projected value.

technology_description_eiaaeo

Generation technology reported for AEO.

summer_capacity_mw

The net summer capacity.

summer_capacity_planned_additions_mw

The total planned additions to net summer generating capacity.

summer_capacity_unplanned_additions_mw

The total unplanned additions to net summer generating capacity.

summer_capacity_retirements_mw

The total retirements from net summer generating capacity.

gross_generation_mwh

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

core_eiaaeo__yearly_projected_fuel_cost_in_electric_sector_by_type

package: pudl

Annual time series of projected fuel prices for the electric power sector, including electricity-only and combined-heat-and-power plants that have a regulatory status.

Most-recent data:

2026

Processing:

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

Source:

EIA Annual Energy Outlook (AEO)

Primary key:

report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, fuel_type_eiaaeo

Columns
report_year

Four-digit year in which the data was reported.

electricity_market_module_region_eiaaeo

AEO projection region.

model_case_eiaaeo

Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details.

projection_year

The year of the projected value.

fuel_type_eiaaeo

Fuel type reported for AEO end-use sector generation data.

fuel_cost_per_mmbtu

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

fuel_cost_real_per_mmbtu_eiaaeo

Average fuel cost per MMBTU of heat content in real USD, standardized to the value of a USD in the year defined by real_cost_basis_year.

real_cost_basis_year

Four-digit year which is the basis for any 'real cost' monetary values (as opposed to nominal values).

core_eiaaeo__yearly_projected_generation_in_end_use_sectors_by_fuel_type

package: pudl

Annual time series of projected generation capacity and total generation in the end-use sector, broken out by fuel type.

Most-recent data:

2026

Processing:

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

Source:

EIA Annual Energy Outlook (AEO)

Primary key:

report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, fuel_type_eiaaeo

Usage Warnings

  • The solar photovoltaic capacity portion of Renewable Sources is reported in megawatts direct current; other technologies are reported in megawatts of alternating current.

Additional Details

Includes combined-heat-and-power plants and electricity-only plants in the commercial and industrial sectors; and small on-site generating systems in the residential, commercial, and industrial sectors used primarily for own-use generation, but which may also sell some power to the grid.

Columns
report_year

Four-digit year in which the data was reported.

electricity_market_module_region_eiaaeo

AEO projection region.

model_case_eiaaeo

Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details.

projection_year

The year of the projected value.

fuel_type_eiaaeo

Fuel type reported for AEO end-use sector generation data.

summer_capacity_mw

The net summer capacity.

gross_generation_mwh

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