Documentation updates

README.rst

@@ -0,0 +1,4 @@
+Foundational Industry Energy Dataset (FIED)
+===========================================
+
+**FIED** is a dataset that compiles and estimates unit-level information for industrial energy analysis and modeling. 

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/build/html/.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 8370bc3dae49b3ec0a3a8e32e8576ba0
+tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/build/html/_sources/data_history.rst.txt

@@ -0,0 +1,6 @@
+A Brief History of U.S. Industrial Energy Data
+==============================================
+
+*The following are excerpts from McMillan et al. (2024) [McMillanetal2024]_ .*
+
+.. [McMillanetal2024] McMillan, Colin, Carrie Schoeneberger, Sarang Supekar, and David Thierry. “The Foundational Industrial Energy Dataset (FIED): Open-Source Data on Industrial Facilities.” Golden, CO: National Renewable Energy Laboratory (NREL), September 5, 2024. https://doi.org/10.2172/2440617.

docs/build/html/_sources/ind_data.rst.txt

@@ -0,0 +1,101 @@
+Sources of Industrial Energy Data for the United States
+#######################################################
+
+This page provides a brief overview of sources of U.S. industrial energy data, including breif descriptions of their publication timelines and resolution.
+Industrial energy datasets developed by NREL are discussed on a :doc:`separate page </nrel_data>`.
+By and large, most industrial energy data is available for "industry" (an aggregation of `North American Industrial Classification System [NAICS] codes <https://www.census.gov/naics/>`_ for Agriculture [NAICS 11], Mining [NAICS 21], Construction [NAICS 23], and Manufacturing [NAICS 31-33]) or for manufacturing industries. Unlike manufacturing, the non-manufacturing sectors do not have their own EIA end-use survey and energy data collection by other federal agencies is limited.  
+The current state of industrial energy data collection and dissemination can be explained by various historical developments. This historical context is summarized in this project :doc:`here </data_history>` and described in more detail in an `NREL technical report <https://www.nrel.gov/docs/fy24osti/90442.pdf>`_. 
+
+.. csv-table:: Summary of Industrial Energy Data Sources
+   :header: "Source", "Data Prodct", "Publication Timeline", "Geographic Resolution", "Industry Resolution", "Fuel Type Disaggregation", "End-Use Disaggregation", "Notes" 
+
+   "EIA",            "`Monthly/Annual Energy Review <https://www.eia.gov/totalenergy/data/monthly/>`_", "Monthly/annually", "National", "None", "Yes", "No", "Comprised of supplier responses from various EIA fuel surveys" 
+   "EIA",            "`State Energy Data System (SEDS) <https://www.eia.gov/state/seds/>`_", "Annual", "None", "Yes", "No", "Comprised of supplier responses to EIA fuel surveys." 
+   "EIA",            "`Manufacturing Energy Consumption Survey (MECS) <https://www.eia.gov/consumption/manufacturing/about.php>`_", "Quadrennial", "Census region", "Up to 6-digit NAICS", "Yes", "Yes", "Survey conducted by the Census Bureau for EIA."
+   "EIA",            "`Annual Energy Outlook (AEO) <https://www.eia.gov/forecasts/aeo/>`_", "Annual", "Census division", "Yes", "Yes", "Yes", "AEO provides annual projections out to 2050. Additional results detail can be requested from EIA staff."
+   "EIA",            "`Form EIA-923 <https://www.eia.gov/electricity/data/eia923>`_", "Monthly and Annual", "Facility", "Up to 6-digit NAICS", "Electricity only", "No", "Provides information for industrial generators (including cogeneration) above 1 MW capacity."
+   "Census Bureau",  "`Economic Census <https://www.census.gov/programs-surveys/economic-census.html>`_", "Quinquennial", "Census Places", "Up to 6-digit NAICS", "Electricity and 'fuels'", "No", "Data are withheld at increasingly geographic and industrial resolution. Use of 'fuels' reported in dollars."
+   "Census Bureau",  "`Annual Integrated Economic Survey (AIES) <https://www.census.gov/programs-surveys/aies.html>`_", "Annual", "State", "Up to 6-digit NAICS", "Electricity and 'fuels'", "No", "AIES has subsumed the Annual Survey of Manufacturers has been. Use of 'fuels' reported in dollars." 
+   "DOE",            "`Combined Heat and Power and Microgrid Database <https://www.doe.icfwebservices.com/chp>`_", "Rolling updates", "Unit", "Up to 6-digit NAICS", "Yes", "No", 
+   "DOE",            "`Industrial Assessment Center (IAC) Database <https://iac.university>`_", "Rolling updates", "Facility", "Up to 6-digit NAICS", "Yes", "No", "Represents participants in IAC program assessments, which are small and medium sized manufacturers."
+
+
+
+Energy Information Administration (EIA)
+***************************************
+
+The EIA is the primary institution responsible for collecting national industrial energy data. Its data products include the supplier-based surveys of fuel use, as well as the user-based Manufacturing Energy Consumption Survey conducted by the U.S. Census Breau. 
+EIA industrial energy data sources include:
+
+* `Monthly/Annual Energy Review <https://www.eia.gov/totalenergy/data/monthly/>`_: National estimates of industry energy use compiled from `fuel supplier survey forms <https://www.eia.gov/Survey/index.php>`_.
+* `State Energy Data System (SEDS) <https://www.eia.gov/state/seds>`_: State estimates of industry energy use compiles from `fuel supplier survey forms <https://www.eia.gov/Survey/index.php>`_.
+* `Manufacturing Energy Consumption Survey (MECS) <https://www.eia.gov/consumption/manufacturing/about.php>`_: Quadrennial survey of manufacturing energy use. 
+* `Form EIA-923 <https://www.eia.gov/electricity/data/eia923>`_: Reports information related to industrial facilities that generate their own electricity.
+
+U.S. Department of Energy (DOE)
+*******************************
+
+Although EIA is responsible for collecting much of the nation's industrial energy data, the DOE does fund complementary data collection efforts. These include:
+
+* `Combined Heat and Power and Microgrid Database <https://www.doe.icfwebservices.com/chp>`_: Database of CHP and microgrid installations.
+* `Industrial Assessment Center (IAC) Database <https://iac.university>`_: Database of recorded energy use, production output, production hours, and other information for facilities that have participated in IAC assessments. 
+
+
+U.S. Census Bureau
+******************
+
+* `Economic Census <https://www.census.gov/programs-surveys/economic-census.html>`_: Survey conducted every five years on economic characteristics of industrial establishments.
+* `Annual Integrated Economic Survey (AIES) <https://www.census.gov/programs-surveys/aies.html>`_: Annual survey that includes economic characteristics of manufacturing establishments. 
+* `Quarterly Survey of Plant Capacity Utilization (QPC) <https://www.census.gov/programs-surveys/qpc.html>`_: Quarterly survey that provides statistics on the rates of industrial capacity utilization and average weekly operating hours.
+
+U.S. Environmental Protection Agency (EPA)
+******************************************
+
+Several EPA datasets provide detailed information about facilities and their individual units. Although these datasets are not explicitly collected to estimated energy use, the emissions they report provide a path for alternative estimates of energy use, as documented in various :doc:`NREL datasets </nrel_data>`.   
+
+
+
+Other Federal agencies
+**********************
+
+Several other federal agencies collect industrial energy information. 
+
+
+U.S. Geological Survey (USGS)
+=============================
+
+* `Minerals Yearbook: Cement <https://www.usgs.gov/centers/national-minerals-information-center/cement-statistics-and-information>`_: Includes estimates of fuels used by cement district.
+
+
+U.S. Department of Agriculture (USDA)
+=====================================
+
+Like the The USDA also maintains the `Federal Life Cycle Assessment (LCA) Commons <https://www.lcacommons.gov>`_, a data repository to support LCA.
+
+
+Justice-Focused
+***************
+
+An increasing number of data products and associated mapping tools have been developed that bring together the locations industrial facilities with the socioeconomic conditions of their surrounding communities.
+These include, but are not limted to:
+
+* `Corporate Toxics Information Project <https://www.peri.umass.edu/corporate-toxics-information-project/>`_: Datasets linking facility ownership to emissions of air emissions and toxics. Developed by the University of Massachusetts Amherst. 
+* `Climate and Economic Justice Screening Tool (CEJST) <https://screeningtool.geoplatform.gov/>`_: Dataset combining indicators of climate change, energy, health, housing, legacy pollution, transportation, water and wastewater, and workforce development burdens. Developed by the White House Council on Environmental Quality.
+* `Energy Communitites IWG Site Review Tool <https://edxspatial.arcgis.netl.doe.gov/experience_builder/IWGSiteReviewTool/index.html>`_:. Dataset developed to link information on industrial facility locations, brownfields, infrastructure, and community attributes. Developed by the National Energy Technology Laboratory and DOE.
+* `Employment Vulnerability to the Energy Transition (E-VET) Tool <https://kailingraham.github.io/ecf-vis-tool/>`_: Analysis and dataset identifying communities that may be vulnerable in an energy transition based on their reliance on carbon-intensive industries. Based on 2024 work from `Kailin Graham and Christopher Knittel <https://doi.org/10.1073/pnas.2314773121>`_.   
+
+
+
+Other Publicly-Avaialable Data
+******************************
+
+* `U.S. industrial boiler inventory <https://github.com/carriescho/Electrification-of-Boilers>`_: Based on 2022 work from `Schoeneberger et al. <https://doi.org/10.1016/j.adapen.2022.100089>`_. 
+* `Global Steel Plant Tracker (GSPT) <https://globalenergymonitor.org/projects/global-steel-plant-tracker/>`_: Data compiled by `Global Energy Monitor <https://globalenergymonitor.org>`_ on global steel facilities.  
+* `Global Blast Furnace Tracker (GBFT) <https://globalenergymonitor.org/projects/global-blast-furnace-tracker/>`_: Data compiled by `Global Energy Monitor <https://globalenergymonitor.org>`_ on global blast furnaces.
+* `Global Cement and Concrete Tracker <https://globalenergymonitor.org/projects/global-cement-and-concrete-tracker/>`_: Scheduled release in July 2025 by `Global Energy Monitor <https://globalenergymonitor.org>`_. 
+
+
+Private (Proprietary) Sources
+*****************************
+
+A mix of industry trade groups and other private sources collect data and may offer access for a fee. 

