Energy Python Library
From the CORGIS Dataset Project
By Austin Cory Bart acbart@vt.edu , Joung Min Choi joungmin@vt.edu , Bo Guan jasonguan0107@vt.edu Version 3.0.0, created 10/7/2021 Tags: energy, renewable, united states, us, nuclear, fossil fuels, power
Overview
United States Government reports on consumption, production, expenditures, and prices of various fuel sources. This data comes from the US Energy Information Administration, which has historical data from 1960 to 2019. Information was not always available, in which case 0 was reported instead. In some cases, very tiny values were rounded down to zero.
https://www.eia.gov/state/seds/seds-data-complete.php
Explore Structure
Each row represents Reports on consumption, production, expenditures, and prices of various fuel sources for each state in a given year .
Explore energy data
Index Type Example Value
0
dict
{
1 dict (same structure)
2 dict (same structure)
... ... ...
Key Type Example Value Description
"State"
str
"Alaska"
The state that this report was made for.
"Year"
int
1960
The year that this report was made.
"Production"
dict
{
"Consumption"
dict
{
"Expenditure"
dict
{
"Price"
dict
{
Key Type Example Value Description
"Coal"
float
11263.0
Coal production in billion BTU. Unfortunately, the other energy sources produced by the United States (including Natural Gas and Petroleum) could not be incorporated.
Key Type Example Value Description
"Commercial"
dict
{
"Electric Power"
dict
{
"Industrial"
dict
{
"Refinery"
dict
{
"Residential"
dict
{
"Transportation"
dict
{
Key Type Example Value Description
"Coal"
float
496.0
Coal consumed by the commercial sector in billion BTU.
"Distillate Fuel Oil"
float
1562.0
Distillate fuel oil consumed by the commercial sector in billion BTU.
"Geothermal"
float
0.0
Geothermal energy consumed by the commercial sector in billion BTU.
"Hydropower"
float
0.0
Hydropower consumed by the commercial sector in billion BTU.
"Kerosene"
float
0.0
Kerosene consumed by the commercial sector in billion BTU.
"Petroleum"
float
5230.0
All petroleum products consumed by the commercial sector in billion BTU.
"Natural Gas"
float
0.0
Natural gas consumed by (delivered to) the commercial sector (including supplemental gaseous fuels) in billion BTU.
"Solar"
float
0.0
Photovoltaic and solar thermal energy consumed by the commercial sector (except portion included in SOHCB) in billion BTU.
"Wind"
float
0.0
Wind energy consumed by the commercial sector in billion BTU.
"Wood"
float
34.0
Wood consumed by the commercial sector in billion BTU.
Key Type Example Value Description
"Coal"
float
914.0
Coal consumed by the electric power sector in billion BTU.
"Distillate Fuel Oil"
float
554.0
Distillate fuel oil consumed by the electrical power sector in billion BTU.
"Natural Gas"
float
0.0
Natural gas consumed by the electric power sector (including supplemental gaseous fuels) in billion BTU.
"Wood"
float
0.0
Wood and waste consumed by the electric power sector in billion BTU.
Key Type Example Value Description
"Coal"
float
4980.0
Coal consumed by the industrial sector in billion BTU.
"Distillate Fuel Oil"
float
5115.0
Distillate fuel oil consumed by the industrial sector in billion BTU.
"Geothermal"
float
0.0
Geothermal energy consumed by the industrial sector in billion BTU.
"Hydropower"
float
0.0
Hydropower consumed by the industrial sector in billion BTU.
"Kerosene"
float
511.0
Kerosene consumed by the industrial sector in billion BTU.
"Petroleum"
float
7415.0
All petroleum products consumed by the industrial sector in billion BTU.
"Natural Gas"
float
1856.0
Natural gas consumed by (delivered to) the industrial sector (including supplemental gaseous fuels) in billion BTU.
"Other Petroleum Products"
float
0.0
Other petroleum products consumed by the industrial sector in billion BTU.
"Solar"
float
0.0
Photovoltaic and solar thermal energy consumed by the industrial sector (except portion included in SOHCB) in billion BTU.
"Wind"
float
0.0
Wind energy consumed by the industrial sector in billion BTU.
"Wood"
float
1840.0
Wood consumed in the industrial sector, total, in billion BTU.
Key Type Example Value Description
"Coal"
float
0.0
Coal consumed as refinery fuel in billion BTU.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil consumed as refinery fuel in billion BTU.
"Natural Gas"
float
0.0
Natural gas consumed as refinery fuel (including supplemental gaseous fuels) in billion BTU.
Key Type Example Value Description
"Coal"
float
714.0
Coal consumed by the residential sector in billion BTU.
"Distillate Fuel Oil"
float
5046.0
Distillate fuel oil consumed by the residential sector in billion BTU.
"Geothermal"
float
0.0
Geothermal energy consumed by the residential sector in billion BTU.
"Kerosene"
float
0.0
Kerosene consumed by the residential sector in billion BTU.
"Petroleum"
float
5137.0
LPG consumed by the residential sector in billion BTU.
"Natural Gas"
float
176.0
Natural gas consumed by (delivered to) the residential sector (including supplemental gaseous fuels) in billion BTU.
"Wood"
float
1806.0
Wood consumed by the residential sector in billion BTU.
Key Type Example Value Description
"Coal"
float
86.0
Coal consumed by the transportation sector in billion BTU.
"Distillate Fuel Oil"
float
3077.0
Distillate fuel oil consumed by the transportation sector in billion BTU.
"Petroleum"
float
27051.0
All petroleum products consumed by the transportation sector in billion BTU.
"Natural Gas"
float
2.0
Natural gas consumed by the transportation sector in billion BTU.
Key Type Example Value Description
"Commercial"
dict
{
"Electric Power"
dict
{
"Industrial"
dict
{
"Residential"
dict
{
"Transportation"
dict
{
Key Type Example Value Description
"Coal"
float
0.0
Coal expenditures in the commercial sector in million dollars.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil expenditures in the commercial sector in million dollars.
"Kerosene"
float
0.0
Kerosene expenditures in the commercial sector in million dollars.
"Petroleum"
float
0.0
All petroleum products total expenditures in the commercial sector in million dollars.
"Natural Gas"
float
0.0
Natural gas expenditures in the commercial sector in million dollars.
Key Type Example Value Description
"Coal"
float
0.0
Coal expenditures in the electric power sector in million dollars.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil expenditures in the electric power sector in million dollars.
"Natural Gas"
float
0.0
Natural gas expenditures in the electric power sector (including supplemental gaseous fuels) in million dollars.
Key Type Example Value Description
"Coal"
float
0.0
Coal expenditures in the industrial sector in million dollars.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil expenditures in the industrial sector in million dollars.
"Kerosene"
float
0.0
Kerosene expenditures in the industrial sector in million dollars.
"Petroleum"
float
0.0
All petroleum products total expenditures in the industrial sector in million dollars.
"Natural Gas"
float
0.0
Natural gas expenditures in the industrial sector (including supplemental gaseous fuels) in million dollars.
"Other Petroleum Products"
float
0.0
Other petroleum products total expenditures in the industrial sector in million dollars.
Key Type Example Value Description
"Coal"
float
0.0
Coal expenditures in the residential sector in million dollars.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil expenditures in the residential sector in million dollars.
"Kerosene"
float
0.0
Kerosene expenditures in the residential sector in million dollars.
"Petroleum"
float
0.0
All petroleum products total expenditures in the residential sector in million dollars.
"Natural Gas"
float
0.0
Natural gas expenditures in the residential sector (including supplemental gaseous fuels) in million dollars.
"Wood"
float
0.0
Wood expenditures in the residential sector in million dollars.
Key Type Example Value Description
"Coal"
float
0.0
Coal expenditures in the transportation sector in million dollars.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil expenditures in the transportation sector in million dollars.
"Petroleum"
float
0.0
All petroleum products total expenditures in the transportation sector in million dollars.
"Natural Gas"
float
0.0
Natural gas expenditures in the transportation sector in million dollars.
Key Type Example Value Description
"Commercial"
dict
{
"Electric Power"
dict
{
"Industrial"
dict
{
"Transportation"
dict
{
Key Type Example Value Description
"Coal"
float
0.0
Coal price in the commercial sector in dollars per million BTU.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil price in the commercial sector in dollars per million BTU.
"Kerosene"
float
0.0
Kerosene price in the commercial sector in dollars per million BTU.
"Petroleum"
float
0.0
All petroleum products average price in the commercial sector in dollars per million BTU.
"Natural Gas"
float
0.0
Natural gas price in the commercial sector (including supplemental gaseous fuels) in dollars per million BTU.
Key Type Example Value Description
"Coal"
float
0.0
Coal price in the electric power sector in dollars per million BTU.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil price in the electric power sector in dollars per million BTU.
"Natural Gas"
float
0.0
Natural gas price in the electric power sector (including supplemental gaseous fuels) in dollars per million BTU.
Key Type Example Value Description
"Coal"
float
0.0
Coal price in the industrial sector in dollars per million BTU.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil price in the industrial sector in dollars per million BTU.
"Kerosene"
float
0.0
Kerosene price in the industrial sector in dollars per million BTU.
"Petroleum"
float
0.0
All petroleum products average price in the industrial sector in dollars per million BTU.
"Natural Gas"
float
0.0
Natural gas price in the industrial sector (including supplemental gaseous fuels) in dollars per million BTU.
"Other Petroleum Products"
float
0.0
Other petroleum products average price in the industrial sector in dollars per million BTU.
Key Type Example Value Description
"Coal"
float
0.0
Coal price in the transportation sector in dollars per million BTU.
"Distillate Fuel Oil"
float
0.0
Distillate fuel oil price in the transportation sector in dollars per million BTU.
"Petroleum"
float
0.0
All petroleum products average price in the transportation sector in dollars per million BTU.
"Natural Gas"
float
0.0
Natural gas price in the transportation sector in dollars per million BTU.
Downloads
Download all of the following files.
energy.py energy.data
Usage
import energy
report = energy . get_report ()
Documentation
get_report() Returns a list of dictionaries representing report.