docs/build/html/_sources/index.rst.txt

@@ -0,0 +1,25 @@
+.. FIED documentation master file, created by
+   sphinx-quickstart on Mon Oct  7 10:21:26 2024.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to FIED's Documentation!
+================================
+
+The **Foundational Industry Energy Dataset (FIED)** provides unit-level energy estimates and other information for industrial energy analysis and modeling. 
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents:
+
+   ind_data
+   nrel_data
+   data_history
+
+
+Indices and Tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

docs/build/html/_sources/nrel_data.rst.txt

@@ -0,0 +1,62 @@
+###############################
+NREL Industrial Energy Datasets
+###############################
+
+NREL has developed several related and oftentimes overlapping industrial energy datasets. All datasets have been developed as attempts to overcome the limited resolution of traditional sources of energy data and are linked by their use of `EPA Greenhouse Gas Reporting Program (GHGRP) <https://enviro.epa.gov/envirofacts/ghg/search>`_ greenhouse gas emissions data to derive facility combustion energy use.
+
+This page serves as a guide to those datasets and their use. The datasets are presented in chronological order and each is referred to by its respository name. In addition to a link to the dataset itself, links are also provided to associated Github repositories and known publications that have used each dataset.
+
+.. _ind_comb_data_2016:
+Industrial Facility Combustion Energy Use (2016)
+************************************************
+
+The first systematic use of EPA GHGRP data to derive facility-level combustion energy use. This initial version of the derivation methodology applied EPA default emissions factors to reported fuel use by fuel type. Additional facility information is included with calculated combustion energy values, such as industry type (six-digit NAICS code), location (lat, long, zip code, county, and state), combustion unit type, and combustion unit name. Energy estimates were disaggregated by end-use by applying data from the `2010 Manufacturing Energy Consumption Survey (MECS) <http://www.eia.gov/consumption/manufacturing/data/2010/>`_. 
+A rough characterization of process heat temperatures was also included.
+*Note that this dataset only includes 14 six-digit NAICS codes that were identified as focus industries.*  
+
+
+* `NREL Data Catalog dataset link <https://doi.org/10.7799/1278644>`_
+* `NREL/INL joint technical report:  <https://doi.org/doi:10.2172/1334495>`_
+* `GitHub repository <>`
+
+.. _ind_comb_data_2018
+Industrial Process Heat Demand Characterization (2018)
+******************************************************
+
+Represents an evolution of the methodology used in the :ref:`2016 dataset <ind_comb_data_2016>`, based on additional GHGRP data to derive combustion energy estimates based on the reporting Tier used by each industry reporter. 
+*Note that this dataset only includes 14 six-digit NAICS codes that were identified as focus industries.*  
+
+* `NREL Data Catalog dataset link <https://doi.org/10.7799/1461488>`_
+* `Paper published in *Applied Energy* <https://doi.org/10.1016/j.apenergy.2019.01.077>`_
+* `GitHub repository <https://github.com/NREL/Industrial-Heat-Demand-Analysis>`_
+* Example applications:
+   * Vanatta, Max, Deep Patel, Todd Allen, Daniel Cooper, and Michael T. Craig. "Technoeconomic analysis of small modular reactors decarbonizing industrial process heat." Joule 7, no. 4 (2023): 713-737 `https://doi.org/10.1016/j.joule.2023.03.009 <https://doi.org/10.1016/j.joule.2023.03.009>`_.
+
+United States County-Level Industrial Energy Use (2018)
+*******************************************************
+
+First implementation of a method to derive national estimates of industrial energy use at a county level using the foundataion of deriving facility-level combustion energy estimates. Includes estimates for non-manufacturing industries, in addition to manufacturing industries, as well as additional disaggregation by end use (e.g. machine drive process heating facility lighting is provided for manufacturing agriculture and mining industries).   
+
+* `NREL Data Catalog dataset link <https//github.com/NREL/Industry-Energy-Tool/>`_
+* `NREL technical report: "The Industry Energy Tool (IET): Documentation" <https://doi.org/10.2172/1484348>`_
+* `GitHub Repository <https//github.com/NREL/Industry-Energy-Tool/>`_
+
+Manufacturing Thermal Energy Use in 2014 (2019)
+***********************************************
+
+Estimates thermal energy use (i.e., fuels combusted for process heating, boilers, and combined heat and power/cogeneration) by end use, temperature, county, and facility employment size class for all U.S. manufacturing industries in 2014. The estimation methodology builds off of the 
+
+
+2018 Industrial Energy Data Book (2019)
+***************************************
+
+The Industrial Energy Data Book (IEDB) aggregates and synthesizes information on the trends in industrial energy use, energy prices, economic activity, and water use. The IEDB also estimates county-level industrial energy use and combustion energy use of large energy-using facilities (i.e., facilities required to report greenhouse gas emissions under the EPA's Greenhouse Gas Reporting Program). These estimates are derived from publicly available sources from EPA, EIA, Census Bureau, USDA, and USGS.
+
+* `NREL Data Catalog dataset link <https://doi.org/10.7799/1575074>`
+* `EERE Industrial Energy Data Book `
+* `GitHub repository <https://github.com/NREL/Industry-energy-data-book>`_
+
+
+Other relevant NREL datasets include:
+
+* Utility Rate Database