{ "name": "pudl", "title": "The Public Utility Data Liberation Project (PUDL)", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "homepage": "https://docs.catalyst.coop/pudl", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "censusdp1tract", "title": "Census DP1 -- Profile of General Demographic Characteristics", "path": "https://www.census.gov/geographies/mapping-files/2010/geo/tiger-data.html", "description": "US Census Demographic Profile 1 (DP1) County and Tract GeoDatabase.", "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127048", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15685568", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censusdp1tract.html" }, { "name": "censuspep", "title": "Population Estimates Program's (PEP) Federal Information Processing Series (FIPS) Codes", "path": "https://www.census.gov/geographies/reference-files/2023/demo/popest/2023-fips.html", "description": "Reference files for Federal Information Processing Series (FIPS) Geographic Codes. These FIPS Codes are a subset of a broader Population Estimates dataset.", "keywords": [ "census", "county", "fips", "geocodes", "geography", "state" ], "concept_doi": "https://doi.org/10.5281/zenodo.14624611", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15315316", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censuspep.html" }, { "name": "eia176", "title": "EIA Form 176 -- Annual Report of Natural and Supplemental Gas Supply and Disposition", "path": "https://www.eia.gov/naturalgas/ngqs/", "description": "The EIA Form 176, also known as the Annual Report of Natural and Supplemental Gas Supply and Disposition, describes the origins, suppliers, and disposition of natural gas on a yearly and state by state basis.", "keywords": [ "eia", "eia176", "energy information administration", "federal", "form 176", "government", "natural gas", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7682357", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.18909200", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia176.html" }, { "name": "eia191", "title": "EIA Form 191 -- Monthly Underground Natural Gas Storage Report", "path": "https://www.eia.gov/naturalgas/ngqs/", "description": "The EIA Form 191, also known as the Monthly Underground Natural Gas Storage Report, describes the working and base gas in reservoirs, injections, withdrawals, and location of reservoirs by field monthly.", "keywords": [ "eia", "eia191", "energy information administration", "federal", "form 191", "government", "natural gas", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.10607836", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.19947262", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia191.html" }, { "name": "eia757a", "title": "EIA Form 757A -- Natural Gas Processing Plant Survey", "path": "https://www.eia.gov/naturalgas/ngqs/", "description": "The EIA Form 757A, also known as the Natural Gas Processing Plant Survey Schedule A provides detailed plant-level information on the capacity, status, operations and connecting infrastructure of natural gas processing plants. The form is completed tri-annually.", "keywords": [ "eia", "eia757", "eia757a", "energy information administration", "federal", "form 757", "form 757 schedule a", "government", "natural gas", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.10607838", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.10635277" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia860m", "title": "EIA Form 860M -- Monthly Update to the Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860m", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 M data for electric power plants with 1 megawatt or greater combined nameplate capacity. Preliminary Monthly Electric Generator Inventory (based on Form EIA-860M as a supplement to Form EIA-860)", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860m", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860m", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4281336", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.20364867" }, { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" }, { "name": "eiaaeo", "title": "EIA Annual Energy Outlook (AEO)", "path": "https://www.eia.gov/outlooks/aeo/", "description": "The EIA Annual Energy Outlook provides projections of future fuel prices, energy supply and consumption, and carbon dioxide emissions by sector and region.", "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10838487", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19535635", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaaeo.html" }, { "name": "eiaapi", "title": "EIA Bulk API Data", "path": "https://www.eia.gov/opendata/bulkfiles.php", "description": "All data made available in bulk through the EIA Open Data API. At present, PUDL integrates only a few specific data series related to fuel receipts and costs figures from the Bulk Electricity API.", "keywords": [ "MW", "MWh", "annual energy outlook", "ash", "carbon dioxide", "chlorine", "co2", "distribution", "eia", "eia aeo", "eia ieo", "eia seds", "eia seo", "electric", "electricity", "emissions", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "ghg", "government", "international energy outlook", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nems", "nox", "particulate", "pm2.5", "pollution", "power", "short-term energy outlook", "so2", "sox", "state energy data system", "sulfur", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.7067366", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947272", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaapi.html" }, { "name": "eiawater", "title": "EIA Thermoelectric Cooling Water", "path": "https://www.eia.gov/electricity/data/water", "email": "infoelectric@eia.gov", "description": "Monthly cooling water usage by generator and boiler. Data collected in conjunction with the EIA-860 and EIA-923.", "keywords": [ "cooling water", "eia", "eia thermoelectric cooling water", "eia waterthermoelectric", "energy information administration", "energy water nexus", "federal", "government", "united states", "us", "usa", "water energy nexus", "water usage" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683135", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] }, { "name": "epacamd_eia", "title": "EPA CAMD to EIA Power Sector Data Crosswalk", "path": "https://github.com/USEPA/camd-eia-crosswalk", "description": "A file created collaboratively by EPA and EIA that connects EPA CAMD smokestacks (units) with corresponding EIA plant part ids reported in EIA Forms 860 and 923 (plant_id_eia, boiler_id, generator_id). This one-to-many connection is necessary because pollutants from various plant parts are collecitvely emitted and measured from one point-source.", "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "boilers", "capacity", "carbon dioxide", "cems", "chlorine", "co2", "combined_cycle", "combustion", "continuous emissions monitoring system", "crosswalk", "distribution", "eia", "electric", "electricity", "emissions", "energy", "energy information administration", "environmental protection agency", "epa", "federal", "generation", "generators", "ghg", "government", "heat rate", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "sox", "steam", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.6633769", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17582121", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/epacamd_eia.html" }, { "name": "epacems", "title": "EPA Hourly Continuous Emission Monitoring System (CEMS)", "path": "https://campd.epa.gov/", "description": "US EPA hourly Continuous Emissions Monitoring System (CEMS) data.Hourly CO2, SO2, NOx emissions and gross load.", "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "carbon dioxide", "cems", "chlorine", "co2", "continuous emissions monitoring system", "distribution", "electric", "electricity", "emissions", "energy", "environmental protection agency", "epa", "federal", "generation", "ghg", "government", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "pm2.5", "pollution", "power", "so2", "sox", "sulfur", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10233185", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.18731117", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/epacems.html" }, { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" }, { "name": "ferc2", "title": "FERC Form 2 -- Annual Report of Major Natural Gas Companies", "path": "https://www.ferc.gov/industries-data/natural-gas/industry-forms/form-2-2a-3-q-gas-historical-vfp-data", "email": "Form2@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 2 is a comprehensive financial and operating report submitted for natural gas pipelines rate regulation and financial audits.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal energy regulatory commission", "ferc", "ferc2", "finance", "form 2", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts" ], "concept_doi": "https://doi.org/10.5281/zenodo.5879542", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787348" }, { "name": "ferc6", "title": "FERC Form 6 -- Annual Report of Oil Pipeline Companies", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-66-q-overview-orders", "email": "Form6@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 6 is a comprehensive financial and operating report submitted for oil pipelines rate regulation and financial audits.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal energy regulatory commission", "ferc", "ferc6", "finance", "form 6", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts" ], "concept_doi": "https://doi.org/10.5281/zenodo.7126395", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947290" }, { "name": "ferc60", "title": "FERC Form 60 -- Annual Report of Centralized Service Companies", "path": "https://www.ferc.gov/ferc-online/ferc-online/filing-forms/service-companies-filing-forms/form-60-annual-report", "email": "Form60@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 60 is a comprehensive financial and operating report submitted for centralized service companies.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal energy regulatory commission", "ferc", "ferc60", "finance", "form 60", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts" ], "concept_doi": "https://doi.org/10.5281/zenodo.7126434", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947282" }, { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" }, { "name": "ferccid", "title": "FERC CID - Company Identifier Listing", "path": "https://data.ferc.gov/company-registration/ferc-company-identifier-listing/", "email": "CID@ferc.gov", "description": "FERC's regulations require regulated or jurisdictional entities and some non-regulated or non-jurisdictional entities to obtain Company Identifier (CID) numbers in order to make required filings with the Commission including tariff filings and various required forms. Each regulatory program requires a unique CID number. These CID numbers show up in various FERC filings, such as Forms 1, 2, 6, 60, 714, and EQR.", "keywords": [ "MW", "MWh", "cid", "company identifier", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.18176680", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.18524062" }, { "name": "ferceqr", "title": "FERC Form 920 -- Electric Quarterly Report (EQR)", "path": "https://www.ferc.gov/industries-data/electric/power-sales-and-markets/electric-quarterly-reports-eqr", "email": "eqr@ferc.gov", "description": "The Electric Quarterly Report (EQR) is submitted by sellers participating in bilateral electricity market transactions. The reports summarize the contractual terms and conditions in agreements for all jurisdictional services, including cost-based sales, market-based rate sales, and transmission service, as well as transaction information for short-term and long-term market-based power sales and cost-based power sales.", "keywords": [ "EQR", "MW", "MWh", "PPA", "ancillary services", "capacity", "contracts", "distribution", "electric", "electric quarterly report", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferceqr", "form 920", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "power purchase agreements", "power sales", "transactions", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.18251901", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.18251902", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferceqr.html" }, { "name": "gridpathratoolkit", "title": "GridPath Resource Adequacy Toolkit Data", "path": "https://gridlab.org/gridpathratoolkit/", "email": "elaine@sylvan.energy", "description": "Hourly renewable generation profiles compiled for the Western United States as part of the GridPath Resource Adequacy Toolkit. Profiles are stated as a capacity factor (a fraction of nameplate capacity). There are 3 different levels of processing or aggregation provided, all at hourly resolution: Individual plant (wind) or generator (solar) output, capacity-weighted averages of wind and solar output aggregated to the level of balancing authority territories (or transmission zones for larger balancing authorities), and that same aggregated output but with some problematic individual generator profiles modified such that they match the overall production curve of the balancing authority they are within. This data also contains some daily weather data from several sites across the western US and tables describing the way in which individual wind and solar projects were aggregated up to the level of balancing authority or transmission zone.", "keywords": [ "capacity factor", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "weather", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.10844661", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Elaine Hart", "path": "https://www.sylvan.energy/", "email": "elaine@sylvan.energy", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Sylvan Energy Analytics", "name": "elaine-hart" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.10892394", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/gridpathratoolkit.html" }, { "name": "mshamines", "title": "Mine Safety and Health Administration (MSHA) Mines", "path": "https://arlweb.msha.gov/OpenGovernmentData/OGIMSHA.asp", "description": "The Mine dataset lists all Coal and Metal/Non-Metal mines under MSHA's jurisdiction. It includes such information as the current status of each mine (Active, Abandoned, NonProducing, etc.), the current owner and operating company, commodity codes and physical attributes of the mine.", "keywords": [ "coal", "department of labor", "federal", "government", "metal", "mine safety and health administration", "mines", "mining", "msha", "mshamines", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683517", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] }, { "name": "nrelatb", "title": "NREL Annual Technology Baseline (ATB) for Electricity", "path": "https://atb.nrel.gov/", "description": "The NREL Annual Technology Baseline (ATB) for Electricity publishes annual projections of operational and capital expenditures (by technology and vintage), as well as operating characteristics (by technology).", "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10839267", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.12658647", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/nrelatb.html" }, { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" }, { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] }, { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" }, { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" }, { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" }, { "name": "vcerare", "title": "Vibrant Clean Energy Resource Adequacy Renewable Energy (RARE) Power Dataset", "path": "https://vibrantcleanenergy.com/products/datasets/", "description": "This dataset was produced by Vibrant Clean Energy and is licensed to the public under the Creative Commons Attribution 4.0 International license (CC-BY-4.0). The data consists of hourly, county-level renewable generation profiles in the continental United States and was compiled based on outputs from the NOAA HRRR weather model. Profiles are stated as a capacity factor (a percentage of nameplate capacity) and exist for onshore wind, offshore wind, and fixed-tilt solar generation types.", "keywords": [ "capacity factor", "county", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "vibrant clean energy", "weather", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.13937522", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Vibrant Clean Energy", "path": "https://vibrantcleanenergy.com/", "email": "info@vibrantcleanenergy.com", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Vibrant Clean Energy", "name": "vibrant-clean-energy" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15166129", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/vcerare.html" } ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" }, { "title": "Elaine Hart", "path": "https://www.sylvan.energy/", "email": "elaine@sylvan.energy", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Sylvan Energy Analytics", "name": "elaine-hart" }, { "title": "Vibrant Clean Energy", "path": "https://vibrantcleanenergy.com/", "email": "info@vibrantcleanenergy.com", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Vibrant Clean Energy", "name": "vibrant-clean-energy" } ], "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly", "eia923", "form 923", "monthly", "department of transportation", "gathering", "liquified natural gas", "lng", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "underground natural gas storage", "us dot", "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "finance", "form 12", "operating expenses", "opex", "plant in service", "power supply", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "usda", "form 7", "eia176", "form 176", "eia191", "form 191", "advanced metering infrastructure", "balancing authority", "business model", "customer class", "demand response", "demand side management", "eia861", "energy efficiency", "form 861", "green pricing", "net metering", "service territory", "balancing authorities", "eia930", "form 930", "grid operations", "hourly", "interchange", "net generation", "annual energy outlook", "eia aeo", "eia ieo", "eia seds", "eia seo", "energy consumption", "energy supply", "fuel projections", "international energy outlook", "nems", "short-term energy outlook", "state energy data system", "air markets program data", "ampd", "cems", "continuous emissions monitoring system", "crosswalk", "environmental protection agency", "epa", "federal energy regulatory commission", "ferc", "ferc1", "form 1", "ferc714", "form 714", "capacity factor", "gridpath", "resource adequacy", "time series", "weather", "annual technology baseline", "nrel atb", "technology", "open data", "open source", "sec", "securities and exchange commission", "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial", "county", "vibrant clean energy" ], "version": "2026.5.1.dev19", "resources": [ { "name": "_core_eia860__cooling_equipment", "type": "table", "description": "Information about cooling equipment at generation facilities.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 6D)\n\nPrimary key:\n plant_id_eia, utility_id_eia, cooling_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has not been harvested with other EIA 923 or 860 data. The same variables present in this table may show up in other _core tables in other years.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nA single plant can have\nseveral collections of cooling equipment, so each line in this table represents one\ncooling system at a given plant. You can determine how to link each set of cooling\nequipment to specific boilers in a plant via :ref:`core_eia860__assn_boiler_cooling`.\n\nEIA-860 respondents are required to submit information about cooling equipment for\nplants over 100 MW - including steam, combined cycle, nuclear or solar thermal\ngenerators.\n\nThis table has been cleaned, but not tidied/normalized with other EIA 923 or 860\ndata. The same variables present in this table may show up in other\ntables and/or in other years. Once this table has been harvested, it will be converted\ninto a``core`` table.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "_core_eia860__cooling_equipment.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "cooling_id_eia", "type": "string", "description": "EIA Identification code for cooling system (if multiple cooling systems are not distinguished by separate IDs, the word 'PLANT' is listed to encompass the cooling system for the entire plant)", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "chlorine_equipment_cost", "type": "number", "description": "Actual installed cost for the existing chlorine discharge control system or the anticipated cost to bring the chlorine discharge control system into commercial operation", "unit": "USD" }, { "name": "chlorine_equipment_operating_date", "type": "date", "description": "Actual or projected in-service date for chlorine discharge control structures and equipment" }, { "name": "cooling_equipment_total_cost", "type": "number", "description": "Actual installed cost for the existing system or the anticipated cost to bring the total system into commercial operation", "unit": "USD" }, { "name": "cooling_status_code", "type": "string", "description": "Operating status of cooling system" }, { "name": "cooling_system_operating_date", "type": "date", "description": "The actual or projected in-service datetime of this cooling system" }, { "name": "cooling_type_1", "type": "string", "description": "Type of cooling system" }, { "name": "cooling_type_2", "type": "string", "description": "Type of cooling system" }, { "name": "cooling_type_3", "type": "string", "description": "Type of cooling system" }, { "name": "cooling_type_4", "type": "string", "description": "Type of cooling system" }, { "name": "cooling_water_discharge", "type": "string", "description": "Name of river, lake, or water source that cooling water is discharged into" }, { "name": "cooling_water_source", "type": "string", "description": "Name of river, lake, or water source that provides cooling water" }, { "name": "intake_distance_shore_feet", "type": "number", "description": "Maximum distance from shore to intake", "unit": "ft" }, { "name": "intake_distance_surface_feet", "type": "number", "description": "Average distance below water surface to intake", "unit": "ft" }, { "name": "intake_rate_100pct_gallons_per_minute", "type": "number", "description": "Design cooling water flow rate at 100 percent load at in-take", "unit": "gpm" }, { "name": "outlet_distance_shore_feet", "type": "number", "description": "Maximum distance from shore to outlet", "unit": "ft" }, { "name": "outlet_distance_surface_feet", "type": "number", "description": "Average distance below water surface to outlet", "unit": "ft" }, { "name": "percent_dry_cooling", "type": "number", "description": "Percent of cooling load served by dry cooling components" }, { "name": "plant_summer_capacity_mw", "type": "number", "description": "The plant summer capacity associated with the operating generators at the plant", "unit": "MW" }, { "name": "pond_cost", "type": "number", "description": "Actual installed cost for the existing cooling ponds or the anticipated cost to bring the cooling ponds into commercial operation", "unit": "USD" }, { "name": "pond_operating_date", "type": "date", "description": "Cooling ponds actual or projected in-service date" }, { "name": "pond_surface_area_acres", "type": "number", "description": "Total surface area of cooling pond", "unit": "acre" }, { "name": "pond_volume_acre_feet", "type": "number", "description": "Total volume of water in cooling pond", "unit": "acre-feet" }, { "name": "power_requirement_mw", "type": "number", "description": "Maximum power requirement for cooling towers at 100 percent load", "unit": "MW" }, { "name": "steam_plant_type_code", "type": "integer", "description": "Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details." }, { "name": "tower_cost", "type": "number", "description": "Actual installed cost for the existing cooling towers or the anticipated cost to bring the cooling towers into commercial operation", "unit": "USD" }, { "name": "tower_operating_date", "type": "date", "description": "Cooling towers actual or projected in-service date" }, { "name": "tower_type_1", "type": "string", "description": "Types of cooling towers at this plant" }, { "name": "tower_type_2", "type": "string", "description": "Types of cooling towers at this plant" }, { "name": "tower_type_3", "type": "string", "description": "Types of cooling towers at this plant" }, { "name": "tower_type_4", "type": "string", "description": "Types of cooling towers at this plant" }, { "name": "tower_water_rate_100pct_gallons_per_minute", "type": "number", "description": "Maximum design rate of water flow at 100 percent load for the cooling towers", "unit": "gpm" }, { "name": "water_source_code", "type": "string", "description": "Type of cooling water source" }, { "name": "water_source", "type": "string", "description": "Name of water source associated with the plant." }, { "name": "water_type_code", "type": "string", "description": "Type of cooling water" } ], "primaryKey": [ "plant_id_eia", "utility_id_eia", "cooling_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "steam_plant_type_code" ], "reference": { "resource": "core_eia__codes_steam_plant_types", "fields": [ "code" ] } }, { "fields": [ "cooling_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "tower_type_1" ], "reference": { "resource": "core_eia__codes_cooling_tower_types", "fields": [ "code" ] } }, { "fields": [ "tower_type_2" ], "reference": { "resource": "core_eia__codes_cooling_tower_types", "fields": [ "code" ] } }, { "fields": [ "tower_type_3" ], "reference": { "resource": "core_eia__codes_cooling_tower_types", "fields": [ "code" ] } }, { "fields": [ "tower_type_4" ], "reference": { "resource": "core_eia__codes_cooling_tower_types", "fields": [ "code" ] } }, { "fields": [ "water_type_code" ], "reference": { "resource": "core_eia__codes_cooling_water_types", "fields": [ "code" ] } }, { "fields": [ "cooling_type_1" ], "reference": { "resource": "core_eia__codes_cooling_system_types", "fields": [ "code" ] } }, { "fields": [ "cooling_type_2" ], "reference": { "resource": "core_eia__codes_cooling_system_types", "fields": [ "code" ] } }, { "fields": [ "cooling_type_3" ], "reference": { "resource": "core_eia__codes_cooling_system_types", "fields": [ "code" ] } }, { "fields": [ "cooling_type_4" ], "reference": { "resource": "core_eia__codes_cooling_system_types", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 630720, "hash": "sha256:4db70253ed1cc9194297f6e1cceaff93c7a54b92c5a6617a19d7101cd75a1cbd" }, { "name": "_core_eia860__fgd_equipment", "type": "table", "description": "Information about flue gas desulfurization equipment at generation facilities.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 6E)\n\nPrimary key:\n plant_id_eia, so2_control_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has not been harvested with other EIA 923 or 860 data. The same variables present in this table may show up in other _core tables in other years.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "_core_eia860__fgd_equipment.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "so2_control_id_eia", "type": "string", "description": "Sulfur dioxide control identification number. This ID is not a unique identifier.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "pattern": "^\\d{2}$" } }, { "name": "county", "type": "string", "description": "County name." }, { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "fgd_operating_date", "type": "date", "description": "The actual or projected in-service datetime of this flue gas desulfurization system" }, { "name": "fgd_operational_status_code", "type": "string", "description": "Operating status code for flue gas desulfurization equipment." }, { "name": "flue_gas_bypass_fgd", "type": "boolean", "description": "Indicates whether flue gas can bypass the flue gas desulfurization unit." }, { "name": "byproduct_recovery", "type": "boolean", "description": "Is saleable byproduct recovered by the unit?" }, { "name": "sludge_pond", "type": "boolean", "description": "Indicates if there is a sludge pond associated with this unit." }, { "name": "sludge_pond_lined", "type": "boolean", "description": "Indicates whether the sludge pond is lined." }, { "name": "pond_landfill_requirements_acre_foot_per_year", "type": "number", "description": "Annual pond and land fill requirements for flue gas desulfurization equipment.", "unit": "acre_foot_per_year" }, { "name": "fgd_structure_cost", "type": "number", "description": "Actual installed costs for the existing systems or the anticipated costs of structures and equipment to bring a planned flue gas desulfurization system into commercial operation.", "unit": "USD" }, { "name": "fgd_other_cost", "type": "number", "description": "Other actual installed costs for installation of a flue gas desulfurization unit or the anticipated other costs pertaining to the installation of a flue gas desulfurization unit.", "unit": "USD" }, { "name": "sludge_disposal_cost", "type": "number", "description": "Actual installed costs for the existing sludge transport and disposal systems or the anticipated costs of sludge transport and disposal systems to bring a planned system into commercial operation.", "unit": "USD" }, { "name": "total_fgd_equipment_cost", "type": "number", "description": "Total actual installed costs for the existing flue gas desulfurization unit or the anticipated costs to bring a planned flue gas desulfurization unit into commercial operation." }, { "name": "fgd_trains_100pct", "type": "number", "description": "Total number of flue gas desulfurization unit scrubber trains operated at 100 percent load." }, { "name": "fgd_trains_total", "type": "number", "description": "Total number of flue gas desulfurization unit scrubber trains." }, { "name": "flue_gas_entering_fgd_pct_of_total", "type": "number", "description": "Ratio of all flue gas that is entering the flue gas desulfurization unit." }, { "name": "flue_gas_exit_rate_cubic_feet_per_minute", "type": "number", "description": "Actual flue gas exit rate, in cubic feet per minute.", "unit": "cfm" }, { "name": "flue_gas_exit_temperature_fahrenheit", "type": "number", "description": "Flue gas exit temperature, in degrees Fahrenheit.", "unit": "F" }, { "name": "so2_emission_rate_lbs_per_hour", "type": "number", "description": "Sulfur dioxide emission rate when operating at 100 percent load (pounds per hour).", "unit": "lb_per_hour" }, { "name": "so2_equipment_type_1", "type": "string", "description": "Type of sulfur dioxide control equipment." }, { "name": "so2_equipment_type_2", "type": "string", "description": "Type of sulfur dioxide control equipment." }, { "name": "so2_equipment_type_3", "type": "string", "description": "Type of sulfur dioxide control equipment." }, { "name": "so2_equipment_type_4", "type": "string", "description": "Type of sulfur dioxide control equipment." }, { "name": "so2_removal_efficiency_design", "type": "number", "description": "Designed removal efficiency for sulfur dioxide when operating at 100 percent load. Reported at the nearest 0.1 percent by weight of gases removed from the flue gas." }, { "name": "specifications_of_coal_ash", "type": "number", "description": "Design fuel specifications for ash when burning coal or petroleum coke (nearest 0.1 percent by weight)." }, { "name": "specifications_of_coal_sulfur", "type": "number", "description": "Design fuel specifications for sulfur when burning coal or petroleum coke (nearest 0.1 percent by weight)." }, { "name": "sorbent_type_1", "type": "string", "description": "Type of sorbent used by this sulfur dioxide control equipment." }, { "name": "sorbent_type_2", "type": "string", "description": "Type of sorbent used by this sulfur dioxide control equipment." }, { "name": "sorbent_type_3", "type": "string", "description": "Type of sorbent used by this sulfur dioxide control equipment." }, { "name": "sorbent_type_4", "type": "string", "description": "Type of sorbent used by this sulfur dioxide control equipment." }, { "name": "fgd_manufacturer", "type": "string", "description": "Name of flue gas desulfurization equipment manufacturer." }, { "name": "fgd_manufacturer_code", "type": "string", "description": "Code corresponding to name of flue gas desulfurization equipment manufacturer." }, { "name": "steam_plant_type_code", "type": "integer", "description": "Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details." }, { "name": "plant_summer_capacity_mw", "type": "number", "description": "The plant summer capacity associated with the operating generators at the plant", "unit": "MW" }, { "name": "water_source", "type": "string", "description": "Name of water source associated with the plant." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "so2_control_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "sorbent_type_1" ], "reference": { "resource": "core_eia__codes_sorbent_types", "fields": [ "code" ] } }, { "fields": [ "sorbent_type_2" ], "reference": { "resource": "core_eia__codes_sorbent_types", "fields": [ "code" ] } }, { "fields": [ "sorbent_type_3" ], "reference": { "resource": "core_eia__codes_sorbent_types", "fields": [ "code" ] } }, { "fields": [ "sorbent_type_4" ], "reference": { "resource": "core_eia__codes_sorbent_types", "fields": [ "code" ] } }, { "fields": [ "fgd_manufacturer_code" ], "reference": { "resource": "core_eia__codes_environmental_equipment_manufacturers", "fields": [ "code" ] } }, { "fields": [ "so2_equipment_type_1" ], "reference": { "resource": "core_eia__codes_emission_control_equipment_types", "fields": [ "code" ] } }, { "fields": [ "so2_equipment_type_2" ], "reference": { "resource": "core_eia__codes_emission_control_equipment_types", "fields": [ "code" ] } }, { "fields": [ "so2_equipment_type_3" ], "reference": { "resource": "core_eia__codes_emission_control_equipment_types", "fields": [ "code" ] } }, { "fields": [ "so2_equipment_type_4" ], "reference": { "resource": "core_eia__codes_emission_control_equipment_types", "fields": [ "code" ] } }, { "fields": [ "steam_plant_type_code" ], "reference": { "resource": "core_eia__codes_steam_plant_types", "fields": [ "code" ] } }, { "fields": [ "fgd_operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 248311, "hash": "sha256:f19f9728c3ec3d9184338e5a0d6d962e2f497e453564cacb57d8c722cb10e3aa" }, { "name": "_core_eia923__monthly_cooling_system_information", "type": "table", "description": "Monthly time series of cooling system information at generation facilities - mainly water volumes and temperatures.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 8D)\n\nPrimary key:\n plant_id_eia, report_date, cooling_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some years use a slightly different data definition.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIn 2008 and 2009, EIA only reports annual averages, but in later years all data is monthly.\n\nNote: This table has been cleaned, but not harvested with other EIA 923 or 860\ndata. The same variables present in this table may show up in other _core\ntables in other years. Once this table has been harvested, it will be removed\nfrom the PUDL database.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia923__monthly_cooling_system_information.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "cooling_id_eia", "type": "string", "description": "EIA Identification code for cooling system (if multiple cooling systems are not distinguished by separate IDs, the word 'PLANT' is listed to encompass the cooling system for the entire plant)", "constraints": { "required": true } }, { "name": "cooling_status_code", "type": "string", "description": "Operating status of cooling system" }, { "name": "cooling_type", "type": "string", "description": "Type of cooling system" }, { "name": "monthly_total_cooling_hours_in_service", "type": "integer", "description": "Total hours the system operated during the month", "unit": "hr" }, { "name": "flow_rate_method", "type": "string", "description": "Calculation method for flow rates (actual or method of estimation)" }, { "name": "temperature_method", "type": "string", "description": "Method for measurement of temperatures" }, { "name": "annual_maximum_intake_summer_temperature_fahrenheit", "type": "number", "description": "Maximum cooling water temperature at intake during the summer", "unit": "F" }, { "name": "annual_maximum_intake_winter_temperature_fahrenheit", "type": "number", "description": "Maximum cooling water temperature at intake in winter", "unit": "F" }, { "name": "monthly_average_intake_temperature_fahrenheit", "type": "number", "description": "Average cooling water temperature at intake point", "unit": "F" }, { "name": "monthly_maximum_intake_temperature_fahrenheit", "type": "number", "description": "Maximum cooling water temperature at intake", "unit": "F" }, { "name": "annual_maximum_outlet_summer_temperature_fahrenheit", "type": "number", "description": "Maximum cooling water temperature at outlet in summer", "unit": "F" }, { "name": "annual_maximum_outlet_winter_temperature_fahrenheit", "type": "number", "description": "Maximum cooling water temperature at outlet in winter", "unit": "F" }, { "name": "monthly_average_discharge_temperature_fahrenheit", "type": "number", "description": "Average cooling water temperature at discharge point", "unit": "F" }, { "name": "monthly_maximum_discharge_temperature_fahrenheit", "type": "number", "description": "Maximum cooling water temperature at discharge", "unit": "F" }, { "name": "annual_average_consumption_rate_gallons_per_minute", "type": "number", "description": "Annual average consumption rate of cooling water", "unit": "gpm" }, { "name": "monthly_average_consumption_rate_gallons_per_minute", "type": "number", "description": "Monthly average consumption rate of cooling water", "unit": "gpm" }, { "name": "monthly_total_consumption_volume_gallons", "type": "number", "description": "Monthly volume of water consumed at consumption point (accurate to 0.1 million gal)", "unit": "gal" }, { "name": "annual_average_discharge_rate_gallons_per_minute", "type": "number", "description": "Annual average discharge rate of cooling water", "unit": "gpm" }, { "name": "monthly_average_discharge_rate_gallons_per_minute", "type": "number", "description": "Monthly average discharge rate of cooling water", "unit": "gpm" }, { "name": "monthly_total_discharge_volume_gallons", "type": "number", "description": "Monthly volume of water discharged at discharge point (accurate to 0.1 million gal)", "unit": "gal" }, { "name": "monthly_average_diversion_rate_gallons_per_minute", "type": "number", "description": "Monthly average diversion rate of cooling water", "unit": "gpm" }, { "name": "monthly_total_diversion_volume_gallons", "type": "number", "description": "Monthly volume of water diverted at diversion point (accurate to 0.1 million gal)", "unit": "gal" }, { "name": "annual_average_withdrawal_rate_gallons_per_minute", "type": "number", "description": "Annual average withdrawal rate of cooling water", "unit": "gpm" }, { "name": "monthly_average_withdrawal_rate_gallons_per_minute", "type": "number", "description": "Monthly average withdrawal rate of cooling water", "unit": "gpm" }, { "name": "monthly_total_withdrawal_volume_gallons", "type": "number", "description": "Monthly volume of water withdrawn at withdrawal point (accurate to 0.1 million gal)", "unit": "gal" }, { "name": "annual_total_chlorine_lbs", "type": "number", "description": "Amount of elemental chlorine added to cooling water annually. May be just the amount of chlorine-containing compound if schedule 9 is filled out.", "unit": "lb" }, { "name": "monthly_total_chlorine_lbs", "type": "number", "description": "Amount of elemental chlorine added to cooling water monthly. May be just the amount of chlorine-containing compound if schedule 9 is filled out.", "unit": "lb" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "cooling_id_eia" ], "foreignKeys": [ { "fields": [ "cooling_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "cooling_type" ], "reference": { "resource": "core_eia__codes_cooling_system_types", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5102232, "hash": "sha256:b9708ba6e6d0427f46e2c67c785f9b20d6e6f59adf260adf371745ce263e84ad" }, { "name": "_core_eia923__yearly_byproduct_disposition", "type": "table", "description": "Annual time series of by-products reported by thermoelectric power plants with total steam turbine capacity of 100 megawatts or greater.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 8A)\n\nPrimary key:\n plant_id_eia, report_date, byproduct_description\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is experimental and/or a work in progress and may change in the future.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAll by-products other than steam sales are reported in thousand tons and are rounded to whole numbers. Steam sales are reported in MMBTu.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia923__yearly_byproduct_disposition.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "byproduct_description", "type": "string", "description": "Description of combustion by-product.", "constraints": { "required": true, "enum": [ "Ash from coal gasification (IGCC) units", "Bottom ash from standard boiler units", "Bottom (bed) ash from FBC units", "FGD Gypsum", "Fly ash from FBC units", "Fly ash from standard boiler/PCD units", "Fly ash from units with dry FGD", "Other FGD byproducts", "Other (specify via footnote on Schedule 9)", "Steam Sales (MMBtu)" ] } }, { "name": "byproduct_units", "type": "string", "description": "Reported unit of measure for combustion byproduct. MMBTU for steam, tons for all other byproducts.", "constraints": { "enum": [ "mmbtu", "tons" ] } }, { "name": "disposal_landfill_units", "type": "number", "description": "Disposed by-products in landfill, to the nearest hundred tons or in MMBTU for steam sales." }, { "name": "disposal_offsite_units", "type": "number", "description": "Disposed by-products offsite, to the nearest hundred tons or in MMBTU for steam sales." }, { "name": "disposal_ponds_units", "type": "number", "description": "Disposed by-products in ponds, to the nearest hundred tons or in MMBTU for steam sales." }, { "name": "sold_units", "type": "number", "description": "Sold by-products, in tons (to the nearest 100 tons) or, for Steam, MMBTU." }, { "name": "stored_offsite_units", "type": "number", "description": "Stored by-products offsite, to the nearest hundred tons or in MMBTU for steam sales.", "unit": "tons or MMBTU" }, { "name": "stored_onsite_units", "type": "number", "description": "Stored by-products onsite, to the nearest hundred tons or in MMBTU for steam sales.", "unit": "tons or MMBTU" }, { "name": "used_offsite_units", "type": "number", "description": "Used offsite by-products, to the nearest hundred tons or in MMBTU for steam sales.", "unit": "tons or MMBTU" }, { "name": "used_onsite_units", "type": "number", "description": "Used onsite by-products, to the nearest hundred tons or in MMBTU for steam sales.", "unit": "tons or MMBTU" }, { "name": "total_disposal_units", "type": "number", "description": "Total by-product disposal, to the nearest hundred tons or in MMBTU for steam sales.", "unit": "tons or MMBTU" }, { "name": "no_byproducts_to_report", "type": "string", "description": "Whether any combustion by-products were produced by a plant. 'Y' indicates no byproducts to report. The 'Y' and 'N' values do not align with expected values of reported byproducts. This column is messy and requires standardization." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "byproduct_description" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 237143, "hash": "sha256:03ac82624a819dca92fb1898b3cd666f4e367a550f757278c1852027ca5d682b" }, { "name": "_core_eia923__yearly_byproduct_expenses_and_revenues", "type": "table", "description": "Annual time series of financial information related to combustion by-products reported by thermoelectric power plants with total steam turbine capacity of 100 megawatts or greater and that produced combustion by-products during the reporting year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 8B)\n\nPrimary key:\n plant_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is experimental and/or a work in progress and may change in the future.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nCost data must be entered for all entries on Schedule 8A. Financial information includes operational and maintenance expenditures (opex), capital expenditures (capex), and by-products sales revenue.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia923__yearly_byproduct_expenses_and_revenues.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "capex_air_abatement", "type": "number", "description": "Cost of new structures and/or equipment purchased to reduce, monitor, or eliminate airborne pollutants.", "unit": "USD" }, { "name": "capex_other_abatement", "type": "number", "description": "Other amortizable expenses and purchases of new structures and or equipment when such purchases are not allocated to a particular unit or item.", "unit": "USD" }, { "name": "capex_solid_waste", "type": "number", "description": "Cost of structures or equipment purchased to collect and dispose of objectionable solids or contained liquids.", "unit": "USD" }, { "name": "capex_water_abatement", "type": "number", "description": "Cost of new structures and/or equipment purchased to reduce, monitor, or eliminate waterborne pollutants, including chlorine, phosphates, acids, bases, hydrocarbons, sewage, and other pollutants.", "unit": "USD" }, { "name": "opex_bottom_ash_collection", "type": "number", "description": "Costs of materials and labor associated with the collection of bottom ash from all sources.", "unit": "USD" }, { "name": "opex_bottom_ash_disposal", "type": "number", "description": "Costs of materials and labor associated with the disposal of bottom ash from all sources.", "unit": "USD" }, { "name": "opex_bottom_ash_other", "type": "number", "description": "Other costs associated with the collection and disposal of bottom ash.", "unit": "USD" }, { "name": "opex_fgd_byproduct_collection", "type": "number", "description": "Costs of materials and labor associated with the collection of sulfur by-product (flue gas desulfurization).", "unit": "USD" }, { "name": "opex_fgd_byproduct_disposal", "type": "number", "description": "Costs of materials and labor associated with the disposal of sulfur by-product (flue gas desulfurization).", "unit": "USD" }, { "name": "opex_fgd_byproduct_other", "type": "number", "description": "Other costs associated with the collection and disposal of sulfur by-product (flue gas desulfurization).", "unit": "USD" }, { "name": "opex_fly_ash_collection", "type": "number", "description": "Costs of materials and labor associated with the collection of fly ash from all sources.", "unit": "USD" }, { "name": "opex_fly_ash_disposal", "type": "number", "description": "Costs of materials and labor associated with the disposal of fly ash from all sources.", "unit": "USD" }, { "name": "opex_fly_ash_other", "type": "number", "description": "Other costs associated with the collection and disposal of fly ash.", "unit": "USD" }, { "name": "opex_other_abatement_collection", "type": "number", "description": "Abatement costs of by-product collection that are not allocated to a particular expenditure, e.g., costs of operating an environmental protection office.", "unit": "USD" }, { "name": "opex_other_abatement_disposal", "type": "number", "description": "Abatement costs of by-product disposal that are not allocated to a particular expenditure.", "unit": "USD" }, { "name": "opex_other_abatement_other", "type": "number", "description": "Other abatement costs that are not allocated to a particular expenditure.", "unit": "USD" }, { "name": "opex_total_collection_abatement", "type": "number", "description": "Sum of abatement costs associated with by-product collection.", "unit": "USD" }, { "name": "opex_total_disposal_abatement", "type": "number", "description": "Sum of abatement costs associated with by-product disposal.", "unit": "USD" }, { "name": "opex_total_other_abatement", "type": "number", "description": "Sum of other abatement costs associated with the collection and disposal of byproducts.", "unit": "USD" }, { "name": "opex_water_abatement_collection", "type": "number", "description": "Costs associated with the collection/abatement of water pollution, e.g., equipment operation and maintenance of pumps, pipes, and settling ponds.", "unit": "USD" }, { "name": "opex_water_abatement_disposal", "type": "number", "description": "Costs associated with the disposal of water pollutants.", "unit": "USD" }, { "name": "opex_water_abatement_other", "type": "number", "description": "Other abatement costs associated with water pollutants.", "unit": "USD" }, { "name": "revenues_bottom_ash", "type": "number", "description": "Revenue from the sale of bottom ash by-product.", "unit": "USD" }, { "name": "revenues_fgd_byproducts", "type": "number", "description": "Revenue from the sale of flue gas desulfurization by-product.", "unit": "USD" }, { "name": "revenues_fly_ash", "type": "number", "description": "Revenue from the sale of fly ash by-product.", "unit": "USD" }, { "name": "revenues_fly_bottom_ash_intermingled", "type": "number", "description": "Revenue from the sale of intermingled fly and bottom ash by-product.", "unit": "USD" }, { "name": "revenues_other_byproducts", "type": "number", "description": "Revenue from the sale of other by-products.", "unit": "USD" }, { "name": "revenues_total_byproduct", "type": "number", "description": "Total revenue from the sale of by-products.", "unit": "USD" } ], "primaryKey": [ "plant_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 354971, "hash": "sha256:96e76c0bd958f170ca444fff861c296263b31d138e8d9b52fe9f8c2b02287043" }, { "name": "_core_eia923__yearly_emissions_control", "type": "table", "description": "Annual time series of Actual rate and removal efficiency for air emissions reported by thermoelectric or combined-cycle power plants with a total steam turbine capacity greater than or equal to 10 megawatts.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 8C)\n\nPrimary key:\n This table has no primary key. This table is not yet normalized, and contains information about several different types of emissions control equipment, each of which has its own ID, and not all of which are present at every plant. As a result there is currently no unique, non-null primary key. Conceptually, the primary key should consist of plant_id_eia, report_date, mercury_control_id_eia, nox_control_id_eia, so2_control_id_eia, and particulate_control_id_eia. In practice many records have NULL values for all of the control equipment IDs.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is experimental and/or a work in progress and may change in the future.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIn the raw data, the so2_test_date and particulate_test_date columns contained a wide variety of non-standard date formats. They have been standardized to ISO-8601 (YYYY-MM-DD) where possible. Missing days and months have been filled in with 01. A handful of manual spot-fixes have been applied to particularly strange formats. Two-digit years have been assumed to fall between 1950 and the last year observed in the report_date column.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia923__yearly_emissions_control.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "acid_gas_removal_efficiency", "type": "number", "description": "Removal efficiency for acid gas emissions. Ranges from 0 to 1." }, { "name": "annual_nox_emission_rate_lb_per_mmbtu", "type": "number", "description": "Actual controlled (or uncontrolled) nitrogen oxides emission rate. Based on data from CEMS where possible.", "unit": "lb_per_MMBTU" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "environmental_equipment_name", "type": "string", "description": "Type of equipment or strategy for the control of air emissions." }, { "name": "fgd_electricity_consumption_mwh", "type": "number", "description": "Electric power consumed by the flue gas desulfurization unit (in MWh).", "unit": "MWh" }, { "name": "fgd_sorbent_consumption_tons", "type": "number", "description": "Quantity of flue gas desulfurization sorbent used, to the nearest 100 ton.", "unit": "tons" }, { "name": "hours_in_service", "type": "integer", "description": "Total hours the emissions control was in service during the reporting year, rounded to the nearest hour.", "unit": "hr" }, { "name": "mercury_control_id_eia", "type": "string", "description": "Mercury control identification number. This ID is not a unique identifier." }, { "name": "mercury_emission_rate_lb_per_trillion_btu", "type": "number", "description": "Actual controlled (or uncontrolled) mercury emission rate, based on data from CEMS, where possible." }, { "name": "mercury_removal_efficiency", "type": "number", "description": "Removal efficiency for mercury emissions. Ranges from 0 to 1." }, { "name": "nox_control_id_eia", "type": "string", "description": "Nitrogen oxide control identification number. This ID is not a unique identifier." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "ozone_season_nox_emission_rate_lb_per_mmbtu", "type": "number", "description": "Actual controlled (or uncontrolled) nitrogen oxides emission rate during the ozone season (May to September)", "unit": "lb_per_MMBTU" }, { "name": "particulate_control_id_eia", "type": "string", "description": "Particulate matter control identification number. This ID is not a unique identifier." }, { "name": "particulate_emission_rate_lb_per_mmbtu", "type": "number", "description": "Average annual emission removal rate for particulate matter.", "unit": "lb_per_MMBTU" }, { "name": "particulate_removal_efficiency_tested", "type": "number", "description": "The tested efficiency for the removal of particulate matter at 100 percent load. If not tested at 100 percent load, then the load at which the test was conducted is included as a comment on Schedule 9. If no test was conducted, the test date and tested efficiency field should be blank. Ranges from 0 to 1." }, { "name": "particulate_removal_efficiency_annual", "type": "number", "description": "Particulate removal efficiency, based on the annual operating factor, which is defined as annual fuel consumption (MMBTU) divided by the product of the boiler design firing rate (MMBTU per hour) and hours of operation per year.When actual data are not available, estimates are provided based on equipment design performance specifications. Ranges from 0 to 1." }, { "name": "particulate_test_date", "type": "date", "description": "Date of the latest efficiency test for the removal of particulate matter." }, { "name": "so2_control_id_eia", "type": "string", "description": "Sulfur dioxide control identification number. This ID is not a unique identifier." }, { "name": "so2_removal_efficiency_tested", "type": "number", "description": "The tested efficiency for the removal of sulfur dioxide at 100 percent load. If not tested at 100 percent load, then the load at which the test was conducted is included as a comment on Schedule 9. If no test was conducted, the test date and tested efficiency field should be blank. Ranges from 0 to 1." }, { "name": "so2_removal_efficiency_annual", "type": "number", "description": "Sulfur dioxide removal efficiency, based on the annual operating factor, which is defined as annual fuel consumption (MMBTU) divided by the product of the boiler design firing rate (MMBTU per hour) and hours of operation per year.When actual data are not available, estimates are provided based on equipment design performance specifications. Ranges from 0 to 1." }, { "name": "so2_test_date", "type": "date", "description": "Date of most recent test for sulfur dioxide removal efficiency." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 920930, "hash": "sha256:6cc6977743788b828d20a0d4bfdcae6270598dbce3308a0b85591c4179cd5520" }, { "name": "_core_eia923__yearly_fgd_operation_maintenance", "type": "table", "description": "Annual time series of flue gas desulfurization (FGD) operation and maintenance expenses at generation facilities.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 8C)\n\nPrimary key:\n plant_id_eia, report_date, so2_control_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some years use a slightly different data definition.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nFrom 2008-2011 this table also reported operational\ncharacteristics that are now reported in 923 Air Emissions Control Info.\n\nNote: This table has been cleaned, but not harvested with other EIA 923 or 860 data.\nThe same variables present in this table may show up in other _core tables in other\nyears. Once this table has been harvested, it will be removed from the PUDL database.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia923__yearly_fgd_operation_maintenance.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "so2_control_id_eia", "type": "string", "description": "Sulfur dioxide control identification number. This ID is not a unique identifier.", "constraints": { "required": true } }, { "name": "opex_fgd_feed_materials_chemical", "type": "integer", "description": "Annual operation and maintenance expenditures for feed materials and chemicals for flue gas desulfurization equipment, excluding electricity.", "unit": "USD" }, { "name": "opex_fgd_labor_supervision", "type": "integer", "description": "Annual operation and maintenance expenditures for labor and supervision of flue gas desulfurization equipment, excluding electricity.", "unit": "USD" }, { "name": "opex_fgd_land_acquisition", "type": "integer", "description": "Annual operation and maintenance expenditures for land acquisition for flue gas desulfurization equipment, excluding electricity.", "unit": "USD" }, { "name": "opex_fgd_maintenance_material_other", "type": "integer", "description": "Annual operation and maintenance expenditures for maintenance, materials and all other costs of flue gas desulfurization equipment, excluding electricity", "unit": "USD" }, { "name": "opex_fgd_waste_disposal", "type": "integer", "description": "Annual operation and maintenance expenditures for waste disposal, excluding electricity.", "unit": "USD" }, { "name": "opex_fgd_total_cost", "type": "integer", "description": "Annual total cost of operation and maintenance expenditures on flue gas desulfurization equipment, excluding electricity", "unit": "USD" }, { "name": "fgd_control_flag", "type": "boolean", "description": "Indicates whether or not a plant has a flue gas desulfurization control unit." }, { "name": "fgd_operational_status_code", "type": "string", "description": "Operating status code for flue gas desulfurization equipment." }, { "name": "fgd_hours_in_service", "type": "integer", "description": "Number of hours the flue gas desulfurization equipment was in operation during the year.", "unit": "hours" }, { "name": "fgd_electricity_consumption_mwh", "type": "number", "description": "Electric power consumed by the flue gas desulfurization unit (in MWh).", "unit": "MWh" }, { "name": "fgd_sorbent_consumption_tons", "type": "number", "description": "Quantity of flue gas desulfurization sorbent used, to the nearest 100 ton.", "unit": "tons" }, { "name": "so2_removal_efficiency_tested", "type": "number", "description": "The tested efficiency for the removal of sulfur dioxide at 100 percent load. If not tested at 100 percent load, then the load at which the test was conducted is included as a comment on Schedule 9. If no test was conducted, the test date and tested efficiency field should be blank. Ranges from 0 to 1." }, { "name": "so2_removal_efficiency_annual", "type": "number", "description": "Sulfur dioxide removal efficiency, based on the annual operating factor, which is defined as annual fuel consumption (MMBTU) divided by the product of the boiler design firing rate (MMBTU per hour) and hours of operation per year.When actual data are not available, estimates are provided based on equipment design performance specifications. Ranges from 0 to 1." }, { "name": "so2_test_date", "type": "date", "description": "Date of most recent test for sulfur dioxide removal efficiency." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "so2_control_id_eia" ], "foreignKeys": [ { "fields": [ "fgd_operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 213741, "hash": "sha256:0c40efdeb20d7eaa90c0dc5eb2402856794de3034f3eae9db0eea7fc9aeea90c" }, { "name": "_core_eia__forensics_entity_resolution_boilers", "type": "table", "description": "Forensic table of the statistics determining how we choose a single consistent value during entity resolution for boilers.\n\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is meant for forensic purposes only. It contains all values which were used to choose canonical or golden-record. See `Entity Resolution Methodology `_ for a fuller conceptual overview.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is a forensic table containing the input values used to\nchoose canonical values during entity resolution. It is not a cleaned up table - it\nis meant for forensic purposes only. If you have a question about why a value is\nreported in an ``scd``, ``entity`` or ``out`` table, you can find out all of the inputs\nthat were used as ingredients to find the canonical value. You can filter by the\ncolumn_name and the entity id to find all of the possible input values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia__forensics_entity_resolution_boilers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "column_name", "type": "string", "description": "The name of the column." }, { "name": "record_value", "type": "string", "description": "The original values found in PUDL _core table records that were used as ingredients to the entity resolution process." }, { "name": "entity_occurrences", "type": "integer", "description": "The number of times this entity - aka this particular utility, plant, etc - occurs across the pre-entity resolution tables." }, { "name": "record_occurrences", "type": "integer", "description": "The number of times this particular ``record_value`` occurs across the pre-entity resolution tables in association with this particular entity." }, { "name": "consistent_rate", "type": "number", "description": "What portion of the entity's records were reported with this particular ``record_value``. This is calculated by dividing the ``record_occurrences`` by the ``entity_occurrences``." }, { "name": "is_candidate", "type": "boolean", "description": "Is this record a candidate for being the canonical value? This is based on ``consistent_rate``. By default PUDL requires values to be at least 70 percent consistent to pass this consistency check. There are exceptions to the default 70 percent consistency check for columns like plant or utility names when we always want a value - for those instances we choose the most frequently occurring value regardless of how consistently it was reported." } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 847665, "hash": "sha256:a4ae7a26373a8f339c71361e7d732b77334ea5a0ed73218be7ed02d5c7a3eaa6" }, { "name": "_core_eia__forensics_entity_resolution_generators", "type": "table", "description": "Forensic table of the statistics determining how we choose a single consistent value during entity resolution for generators.\n\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is meant for forensic purposes only. It contains all values which were used to choose canonical or golden-record. See `Entity Resolution Methodology `_ for a fuller conceptual overview.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is a forensic table containing the input values used to\nchoose canonical values during entity resolution. It is not a cleaned up table - it\nis meant for forensic purposes only. If you have a question about why a value is\nreported in an ``scd``, ``entity`` or ``out`` table, you can find out all of the inputs\nthat were used as ingredients to find the canonical value. You can filter by the\ncolumn_name and the entity id to find all of the possible input values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia__forensics_entity_resolution_generators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "column_name", "type": "string", "description": "The name of the column." }, { "name": "record_value", "type": "string", "description": "The original values found in PUDL _core table records that were used as ingredients to the entity resolution process." }, { "name": "entity_occurrences", "type": "integer", "description": "The number of times this entity - aka this particular utility, plant, etc - occurs across the pre-entity resolution tables." }, { "name": "record_occurrences", "type": "integer", "description": "The number of times this particular ``record_value`` occurs across the pre-entity resolution tables in association with this particular entity." }, { "name": "consistent_rate", "type": "number", "description": "What portion of the entity's records were reported with this particular ``record_value``. This is calculated by dividing the ``record_occurrences`` by the ``entity_occurrences``." }, { "name": "is_candidate", "type": "boolean", "description": "Is this record a candidate for being the canonical value? This is based on ``consistent_rate``. By default PUDL requires values to be at least 70 percent consistent to pass this consistency check. There are exceptions to the default 70 percent consistency check for columns like plant or utility names when we always want a value - for those instances we choose the most frequently occurring value regardless of how consistently it was reported." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5589843, "hash": "sha256:601f88f4a60835f07b3d2ec3c0b771ac14baede55a7c5959980d590470a9b633" }, { "name": "_core_eia__forensics_entity_resolution_plants", "type": "table", "description": "Forensic table of the statistics determining how we choose a single consistent value during entity resolution for plants.\n\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is meant for forensic purposes only. It contains all values which were used to choose canonical or golden-record. See `Entity Resolution Methodology `_ for a fuller conceptual overview.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is a forensic table containing the input values used to\nchoose canonical values during entity resolution. It is not a cleaned up table - it\nis meant for forensic purposes only. If you have a question about why a value is\nreported in an ``scd``, ``entity`` or ``out`` table, you can find out all of the inputs\nthat were used as ingredients to find the canonical value. You can filter by the\ncolumn_name and the entity id to find all of the possible input values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia__forensics_entity_resolution_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "column_name", "type": "string", "description": "The name of the column." }, { "name": "record_value", "type": "string", "description": "The original values found in PUDL _core table records that were used as ingredients to the entity resolution process." }, { "name": "entity_occurrences", "type": "integer", "description": "The number of times this entity - aka this particular utility, plant, etc - occurs across the pre-entity resolution tables." }, { "name": "record_occurrences", "type": "integer", "description": "The number of times this particular ``record_value`` occurs across the pre-entity resolution tables in association with this particular entity." }, { "name": "consistent_rate", "type": "number", "description": "What portion of the entity's records were reported with this particular ``record_value``. This is calculated by dividing the ``record_occurrences`` by the ``entity_occurrences``." }, { "name": "is_candidate", "type": "boolean", "description": "Is this record a candidate for being the canonical value? This is based on ``consistent_rate``. By default PUDL requires values to be at least 70 percent consistent to pass this consistency check. There are exceptions to the default 70 percent consistency check for columns like plant or utility names when we always want a value - for those instances we choose the most frequently occurring value regardless of how consistently it was reported." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7797525, "hash": "sha256:b113e1d5ee2243f3cc9caa04624ff06e15c61dcbe9dfcc9d2118574c6ae18c6b" }, { "name": "_core_eia__forensics_entity_resolution_utilities", "type": "table", "description": "Forensic table of the statistics determining how we choose a single consistent value during entity resolution for utilities.\n\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is meant for forensic purposes only. It contains all values which were used to choose canonical or golden-record. See `Entity Resolution Methodology `_ for a fuller conceptual overview.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is a forensic table containing the input values used to\nchoose canonical values during entity resolution. It is not a cleaned up table - it\nis meant for forensic purposes only. If you have a question about why a value is\nreported in an ``scd``, ``entity`` or ``out`` table, you can find out all of the inputs\nthat were used as ingredients to find the canonical value. You can filter by the\ncolumn_name and the entity id to find all of the possible input values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "_core_eia__forensics_entity_resolution_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "column_name", "type": "string", "description": "The name of the column." }, { "name": "record_value", "type": "string", "description": "The original values found in PUDL _core table records that were used as ingredients to the entity resolution process." }, { "name": "entity_occurrences", "type": "integer", "description": "The number of times this entity - aka this particular utility, plant, etc - occurs across the pre-entity resolution tables." }, { "name": "record_occurrences", "type": "integer", "description": "The number of times this particular ``record_value`` occurs across the pre-entity resolution tables in association with this particular entity." }, { "name": "consistent_rate", "type": "number", "description": "What portion of the entity's records were reported with this particular ``record_value``. This is calculated by dividing the ``record_occurrences`` by the ``entity_occurrences``." }, { "name": "is_candidate", "type": "boolean", "description": "Is this record a candidate for being the canonical value? This is based on ``consistent_rate``. By default PUDL requires values to be at least 70 percent consistent to pass this consistency check. There are exceptions to the default 70 percent consistency check for columns like plant or utility names when we always want a value - for those instances we choose the most frequently occurring value regardless of how consistently it was reported." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2672129, "hash": "sha256:22f76d14431fa24dfa96d8c777ee9009bfbe7ff519ca23ab098279bb6dddb82e" }, { "name": "_core_phmsagas__yearly_distribution_by_install_decade", "type": "table", "description": "Annual time series of miles of mains and the number of services in operation at the end of the year by install decade.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part B - System Description / Section 4)\n\nPrimary key:\n report_id, report_date, operator_id_phmsa, operating_state, install_decade\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe records with an install decade of total_decade are a total - beware of aggregating these values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_by_install_decade.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID.", "constraints": { "required": true } }, { "name": "commodity", "type": "string", "description": "The type of gas delivered by the distribution pipeline." }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states.", "constraints": { "required": true } }, { "name": "install_decade", "type": "string", "description": "The decade the distribution pipeline was installed.", "constraints": { "required": true, "pattern": "(\\d{4}s|unknown_decade|pre_1940|total_decades)" } }, { "name": "mains_miles", "type": "number", "description": "The miles of mains distribution pipeline.", "unit": "miles" }, { "name": "services", "type": "number", "description": "Number of services in system at end of year." } ], "primaryKey": [ "report_id", "report_date", "operator_id_phmsa", "operating_state", "install_decade" ], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1542472, "hash": "sha256:b3d72531952fa3f70e59b264ad611de5838f5a6d201f4f226b07e739efb4458e" }, { "name": "_core_phmsagas__yearly_distribution_by_material", "type": "table", "description": "Annual time series of miles of mains and the number of services in operation at the end of the year by material for each gas distribution operator.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part B - System Description / Section 1 - General)\n\nPrimary key:\n This table has no primary key. We expect the primary key for this table should be report_id, operator_id_phmsa, operating_state and material. However, there are nulls in the operating_state across several years of reporting.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* The categories of material types have changed slightly over the years (ex: cast and wrought iron were broken up in two categories before 1984).\n\n* Beginning in 2004, companies file one report per state. The operating_state column has not been normalized and may contain more than one state in earlier years of data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_by_material.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID." }, { "name": "commodity", "type": "string", "description": "The type of gas delivered by the distribution pipeline." }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states." }, { "name": "material", "type": "string", "description": "The material of the gas distribution pipe. The categories of material types have changed slightly over the years (ex: cast and wrought iron were broken up in two categories before 1984).", "constraints": { "enum": [ "unprotected_steel_bare", "unprotected_steel_coated", "cathodically_protected_steel_bare", "cathodically_protected_steel_coated", "steel", "pvc", "pe", "abs", "other_plastic", "plastic", "cast_or_wrought_iron", "wrought_iron", "ductile_iron", "copper", "other_alt", "other_material", "other", "reconditioned_cast_iron", "cast_iron", "all_materials", "total" ] } }, { "name": "mains_miles", "type": "number", "description": "The miles of mains distribution pipeline.", "unit": "miles" }, { "name": "services", "type": "number", "description": "Number of services in system at end of year." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3124749, "hash": "sha256:d044827d8c71fa22e92ac8a5b31a0ec033c84c8e961a03dff648dc8e6d972f7d" }, { "name": "_core_phmsagas__yearly_distribution_by_material_and_size", "type": "table", "description": "Annual time series of miles of mains and the number of services in operation at the end of the year by material and size of pipe.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part B - System Description / Section 3)\n\nPrimary key:\n This table has no primary key. We expect the primary key for this table should be report_id, operator_id_phmsa, operating_state, main_size and material. There are nulls in the operating_state across several years of reporting.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* The size ranges in main_size have changed slightly over the years (ex: before 1984 they reported 0.5_in_or_less whereas after they reported 1_in_or_less)\n\n* The categories of material types have changed slightly over the years (ex: cast and wrought iron were broken up in two categories before 1984).\n\n* Beginning in 2004, companies file one report per state. The operating_state column has not been normalized and may contain more than one state in earlier years of data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_by_material_and_size.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission." }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID." }, { "name": "commodity", "type": "string", "description": "The type of gas delivered by the distribution pipeline." }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states." }, { "name": "main_size", "type": "string", "description": "Size range of mains. The size ranges have changed slightly over the years (ex: before 1984 they reported 0.5_in_or_less whereas after they reported 1_in_or_less).", "constraints": { "enum": [ "0.5_in_or_less", "0.5_to_1_in", "1_in_or_less", "1_to_2_in", "2_in_or_less", "2_to_4_in", "4_to_6_in", "4_to_8_in", "8_in", "8_to_12_in", "10_in", "12_in", "over_12_in", "total", "unknown" ] } }, { "name": "material", "type": "string", "description": "The material of the gas distribution pipe. The categories of material types have changed slightly over the years (ex: cast and wrought iron were broken up in two categories before 1984).", "constraints": { "enum": [ "unprotected_steel_bare", "unprotected_steel_coated", "cathodically_protected_steel_bare", "cathodically_protected_steel_coated", "steel", "pvc", "pe", "abs", "other_plastic", "plastic", "cast_or_wrought_iron", "wrought_iron", "ductile_iron", "copper", "other_alt", "other_material", "other", "reconditioned_cast_iron", "cast_iron", "all_materials", "total" ] } }, { "name": "mains_miles", "type": "number", "description": "The miles of mains distribution pipeline.", "unit": "miles" }, { "name": "services", "type": "number", "description": "Number of services in system at end of year." }, { "name": "main_other_material_detail", "type": "string", "description": "A free-form text field containing notes about the other material type. This column should only contain values in it for rows with other as the material type listed." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 9260015, "hash": "sha256:66c8d78cb172ab6285c34c7ec974db764dabfccd39b1ff1a693245edcb6ed8e2" }, { "name": "_core_phmsagas__yearly_distribution_excavation_damages", "type": "table", "description": "Annual time series of excavation damages from various sources.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part D - Excavation Damage)\n\nPrimary key:\n report_id, damage_type, damage_sub_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_excavation_damages.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID." }, { "name": "commodity", "type": "string", "description": "The type of gas delivered by the distribution pipeline." }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states." }, { "name": "damage_type", "type": "string", "description": "A high level category of excavation damage causes.", "constraints": { "required": true, "enum": [ "notification", "locating", "excavation", "other", "total" ] } }, { "name": "damage_sub_type", "type": "string", "description": "A sub-category of damage_type of excavation damage causes.", "constraints": { "required": true, "enum": [ "deteriorated_facility", "dug_after_expiry", "failed_clearance", "failed_to_protect_facilities", "improper_backfilling", "inaccurate_mark_abandoned_facility", "inaccurate_mark_incorrect_records", "inaccurate_mark_locator_error", "inaccurate_mark_tracer_wire", "incorrect_information", "issues_total", "marks_faded", "no_one_call_made", "not_marked_abandoned_facility", "not_marked_incomplete_marks", "not_marked_incorrect_records", "not_marked_locator_error", "not_marked_no_response", "not_marked_tracer_wire", "not_marked_unlocatable_facility", "one_call_center_error", "other_issues", "outside_ticket_area", "previous_damage", "prior_to_test_hole_verification", "prior_to_valid_start_time", "root_cause_not_listed", "total" ] } }, { "name": "damages", "type": "number", "description": "Number of instances of excavation damage." } ], "primaryKey": [ "report_id", "damage_type", "damage_sub_type" ], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 527381, "hash": "sha256:2354598af2cd72fcb6e3ad1433bbe6df943d91b7c89d9e6995ddd71aa585155a" }, { "name": "_core_phmsagas__yearly_distribution_filings", "type": "table", "description": "Annual time series of filings (aka submissions) from gas distribution system operators.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report\n\nPrimary key:\n report_id, report_date, operator_id_phmsa\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table contains information about the filer and filing type. This includes information about who filed but also whether this was an original filing or a correction.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_filings.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission.", "constraints": { "required": true } }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "filing_date", "type": "date", "description": "Date on which the filing was submitted." }, { "name": "initial_filing_date", "type": "date", "description": "Initial date when filing was originally submitted." }, { "name": "filing_correction_date", "type": "date", "description": "Date when a correction filing was submitted." }, { "name": "report_filing_type", "type": "string", "description": "Type of report submitted, either Initial or Supplemental.", "constraints": { "enum": [ "Initial", "Supplemental" ] } }, { "name": "data_date", "type": "date", "description": "When the data source was last updated." }, { "name": "form_revision_id", "type": "string", "description": "PHMSA form revision identifier." }, { "name": "preparer_name", "type": "string", "description": "Name of representative who filed report." }, { "name": "preparer_title", "type": "string", "description": "Title of representative who filed report." }, { "name": "preparer_phone", "type": "string", "description": "Phone number of representative who filed report." }, { "name": "preparer_fax", "type": "string", "description": "Fax number of representative who filed report." }, { "name": "preparer_email", "type": "string", "description": "Email address of representative who filed report." } ], "primaryKey": [ "report_id", "report_date", "operator_id_phmsa" ], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1826272, "hash": "sha256:78a5b858a4bd8ad3bd241594ee619874d7a0942343d0c12fd23f148ec1587b42" }, { "name": "_core_phmsagas__yearly_distribution_leaks", "type": "table", "description": "Annual time series of total and hazardous leaks eliminated or repaired during the report year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part C)\n\nPrimary key:\n This table has no primary key. We expect the primary key for this table should be report_id, operator_id_phmsa, operating_state, leak_severity and leak_source. There are nulls in the operating_state across several years of reporting.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Beginning in 2004, companies file one report per state. The operating_state column has not been normalized and may contain more than one state in earlier years of data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_leaks.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID." }, { "name": "commodity", "type": "string", "description": "The type of gas delivered by the distribution pipeline." }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states." }, { "name": "leak_severity", "type": "string", "description": "Whether or not the leak described in this record are all leaks or hazardous leaks.", "constraints": { "enum": [ "all_leaks", "hazardous_leaks" ] } }, { "name": "leak_source", "type": "string", "description": "The cause of the leaks.", "constraints": { "enum": [ "construction_defect", "corrosion_failure", "equipment_failure", "excavation_damage", "incorrect_operation", "material_defect", "natural_force_damage", "other", "other_outside_force", "outside_force", "pipe_weld_joint_failure", "third_party", "total" ] } }, { "name": "mains", "type": "number", "description": "The number of mains distribution pipeline.", "unit": "miles" }, { "name": "services", "type": "number", "description": "Number of services in system at end of year." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2569981, "hash": "sha256:d8917dce1510ddec30d6700e2b8360449397542811dde99bfdae942e1257c992" }, { "name": "_core_phmsagas__yearly_distribution_misc", "type": "table", "description": "Annual time series of miscellaneous distribution information.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part B & C)\n\nPrimary key:\n This table has no primary key. We expect the primary key for this table should be report_id, operator_id_phmsa, and operating_state. There are nulls in the operating_state across several years of reporting.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table has been concatenated across all years and re-organized into a logical structure, but the data has not been fully cleaned. Except some inconsistent units, data types and values over the years of reported data. Once fully cleaned, this table will be deprecated and replaced with a core table.\n\n* Beginning in 2004, companies file one report per state. The operating_state column has not been normalized and may contain more than one state in earlier years of data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "_core_phmsagas__yearly_distribution_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission." }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID." }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states." }, { "name": "all_known_leaks_scheduled_for_repair", "type": "number", "description": "The number of known system leaks at the end of the report year scheduled for repair." }, { "name": "all_known_leaks_scheduled_for_repair_main", "type": "number", "description": "The number of known leaks on main at the end of the report year scheduled for repair." }, { "name": "hazardous_leaks_mechanical_joint_failure", "type": "number", "description": "The total number of hazardous leaks caused by a mechanical joint failure." }, { "name": "federal_land_leaks_repaired_or_scheduled", "type": "integer", "description": "Total number of leaks repaired, eliminated, or scheduled for repair on federal land during the reporting year." }, { "name": "average_service_length_feet", "type": "number", "description": "The average system service length in feet.", "unit": "feet" }, { "name": "services_efv_in_system", "type": "integer", "description": "Estimated number of services with Excess Flow Valve in the system at end of reported year related to natural gas distribution." }, { "name": "services_efv_installed", "type": "integer", "description": "Total number of services with Excess Flow Valve installed during reported year related to natural gas distribution." }, { "name": "services_shutoff_valve_in_system", "type": "integer", "description": "Estimated number of services with manual service line shut-off valves installed in the system at end of report year related to natural gas distribution." }, { "name": "services_shutoff_valve_installed", "type": "integer", "description": "Total number of manual service line shut-off valves installed during reported year related to natural gas distribution." }, { "name": "unaccounted_for_gas_fraction", "type": "number", "description": "Unaccounted for gas as a fraction of total consumption for the 12 months ending June 30 of the reporting year. Calculated as follows: Take the sum of: (purchased gas + produced gas) minus (customer use + company use + appropriate adjustments). Then divide by the sum of (customer use + company use + appropriate adjustments). Prior to 2017, this field was calculated with a different deonominator (purchased gas + produced gas). The time period between 2010-2017 having this different calculation method ensured that there was no records that had a negative fraction. For all the other reporting years there are known and expected negative values in this column." }, { "name": "excavation_tickets", "type": "integer", "description": "Number of Excavation Tickets received by the operator during the year, (i.e., receipt of information by the operator from the notification center)." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "report_id", "report_date", "operator_id_phmsa" ], "reference": { "resource": "core_phmsagas__yearly_distribution_operators", "fields": [ "report_id", "report_date", "operator_id_phmsa" ] } } ] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1207143, "hash": "sha256:d189dbaec9d7166625a47a5654c31281be61e2de6f796b005a2a75ab96fd545e" }, { "name": "_core_rus12__forensics_entity_resolution_borrowers", "type": "table", "description": "Forensic table of the statistics determining how we choose a single consistent value during entity resolution.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is meant for forensic purposes only. It contains all values which were used to choose canonical or golden-record. See `Entity Resolution Methodology `_ for a fuller conceptual overview.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is a forensic table containing the input values used to\nchoose canonical values during entity resolution. It is not a cleaned up table - it\nis meant for forensic purposes only. If you have a question about why a value is\nreported in an ``scd``, ``entity`` or ``out`` table, you can find out all of the inputs\nthat were used as ingredients to find the canonical value. You can filter by the\ncolumn_name and the entity id to find all of the possible input values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "_core_rus12__forensics_entity_resolution_borrowers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "column_name", "type": "string", "description": "The name of the column." }, { "name": "record_value", "type": "string", "description": "The original values found in PUDL _core table records that were used as ingredients to the entity resolution process." }, { "name": "entity_occurrences", "type": "integer", "description": "The number of times this entity - aka this particular utility, plant, etc - occurs across the pre-entity resolution tables." }, { "name": "record_occurrences", "type": "integer", "description": "The number of times this particular ``record_value`` occurs across the pre-entity resolution tables in association with this particular entity." }, { "name": "consistent_rate", "type": "number", "description": "What portion of the entity's records were reported with this particular ``record_value``. This is calculated by dividing the ``record_occurrences`` by the ``entity_occurrences``." }, { "name": "is_candidate", "type": "boolean", "description": "Is this record a candidate for being the canonical value? This is based on ``consistent_rate``. By default PUDL requires values to be at least 70 percent consistent to pass this consistency check. There are exceptions to the default 70 percent consistency check for columns like plant or utility names when we always want a value - for those instances we choose the most frequently occurring value regardless of how consistently it was reported." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 15378, "hash": "sha256:93ec12405350b881bdf5153d4b4f683c8299d1a2b8c89fbabff56ccbb5c3374e" }, { "name": "_core_rus7__forensics_entity_resolution_borrowers", "type": "table", "description": "Forensic table of the statistics determining how we choose a single consistent value during entity resolution.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned but not tidied/normalized. Published only temporarily and may be removed without notice.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table is meant for forensic purposes only. It contains all values which were used to choose canonical or golden-record. See `Entity Resolution Methodology `_ for a fuller conceptual overview.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is a forensic table containing the input values used to\nchoose canonical values during entity resolution. It is not a cleaned up table - it\nis meant for forensic purposes only. If you have a question about why a value is\nreported in an ``scd``, ``entity`` or ``out`` table, you can find out all of the inputs\nthat were used as ingredients to find the canonical value. You can filter by the\ncolumn_name and the entity id to find all of the possible input values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "_core_rus7__forensics_entity_resolution_borrowers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "column_name", "type": "string", "description": "The name of the column." }, { "name": "record_value", "type": "string", "description": "The original values found in PUDL _core table records that were used as ingredients to the entity resolution process." }, { "name": "entity_occurrences", "type": "integer", "description": "The number of times this entity - aka this particular utility, plant, etc - occurs across the pre-entity resolution tables." }, { "name": "record_occurrences", "type": "integer", "description": "The number of times this particular ``record_value`` occurs across the pre-entity resolution tables in association with this particular entity." }, { "name": "consistent_rate", "type": "number", "description": "What portion of the entity's records were reported with this particular ``record_value``. This is calculated by dividing the ``record_occurrences`` by the ``entity_occurrences``." }, { "name": "is_candidate", "type": "boolean", "description": "Is this record a candidate for being the canonical value? This is based on ``consistent_rate``. By default PUDL requires values to be at least 70 percent consistent to pass this consistency check. There are exceptions to the default 70 percent consistency check for columns like plant or utility names when we always want a value - for those instances we choose the most frequently occurring value regardless of how consistently it was reported." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 51860, "hash": "sha256:6a25afe55b3a216d8d9a0ae1b7d2871a9e5ca535afa0628e05b2a6a594bbbcee" }, { "name": "core_eia176__yearly_gas_disposition", "type": "table", "description": "Annual time series of a company's natural and supplemental gas disposition for the report state.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 176 -- Annual Report of Natural and Supplemental Gas Supply and Disposition (Part 6, Lines 9, 12-20)\n\nPrimary key:\n operator_id_eia, report_year\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe ``deliveries_out_of_state_volume_mcf`` (Line 14.0) are reported as one aggregated volume,\ncalculated by summing the original granular data. Similarly, ``disposition_to_other_volume_mcf``\n(Line 18.4) is summed from the original granular data and reported as one aggregate field.\n\nThe ``delivered_gas_heat_content_mmbtu_per_mcf`` is expected to be between 0.8 and 1.2\nby the EIA. We find that less than 0.5 percent of data falls outside of these expected bounds.\n\nThe ``total_disposition_mcf`` field includes disposition to consumers which is reported in core_eia176__yearly_gas_disposition_by_consumer.\nNote that the reported total disposition and the sum of values in this table and core_eia176__yearly_gas_disposition_by_consumer often don't match as would be expected.\nThus, we have preserved both the total field and the sub-components in these two tables.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia176", "title": "EIA Form 176 -- Annual Report of Natural and Supplemental Gas Supply and Disposition", "path": "https://www.eia.gov/naturalgas/ngqs/", "description": "The EIA Form 176, also known as the Annual Report of Natural and Supplemental Gas Supply and Disposition, describes the origins, suppliers, and disposition of natural gas on a yearly and state by state basis.", "keywords": [ "eia", "eia176", "energy information administration", "federal", "form 176", "government", "natural gas", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7682357", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.18909200", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia176.html" } ], "path": "core_eia176__yearly_gas_disposition.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "operator_id_eia", "type": "string", "description": "The unique EIA identifier for an operator in a given state. The last two letters of the ID indicate the state.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "operating_state", "type": "string", "description": "State that the distribution utility is reporting for. Prior to 2004, this may be a list of states." }, { "name": "delivered_gas_heat_content_mmbtu_per_mcf", "type": "number", "description": "The average annual heat content of gas delivered directly to consumers.", "unit": "MMBTU_per_Mcf" }, { "name": "operational_consumption_facility_space_heat_mcf", "type": "number", "description": "Volume of natural gas consumed as fuel for space heat of the operator's own facilities within the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_consumption_new_pipeline_fill_mcf", "type": "number", "description": "Volume of natural gas consumed as fuel for the operator's new pipeline fill within the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_consumption_compressors_mcf", "type": "number", "description": "Volume of natural gas consumed as fuel for the operator's own pipeline distribution or storage compressor use within the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_consumption_lng_vaporization_liquefaction_mcf", "type": "number", "description": "Volume of natural gas consumed by the operator for vaporization, liquefaction, and LNG fuel within the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_consumption_vehicle_fuel_mcf", "type": "number", "description": "Volume of natural gas used in the operator's company-owned fleet within the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_consumption_other_mcf", "type": "number", "description": "Volume of natural gas consumed as fuel by the operator for other purposes within the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_consumption_other_detail", "type": "string", "description": "Free-text detail describing the operator\u2019s specified 'other purposes' for operational natural-gas consumption, corresponding to the volume reported in operational_consumption_other_mcf." }, { "name": "operational_storage_underground_mcf", "type": "number", "description": "The total volume added to underground storage operated by the company within the report state, regardless of ownership of the gas. This includes new fields. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "operational_lng_storage_injections_mcf", "type": "number", "description": "The total volume added to LNG storage operated by the company within the report state, regardless of ownership of the gas. For LNG import and export marine terminals, this should exclude injections of LNG during the course of routine operations for handling imports, as well as LNG held in storage for future use. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "producer_lease_use_mcf", "type": "number", "description": "The total volume of gas used in the company's well, field and lease operations. This field should only be reported by producers. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "producer_returned_for_repressuring_reinjection_mcf", "type": "number", "description": "The volume of gas delivered directly from the operator's system to oil or gas fields located within the report state for repressuring, pressure maintenance, and cycling operations. This field should only be reported by producers. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "disposition_distribution_companies_mcf", "type": "number", "description": "Disposition to distribution companies within the report state that does not fall into one of the other reported categories in lines 10.1-17.0. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "disposition_storage_operators_mcf", "type": "number", "description": "Disposition to storage operators within the report state that does not fall into one of the other reported categories in lines 10.1-17.0. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "disposition_other_pipelines_mcf", "type": "number", "description": "Disposition to other pipelines within the report state that does not fall into one of the other reported categories in lines 10.1-17.0. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "disposition_out_of_state_mcf", "type": "number", "description": "Total volume of the operator's deliveries across or to state lines or U.S. borders. This has been summed from the detailed data reported by each company on Line 14.0 of the original form in order to preserve the primary key of the table. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "other_disposition_all_other_mcf", "type": "number", "description": "Other disposition within the report state that does not fall into one of the other reported categories in lines 10.1-17.0. This has been summed from the detailed data reported by each company on Line 18.4 of the original form in order to preserve the primary key of the table. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "total_disposition_mcf", "type": "number", "description": "Total disposition within the report state, as reported by the operator. This includes disposition to consumers which is reported in core_eia176__yearly_gas_disposition_by_consumer. Note that the reported total disposition and the sum of values in this table and core_eia176__yearly_gas_disposition_by_consumer often don't match as it would be expected. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "losses_mcf", "type": "number", "description": "Known loss volumes as a result of leaks, damage, accidents, migration and blow down within the report state where the events took place, as well as estimated losses from leaks occurring during distribution activities. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" }, { "name": "unaccounted_for_mcf", "type": "number", "description": "The difference between gas supply and disposition. A positive entry indicates supply in excess of accounted-for disposition. A negative entry indicates accounted-for disposition exceeds reported supply. This is calculated as the difference between Part 4 Line 7.0 and Part 6 Line 19.0, and is reported as Line 20.0 in the original form.", "unit": "Mcf" } ], "primaryKey": [ "operator_id_eia", "report_year" ], "foreignKeys": [] }, "keywords": [ "eia", "eia176", "energy information administration", "federal", "form 176", "government", "natural gas", "united states", "us", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1271609, "hash": "sha256:183a4f7a75846627bd4362e463fe3baf069f941e948518ffb9da819fa0958f48" }, { "name": "core_eia176__yearly_gas_disposition_by_consumer", "type": "table", "description": "Annual time series of a company's natural gas deliveries to end-use consumers within the report state.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 176 -- Annual Report of Natural and Supplemental Gas Supply and Disposition (Part 6, Lines 10.0-11.6)\n\nPrimary key:\n report_year, operator_id_eia, customer_class, revenue_class", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia176", "title": "EIA Form 176 -- Annual Report of Natural and Supplemental Gas Supply and Disposition", "path": "https://www.eia.gov/naturalgas/ngqs/", "description": "The EIA Form 176, also known as the Annual Report of Natural and Supplemental Gas Supply and Disposition, describes the origins, suppliers, and disposition of natural gas on a yearly and state by state basis.", "keywords": [ "eia", "eia176", "energy information administration", "federal", "form 176", "government", "natural gas", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7682357", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.18909200", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia176.html" } ], "path": "core_eia176__yearly_gas_disposition_by_consumer.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "operator_id_eia", "type": "string", "description": "The unique EIA identifier for an operator in a given state. The last two letters of the ID indicate the state.", "constraints": { "required": true } }, { "name": "operating_state", "type": "string", "description": "State that the operator is reporting for." }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "required": true, "enum": [ "commercial", "electric_power", "industrial", "other", "residential", "vehicle_fuel" ] } }, { "name": "revenue_class", "type": "string", "description": "Source of revenue: whether revenue originates from gas owned directly by the operator (sales) or gas transported by the operator (transport).", "constraints": { "required": true, "enum": [ "sales", "transport" ] } }, { "name": "consumers", "type": "integer", "description": "Number of end-use consumers within the report state." }, { "name": "revenue", "type": "number", "description": "Revenue including taxes, rounded to the nearest whole dollar.", "unit": "USD" }, { "name": "volume_mcf", "type": "number", "description": "Total volume of natural gas deliveries in the report state. Reference conditions for measurement are 14.73 psia and 60\u00b0 Fahrenheit.", "unit": "Mcf" } ], "primaryKey": [ "report_year", "operator_id_eia", "customer_class", "revenue_class" ], "foreignKeys": [] }, "keywords": [ "eia", "eia176", "energy information administration", "federal", "form 176", "government", "natural gas", "united states", "us", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1949122, "hash": "sha256:a7febece41f1cacdfebf5a4d8e90b418a83313e9084e08d6dc79a8cc865b54a4" }, { "name": "core_eia191__monthly_gas_storage", "type": "table", "description": "Monthly time series of monthly underground natural gas storage activity reported by operators.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 191 -- Monthly Underground Natural Gas Storage Report\n\nPrimary key:\n storage_field_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* ``total_field_capacity_mcf`` is not reliably equal to the sum of ``working_gas_capacity_mcf`` and ``base_gas_mcf``: approximately 23% of records differ. This reflects loose EIA definitions and operator self-reporting practices, not data errors. Do not assume additivity among these three fields.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia191", "title": "EIA Form 191 -- Monthly Underground Natural Gas Storage Report", "path": "https://www.eia.gov/naturalgas/ngqs/", "description": "The EIA Form 191, also known as the Monthly Underground Natural Gas Storage Report, describes the working and base gas in reservoirs, injections, withdrawals, and location of reservoirs by field monthly.", "keywords": [ "eia", "eia191", "energy information administration", "federal", "form 191", "government", "natural gas", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.10607836", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.19947262", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia191.html" } ], "path": "core_eia191__monthly_gas_storage.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "storage_field_id_eia", "type": "string", "description": "EIA-assigned identifier for an underground natural gas storage reservoir. IDs are assigned per company and state, so the same physical reservoir may have different IDs if ownership changes.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "gas_field_id_eia", "type": "integer", "description": "EIA-assigned numeric identifier for a natural gas storage field." }, { "name": "reservoir_id_eia", "type": "integer", "description": "EIA-assigned numeric identifier for the individual storage reservoir within a natural gas storage field." }, { "name": "company_name", "type": "string", "description": "Name of the reporting company." }, { "name": "field_name", "type": "string", "description": "Name of the natural gas storage field." }, { "name": "reservoir_name", "type": "string", "description": "Name of the individual underground natural gas storage reservoir." }, { "name": "field_type", "type": "string", "description": "Type of underground natural gas storage facility. One of: depleted field (a reservoir previously used for natural gas production), aquifer (a porous rock structure used to store gas), or salt dome (a cavern created within a salt formation).", "constraints": { "enum": [ "aquifer", "depleted field", "salt dome" ] } }, { "name": "county", "type": "string", "description": "County name." }, { "name": "operational_status", "type": "string", "description": "Operational status of the underground natural gas storage reservoir.", "constraints": { "enum": [ "active", "inactive" ] } }, { "name": "base_gas_mcf", "type": "number", "description": "Volume of base gas (cushion gas) in the underground storage reservoir. Base gas is the volume of gas intended as permanent inventory in a reservoir to maintain adequate pressure and deliverability rates.", "unit": "Mcf" }, { "name": "working_gas_capacity_mcf", "type": "number", "description": "Volume of working gas (the portion of stored gas available for withdrawal) in the underground storage reservoir.", "unit": "Mcf" }, { "name": "total_field_capacity_mcf", "type": "number", "description": "Total design capacity of the underground natural gas storage field (base gas plus working gas).", "unit": "Mcf" }, { "name": "maximum_daily_delivery_mcf", "type": "number", "description": "Maximum daily quantity of gas that can be withdrawn from the underground storage reservoir under normal operating conditions.", "unit": "Mcf" }, { "name": "region", "type": "string", "description": "EIA storage region in which the underground natural gas storage field is located.", "constraints": { "enum": [ "alaska", "east region", "midwest region", "mountain region", "pacific region", "south central region" ] } } ], "primaryKey": [ "storage_field_id_eia", "report_date" ], "foreignKeys": [] }, "keywords": [ "eia", "eia191", "energy information administration", "federal", "form 191", "government", "natural gas", "united states", "us", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 644702, "hash": "sha256:d7955d3800d2c6c88c492299f07c4756ce0ee748da35792bd741acfce40680c0" }, { "name": "core_eia860__assn_boiler_cooling", "type": "table", "description": "Association table providing connections between EIA boiler IDs and EIA cooling system IDs.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n report_date, plant_id_eia, boiler_id, cooling_id_eia", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__assn_boiler_cooling.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "cooling_id_eia", "type": "string", "description": "EIA Identification code for cooling system (if multiple cooling systems are not distinguished by separate IDs, the word 'PLANT' is listed to encompass the cooling system for the entire plant)", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "report_date", "plant_id_eia", "boiler_id", "cooling_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "boiler_id", "report_date" ], "reference": { "resource": "core_eia860__scd_boilers", "fields": [ "plant_id_eia", "boiler_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 137844, "hash": "sha256:c9785815c81a3fe861f82af693624a752660f9ef34ad1e408e5bb0d9ccc9ffb5" }, { "name": "core_eia860__assn_boiler_generator", "type": "table", "description": "Association table providing connections between boilers and generators.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 6, Part A)\n\nPrimary key:\n plant_id_eia, report_date, generator_id, boiler_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAugmented with various heuristics within PUDL.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia860__assn_boiler_generator.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "unit_id_eia", "type": "string", "description": "EIA-assigned unit identification code." }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "boiler_generator_assn_type_code", "type": "string", "description": "Indicates whether boiler associations with generator during the year were actual or theoretical. Only available before 2013." }, { "name": "steam_plant_type_code", "type": "integer", "description": "Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details." }, { "name": "bga_source", "type": "string", "description": "The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections)." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "generator_id", "boiler_id" ], "foreignKeys": [ { "fields": [ "boiler_generator_assn_type_code" ], "reference": { "resource": "core_eia__codes_boiler_generator_assn_types", "fields": [ "code" ] } }, { "fields": [ "steam_plant_type_code" ], "reference": { "resource": "core_eia__codes_steam_plant_types", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "boiler_id", "report_date" ], "reference": { "resource": "core_eia860__scd_boilers", "fields": [ "plant_id_eia", "boiler_id", "report_date" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 230982, "hash": "sha256:4f826f6599aa7a3ab77be5a92392835435e26f2e5d8b3d52bb69a2fb4c6365c9" }, { "name": "core_eia860__assn_boiler_stack_flue", "type": "table", "description": "Association table providing connections between EIA boiler IDs and EIA stack and/or flue system IDs.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n report_date, plant_id_eia, boiler_id, stack_flue_id_pudl", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__assn_boiler_stack_flue.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "stack_id_eia", "type": "string", "description": "The stack identification value reported to EIA. Stacks or chimneys are the place where emissions from the combustion process are released into the atmosphere. This field was reported in conjunction with flue_id_eia until 2013 when stack_flue_id_eia took their place." }, { "name": "flue_id_eia", "type": "string", "description": "The flue identification value reported to EIA. The flue is a duct, pipe, or opening that transports exhast gases through the stack. This field was reported in conjunction with stack_id_eia until 2013 when stack_flue_id_eia took their place." }, { "name": "stack_flue_id_eia", "type": "string", "description": "The stack or flue identification value reported to EIA. This denotes the place where emissions from the combustion process are released into the atmosphere. Prior to 2013, this was reported as `stack_id_eia` and `flue_id_eia`." }, { "name": "stack_flue_id_pudl", "type": "string", "description": "A stack and/or flue identification value created by PUDL for use as part of the primary key for the stack flue equipment and boiler association tables. For 2013 and onward, this value is equal to the value for stack_flue_id_eia. Prior to 2013, this value is equal to the value for stack_id_eia and the value for flue_id_eia separated by an underscore or just the stack_flue_eia in cases where flue_id_eia is NA.", "constraints": { "required": true } } ], "primaryKey": [ "report_date", "plant_id_eia", "boiler_id", "stack_flue_id_pudl" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "boiler_id", "report_date" ], "reference": { "resource": "core_eia860__scd_boilers", "fields": [ "plant_id_eia", "boiler_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 195660, "hash": "sha256:0beb68c22eaca8facbcd8859f6295818275eff1336ba9659f27727870003cf36" }, { "name": "core_eia860__assn_yearly_boiler_emissions_control_equipment", "type": "table", "description": "Association table providing connections between EIA boiler IDs and emissions control IDs for NOx, SO2, mercury, and particulate monitoring.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n report_date, plant_id_eia, boiler_id, emission_control_id_type, emission_control_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The relationship between the IDs is sometimes many to many.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__assn_yearly_boiler_emissions_control_equipment.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "emission_control_id_type", "type": "string", "description": "The type of emissions control id: SO2, NOx, particulate, or mercury.", "constraints": { "required": true } }, { "name": "emission_control_id_eia", "type": "string", "description": "The emission control ID used to collect SO2, NOx, particulate, and mercury emissions data. This column should be used in conjunction with emissions_control_type as it's not guaranteed to be unique.", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "report_date", "plant_id_eia", "boiler_id", "emission_control_id_type", "emission_control_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "boiler_id", "report_date" ], "reference": { "resource": "core_eia860__scd_boilers", "fields": [ "plant_id_eia", "boiler_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 275948, "hash": "sha256:8da2c19d4ea82cbff02af12ad9100e7798cebdcadfcd6da656aeb51a23508395" }, { "name": "core_eia860__scd_boilers", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of boilers which may vary from year to year. Compiled from across all EIA-860 data.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n plant_id_eia, boiler_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for boilers are set. It contains values which are expected to vary slowly, while\n:ref:`core_eia__entity_boilers` contains those expected to remain fixed.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia860__scd_boilers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "boiler_operating_date", "type": "date", "description": "Date the boiler began or is planned to begin commercial operation." }, { "name": "boiler_status", "type": "string", "description": "EIA short code identifying boiler operational status." }, { "name": "boiler_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the boiler." }, { "name": "boiler_type", "type": "string", "description": "EIA short code indicating the standards under which the boiler is operating as described in the U.S. EPA regulation under 40 CFR." }, { "name": "firing_type_1", "type": "string", "description": "EIA short code indicating the type of firing used by this boiler." }, { "name": "firing_type_2", "type": "string", "description": "EIA short code indicating the type of firing used by this boiler." }, { "name": "firing_type_3", "type": "string", "description": "EIA short code indicating the type of firing used by this boiler." }, { "name": "firing_rate_using_coal_tons_per_hour", "type": "number", "description": "Design firing rate at maximum continuous steam flow for coal to the nearest 0.1 ton per hour.", "unit": "tons_per_hour" }, { "name": "firing_rate_using_oil_bbls_per_hour", "type": "number", "description": "Design firing rate at maximum continuous steam flow for pet coke to the nearest 0.1 barrels per hour.", "unit": "bbls_per_hour" }, { "name": "firing_rate_using_gas_mcf_per_hour", "type": "number", "description": "Design firing rate at maximum continuous steam flow for gas to the nearest 0.1 cubic feet per hour.", "unit": "mcf_per_hour" }, { "name": "firing_rate_using_other_fuels", "type": "number", "description": "Design firing rate at maximum continuous steam flow for energy sources other than coal, petroleum, or natural gas." }, { "name": "boiler_fuel_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the boiler." }, { "name": "boiler_fuel_code_2", "type": "string", "description": "The code representing the second most predominant type of energy that fuels the boiler." }, { "name": "boiler_fuel_code_3", "type": "string", "description": "The code representing the third most predominant type of energy that fuels the boiler." }, { "name": "boiler_fuel_code_4", "type": "string", "description": "The code representing the fourth most predominant type of energy that fuels the boiler." }, { "name": "waste_heat_input_mmbtu_per_hour", "type": "number", "description": "Design waste-heat input rate at maximum continuous steam flow where a waste-heat boiler is a boiler that receives all or a substantial portion of its energy input from the noncumbustible exhaust gases of a separate fuel-burning process (MMBTU per hour).", "unit": "MMBTU_per_hour" }, { "name": "wet_dry_bottom", "type": "string", "description": "Wet or Dry Bottom where Wet Bottom is defined as slag tanks that are installed at furnace throat to contain and remove molten ash from the furnace, and Dry Bottom is defined as having no slag tanks at furnace throat area, throat area is clear, and bottom ash drops through throat to bottom ash water hoppers.", "unit": "MMBTU_per_hour" }, { "name": "fly_ash_reinjection", "type": "boolean", "description": "Indicates whether the boiler is capable of re-injecting fly ash." }, { "name": "hrsg", "type": "boolean", "description": "indicates if the boiler is a heat recovery steam generator (HRSG)." }, { "name": "max_steam_flow_lbs_per_hour", "type": "number", "description": "Maximum continuous steam flow at 100 percent load.", "unit": "lb_per_hour" }, { "name": "turndown_ratio", "type": "number", "description": "The turndown ratio for the boiler." }, { "name": "efficiency_100pct_load", "type": "number", "description": "Boiler efficiency percentage when burning at 100 percent load to the nearest 0.1 percent." }, { "name": "efficiency_50pct_load", "type": "number", "description": "Boiler efficiency percentage when burning at 50 percent load to the nearest 0.1 percent." }, { "name": "air_flow_100pct_load_cubic_feet_per_minute", "type": "number", "description": "Total air flow including excess air at 100 percent load, reported at standard temperature and pressure (i.e. 68 F and one atmosphere pressure).", "unit": "cfm" }, { "name": "new_source_review", "type": "boolean", "description": "Indicates whether the boiler is subject to New Source Review requirements." }, { "name": "new_source_review_date", "type": "date", "description": "Month of issued New Source Review permit." }, { "name": "new_source_review_permit", "type": "string", "description": "New Source Review permit number." }, { "name": "regulation_particulate", "type": "string", "description": "EIA short code for most stringent type of statute or regulation code under which the boiler is operating for particulate matter control standards." }, { "name": "regulation_so2", "type": "string", "description": "EIA short code for most stringent type of statute or regulation code under which the boiler is operating for sulfur dioxide control standards." }, { "name": "regulation_nox", "type": "string", "description": "EIA short code for most stringent type of statute or regulation code under which the boiler is operating for nitrogen oxide control standards." }, { "name": "standard_particulate_rate", "type": "number", "description": "Numeric value for the unit of measurement specified for particulate matter." }, { "name": "standard_so2_rate", "type": "number", "description": "Numeric value for the unit of measurement specified for sulfur dioxide." }, { "name": "standard_nox_rate", "type": "number", "description": "Numeric value for the unit of measurement specified for nitrogen oxide." }, { "name": "unit_particulate", "type": "string", "description": "Numeric value for the unit of measurement specified for particulate matter." }, { "name": "unit_so2", "type": "string", "description": "Numeric value for the unit of measurement specified for sulfur dioxide." }, { "name": "unit_nox", "type": "string", "description": "Numeric value for the unit of measurement specified for nitrogen oxide." }, { "name": "compliance_year_particulate", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for particulate matter emissions." }, { "name": "compliance_year_nox", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for nitrogen oxide emissions." }, { "name": "compliance_year_so2", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for sulfur dioxide emissions." }, { "name": "particulate_control_out_of_compliance_strategy_1", "type": "string", "description": "If boiler is not in compliance with particulate matter regulations, strategy for compliance." }, { "name": "particulate_control_out_of_compliance_strategy_2", "type": "string", "description": "If boiler is not in compliance with particulate matter regulations, strategy for compliance." }, { "name": "particulate_control_out_of_compliance_strategy_3", "type": "string", "description": "If boiler is not in compliance with particulate matter regulations, strategy for compliance." }, { "name": "so2_control_out_of_compliance_strategy_1", "type": "string", "description": "If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance." }, { "name": "so2_control_out_of_compliance_strategy_2", "type": "string", "description": "If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance." }, { "name": "so2_control_out_of_compliance_strategy_3", "type": "string", "description": "If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance." }, { "name": "so2_control_existing_caaa_compliance_strategy_1", "type": "string", "description": "Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_existing_caaa_compliance_strategy_2", "type": "string", "description": "Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_existing_caaa_compliance_strategy_3", "type": "string", "description": "Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_planned_caaa_compliance_strategy_1", "type": "string", "description": "Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_planned_caaa_compliance_strategy_2", "type": "string", "description": "Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_planned_caaa_compliance_strategy_3", "type": "string", "description": "Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_out_of_compliance_strategy_1", "type": "string", "description": "If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance." }, { "name": "nox_control_out_of_compliance_strategy_2", "type": "string", "description": "If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance." }, { "name": "nox_control_out_of_compliance_strategy_3", "type": "string", "description": "If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance." }, { "name": "nox_control_existing_caaa_compliance_strategy_1", "type": "string", "description": "Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_existing_caaa_compliance_strategy_2", "type": "string", "description": "Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_existing_caaa_compliance_strategy_3", "type": "string", "description": "Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_planned_caaa_compliance_strategy_1", "type": "string", "description": "Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_planned_caaa_compliance_strategy_2", "type": "string", "description": "Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_planned_caaa_compliance_strategy_3", "type": "string", "description": "Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "compliance_year_mercury", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for mercury emissions." }, { "name": "mercury_control_existing_strategy_1", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_2", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_3", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_4", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_5", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_6", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_proposed_strategy_1", "type": "string", "description": "Proposed strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_proposed_strategy_2", "type": "string", "description": "Proposed strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_proposed_strategy_3", "type": "string", "description": "Proposed strategy to comply with the most stringent mercury regulation." }, { "name": "nox_control_existing_strategy_1", "type": "string", "description": "Existing strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_existing_strategy_2", "type": "string", "description": "Existing strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_existing_strategy_3", "type": "string", "description": "Existing strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_manufacturer", "type": "string", "description": "Name of nitrogen oxide control manufacturer." }, { "name": "nox_control_manufacturer_code", "type": "string", "description": "Code indicating the nitrogen oxide control burner manufacturer." }, { "name": "nox_control_proposed_strategy_1", "type": "string", "description": "Proposed strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_proposed_strategy_2", "type": "string", "description": "Proposed strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_proposed_strategy_3", "type": "string", "description": "Proposed strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_status_code", "type": "string", "description": "Nitrogen oxide control status code." }, { "name": "regulation_mercury", "type": "string", "description": "Most stringent type of statute or regulation code under which the boiler is operating for mercury control standards." }, { "name": "so2_control_existing_strategy_1", "type": "string", "description": "Existing strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_existing_strategy_2", "type": "string", "description": "Existing strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_existing_strategy_3", "type": "string", "description": "Existing strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_proposed_strategy_1", "type": "string", "description": "Proposed strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_proposed_strategy_2", "type": "string", "description": "Proposed strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_proposed_strategy_3", "type": "string", "description": "Proposed strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "standard_so2_percent_scrubbed", "type": "number", "description": "The percent of sulfur dioxide to be scrubbed specified by the most stringent sulfur dioxide regulation." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "boiler_id", "report_date" ], "foreignKeys": [ { "fields": [ "boiler_type" ], "reference": { "resource": "core_eia__codes_boiler_types", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "boiler_id" ], "reference": { "resource": "core_eia__entity_boilers", "fields": [ "plant_id_eia", "boiler_id" ] } }, { "fields": [ "boiler_status" ], "reference": { "resource": "core_eia__codes_boiler_status", "fields": [ "code" ] } }, { "fields": [ "nox_control_manufacturer_code" ], "reference": { "resource": "core_eia__codes_environmental_equipment_manufacturers", "fields": [ "code" ] } }, { "fields": [ "firing_type_1" ], "reference": { "resource": "core_eia__codes_firing_types", "fields": [ "code" ] } }, { "fields": [ "firing_type_2" ], "reference": { "resource": "core_eia__codes_firing_types", "fields": [ "code" ] } }, { "fields": [ "firing_type_3" ], "reference": { "resource": "core_eia__codes_firing_types", "fields": [ "code" ] } }, { "fields": [ "nox_control_existing_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_existing_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_existing_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_out_of_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_out_of_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_out_of_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_planned_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_planned_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_planned_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_status_code" ], "reference": { "resource": "core_eia__codes_nox_control_status", "fields": [ "code" ] } }, { "fields": [ "unit_nox" ], "reference": { "resource": "core_eia__codes_nox_units", "fields": [ "code" ] } }, { "fields": [ "mercury_control_proposed_strategy_1" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_proposed_strategy_2" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_proposed_strategy_3" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_1" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_2" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_3" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_4" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_5" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_6" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "particulate_control_out_of_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_particulate_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "particulate_control_out_of_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_particulate_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "particulate_control_out_of_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_particulate_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "unit_particulate" ], "reference": { "resource": "core_eia__codes_particulate_units", "fields": [ "code" ] } }, { "fields": [ "regulation_nox" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "regulation_particulate" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "regulation_so2" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "regulation_mercury" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "so2_control_existing_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_existing_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_existing_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_out_of_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_out_of_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_out_of_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_planned_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_planned_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_planned_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "wet_dry_bottom" ], "reference": { "resource": "core_eia__codes_wet_dry_bottom", "fields": [ "code" ] } }, { "fields": [ "unit_so2" ], "reference": { "resource": "core_eia__codes_so2_units", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1690605, "hash": "sha256:46d5fd6b09406024cca5c668dcd0f3c9ebd8d1378b9951e603af5541ed1eb568" }, { "name": "core_eia860__scd_emissions_control_equipment", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of emissions control equipment reported to EIA, including cost, type, operating status, retirement date, and install year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n report_date, plant_id_eia, emission_control_id_pudl\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIncludes control ids for sulfur dioxide\n(SO2), particulate matter, mercury, nitrogen oxide (NOX), and acid (HCl) gas\nmonitoring.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__scd_emissions_control_equipment.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "emission_control_id_pudl", "type": "number", "description": "A PUDL-generated ID used to distinguish emission control units in the same report year and plant id. This ID should not be used to track units over time or between plants.", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "emission_control_equipment_type_code", "type": "string", "description": "Short code indicating the type of emission control equipment installed." }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "mercury_control_id_eia", "type": "string", "description": "Mercury control identification number. This ID is not a unique identifier." }, { "name": "nox_control_id_eia", "type": "string", "description": "Nitrogen oxide control identification number. This ID is not a unique identifier." }, { "name": "particulate_control_id_eia", "type": "string", "description": "Particulate matter control identification number. This ID is not a unique identifier." }, { "name": "so2_control_id_eia", "type": "string", "description": "Sulfur dioxide control identification number. This ID is not a unique identifier." }, { "name": "acid_gas_control", "type": "boolean", "description": "Indicates whether the emissions control equipment controls acid (HCl) gas." }, { "name": "emission_control_equipment_cost", "type": "number", "description": "The total cost to install a piece of emission control equipment.", "unit": "USD" }, { "name": "emission_control_operating_date", "type": "date", "description": "The date a piece of emissions control equipment began operating. Derived from month and year columns in the raw data." }, { "name": "emission_control_retirement_date", "type": "date", "description": "The expected or actual retirement date for a piece of emissions control equipment. Derived from month and year columns in the raw data." } ], "primaryKey": [ "report_date", "plant_id_eia", "emission_control_id_pudl" ], "foreignKeys": [ { "fields": [ "emission_control_equipment_type_code" ], "reference": { "resource": "core_eia__codes_emission_control_equipment_types", "fields": [ "code" ] } }, { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 443584, "hash": "sha256:51964beb2c1996c224f90f333f4b55626b40b85e8bb9cf02397dce1fbbf89bf9" }, { "name": "core_eia860__scd_generators", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of generators which may vary from year to year. Compiled from across EIA-860 and EIA-923 data.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for generators are set. It contains values which are expected to vary slowly, while\n:ref:`core_eia__entity_generators` contains those expected to remain fixed.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia860__scd_generators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "ownership_code", "type": "string", "description": "Identifies the ownership for each generator." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "summer_capacity_estimate", "type": "boolean", "description": "Whether the summer capacity value was an estimate" }, { "name": "winter_capacity_mw", "type": "number", "description": "The net winter capacity.", "unit": "MW" }, { "name": "winter_capacity_estimate", "type": "boolean", "description": "Whether the winter capacity value was an estimate" }, { "name": "net_capacity_mwdc", "type": "number", "description": "Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.", "unit": "MW" }, { "name": "energy_storage_capacity_mwh", "type": "number", "description": "Energy storage capacity in MWh (e.g. for batteries).", "unit": "MWh" }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "energy_source_code_2", "type": "string", "description": "The code representing the second most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_3", "type": "string", "description": "The code representing the third most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_4", "type": "string", "description": "The code representing the fourth most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_5", "type": "string", "description": "The code representing the fifth most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_6", "type": "string", "description": "The code representing the sixth most predominant type of energy that fuels the generator" }, { "name": "energy_source_1_transport_1", "type": "string", "description": "Primary mode of transport for energy source 1." }, { "name": "energy_source_1_transport_2", "type": "string", "description": "Secondary mode of transport for energy source 1." }, { "name": "energy_source_1_transport_3", "type": "string", "description": "Tertiary mode of transport for energy source 1." }, { "name": "energy_source_2_transport_1", "type": "string", "description": "Primary mode of transport for energy source 2." }, { "name": "energy_source_2_transport_2", "type": "string", "description": "Secondary mode of transport for energy source 2." }, { "name": "energy_source_2_transport_3", "type": "string", "description": "Tertiary mode of transport for energy source 2." }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "can_burn_multiple_fuels", "type": "boolean", "description": "Whether the generator can burn multiple fuels." }, { "name": "deliver_power_transgrid", "type": "boolean", "description": "Indicate whether the generator can deliver power to the transmission grid." }, { "name": "distributed_generation", "type": "boolean", "description": "Whether the generator is considered distributed generation" }, { "name": "synchronized_transmission_grid", "type": "boolean", "description": "Indicates whether standby generators (SB status) can be synchronized to the grid." }, { "name": "turbines_num", "type": "integer", "description": "Number of wind turbines, or hydrokinetic buoys." }, { "name": "planned_modifications", "type": "boolean", "description": "Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years." }, { "name": "planned_net_summer_capacity_uprate_mw", "type": "number", "description": "Increase in summer capacity expected to be realized from the modification to the equipment.", "unit": "MW" }, { "name": "planned_net_winter_capacity_uprate_mw", "type": "number", "description": "Increase in winter capacity expected to be realized from the uprate modification to the equipment.", "unit": "MW" }, { "name": "planned_uprate_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the uprate modification." }, { "name": "planned_net_summer_capacity_derate_mw", "type": "number", "description": "Decrease in summer capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_net_winter_capacity_derate_mw", "type": "number", "description": "Decrease in winter capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_derate_date", "type": "date", "description": "Planned effective month that the generator is scheduled to enter operation after the derate modification." }, { "name": "planned_new_prime_mover_code", "type": "string", "description": "New prime mover for the planned repowered generator." }, { "name": "planned_energy_source_code_1", "type": "string", "description": "New energy source code for the planned repowered generator." }, { "name": "planned_repower_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the repowering is complete." }, { "name": "other_planned_modifications", "type": "boolean", "description": "Indicates whether there are there other modifications planned for the generator." }, { "name": "other_modifications_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete." }, { "name": "planned_generator_retirement_date", "type": "date", "description": "Planned effective date of the scheduled retirement of the generator." }, { "name": "carbon_capture", "type": "boolean", "description": "Indicates whether the generator uses carbon capture technology." }, { "name": "startup_source_code_1", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_2", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_3", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_4", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "turbines_inverters_hydrokinetics", "type": "integer", "description": "Number of wind turbines, or hydrokinetic buoys." }, { "name": "time_cold_shutdown_full_load_code", "type": "string", "description": "The minimum amount of time required to bring the unit to full load from shutdown." }, { "name": "planned_new_capacity_mw", "type": "number", "description": "The expected new namplate capacity for the generator.", "unit": "MW" }, { "name": "can_cofire_fuels", "type": "boolean", "description": "Whether the generator can co-fire fuels." }, { "name": "can_switch_oil_gas", "type": "boolean", "description": "Whether the generator can switch between oil and natural gas." }, { "name": "nameplate_power_factor", "type": "number", "description": "The nameplate power factor of the generator." }, { "name": "minimum_load_mw", "type": "number", "description": "The minimum load at which the generator can operate at continuosuly.", "unit": "MW" }, { "name": "uprate_derate_during_year", "type": "boolean", "description": "Was an uprate or derate completed on this generator during the reporting year?" }, { "name": "uprate_derate_completed_date", "type": "date", "description": "The date when the uprate or derate was completed." }, { "name": "current_planned_generator_operating_date", "type": "date", "description": "The most recently updated effective date on which the generator is scheduled to start operation" }, { "name": "summer_estimated_capability_mw", "type": "number", "description": "EIA estimated summer capacity (in MWh).", "unit": "MWh" }, { "name": "winter_estimated_capability_mw", "type": "number", "description": "EIA estimated winter capacity (in MWh).", "unit": "MWh" }, { "name": "generator_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the generator." }, { "name": "owned_by_non_utility", "type": "boolean", "description": "Whether any part of generator is owned by a nonutilty" }, { "name": "reactive_power_output_mvar", "type": "number", "description": "Reactive Power Output (MVAr)", "unit": "MVAr" }, { "name": "ferc_qualifying_facility", "type": "boolean", "description": "Indicates whether or not a generator is a qualifying FERC cogeneration facility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_5" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_6" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "planned_energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_1" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_2" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_3" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_1" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_2" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_3" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "planned_new_prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 9133216, "hash": "sha256:5fd81b33bf8abaa9bc01b5d44c525ef690ddd19b417044e658093b04a22f9644" }, { "name": "core_eia860__scd_generators_energy_storage", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of energy storage which may vary from year to year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes only those values that are unique to energy storage. The rest of the columns that are reported in the EIA-860 Energy Storage tabs are included in :ref:`core_eia860__scd_generators` and :ref:`core_eia__entity_generators`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__scd_generators_energy_storage.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "max_charge_rate_mw", "type": "number", "description": "Maximum charge rate in MW.", "unit": "MW" }, { "name": "max_discharge_rate_mw", "type": "number", "description": "Maximum discharge rate in MW.", "unit": "MW" }, { "name": "storage_enclosure_code", "type": "string", "description": "A code representing the enclosure type that best describes where the generator is located." }, { "name": "storage_technology_code_1", "type": "string", "description": "The electro-chemical storage technology used for this battery applications." }, { "name": "storage_technology_code_2", "type": "string", "description": "The electro-chemical storage technology used for this battery applications." }, { "name": "storage_technology_code_3", "type": "string", "description": "The electro-chemical storage technology used for this battery applications." }, { "name": "storage_technology_code_4", "type": "string", "description": "The electro-chemical storage technology used for this battery applications." }, { "name": "served_arbitrage", "type": "boolean", "description": "Whether the energy storage device served arbitrage applications during the reporting year" }, { "name": "served_backup_power", "type": "boolean", "description": "Whether the energy storage device served backup power applications during the reporting year." }, { "name": "served_co_located_renewable_firming", "type": "boolean", "description": "Whether the energy storage device served renewable firming applications during the reporting year." }, { "name": "served_frequency_regulation", "type": "boolean", "description": "Whether the energy storage device served frequency regulation applications during the reporting year." }, { "name": "served_load_following", "type": "boolean", "description": "Whether the energy storage device served load following applications during the reporting year." }, { "name": "served_load_management", "type": "boolean", "description": "Whether the energy storage device served load management applications during the reporting year." }, { "name": "served_ramping_spinning_reserve", "type": "boolean", "description": "Whether the this energy storage device served ramping / spinning reserve applications during the reporting year." }, { "name": "served_system_peak_shaving", "type": "boolean", "description": "Whether the energy storage device served system peak shaving applications during the reporting year." }, { "name": "served_transmission_and_distribution_deferral", "type": "boolean", "description": "Whether the energy storage device served renewable firming applications during the reporting year." }, { "name": "served_voltage_or_reactive_power_support", "type": "boolean", "description": "Whether the energy storage device served voltage or reactive power support applications during the reporting year." }, { "name": "stored_excess_wind_and_solar_generation", "type": "boolean", "description": "Whether the energy storage device was used to store excess wind/solar generation during the reporting year." }, { "name": "is_ac_coupled", "type": "boolean", "description": "Indicates if this energy storage device is AC-coupled (means the energy storage device and the PV system are not installed on the same side of an inverter)." }, { "name": "is_dc_coupled", "type": "boolean", "description": "Indicates if this energy storage device is DC-coupled (means the energy storage device and the PV system are on the same side of an inverter and the battery can still charge from the grid)." }, { "name": "is_dc_coupled_tightly", "type": "boolean", "description": "Indicates if this energy storage device is DC tightly coupled (means the energy storage device and the PV system are on the same side of an inverter and the battery cannot charge from the grid)." }, { "name": "is_independent", "type": "boolean", "description": "Indicates if this energy storage device is independent (not coupled with another generators)" }, { "name": "is_transmission_and_distribution_asset_support", "type": "boolean", "description": "Indicate if the energy storage system is intended to support a specific substation, transmission or distribution asset." }, { "name": "is_direct_support", "type": "boolean", "description": "Indicates if this energy storage device is intended for dedicated generator firming or storing excess generation of other units." }, { "name": "plant_id_eia_direct_support_1", "type": "integer", "description": "The EIA Plant ID of the primary unit whose generation this energy storage device is intended to firm or store." }, { "name": "generator_id_direct_support_1", "type": "string", "description": "The EIA Generator ID of the primary unit whose generation this energy storage device is intended to firm or store." }, { "name": "plant_id_eia_direct_support_2", "type": "integer", "description": "The EIA Plant ID of the secondary unit whose generation this energy storage device is intended to firm or store." }, { "name": "generator_id_direct_support_2", "type": "string", "description": "The EIA Generator ID of the secondary unit whose generation this energy storage device is intended to firm or store." }, { "name": "plant_id_eia_direct_support_3", "type": "integer", "description": "The EIA Plant ID of the tertiary unit whose generation this energy storage device is intended to firm or store." }, { "name": "generator_id_direct_support_3", "type": "string", "description": "The EIA Generator ID of the tertiary unit whose generation this energy storage device is intended to firm or store." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "plant_id_eia_direct_support_1", "generator_id_direct_support_1" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "plant_id_eia_direct_support_2", "generator_id_direct_support_2" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "plant_id_eia_direct_support_3", "generator_id_direct_support_3" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "storage_enclosure_code" ], "reference": { "resource": "core_eia__codes_storage_enclosure_types", "fields": [ "code" ] } }, { "fields": [ "storage_technology_code_1" ], "reference": { "resource": "core_eia__codes_storage_technology_types", "fields": [ "code" ] } }, { "fields": [ "storage_technology_code_2" ], "reference": { "resource": "core_eia__codes_storage_technology_types", "fields": [ "code" ] } }, { "fields": [ "storage_technology_code_3" ], "reference": { "resource": "core_eia__codes_storage_technology_types", "fields": [ "code" ] } }, { "fields": [ "storage_technology_code_4" ], "reference": { "resource": "core_eia__codes_storage_technology_types", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 83847, "hash": "sha256:acc8438dc51dc28afb721e46998dd41725c416bcf4bd355b9298ba35ca9b9b41" }, { "name": "core_eia860__scd_generators_multifuel", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of generators that may vary from year to year, pertaining to fuel-switching and the use of multiple fuels.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 3)\n\nPrimary key:\n report_date, utility_id_eia, generator_id, plant_id_eia", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__scd_generators_multifuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "sector_name_eia", "type": "string", "description": "EIA assigned sector name, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "sector_id_eia", "type": "integer", "description": "EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "winter_capacity_mw", "type": "number", "description": "The net winter capacity.", "unit": "MW" }, { "name": "current_planned_generator_operating_date", "type": "date", "description": "The most recently updated effective date on which the generator is scheduled to start operation" }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "energy_source_code_2", "type": "string", "description": "The code representing the second most predominant type of energy that fuels the generator" }, { "name": "can_burn_multiple_fuels", "type": "boolean", "description": "Whether the generator can burn multiple fuels." }, { "name": "can_cofire_fuels", "type": "boolean", "description": "Whether the generator can co-fire fuels." }, { "name": "cofire_energy_source_1", "type": "string", "description": "The codes representing the type of fuel that will be co-fired." }, { "name": "cofire_energy_source_2", "type": "string", "description": "The codes representing the type of fuel that will be co-fired." }, { "name": "cofire_energy_source_3", "type": "string", "description": "The codes representing the type of fuel that will be co-fired." }, { "name": "cofire_energy_source_4", "type": "string", "description": "The codes representing the type of fuel that will be co-fired." }, { "name": "cofire_energy_source_5", "type": "string", "description": "The codes representing the type of fuel that will be co-fired." }, { "name": "cofire_energy_source_6", "type": "string", "description": "The codes representing the type of fuel that will be co-fired." }, { "name": "can_switch_oil_gas", "type": "boolean", "description": "Whether the generator can switch between oil and natural gas." }, { "name": "time_to_switch_oil_to_gas", "type": "string", "description": "The time required to switch the generator from running 100 percent oil to running 100 percent natural gas." }, { "name": "time_to_switch_gas_to_oil", "type": "string", "description": "The time required to switch the generator from running 100 percent natural gas to running 100 percent oil." }, { "name": "can_switch_when_operating", "type": "boolean", "description": "Indicates whether a fuel switching generator can switch fuels while operating." }, { "name": "net_summer_capacity_natural_gas_mw", "type": "number", "description": "The maximum net summer output achievable when running on natural gas.", "unit": "MW" }, { "name": "net_summer_capacity_oil_mw", "type": "number", "description": "The maximum net summer output achievable when running on oil.", "unit": "MW" }, { "name": "net_winter_capacity_natural_gas_mw", "type": "number", "description": "The maximum net winter output achievable when running on natural gas.", "unit": "MW" }, { "name": "net_winter_capacity_oil_mw", "type": "number", "description": "The maximum net summer output achievable when running on oil.", "unit": "MW" }, { "name": "has_factors_that_limit_switching", "type": "boolean", "description": "Whether there are factors that limit the generator's ability to switch between oil and natural gas." }, { "name": "has_storage_limits", "type": "boolean", "description": "Whether limited on-site fuel storage is a factor that limits the generator's ability to switch between oil and natural gas." }, { "name": "has_air_permit_limits", "type": "boolean", "description": "Whether air permit limits are a factor that limits the generator's ability to switch between oil and natural gas." }, { "name": "has_other_factors_that_limit_switching", "type": "boolean", "description": "Whether there are factors other than air permit limits and storage that limit the generator's ability to switch between oil and natural gas." }, { "name": "can_cofire_oil_and_gas", "type": "boolean", "description": "Whether the generator can co-fire oil and gas." }, { "name": "can_cofire_100_oil", "type": "boolean", "description": "Whether the generator can co-fire 100 oil." }, { "name": "max_oil_heat_input", "type": "number", "description": "The maximum oil heat input (percent of MMBTUs) expected for proposed unit when co-firing with natural gas", "unit": "% MMBTU" }, { "name": "max_oil_output_mw", "type": "number", "description": "The maximum output (net MW) expected for proposed unit, when making the maximum use of oil and co-firing natural gas.", "unit": "MW" }, { "name": "can_fuel_switch", "type": "boolean", "description": "Whether a unit is able to switch fuels." }, { "name": "has_regulatory_limits", "type": "boolean", "description": "Whether there are factors that limit the operation of the generator when running on 100 percent oil" }, { "name": "fuel_switch_energy_source_1", "type": "string", "description": "The codes representing the type of fuel that will be able to be used as a sole source of fuel for this unit." }, { "name": "fuel_switch_energy_source_2", "type": "string", "description": "The codes representing the type of fuel that will be able to be used as a sole source of fuel for this unit." }, { "name": "fuel_switch_energy_source_3", "type": "string", "description": "The codes representing the type of fuel that will be able to be used as a sole source of fuel for this unit." }, { "name": "fuel_switch_energy_source_4", "type": "string", "description": "The codes representing the type of fuel that will be able to be used as a sole source of fuel for this unit." }, { "name": "fuel_switch_energy_source_5", "type": "string", "description": "The codes representing the type of fuel that will be able to be used as a sole source of fuel for this unit." }, { "name": "fuel_switch_energy_source_6", "type": "string", "description": "The codes representing the type of fuel that will be able to be used as a sole source of fuel for this unit." } ], "primaryKey": [ "report_date", "utility_id_eia", "generator_id", "plant_id_eia" ], "foreignKeys": [ { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "sector_id_eia" ], "reference": { "resource": "core_eia__codes_sector_consolidated", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1205526, "hash": "sha256:d71a083eb00aa85f17deeb2ee7e89d290e303a15058cd9b1773c798033dc6569" }, { "name": "core_eia860__scd_generators_solar", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of solar generators that may vary from year to year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 3.3)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes only those values that are unique to solar generators. The rest of the columns that are reported in the EIA-860 Solar tabs are included in :ref:`core_eia860__scd_generators` and :ref:`core_eia__entity_generators`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__scd_generators_solar.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "standard_testing_conditions_capacity_mwdc", "type": "number", "description": "The net capacity of this photovoltaic generator in direct current under standard test conditions (STC) of 1000 W/m^2 solar irradiance and 25 degrees Celsius PV module temperature. This was only reported in 2013 and 2014.", "unit": "MW" }, { "name": "net_metering_capacity_mwdc", "type": "number", "description": "The DC megawatt capacity that is part of a net metering agreement.", "unit": "MW" }, { "name": "uses_net_metering_agreement", "type": "boolean", "description": "Indicates if the output from this generator is part of a net metering agreement." }, { "name": "uses_virtual_net_metering_agreement", "type": "boolean", "description": "Indicates if the output from this generator is part of a virtual net metering agreement." }, { "name": "virtual_net_metering_capacity_mwdc", "type": "number", "description": "The DC capacity in MW that is part of a virtual net metering agreement.", "unit": "MW" }, { "name": "azimuth_angle_deg", "type": "number", "description": "Indicates the azimuth angle of the unit for fixed tilt or single-axis technologies.", "unit": "deg" }, { "name": "tilt_angle_deg", "type": "number", "description": "Indicates the tilt angle of the unit for fixed tilt or single-axis technologies.", "unit": "deg" }, { "name": "uses_technology_lenses_mirrors", "type": "boolean", "description": "Indicates whether lenses or mirrors are used at this solar generating unit." }, { "name": "uses_technology_single_axis_tracking", "type": "boolean", "description": "Indicates whether single-axis tracking technologies are used at this solar generating unit." }, { "name": "uses_technology_dual_axis_tracking", "type": "boolean", "description": "Indicates whether dual-axis tracking technologies are used at this solar generating unit." }, { "name": "uses_technology_fixed_tilt", "type": "boolean", "description": "Indicates whether fixed tilt technologies are used at this solar generating unit." }, { "name": "uses_technology_east_west_fixed_tilt", "type": "boolean", "description": "Indicates whether east west fixed tilt technologies are used at this solar generating unit." }, { "name": "uses_technology_parabolic_trough", "type": "boolean", "description": "Indicates whether parabolic trough technologies s are used at this solar generating unit." }, { "name": "uses_technology_linear_fresnel", "type": "boolean", "description": "Indicates whether linear fresnel technologies are used at this solar generating unit." }, { "name": "uses_technology_power_tower", "type": "boolean", "description": "Indicates whether power towers are used at this solar generating unit." }, { "name": "uses_technology_dish_engine", "type": "boolean", "description": "Indicates whether dish engines are used at this solar generating unit." }, { "name": "uses_technology_other", "type": "boolean", "description": "Indicates whether other solar technologies are used at this solar generating unit." }, { "name": "uses_material_crystalline_silicon", "type": "boolean", "description": "Indicates whether any solar photovoltaic panels at this generator are made of crystalline silicon." }, { "name": "uses_material_thin_film_a_si", "type": "boolean", "description": "Indicates whether any solar photovoltaic panels at this generator are made of thin-film amorphous silicon (A-Si)." }, { "name": "uses_material_thin_film_cdte", "type": "boolean", "description": "Indicates whether any solar photovoltaic panels at this generator are made of thin-film cadmium telluride (CdTe)." }, { "name": "uses_material_thin_film_cigs", "type": "boolean", "description": "Indicates whether any solar photovoltaic panels at this generator are made of thin-film copper indium gallium diselenide (CIGS)." }, { "name": "uses_material_thin_film_other", "type": "boolean", "description": "Indicates whether any solar photovoltaic panels at this generator are made of other thin-film material." }, { "name": "uses_material_other", "type": "boolean", "description": "Indicates whether any solar photovoltaic panels at this generator are made of other materials." }, { "name": "uses_bifacial_panels", "type": "boolean", "description": "Indicates whether bifacial solar panels are used at this solar generating unit." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 309686, "hash": "sha256:148bb21a75e6a5c0b6fd58b71da1749a94e1866243a8f680f3e9ec58ca3441c8" }, { "name": "core_eia860__scd_generators_wind", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of wind generators that may vary from year to year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 3.2)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes only those values that are unique to wind generators. The rest of the columns that are reported in the EIA-860 Wind tabs are included in :ref:`core_eia860__scd_generators` and :ref:`core_eia__entity_generators`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__scd_generators_wind.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "design_wind_speed_mph", "type": "number", "description": "Average annual wind speed that turbines at this wind site were designed for." }, { "name": "obstacle_id_faa", "type": "string", "description": "The Federal Aviation Administration (FAA) obstacle number assigned to this generator. If more than one obstacle number exists, the one that best represents the turbines. References the obstacle numbers reported in the FAA's Digital Obstacle File: https://www.faa.gov/air_traffic/flight_info/aeronav/digital_products/dof/ This field was only reported from 2013 through 2015." }, { "name": "predominant_turbine_manufacturer", "type": "string", "description": "Name of predominant manufacturer of turbines at this generator." }, { "name": "predominant_turbine_model", "type": "string", "description": "Predominant model number of turbines at this generator." }, { "name": "turbine_hub_height_feet", "type": "number", "description": "The hub height of turbines at this generator. If more than one value exists, the one that best represents the turbines.", "unit": "ft" }, { "name": "wind_quality_class", "type": "integer", "description": "The wind quality class for turbines at this generator. See table core_eia__codes_wind_quality_class for specifications about each class.", "constraints": { "minimum": 1, "maximum": 4 } } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "wind_quality_class" ], "reference": { "resource": "core_eia__codes_wind_quality_class", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 107282, "hash": "sha256:70ab8364705000fe78555a7c5e135865eb2ce08d1234e467badd028b1ccfdeb2" }, { "name": "core_eia860__scd_ownership", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of generator ownership. Includes only jointly or third-party owned generators.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 4)\n\nPrimary key:\n report_date, plant_id_eia, generator_id, owner_utility_id_eia", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860__scd_ownership.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "owner_utility_id_eia", "type": "integer", "description": "The EIA utility Identification number for the owner company that is responsible for the day-to-day operations of the generator, not the operator utility.", "constraints": { "required": true } }, { "name": "operator_utility_id_eia", "type": "integer", "description": "The EIA utility Identification number for the operator utility." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "owner_utility_name_eia", "type": "string", "description": "The name of the EIA owner utility." }, { "name": "owner_state", "type": "string", "description": "Two letter ISO-3166 political subdivision code.", "constraints": { "enum": [ "NS", "SC", "VI", "WA", "IA", "ND", "HI", "DE", "SD", "ON", "GU", "AS", "MT", "CO", "NB", "VA", "NC", "AL", "AR", "BC", "MB", "NH", "VT", "NJ", "OR", "LA", "NY", "IL", "RI", "FL", "ME", "NU", "WY", "MI", "AB", "MO", "NV", "PR", "MN", "NL", "PA", "GA", "DC", "TN", "WI", "OH", "WV", "MA", "TX", "SK", "AK", "AZ", "QC", "UT", "YT", "CA", "KS", "MD", "CT", "NM", "MS", "MP", "PE", "OK", "IN", "NE", "NT", "KY", "ID" ] } }, { "name": "owner_city", "type": "string", "description": "City of owner." }, { "name": "owner_country", "type": "string", "description": "Three letter ISO-3166 country code.", "constraints": { "enum": [ "USA", "CAN" ] } }, { "name": "owner_street_address", "type": "string", "description": "Steet address of owner." }, { "name": "owner_zip_code", "type": "string", "description": "Zip code of owner.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id", "owner_utility_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "owner_utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 498606, "hash": "sha256:d91b6333e010cd97d11b2fd813207727d64afbe6d8138207cbb6b9b8a86d8ca9" }, { "name": "core_eia860__scd_plants", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of plants which may vary from year to year. Compiled from across all EIA-860 and EIA-923 data.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n plant_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for plants are set. It contains values which are expected to vary slowly, while\n:ref:`core_eia__entity_plants` contains those expected to remain fixed.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia860__scd_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "ash_impoundment", "type": "boolean", "description": "Is there an ash impoundment (e.g. pond, reservoir) at the plant?" }, { "name": "ash_impoundment_lined", "type": "boolean", "description": "If there is an ash impoundment at the plant, is the impoundment lined?" }, { "name": "ash_impoundment_status", "type": "string", "description": "If there is an ash impoundment at the plant, the ash impoundment status as of December 31 of the reporting year." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "datum", "type": "string", "description": "Geodetic coordinate system identifier (e.g. NAD27, NAD83, or WGS84)." }, { "name": "energy_storage", "type": "boolean", "description": "Indicates if the facility has energy storage capabilities." }, { "name": "ferc_cogen_docket_no", "type": "string", "description": "The docket number relating to the FERC cogenerator status. See FERC Form 556." }, { "name": "ferc_cogen_status", "type": "boolean", "description": "Indicates whether the plant has FERC qualifying facility cogenerator status. See FERC Form 556." }, { "name": "ferc_exempt_wholesale_generator_docket_no", "type": "string", "description": "The docket number relating to the FERC qualifying facility exempt wholesale generator status." }, { "name": "ferc_exempt_wholesale_generator", "type": "boolean", "description": "Indicates whether the plant has FERC qualifying facility exempt wholesale generator status" }, { "name": "ferc_small_power_producer_docket_no", "type": "string", "description": "The docket number relating to the FERC qualifying facility small power producer status. See FERC Form 556." }, { "name": "ferc_small_power_producer", "type": "boolean", "description": "Indicates whether the plant has FERC qualifying facility small power producer status. See FERC Form 556." }, { "name": "ferc_qualifying_facility_docket_no", "type": "string", "description": "The docket number relating to the FERC qualifying facility cogenerator status. See FERC Form 556." }, { "name": "grid_voltage_1_kv", "type": "number", "description": "Plant's grid voltage at point of interconnection to transmission or distribution facilities", "unit": "kV" }, { "name": "grid_voltage_2_kv", "type": "number", "description": "Plant's grid voltage at point of interconnection to transmission or distribution facilities", "unit": "kV" }, { "name": "grid_voltage_3_kv", "type": "number", "description": "Plant's grid voltage at point of interconnection to transmission or distribution facilities", "unit": "kV" }, { "name": "iso_rto_code", "type": "string", "description": "The code of the plant's ISO or RTO. NA if not reported in that year." }, { "name": "liquefied_natural_gas_storage", "type": "boolean", "description": "Indicates if the facility have the capability to store the natural gas in the form of liquefied natural gas." }, { "name": "natural_gas_local_distribution_company", "type": "string", "description": "Names of Local Distribution Company (LDC), connected to natural gas burning power plants." }, { "name": "natural_gas_storage", "type": "boolean", "description": "Indicates if the facility have on-site storage of natural gas." }, { "name": "natural_gas_pipeline_name_1", "type": "string", "description": "The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility." }, { "name": "natural_gas_pipeline_name_2", "type": "string", "description": "The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility." }, { "name": "natural_gas_pipeline_name_3", "type": "string", "description": "The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility." }, { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "has_net_metering", "type": "boolean", "description": "Whether the plant has a net metering agreement in effect during the reporting year. (Only displayed for facilities that report the sun or wind as an energy source). This field was only reported up until 2015" }, { "name": "pipeline_notes", "type": "string", "description": "Additional owner or operator of natural gas pipeline." }, { "name": "primary_purpose_id_naics", "type": "integer", "description": "North American Industry Classification System (NAICS) code that best describes the primary purpose of the reporting plant" }, { "name": "regulatory_status_code", "type": "string", "description": "Indicates whether the plant is regulated or non-regulated." }, { "name": "reporting_frequency_code", "type": "string", "description": "Code that specifies what time period data has to be reported (i.e. monthly data or annual totals) and how often the power plant reports this data to EIA. See reporting_frequencies_eia for more details.", "constraints": { "enum": [ "A", "AM", "M" ] } }, { "name": "sector_id_eia", "type": "integer", "description": "EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "sector_name_eia", "type": "string", "description": "EIA assigned sector name, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "service_area", "type": "string", "description": "Service area in which plant is located; for unregulated companies, it's the electric utility with which plant is interconnected" }, { "name": "transmission_distribution_owner_id", "type": "integer", "description": "EIA-assigned code for owner of transmission/distribution system to which the plant is interconnected." }, { "name": "transmission_distribution_owner_name", "type": "string", "description": "Name of the owner of the transmission or distribution system to which the plant is interconnected." }, { "name": "transmission_distribution_owner_state", "type": "string", "description": "State location for owner of transmission/distribution system to which the plant is interconnected." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "water_source", "type": "string", "description": "Name of water source associated with the plant." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "reporting_frequency_code" ], "reference": { "resource": "core_eia__codes_reporting_frequencies", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "sector_id_eia" ], "reference": { "resource": "core_eia__codes_sector_consolidated", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3168543, "hash": "sha256:1dc37cf322e5ffad004f3db4e3a5cb59343ad9f816e332244c8c29ed131f1f21" }, { "name": "core_eia860__scd_utilities", "type": "table", "description": "Slowly changing dimension (SCD) table describing attributes of utilities which may vary from year to year. Compiled from all EIA data.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n utility_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for utilities are set. It contains values which are expected to vary slowly, while\n:ref:`core_eia__entity_utilities` contains those expected to remain fixed.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia860__scd_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "plants_reported_owner", "type": "boolean", "description": "Is the reporting entity an owner of power plants reported on Schedule 2 of the form?" }, { "name": "plants_reported_operator", "type": "boolean", "description": "Is the reporting entity an operator of power plants reported on Schedule 2 of the form?" }, { "name": "plants_reported_asset_manager", "type": "boolean", "description": "Is the reporting entity an asset manager of power plants reported on Schedule 2 of the form?" }, { "name": "plants_reported_other_relationship", "type": "boolean", "description": "Does the reporting entity have any other relationship to the power plants reported on Schedule 2 of the form?" }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "attention_line", "type": "string", "description": "Mail attention name of the operator/owner." }, { "name": "address_2", "type": "string", "description": "Second line of the address." }, { "name": "zip_code_4", "type": "string", "description": "Four digit US Zip Code suffix.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "contact_firstname", "type": "string", "description": "First name of utility contact 1." }, { "name": "contact_lastname", "type": "string", "description": "Last name of utility contact 1." }, { "name": "contact_title", "type": "string", "description": "Title of of utility contact 1." }, { "name": "phone_number", "type": "string", "description": "Phone number for utility contact 1." }, { "name": "phone_extension", "type": "string", "description": "Phone extension for utility contact 1" }, { "name": "contact_firstname_2", "type": "string", "description": "First name of utility contact 2." }, { "name": "contact_lastname_2", "type": "string", "description": "Last name of utility contact 2." }, { "name": "contact_title_2", "type": "string", "description": "Title of utility contact 2." }, { "name": "phone_number_2", "type": "string", "description": "Phone number for utility contact 2." }, { "name": "phone_extension_2", "type": "string", "description": "Phone extension for utility contact 2" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2263819, "hash": "sha256:0d13a1edd6363251aedb61bc362c27d9982312b3a504bc21780a90c40eb9fd65" }, { "name": "core_eia860m__changelog_generators", "type": "table", "description": "Changelog table tracking changes in generator characteristics reported in EIA-860M.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 860M -- Monthly Update to the Annual Electric Generator Report\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nEIA-860M includes\ngenerator tables with the most up-to-date catalog of EIA generators and their\noperational status and other generator characteristics. EIA-860M is reported monthly,\nalthough for the vast majority of the generators nothing changes month-to-month. This\ntable is a changelog of that monthly reported generator data. There is a record\ncorresponding to the first instance of a generator and associated characteristics with a\nreport_date column and a valid_until_date column. Whenever any of the reported EIA-860M\ndata was changed for a record, there will be a new changelog record with a new\nreport_date.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia860m__changelog_generators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "valid_until_date", "type": "date", "description": "The record in the changelog is valid until this date. The record is valid from the report_date up until but not including the valid_until_date." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "county", "type": "string", "description": "County name." }, { "name": "current_planned_generator_operating_date", "type": "date", "description": "The most recently updated effective date on which the generator is scheduled to start operation" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "energy_storage_capacity_mwh", "type": "number", "description": "Energy storage capacity in MWh (e.g. for batteries).", "unit": "MWh" }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "generator_operating_date", "type": "date", "description": "Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date." }, { "name": "generator_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the generator." }, { "name": "latitude", "type": "number", "description": "Latitude of the plant's location, in degrees." }, { "name": "longitude", "type": "number", "description": "Longitude of the plant's location, in degrees." }, { "name": "net_capacity_mwdc", "type": "number", "description": "Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.", "unit": "MW" }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "planned_derate_date", "type": "date", "description": "Planned effective month that the generator is scheduled to enter operation after the derate modification." }, { "name": "planned_generator_retirement_date", "type": "date", "description": "Planned effective date of the scheduled retirement of the generator." }, { "name": "planned_net_summer_capacity_derate_mw", "type": "number", "description": "Decrease in summer capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_net_summer_capacity_uprate_mw", "type": "number", "description": "Increase in summer capacity expected to be realized from the modification to the equipment.", "unit": "MW" }, { "name": "planned_uprate_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the uprate modification." }, { "name": "planned_repower_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the repowering is complete." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "sector_id_eia", "type": "integer", "description": "EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "winter_capacity_mw", "type": "number", "description": "The net winter capacity.", "unit": "MW" } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "sector_id_eia" ], "reference": { "resource": "core_eia__codes_sector_consolidated", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3202102, "hash": "sha256:ce56ce42bb3d2b2db28450f1d26b96556df9978a6da4efba97e9cfca6aa5115e" }, { "name": "core_eia861__assn_balancing_authority", "type": "table", "description": "Association table providing connections between state, balancing authority, and utility in a given year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n report_date, balancing_authority_id_eia, utility_id_eia, state", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__assn_balancing_authority.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "balancing_authority_id_eia", "type": "integer", "description": "EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } } ], "primaryKey": [ "report_date", "balancing_authority_id_eia", "utility_id_eia", "state" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 234639, "hash": "sha256:d3ba00bed27fc849578effcee80e36e15b41d6b6604a7f57a9cabbbd729b10cf" }, { "name": "core_eia861__assn_utility", "type": "table", "description": "Association table providing connections between utility and state in a given year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n report_date, utility_id_eia, state", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__assn_utility.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } } ], "primaryKey": [ "report_date", "utility_id_eia", "state" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 237887, "hash": "sha256:e34ef698e5c4f4d7d6c3c01a1aa2eb9c28cd5982687200fd7a8ec6ca2cf25244" }, { "name": "core_eia861__yearly_advanced_metering_infrastructure", "type": "table", "description": "Annual time series of advanced metering infrastructure (AMI) and automated meter reading (AMR) by state, sector, and balancing authority.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n balancing_authority_code_eia, customer_class, report_date, state, utility_id_eia\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe energy served (in MWH) for AMI systems is provided. Form EIA-861 respondents also report the number\nof standard meters (non AMR/AMI) in their system. Historical Changes: We started collecting the number of standard meters in 2013. The monthly survey collected\nthese data from January 2011 to January 2017.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_advanced_metering_infrastructure.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "advanced_metering_infrastructure", "type": "integer", "description": "Number of meters that measure and record usage data at a minimum, in hourly intervals and provide usage data at least daily to energy companies and may also provide data to consumers. Data are used for billing and other purposes. Advanced meters include basic hourly interval meters and extend to real-time meters with built-in two-way communication capable of recording and transmitting instantaneous data." }, { "name": "automated_meter_reading", "type": "integer", "description": "Number of meters that collect data for billing purposes only and transmit this data one way, usually from the customer to the distribution utility." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "required": true, "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "daily_digital_access_customers", "type": "integer", "description": "Number of customers able to access daily energy usage through a webportal or other electronic means." }, { "name": "direct_load_control_customers", "type": "integer", "description": "Number of customers with direct load control: a A demand response activity by which the program sponsor remotely shuts down or cycles a customer\u2019s electrical equipment (e.g. air conditioner, water heater) on short notice." }, { "name": "energy_served_ami_mwh", "type": "number", "description": "Amount of energy served through AMI meters. AMI meters can transmit data in both directions, between the delivery entity and the customer.", "unit": "MWh" }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "home_area_network", "type": "integer", "description": "Number of AMI meters with home area network (HAN) gateway enabled." }, { "name": "non_amr_ami", "type": "integer", "description": "Number of non-AMR/AMI meters. Usually electromechanical or solid state meters measuring aggregated kWh where data are manually retrieved over monthly billing cycles for billing purposes only. Standard meters may also include functions to measure time-of-use and/or demand with data manually retrieved over monthly billing cycles." }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "balancing_authority_code_eia", "customer_class", "report_date", "state", "utility_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1375902, "hash": "sha256:10ca00f82536f204afaaa836efca7847c5d4cf00fde206b3615984d87d83b7d4" }, { "name": "core_eia861__yearly_balancing_authority", "type": "table", "description": "Annual time series of balancing authorities.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n report_date, balancing_authority_id_eia", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_balancing_authority.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "balancing_authority_id_eia", "type": "integer", "description": "EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." } ], "primaryKey": [ "report_date", "balancing_authority_id_eia" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 17316, "hash": "sha256:bfc894dff149e6c7c2921163d86b53c55327a8c54a65fb010da6fc63f0fc3b55" }, { "name": "core_eia861__yearly_demand_response", "type": "table", "description": "Annual time series of demand response programs by state, sector, and balancing authority.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n balancing_authority_code_eia, customer_class, report_date, state, utility_id_eia\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe EIA861 demand-side management (DSM) table (split into three normalized tables in\nPUDL) contain data through 2012. The form changed in 2013 and split the contents of the\nDSM table into energy efficiency and demand response tables. Though similar, the\ninformation collected before and after 2012 are not comparable enough to combine into a\nsingular, continuous table. We were discouraged from doing so after contacting a\nrepresentative from EIA.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_demand_response.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "actual_peak_demand_savings_mw", "type": "number", "description": "Demand reduction actually achieved by demand response activities. Measured at the time of the company's annual system peak hour.", "unit": "MW" }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "required": true, "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "customer_incentives_cost", "type": "number", "description": "Total cost of customer incentives in a given report year. Customer incentives are the total financial value provided to a customer for program participation, whether, for example, cash payment, or lowered tariff rates relative to non-participants, in-kind services (e.g. design work), or other benefits directly provided to the customer for their program participation.", "unit": "USD" }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "energy_savings_mwh", "type": "number", "description": "The energy savings incurred in a given reporting year by participation in demand response programs.", "unit": "MWh" }, { "name": "other_costs", "type": "number", "description": "Additional costs.", "unit": "USD" }, { "name": "potential_peak_demand_savings_mw", "type": "number", "description": "The total demand savings that could occur at the time of the system peak hour assuming all demand response is called.", "unit": "MW" }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "balancing_authority_code_eia", "customer_class", "report_date", "state", "utility_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 208614, "hash": "sha256:e80e524ac2d08b03f8f3faf929fc0f53d0c5e9ec9b631492230f185f1a0236b0" }, { "name": "core_eia861__yearly_demand_response_water_heater", "type": "table", "description": "Annual time series of grid-connected water heaters enrolled in demand response programs.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n balancing_authority_code_eia, report_date, state, utility_id_eia", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_demand_response_water_heater.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "num_water_heaters", "type": "integer", "description": "The number of grid-enabled water heaters added to the respondent's program this year - if the respondent has DSM program for grid-enabled water heaters (as defined by DOE\u2019s Office of Energy Efficiency and Renewable Energy)." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "balancing_authority_code_eia", "report_date", "state", "utility_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 23903, "hash": "sha256:15e4588b29c03a302d7e3ecdc333f13a86af4ee61149fbd7883b6e639a267aad" }, { "name": "core_eia861__yearly_demand_side_management_ee_dr", "type": "table", "description": "Annual time series of The impact of energy efficiency and load management programs on total energy sold (MWh) and peak demand (MW) by customer class.\n\n\nMost-recent data:\n 2012\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe raw EIA861 demand-side management (DSM) table (split into three normalized tables in\nPUDL) contain data through 2012. The form changed in 2013 and split the contents of the\nDSM table into energy efficiency and demand response tables. Though similar, the\ninformation collected before and after 2012 are not comparable enough to combine into a\nsingular, continuous table. We were discouraged from doing so after contacting a\nrepresentative from EIA.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_demand_side_management_ee_dr.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "annual_indirect_program_cost", "type": "number", "description": "Costs that have not been included in any program category, but could be meaningfully identified with operating the company\u2019s DSM programs (e.g., Administrative, Marketing, Monitoring & Evaluation, Company-Earned Incentives, Other).", "unit": "USD" }, { "name": "annual_total_cost", "type": "number", "description": "The sum of direct program costs, indirect program costs, and incentive payments associated with utility demand side management programs.", "unit": "USD" }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "energy_efficiency_annual_actual_peak_reduction_mw", "type": "number", "description": "The peak reduction incurred in a given reporting year by all participants in efficiency programs.", "unit": "MW" }, { "name": "energy_efficiency_annual_direct_cost", "type": "number", "description": "The sum of actual direct costs (excluding incentive payments) incurred from energy efficiency programs in a given reporting year.", "unit": "USD" }, { "name": "energy_efficiency_annual_effects_mwh", "type": "number", "description": "The change in energy use incurred in a given reporting year by all participants in energy efficiency programs.", "unit": "MWh" }, { "name": "energy_efficiency_annual_incentive_cost", "type": "number", "description": "The cost of incentive payments incurred in a given reporting year from energy efficiency programs. Incentives are the total financial value provided to a customer for program participation, whether cash payment, in-kind services (e.g. design work), or other benefits directly provided customer for their program participation.", "unit": "USD" }, { "name": "energy_efficiency_incremental_actual_peak_reduction_mw", "type": "number", "description": "The peak reduction incurred in a given reporting year by new participants in existing energy efficiency programs and all participants in new energy efficiency programs.", "unit": "MW" }, { "name": "energy_efficiency_incremental_effects_mwh", "type": "number", "description": "The change in energy use incurred in a given reporting year by new participants in existing energy efficiency programs and all participants in new energy efficiency programs.", "unit": "MWh" }, { "name": "load_management_annual_actual_peak_reduction_mw", "type": "number", "description": "The peak reduction incurred in a given reporting year by all participants in load management programs.", "unit": "MW" }, { "name": "load_management_annual_direct_cost", "type": "number", "description": "The sum of actual direct costs (excluding incentive payments) incurred from load management programs in a given reporting year.", "unit": "USD" }, { "name": "load_management_annual_effects_mwh", "type": "number", "description": "The change in energy use incurred in a given reporting year by all participants in load management programs.", "unit": "MWh" }, { "name": "load_management_annual_incentive_cost", "type": "number", "description": "The cost of incentive payments incurred in a given reporting year from load management programs. Incentives are the total financial value provided to a customer for program participation, whether cash payment, in-kind services (e.g. design work), or other benefits directly provided customer for their program participation.", "unit": "USD" }, { "name": "load_management_annual_potential_peak_reduction_mw", "type": "number", "description": "The potential amount of peak reduction that could be incurred in a given reporting year by all participants in load management programs.", "unit": "MW" }, { "name": "load_management_incremental_actual_peak_reduction_mw", "type": "number", "description": "The peak reduction incurred in a given reporting year by new participants in existing load management programs and all participants in new load management programs.", "unit": "MW" }, { "name": "load_management_incremental_effects_mwh", "type": "number", "description": "The change in energy use incurred in a given reporting year by new participants in existing load management programs and all participants in new load management programs.", "unit": "MWh" }, { "name": "load_management_incremental_potential_peak_reduction_mw", "type": "number", "description": "The potential amount of peak reduction that could be incurred in a given reporting year by new participants in existing load management programs and all participants in new load management programs.", "unit": "MW" }, { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "price_responsiveness_customers", "type": "integer", "description": "The number of customers participating in the respondent's incentive-based demand response programs." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "time_responsiveness_customers", "type": "integer", "description": "The number of cusomters participating in the respondent's time-based rate programs." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 435025, "hash": "sha256:b541281272c400c1dbb8b1f149163a9f5f4b8a75f553626537025f8e2280c810" }, { "name": "core_eia861__yearly_demand_side_management_misc", "type": "table", "description": "Annual time series of demand-side management (DSM) program information.\n\n\nMost-recent data:\n 2012\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIncludes boolean fields about whether the energy savings estimates/calculations were\nindependently verified and whether the utility runs time and or price responsive\nprograms. Also contains information on whether any of the respondent's DSM activities\nare reported under another company, and if so which one.\n\nThe raw EIA861 demand-side management (DSM) table (split into three normalized tables in\nPUDL) contain data through 2012. The form changed in 2013 and split the contents of the\nDSM table into energy efficiency and demand response tables. Though similar, the\ninformation collected before and after 2012 are not comparable enough to combine into a\nsingular, continuous table. We were discouraged from doing so after contacting a\nrepresentative from EIA.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_demand_side_management_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "energy_savings_estimates_independently_verified", "type": "boolean", "description": "Whether savings estimates are based on a forecast or the report of one or more independent evaluators." }, { "name": "energy_savings_independently_verified", "type": "boolean", "description": "Whether reported energy savings were verified through an independent evaluation." }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "major_program_changes", "type": "boolean", "description": "Whether there have been any major changes to the respondent's demand-side management programs (e.g., terminated programs, new information or financing programs, or a shift to programs with dual load building objectives and energy efficiency objectives), program tracking procedures, or reporting methods that affect the comparison of demand-side management data reported on this schedule to data from previous years." }, { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "price_responsive_programs", "type": "boolean", "description": "Whether the respondent operates any incentive-based demand response programs (e.g., market incentives, financial incentives, direct load control, interruptible programs, demand bidding/buyback, emergency demand response, capacity market programs, and ancillary service market programs)." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "reported_as_another_company", "type": "string", "description": "The name of the company if a respondent's demand-side management activities are reported on Schedule 6 of another company\u2019s form." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "has_time_responsive_programs", "type": "boolean", "description": "Whether the respondent operates any time-based rate programs (e.g., real-time pricing, critical peak pricing, variable peak pricing and time-of-use rates administered through a tariff)." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 121435, "hash": "sha256:4742d58d6d652bd88825d665ddb74f0358d8beb2d15a491286559298cce62146" }, { "name": "core_eia861__yearly_demand_side_management_sales", "type": "table", "description": "Annual time series of electricity sales related to demand-side management (DSM).\n\n\nMost-recent data:\n 2012\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe raw EIA861 demand-side management (DSM) table (split into three normalized tables in\nPUDL) contain data through 2012. The form changed in 2013 and split the contents of the\nDSM table into energy efficiency and demand response tables. Though similar, the\ninformation collected before and after 2012 are not comparable enough to combine into a\nsingular, continuous table. We were discouraged from doing so after contacting a\nrepresentative from EIA.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_demand_side_management_sales.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "sales_for_resale_mwh", "type": "number", "description": "The amount of electricity sold for resale purposes. This entry should include sales for resale to power marketers (reported separately in previous years), full and partial requirements customers, firm power customers and nonfirm customers.", "unit": "MWh" }, { "name": "sales_to_ultimate_consumers_mwh", "type": "number", "description": "The amount of electricity sold to customers purchasing electricity for their own use and not for resale.", "unit": "MWh" }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 123199, "hash": "sha256:780a590f84718a208027da2adbf39441d4d2f0c515e2440ba140b03c0765e7e7" }, { "name": "core_eia861__yearly_distributed_generation_fuel", "type": "table", "description": "Annual time series of the energy sources used for utility or customer-owned distributed generation capacity.\n\n\nMost-recent data:\n 2015\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nFrom 2016 on, there's no great match for the data found in this table.\nYou may be able to compute an analog for fuel percents using the capacity and tech class\nfigures in :ref:`core_eia861__yearly_non_net_metering_customer_fuel_class`, but no\ncorresponding consumption or generation information is available in the new format.\n\nThe raw EIA861 distributed generation (DG) table (split into three normalized tables in\nPUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in\nthe Non-Net Metering table (2016+) are split by sector, contain fuel cell information,\nand convert capacity reported in DC units to AC units.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_distributed_generation_fuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "estimated_or_actual_fuel_data", "type": "string", "description": "Whether the reported fuel data is estimated or actual.", "constraints": { "enum": [ "estimated", "actual" ] } }, { "name": "fuel_class", "type": "string", "description": "Fuel types specific to EIA 861 distributed generation table: ['gas', 'oil', 'other', 'renewable', 'water', 'wind', 'wood']", "constraints": { "enum": [ "gas", "oil", "other", "renewable", "water", "wind", "wood" ] } }, { "name": "fuel_pct", "type": "number", "description": "Percent of fuel" }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 40702, "hash": "sha256:4dd47c93d7d12b38101fbc1c94dae878c7754aa51c31d000858ea255ada7da16" }, { "name": "core_eia861__yearly_distributed_generation_misc", "type": "table", "description": "Annual time series of the capacity and quantity of utility or customer-owned distributed generation.\n\n\nMost-recent data:\n 2015\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nFrom 2016 on, data similar to that found in this table can be found in\n:ref:`core_eia861__yearly_non_net_metering_misc`.\n\nThe raw EIA861 distributed generation (DG) table (split into three normalized tables in\nPUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in\nthe Non-Net Metering table (2016+) are split by sector, contain fuel cell information,\nand convert capacity reported in DC units to AC units.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_distributed_generation_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "backup_capacity_mw", "type": "number", "description": "The total nameplate capacity of generators that are used only for emergency backup service.", "unit": "MW" }, { "name": "distributed_generation_owned_capacity_mw", "type": "number", "description": "Amount of distributed generation capacity owned by the respondent.", "unit": "MW" }, { "name": "estimated_or_actual_capacity_data", "type": "string", "description": "Whether the reported capacity data is estimated or actual.", "constraints": { "enum": [ "estimated", "actual" ] } }, { "name": "generators_num_less_1_mw", "type": "integer", "description": "Total number of generators less than 1 MW." }, { "name": "generators_number", "type": "integer", "description": "Total number of generators" }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "total_capacity_less_1_mw", "type": "number", "description": "The total amount of capacity from generators with less than 1 MW of nameplate capacity.", "unit": "MW" }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 56256, "hash": "sha256:2a2fbd93b06edeec5d243b2c4beb142bc7a09eecfd015bc23b5e2bbee295570e" }, { "name": "core_eia861__yearly_distributed_generation_tech", "type": "table", "description": "Annual time series of the technology used for utility or customer-owned distributed generation.\n\n\nMost-recent data:\n 2015\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nFrom 2016 on, data similar to that found in this table can be found in\n:ref:`core_eia861__yearly_non_net_metering_customer_fuel_class`.\n\nThe raw EIA861 distributed generation (DG) table (split into three normalized tables in\nPUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in\nthe Non-Net Metering table (2016+) are split by sector, contain fuel cell information,\nand convert capacity reported in DC units to AC units.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_distributed_generation_tech.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "estimated_or_actual_tech_data", "type": "string", "description": "Whether the reported technology data is estimated or actual.", "constraints": { "enum": [ "estimated", "actual" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "tech_class", "type": "string", "description": "Type of technology specific to EIA 861 distributed generation and net generation tables: ['backup', 'chp_cogen', 'combustion_turbine', 'fuel_cell', 'hydro', 'internal_combustion', 'other', 'pv', 'steam', 'storage_pv', 'storage_nonpv', 'all_storage', 'total', 'virtual_pv', 'virtual_pv_under_1mw', 'virtual_pv_over_1mw', 'wind'].", "constraints": { "enum": [ "backup", "chp_cogen", "combustion_turbine", "fuel_cell", "hydro", "internal_combustion", "other", "pv", "steam", "storage_pv", "storage_nonpv", "all_storage", "total", "virtual_pv", "virtual_pv_under_1mw", "virtual_pv_over_1mw", "wind" ] } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 44892, "hash": "sha256:579289ecf5b2b67535b509972e51984933c8e482e58cca692cae58f9bbf0fef3" }, { "name": "core_eia861__yearly_distribution_systems", "type": "table", "description": "Annual time series of distribution circuits and circuits with voltage optimization by state.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_distribution_systems.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "circuits_with_voltage_optimization", "type": "integer", "description": "Number of distribution circuits that employ voltage/VAR optimization (VVO)." }, { "name": "distribution_circuits", "type": "integer", "description": "Total number of distribution circuits." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 145437, "hash": "sha256:e39c6f0d6481e47cd287863b3b5f5f4f3002e736b6ce7c081c778dfcbac18a37" }, { "name": "core_eia861__yearly_dynamic_pricing", "type": "table", "description": "Annual time series of enrollment in dynamic pricing programs by state, sector, and balancing authority.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nRespondents check if one or more customers are enrolled in time-of-use pricing, real\ntime pricing, variable peak pricing, critical peak pricing, and critical peak rebates.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_dynamic_pricing.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "critical_peak_pricing", "type": "boolean", "description": "Whether customers are participating in critical peak pricing, a program in which rate and/or price structure is designed to encourage reduced consumption during periods of high wholesale market prices or system contingencies, by imposing a pre-specified high rate or price for a limited number of days or hours." }, { "name": "critical_peak_rebate", "type": "boolean", "description": "Whether customers are participating in critical peak rebates, a program in which rate and/or price structure is designed to encourage reduced consumption during periods of high wholesale market prices or system contingencies, by providing a rebate to the customer on a limited number of days and for a limited number of hours, at the request of the energy provider." }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "real_time_pricing", "type": "boolean", "description": "Whether the respondent has customers participating in a real time pricing (RTP) program. RTP is a program of rate and price structure in which the retail price for electricity typically fluctuates hourly or more often, to reflect changes in the wholesale price of electricity on either a day- ahead or hour-ahead basis." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "time_of_use_pricing", "type": "boolean", "description": "Whether the respondent has customers participating in a time-of-use pricing programs (TOU). TOU is a program in which customers pay different prices at different times of the day. On-peak prices are higher and off-peak prices are lower than a \u201cstandard\u201d rate. Price schedule is fixed and predefined, based on season, day of week, and time of day." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "variable_peak_pricing", "type": "boolean", "description": "Whether the respondent has customers participating in a variable peak pricing program (VPP). VPP is a program in which a form of TOU pricing allows customers to purchase their generation supply at prices set on a daily basis with varying on-peak and constant off-peak rates. Under the VPP program, the on-peak price for each weekday becomes available the previous day (typically late afternoon) and the customer is billed for actual consumption during the billing cycle at these prices." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 151689, "hash": "sha256:bf6f4ef4c166eaea7bab99ff5da3f1f9b67d04b36532f395964f24130db1ca82" }, { "name": "core_eia861__yearly_energy_efficiency", "type": "table", "description": "Annual time series of incremental energy savings, peak demand savings, weighted average life\ncycle, and associated costs for the reporting year and life cycle of energy efficiency\nprograms.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe EIA861 demand-side management (DSM) table (split into three normalized tables in\nPUDL) contain data through 2012. The form changed in 2013 and split the contents of the\nDSM table into energy efficiency and demand response tables. Though similar, the\ninformation collected before and after 2012 are not comparable enough to combine into a\nsingular, continuous table. We were discouraged from doing so after contacting a\nrepresentative from EIA.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_energy_efficiency.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "customer_incentives_incremental_cost", "type": "number", "description": "The cost of customer incentives resulting from new participants in existing energy efficiency programs and all participants in new energy efficiency programs. Customer incentives are the total financial value provided to a customer for program participation, whether, for example, cash payment, or lowered tariff rates relative to non-participants, in-kind services (e.g. design work), or other benefits directly provided to the customer for their program participation.", "unit": "USD" }, { "name": "customer_incentives_incremental_life_cycle_cost", "type": "number", "description": "All anticipated costs of the customer incentives including reporting year incremental costs and all future costs. Customer incentives are the total financial value provided to a customer for program participation, whether, for example, cash payment, or lowered tariff rates relative to non-participants, in-kind services (e.g. design work), or other benefits directly provided to the customer for their program participation.", "unit": "USD" }, { "name": "customer_other_costs_incremental_life_cycle_cost", "type": "number", "description": "All anticipated costs other than customer incentives. Includes reporting year incremental costs and all future costs.", "unit": "USD" }, { "name": "incremental_energy_savings_mwh", "type": "number", "description": "Energy savings in the given report year resulting from new participants in existing demand response programs and all participants in new demand response programs.", "unit": "MWh" }, { "name": "incremental_life_cycle_energy_savings_mwh", "type": "number", "description": "The estimated total changes in energy use for incremental programs and participants over the life of the programs. DSM programs have a useful life, and the net effects of these programs will diminish over time. Considers the useful life of energy efficiency technology by accounting for building demolition, equipment degradation, and program attrition.", "unit": "MWh" }, { "name": "incremental_life_cycle_peak_reduction_mw", "type": "number", "description": "The estimated total changes in peak load for incremental programs and participants over the life of the programs. DSM programs have a useful life, and the net effects of these programs will diminish over time. Considers the useful life of energy efficiency technology by accounting for building demolition, equipment degradation, and program attrition.", "unit": "MW" }, { "name": "incremental_peak_reduction_mw", "type": "number", "description": "The peak reduction incurred in a given reporting year by new participants in existing energy efficiency programs and all participants in new energy efficiency programs.", "unit": "MW" }, { "name": "other_costs_incremental_cost", "type": "number", "description": "Costs resulting from new participants in existing energy efficiency programs and all participants in new energy efficiency programs that aren't directly associated with customer incentives.", "unit": "USD" }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "weighted_average_life_years", "type": "number", "description": "The weighted average life of the respondent's portfolio of energy efficiency programs." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 809458, "hash": "sha256:b9a0f3eb4fa56a15d75af9e30230bb76cdb7dbae33f6e90f4d3ef7b264db36c9" }, { "name": "core_eia861__yearly_green_pricing", "type": "table", "description": "Annual time series of green pricing program revenue, sales, and customer count by sector and state.\n\n\nMost-recent data:\n 2012\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_green_pricing.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "green_pricing_revenue", "type": "number", "description": "The money derived from premium green pricing rate of the respondent'sprogram.", "unit": "USD" }, { "name": "rec_revenue", "type": "number", "description": "Amount of revenue collected from Renewable Energy Certificates (RECs).", "unit": "USD" }, { "name": "rec_sales_mwh", "type": "number", "description": "Amount of sales collected from Renewable Energy Certificates (RECs).", "unit": "MWh" }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 185865, "hash": "sha256:019959ea674b65ed3eb2264ac3f60a686985773819ce2889ee680b877f80f374" }, { "name": "core_eia861__yearly_mergers", "type": "table", "description": "Annual time series of utility mergers and acquisitions.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_mergers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "merge_address", "type": "string", "description": "Address of new parent company." }, { "name": "merge_city", "type": "string", "description": "City of new parent company." }, { "name": "merge_company", "type": "string", "description": "Name of the company merged with or acquired." }, { "name": "merge_date", "type": "date", "description": "Date of merger or acquisition." }, { "name": "merge_state", "type": "string", "description": "Two letter US state abbreviations and three letter ISO-3166-1 country codes for international mines." }, { "name": "new_parent", "type": "string", "description": "Name of the new parent company post merger." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "zip_code_4", "type": "string", "description": "Four digit US Zip Code suffix.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 30153, "hash": "sha256:533ae0bffc8ad1291a5c6daa448737d1545551b0a3be1ec5261417201e255442" }, { "name": "core_eia861__yearly_net_metering_customer_fuel_class", "type": "table", "description": "Annual time series of net metering by customer and fuel class.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some years use a slightly different data definition.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe amount of energy sold to back to the grid. From 2007 - 2009 the data\nare reported as a lump sum of total energy dispatched by sector. After 2009, the data\nare broken down by sector and technology type.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_net_metering_customer_fuel_class.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "energy_capacity_mwh", "type": "number", "description": "The total amount of energy which the system can supply power before recharging is necessary, in megawatt-hours.", "unit": "MWh" }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "sold_to_utility_mwh", "type": "number", "description": "The amount of electric energy sold back to the utility through the net metering application.", "unit": "MWh" }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "tech_class", "type": "string", "description": "Type of technology specific to EIA 861 distributed generation and net generation tables: ['backup', 'chp_cogen', 'combustion_turbine', 'fuel_cell', 'hydro', 'internal_combustion', 'other', 'pv', 'steam', 'storage_pv', 'storage_nonpv', 'all_storage', 'total', 'virtual_pv', 'virtual_pv_under_1mw', 'virtual_pv_over_1mw', 'wind'].", "constraints": { "enum": [ "backup", "chp_cogen", "combustion_turbine", "fuel_cell", "hydro", "internal_combustion", "other", "pv", "steam", "storage_pv", "storage_nonpv", "all_storage", "total", "virtual_pv", "virtual_pv_under_1mw", "virtual_pv_over_1mw", "wind" ] } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 783336, "hash": "sha256:db8215d8230cd65ef1b745f764120065b124c5cb8b06b3594674e4a08131622a" }, { "name": "core_eia861__yearly_net_metering_misc", "type": "table", "description": "Annual time series of PV current flow type for net metered capacity.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_net_metering_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "pv_current_flow_type", "type": "string", "description": "Current flow type for photovoltaics: AC or DC", "constraints": { "enum": [ "AC", "DC" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 49806, "hash": "sha256:1ae828754bc4773fad12a85165131ebdbbd8f9a325756997e1cb2460da9eea61" }, { "name": "core_eia861__yearly_non_net_metering_customer_fuel_class", "type": "table", "description": "Annual time series of non-net metered distributed generation by sector and technology type.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table's data starts in 2016. For 2015 and earlier, data similar to that found in this table can be found in\n:ref:`core_eia861__yearly_distributed_generation_tech`.\n\nThe raw EIA861 distributed generation (DG) table (split into three normalized tables in\nPUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in\nthe Non-Net Metering table (2016+) are split by sector, contain fuel cell information,\nand convert capacity reported in DC units to AC units.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_non_net_metering_customer_fuel_class.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "energy_capacity_mwh", "type": "number", "description": "The total amount of energy which the system can supply power before recharging is necessary, in megawatt-hours.", "unit": "MWh" }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "tech_class", "type": "string", "description": "Type of technology specific to EIA 861 distributed generation and net generation tables: ['backup', 'chp_cogen', 'combustion_turbine', 'fuel_cell', 'hydro', 'internal_combustion', 'other', 'pv', 'steam', 'storage_pv', 'storage_nonpv', 'all_storage', 'total', 'virtual_pv', 'virtual_pv_under_1mw', 'virtual_pv_over_1mw', 'wind'].", "constraints": { "enum": [ "backup", "chp_cogen", "combustion_turbine", "fuel_cell", "hydro", "internal_combustion", "other", "pv", "steam", "storage_pv", "storage_nonpv", "all_storage", "total", "virtual_pv", "virtual_pv_under_1mw", "virtual_pv_over_1mw", "wind" ] } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 225477, "hash": "sha256:9ffe3a21ce7382034b515c54e91ba947c7d813bd80b1b9c524eb142e994b4684" }, { "name": "core_eia861__yearly_non_net_metering_misc", "type": "table", "description": "Annual time series of non-net metered distributed generation generators, pv current flow type, backup capacity and utility owned capacity.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table's data starts in 2016. For 2015 and earlier, data similar to that found in this table can be found in\n:ref:`core_eia861__yearly_distributed_generation_misc`.\n\nThe raw EIA861 distributed generation (DG) table (split into three normalized tables in\nPUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in\nthe Non-Net Metering table (2016+) are split by sector, contain fuel cell information,\nand convert capacity reported in DC units to AC units.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_non_net_metering_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "backup_capacity_mw", "type": "number", "description": "The total nameplate capacity of generators that are used only for emergency backup service.", "unit": "MW" }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "generators_number", "type": "integer", "description": "Total number of generators" }, { "name": "pv_current_flow_type", "type": "string", "description": "Current flow type for photovoltaics: AC or DC", "constraints": { "enum": [ "AC", "DC" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_owned_capacity_mw", "type": "number", "description": "Total non-net-metered capacity owned by the respondent.", "unit": "MW" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 43499, "hash": "sha256:70482c8f0c3ec76e7d4a6ffd7bb4d5eb46246d644f0f3b32c26a8fe907ce047e" }, { "name": "core_eia861__yearly_operational_data_misc", "type": "table", "description": "Annual time series of megawatt hours (MWH) for the sources and disposition of a utility's electricity.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report (Schedule 2B)\n\nPrimary key:\n utility_id_eia, nerc_region, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some values have been redacted.\n\n* Contains rows where missing values were imputed.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nRespondents are required to report this information to the EIA, but are not required\nto disclose utility-level data to the public. When a respondent chooses to keep its\nutility-level data proprietary, it files using EIA utility id 88888. For more details,\nsee :ref:`EIA-861 Notable Irregularities `.\n\nRows where ``data_observed`` is False were labeled as imputed in the raw EIA data.\nThe EIA documentation does not specify what imputation applies to operational data,\nonly net metering and non net-metering distributed data. Less than 1% of rows are\nlabeled as imputed, all of which occur in 2004 or 2005. Imputed rows make up no\nmore than 25% of the rows for any utility.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_operational_data_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "consumed_by_facility_mwh", "type": "number", "description": "The amount of electricity used by the facility.", "unit": "MWh" }, { "name": "consumed_by_respondent_without_charge_mwh", "type": "number", "description": "The amount of electricity used by the electric utility in its electric and other departments without charge.", "unit": "MWh" }, { "name": "data_observed", "type": "boolean", "description": "Is the value observed (True) or imputed (False)." }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "exchange_energy_delivered_mwh", "type": "number", "description": "The amount of exchange energy delivered. Does not include power delivered as part of a tolling arrangement.", "unit": "MWh" }, { "name": "exchange_energy_received_mwh", "type": "number", "description": "The amount of exchange energy received. Does not include power received through tolling arrangements.", "unit": "MWh" }, { "name": "furnished_without_charge_mwh", "type": "number", "description": "The amount of electricity furnished by the electric utility without charge, such as to a municipality under a franchise agreement or for street and highway lighting.", "unit": "MWh" }, { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "required": true, "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "net_power_exchanged_mwh", "type": "number", "description": "The net amount of energy exchanged. Net exchange is the difference between the amount of exchange received and the amount of exchange delivered. This entry should not include wholesale energy purchased from or sold to regulated companies or unregulated companies for other systems.", "unit": "MWh" }, { "name": "net_wheeled_power_mwh", "type": "number", "description": "The difference between the amount of energy entering the respondent's system (wheeled received) for transmission through the respondent's system and the amount of energy leaving the respondent's system (wheeled delivered). Wheeled net represents the energy losses on the respondent's system associated with the wheeling of energy for other systems.", "unit": "MWh" }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "retail_sales_mwh", "type": "number", "description": "MWh of sales to end-use customers in areas where the customer has been given the legal right to select a power supplier other than the traditional, vertically integrated electric utility.", "unit": "MWh" }, { "name": "sales_for_resale_mwh", "type": "number", "description": "The amount of electricity sold for resale purposes. This entry should include sales for resale to power marketers (reported separately in previous years), full and partial requirements customers, firm power customers and nonfirm customers.", "unit": "MWh" }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "summer_peak_demand_mw", "type": "number", "description": "The maximum hourly summer load (for the months of June through September) based on net energy for the system during the reporting year. Net energy for the system is the sum of energy an electric utility needs to satisfy their service area and includes full and partial wholesale requirements customers, and the losses experienced in delivery. The maximum hourly load is determined by the interval in which the 60-minute integrated demand is the greatest.", "unit": "MW" }, { "name": "total_disposition_mwh", "type": "number", "description": "Sum of all disposition of electricity listed. Includes sales to ultimate customers, sales for resale, energy furnished without charge, energy consumed by respondent without charge and total energy losses.", "unit": "MWh" }, { "name": "total_energy_losses_mwh", "type": "number", "description": "The total amount of electricity lost from transmission, distribution, and/or unaccounted for. Should be expressed as a positive number.", "unit": "MWh" }, { "name": "total_sources_mwh", "type": "number", "description": "Sum of all sources of electricity listed. Includes net generation, purchases from electricity suppliers, net exchanges (received - delivered), net wheeled (received - delivered), transmission by others, and losses.", "unit": "MWh" }, { "name": "transmission_by_other_losses_mwh", "type": "number", "description": "The amount of energy losses associated with the wheeling of electricity provided to the respondent's system by other utilities. Transmission by others, losses should always be a negative value.", "unit": "MWh" }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "wheeled_power_delivered_mwh", "type": "number", "description": "The total amount of energy leaving the respondent's system that was transmitted through the respondent's system for delivery to other systems. If wheeling delivered is not precisely known, the value is an estimate based on the respondent's system's known percentage of losses for wheeling transactions.", "unit": "MWh" }, { "name": "wheeled_power_received_mwh", "type": "number", "description": "The total amount of energy entering the respondent's system from other systems for transmission through the respondent's system (wheeling) for delivery to other systems. Does not include energy purchased or exchanged for consumption within the respondent's system, which was wheeled to the respondent by others.", "unit": "MWh" }, { "name": "wholesale_power_purchases_mwh", "type": "number", "description": "Purchases from electricity suppliers.", "unit": "MWh" }, { "name": "winter_peak_demand_mw", "type": "number", "description": "The maximum hourly winter load (for the months of January through March) based on net energy for the system during the reporting year. Net energy for the system is the sum of energy an electric utility needs to satisfy their service area and includes full and partial wholesale requirements customers, and the losses experienced in delivery. The maximum hourly load is determined by the interval in which the 60-minute integrated demand is the greatest.", "unit": "MW" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "nerc_region", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2945268, "hash": "sha256:1239cb00a606c5348085d44c6ba75295078d63720a68fe842b6d5a62a13f4666" }, { "name": "core_eia861__yearly_operational_data_revenue", "type": "table", "description": "Annual time series of utility revenue by type of electric operating revenue.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report (Schedule 2C)\n\nPrimary key:\n utility_id_eia, nerc_region, report_date, revenue_class\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some values have been redacted.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nA utility's revenue by type of electric operating revenue.\nIncludes electric operating revenue from sales to ultimate customers, revenue from\nunbundled (delivery) customers, revenue from sales for resale, electric credits/other\nadjustments, revenue from transmission, other electric operating revenue, and total\nelectric operating revenue.\n\nRespondents are required to report this information to the EIA, but are not required\nto disclose utility-level data to the public. When a respondent chooses to keep its\nutility-level data proprietary, it files using EIA utility id 88888. For more details,\nsee :ref:`EIA-861 Notable Irregularities `.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_operational_data_revenue.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "required": true, "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "revenue", "type": "number", "description": "Amount of revenue.", "unit": "USD" }, { "name": "revenue_class", "type": "string", "description": "Source of revenue (e.g., retail sales, transmission).", "constraints": { "required": true, "enum": [ "credits_or_adjustments", "delivery_customers", "other", "retail_sales", "sales_for_resale", "total", "transmission", "unbundled" ] } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "nerc_region", "report_date", "revenue_class" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1554847, "hash": "sha256:8a36ca203d7415795a0c3c557024c2dcc47b8f63273eee7cdcf1cfc1c16a98f8" }, { "name": "core_eia861__yearly_reliability", "type": "table", "description": "Annual time series of electricity system reliability and outage impacts.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report (Schedules 3B and 3C)\n\nPrimary key:\n utility_id_eia, state, report_date, standard \n\n Note: ``standard`` is included because while respondents are asked to only fill out one of parts B or C, sometimes they fill out both.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nContains information on non-momentary electrical interruptions.\nIncludes the system average interruption duration index (SAIDI), system average\ninterruption frequency index (SAIFI), and customer average interruption duration index\n(CAIDI) aka SAIDI/SAIFI with and without major event days and loss of service. Includes\nthe standard (IEEE/other) and other relevant information.\n\nSAIDI is measured in minutes, and represents the sum over the year of all customers interrupted times\nthe number of minutes they experienced an interruption, divided by total number of customers.\n\nSAIFI is measured in customers, and represents the sum over the year of the total number of customers that\nexperienced an interruption, divided by the total number of customers.\n\nThe IEEE standards which can be used to calculate SAIDI and SAIFI include IEEE 1366-2003 and IEEE 1366-2012.\nThese standards define momentary interruptions as having a duration of five minutes or less.\nIf one of these IEEE standards is used, respondents fill out part B and are required to specify:\n\n* SAIDI major event days minus loss of supply\n* SAIFI major event days minus loss of supply\n\nSAIDI and SAIFI major event days minus loss of supply excludes events where the reliability event resulted\nfrom an event on the distribution system, not from the high-voltage system. The voltage that distinguishes\nthe distribution system from the supply system is given in ``highest_distribution_voltage_kv``.\n\nIf a method other than these IEEE standards is used for calculating SAIDI and SAIFI indexes, respondents\nfill out part C and are required to specify:\n\n* whether inactive accounts are included\n* how they define a momentary interruption (less than 1 minute, less than or equal to 5 minutes, or other)\n\nIn this table, column ``standard`` is \"ieee_standard\" for respondents who have filled out part B, and\n\"other_standard\" for respondents who have filled out part C.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_reliability.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "caidi_w_major_event_days_minus_loss_of_service_minutes", "type": "number", "description": "Average number of minutes per interruption (SAIDI/SAIFI) including major event days and excluding reliability events caused by a loss of supply.", "unit": "min" }, { "name": "caidi_w_major_event_days_minutes", "type": "number", "description": "Average number of minutes per interruption (SAIDI/SAIFI) including major event days.", "unit": "min" }, { "name": "caidi_wo_major_event_days_minutes", "type": "number", "description": "Average number of minutes per interruption (SAIDI/SAIFI) excluding major event days.", "unit": "min" }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "highest_distribution_voltage_kv", "type": "number", "description": "The highest voltage that's part of the distribution system.", "unit": "kV" }, { "name": "inactive_accounts_included", "type": "boolean", "description": "Whether the respondent includes inactive accounts in its definition of customers used to determine SAIDI and SAIFI." }, { "name": "momentary_interruption_definition", "type": "string", "description": "How the respondent defines momentary service interruptions: less than 1 min, equal to or less than 5 min, or some other way." }, { "name": "outages_recorded_automatically", "type": "boolean", "description": "Whether the information about customer outages is recorded automatically." }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "saidi_w_major_event_days_minus_loss_of_service_minutes", "type": "number", "description": "Cumulative duration (minutes) of interruption for the average customer during the report year including major event days and excluding reliability events caused by a loss of supply.", "unit": "min" }, { "name": "saidi_w_major_event_days_minutes", "type": "number", "description": "Cumulative duration (minutes) of interruption for the average customer during the report year including major event days.", "unit": "min" }, { "name": "saidi_wo_major_event_days_minutes", "type": "number", "description": "Cumulative duration (minutes) of interruption for the average customer during the report year excluding major event days.", "unit": "min" }, { "name": "saifi_w_major_event_days_customers", "type": "number", "description": "Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year including major event days." }, { "name": "saifi_w_major_event_days_minus_loss_of_service_customers", "type": "number", "description": "Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year including major event days and excluding reliability events caused by a loss of supply." }, { "name": "saifi_wo_major_event_days_customers", "type": "number", "description": "Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year excluding major event days." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "standard", "type": "string", "description": "Whether the respondent calculates SAIDI/SAIFI, and major event days according to the IEEE or an Other standard.", "constraints": { "required": true, "enum": [ "ieee_standard", "other_standard" ] } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "state", "report_date", "standard" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "momentary_interruption_definition" ], "reference": { "resource": "core_eia__codes_momentary_interruptions", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 618425, "hash": "sha256:e11761d19afcddc348ef51b4ca2243743d3e89795d0c0a21113fcec244cb3af5" }, { "name": "core_eia861__yearly_sales", "type": "table", "description": "Annual time series of electricity sales to ultimate customers by utility, balancing authority, state, and customer class.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n utility_id_eia, state, report_date, balancing_authority_code_eia, customer_class, business_model, service_type", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_sales.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "required": true, "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "business_model", "type": "string", "description": "Business model.", "constraints": { "required": true, "enum": [ "retail", "energy_services" ] } }, { "name": "data_observed", "type": "boolean", "description": "Is the value observed (True) or imputed (False)." }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "service_type", "type": "string", "description": "The type of service the respondent provides to a given customer class.Bundled: both energy and delivery; energy: just the energy consumed; delivery: just the billing and energy delivery services.", "constraints": { "required": true, "enum": [ "bundled", "energy", "delivery" ] } }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "sales_revenue", "type": "number", "description": "Revenue from electricity sold.", "unit": "USD" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "state", "report_date", "balancing_authority_code_eia", "customer_class", "business_model", "service_type" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3892437, "hash": "sha256:7e1c2a54a92b3f243b59fc90ebf1564bdfb72c6f194142f9ba4d0bb488a9902d" }, { "name": "core_eia861__yearly_service_territory", "type": "table", "description": "Annual time series of counties in utility service territories.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n report_date, utility_id_eia, county_id_fips", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_service_territory.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "county", "type": "string", "description": "County name." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "pattern": "^\\d{2}$" } }, { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "required": true, "pattern": "^\\d{5}$" } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "report_date", "utility_id_eia", "county_id_fips" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1582075, "hash": "sha256:59edb860c7652976205846f4f5cecca2b98f3cb1ea1d7ae5551448c4bd8e6f8b" }, { "name": "core_eia861__yearly_short_form", "type": "table", "description": "Annual time series of data from the short form (EIA-861S).\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n utility_id_eia, state, report_date, balancing_authority_code_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some years are missing from the data record.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe data started being reported in 2012. However, the 2019 data is not available.\nThey are expected to submit the completed Form EIA-861S to EIA by April 30th, following the end of the prior calendar year.\nUtilities report on Form EIA-861S if they:\n\n- Report less than 200,000 megawatthours on the last previous Form EIA-861.\n\n- Provide only bundled service (generation and distribution).\n\n- Are not needed to ensure acceptable quality of statistical estimates.\n\n- Are not part of the aggregate TVA or WPPI.\n\n- Do not report on Form EIA-861M.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_short_form.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "sales_revenue", "type": "number", "description": "Revenue from electricity sold.", "unit": "USD" }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "customers", "type": "number", "description": "Number of customers." }, { "name": "has_net_metering", "type": "boolean", "description": "Whether the plant has a net metering agreement in effect during the reporting year. (Only displayed for facilities that report the sun or wind as an energy source). This field was only reported up until 2015" }, { "name": "has_demand_side_management", "type": "boolean", "description": "Whether there were strategies or measures used to control electricity demand by customers" }, { "name": "has_time_responsive_programs", "type": "boolean", "description": "Whether the respondent operates any time-based rate programs (e.g., real-time pricing, critical peak pricing, variable peak pricing and time-of-use rates administered through a tariff)." }, { "name": "has_green_pricing", "type": "boolean", "description": "Whether a green pricing program was associated with this utility during the reporting year." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "state", "report_date", "balancing_authority_code_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 312982, "hash": "sha256:5301cd058abcb51da873f3ab35b0fcda3add092c8331c200964d0bfd9cab5ce3" }, { "name": "core_eia861__yearly_utility_data_misc", "type": "table", "description": "Annual time series of utility business activities.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key. The primary key would have been: utility_id_eia, state, report_date,\n and nerc_region, but there are nulls in the state column across several years of reporting.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis includes whether they operate alternative fuel vehicles, whether they provide\ntransmission, distribution, or generation services (bundled or unbundled), and whether\nthey engage in wholesale and/or retail markets.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_utility_data_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "alternative_fuel_vehicle_2_activity", "type": "boolean", "description": "Whether the utility plants to operate alternative-fueled vehicles this coming year." }, { "name": "alternative_fuel_vehicle_activity", "type": "boolean", "description": "Whether the utility operates alternative-fueled vehicles during the year." }, { "name": "bundled_activity", "type": "boolean", "description": "Whether a utility engaged in combined utility services (electricity plus other services such as gas, water, etc. in addition to electric services) during the year." }, { "name": "buying_distribution_activity", "type": "boolean", "description": "Whether a utility bought any distribution on other electrical systems during the year." }, { "name": "buying_transmission_activity", "type": "boolean", "description": "Whether a utility bought any transmission services on other electrical systems during the year." }, { "name": "distribution_activity", "type": "boolean", "description": "Whether a utility engaged in any distribution using owned/leased electrical wires during the year." }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "generation_activity", "type": "boolean", "description": "Whether a utility utilized generation from company owned plant during the year." }, { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "operates_generating_plant", "type": "boolean", "description": "Whether the respondent operated at least one generating plant during the reporting period." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "retail_marketing_activity", "type": "boolean", "description": "Whether a utility engaged in retail power marketing during the year." }, { "name": "short_form", "type": "boolean", "description": "Whether the reported information comes from the short form. In the case of form EIA 861, a shorter version of the form was created in 2012 to reduce respondent burden on smaller utilities and increase our processing efficiency." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "transmission_activity", "type": "boolean", "description": "Whether a utility engaged in any transmission activities during the year." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "wholesale_marketing_activity", "type": "boolean", "description": "Whether a utility engages in wholesale power marketing during the year." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 214448, "hash": "sha256:c0f9a126b7dbf80facb3ec3dddca2171ff76a7c4613f6dbdf2cdd822d25b55f8" }, { "name": "core_eia861__yearly_utility_data_nerc", "type": "table", "description": "Annual time series of the NERC regions that utilities operate in.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key. The primary key would have been: utility_id_eia, state, report_date,\n nerc_region, and nerc_regions_of_operation, but there are nulls in the state column across several years of reporting.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_utility_data_nerc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "nerc_regions_of_operation", "type": "string", "description": "All the regional entities within the North American Electric Reliability Corporation (NERC) in which the respodent conducts operations.", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 135287, "hash": "sha256:bb8dcb60df069e2ac6f9c86b776fb9b76ac570a238029c22a9beb7cc476a9d1a" }, { "name": "core_eia861__yearly_utility_data_rto", "type": "table", "description": "Annual time series of the RTOs that utilities operate in.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n This table has no primary key. The primary key would have been: utility_id_eia, state, report_date,\n nerc_region, and rtos_of_operation, but there are nulls in the state column across several years of reporting.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia861__yearly_utility_data_rto.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "rtos_of_operation", "type": "string", "description": "The ISOs/RTOs, in which the respondent conducts operations.", "constraints": { "enum": [ "caiso", "ercot", "isone", "miso", "nyiso", "other", "pjm", "spp" ] } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 80332, "hash": "sha256:d9146ccd8f27463f80934aa7056769288365bd4eafc360746d5b2a2e02b80275" }, { "name": "core_eia923__entity_coalmine", "type": "table", "description": "Entity table containing static information about coal mines reporting deliveries in the Fuel Receipts and Costs table.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 2, Part C)\n\nPrimary key:\n mine_id_pudl\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Mine ID's are not as well defined and consistent as other EIA ID's.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is produced during the transformation of fuel delivery data, in order to\nproduce a better normalized database. The same coalmines report many individual\ndeliveries, and repeating their attributes many times in the fuel receipts and costs\ntable is duplicative. Unfortunately the coalmine attributes do not generally use a\ncontrolled vocabulary or well defined IDs and so in practice there are many distinct\nrecords in this table that correspond to the same mines in reality.\n\nWe have not yet taken the time to rigorously clean this data, but it could be linked\nwith both Mining Safety and Health Administration (MSHA) and USGS data to provide more\ninsight into where coal is coming from, and what the employment and geological context\nis for those supplies.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__entity_coalmine.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "mine_id_pudl", "type": "integer", "description": "Dynamically assigned PUDL mine identifier.", "constraints": { "required": true } }, { "name": "mine_name", "type": "string", "description": "Coal mine name." }, { "name": "mine_type_code", "type": "string", "description": "Type of coal mine." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "mine_id_msha", "type": "integer", "description": "MSHA issued mine identifier." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "mine_id_pudl" ], "foreignKeys": [ { "fields": [ "mine_type_code" ], "reference": { "resource": "core_eia__codes_coalmine_types", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 82585, "hash": "sha256:febf205f8c18330f8fff103b1d49be062f4ef66a8f04f50c30365fb31fea0e5c" }, { "name": "core_eia923__fuel_receipts_costs", "type": "table", "description": "Individual fuel deliveries to power plants, organized by fuel type and supplier.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 2 - Part A)\n\nPrimary key:\n This table has no primary key. Each record describes an individual fuel delivery. There can be multiple deliveries of the same type of fuel from the same supplier to the same plant in a single month, so the table has no natural primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Some values have been redacted.\n\n* Time of fuel deliveries is not necessarily connected with time of fuel consumption.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThere can be a significant delay between the receipt of fuel and its consumption, so\nusing this table to infer monthly attributes associated with power generation may not be\nentirely accurate. However, this is the most granular data we have describing fuel\ncosts, and we use it in calculating the marginal cost of electricity for individual\ngeneration units.\n\nUnder some circumstances utilities are allowed to treat the price of fuel as proprietary\nbusiness data, meaning it is redacted from the publicly available spreadsheets. It's\nstill reported to EIA and influences the aggregated (state, region, annual, etc.) fuel\nprices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing\ndata is not randomly distributed. Deregulated markets dominated by merchant generators\n(independent power producers) redact much more data, and natural gas is by far the most\nlikely fuel to have its price redacted. This means, for instance, that the entire\nNortheastern US reports essentially no fine-grained data about its natural gas prices.\n\nAdditional data which we haven't yet integrated is available in a similar format from\n2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__fuel_receipts_costs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "contract_type_code", "type": "string", "description": "Purchase type under which receipts occurred in the reporting month. C: Contract, NC: New Contract, S: Spot Purchase, T: Tolling Agreement.", "constraints": { "enum": [ "S", "C", "NC", "T" ] } }, { "name": "contract_expiration_date", "type": "date", "description": "Date contract expires.Format: MMYY." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record." }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_group_code", "type": "string", "description": "Fuel groups used in the Electric Power Monthly", "constraints": { "enum": [ "petroleum", "other_gas", "petroleum_coke", "natural_gas", "coal" ] } }, { "name": "mine_id_pudl", "type": "integer", "description": "Dynamically assigned PUDL mine identifier." }, { "name": "supplier_name", "type": "string", "description": "Company that sold the fuel to the plant or, in the case of Natural Gas, pipeline owner." }, { "name": "fuel_received_units", "type": "number", "description": "Quantity of fuel received in tons, barrel, or Mcf." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "mercury_content_ppm", "type": "number", "description": "Mercury content in parts per million (ppm) to the nearest 0.001 ppm.", "unit": "ppm" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "primary_transportation_mode_code", "type": "string", "description": "Transportation mode for the longest distance transported." }, { "name": "secondary_transportation_mode_code", "type": "string", "description": "Transportation mode for the second longest distance transported." }, { "name": "natural_gas_transport_code", "type": "string", "description": "Contract type for natural gas transportation service.", "constraints": { "enum": [ "firm", "interruptible" ] } }, { "name": "natural_gas_delivery_contract_type_code", "type": "string", "description": "Contract type for natural gas delivery service:", "constraints": { "enum": [ "firm", "interruptible" ] } }, { "name": "moisture_content_pct", "type": "number", "description": "For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent." }, { "name": "chlorine_content_ppm", "type": "number", "description": "For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.", "unit": "ppm" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "contract_type_code" ], "reference": { "resource": "core_eia__codes_contract_types", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "primary_transportation_mode_code" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "secondary_transportation_mode_code" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "mine_id_pudl" ], "reference": { "resource": "core_eia923__entity_coalmine", "fields": [ "mine_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 10107974, "hash": "sha256:7996020f5833cea27d697a25270be9055c3d18561c034fed1bb3f9c35acb0995" }, { "name": "core_eia923__monthly_boiler_fuel", "type": "table", "description": "Monthly time series of boiler fuel consumption and emissions.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, boiler_id, energy_source_code, prime_mover_code, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReports the quantity of each type of fuel consumed by each boiler on a monthly basis, as\nwell as the sulfur and ash content of those fuels. Fuel quantity is reported in standard\nEIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported,\nmaking this table useful for calculating the thermal efficiency (heat rate) of various\ngeneration units.\n\nThis table provides better coverage of the entire fleet of generators than the\n``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly\nassociated with a generator. This complicates the heat rate calculation, since the\nassociations between individual boilers and generators are incomplete and can be\ncomplex.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__monthly_boiler_fuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "boiler_id", "energy_source_code", "prime_mover_code", "report_date" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "boiler_id" ], "reference": { "resource": "core_eia__entity_boilers", "fields": [ "plant_id_eia", "boiler_id" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6977106, "hash": "sha256:5c60f38ad4f52d48fd4f13a74bf72841ded8a748320e73b3069ac4bed25b5fb9" }, { "name": "core_eia923__monthly_energy_storage", "type": "table", "description": "Monthly time series of energy consumed and discharged (\"generated\") by energy storage units.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, report_date, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe total MWh discharged from the energy storage unit during the\nreporting period is the gross generation and the difference between gross generation\nand consumption is the net generation.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__monthly_energy_storage.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "fuel_units", "type": "string", "description": "Reported unit of measure for fuel.", "constraints": { "enum": [ "barrels", "mcf", "mwh", "short_tons" ] } }, { "name": "fuel_consumed_for_electricity_units", "type": "number", "description": "Consumption for electric generation of the fuel type in physical unit." }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" } ], "primaryKey": [ "plant_id_eia", "report_date", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 698625, "hash": "sha256:c177495f566ebcb078aabb03f33a1e6ed01fc7f9ca3df41337015355284d250e" }, { "name": "core_eia923__monthly_generation", "type": "table", "description": "Monthly time series of net electricity generated by power plant generators.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Not all IDs are present.\n\n* Table has known low coverage - either geographic or temporal or otherwise.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is the most granular information we have about how much electricity individual\ngenerators are producing, but only about half of all the generation reported in the\n``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting\nrequirements imposed on different types and sizes of generators.\n\nWhenever possible, we use this generator-level net generation to estimate the heat rates\nof generation units and the marginal cost of electricity on a per-generator basis, but\nthose calculations depend on plant-level fuel costs and sometimes uncertain or\nincomplete boiler-generator associations.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__monthly_generation.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2700191, "hash": "sha256:129d9ddb3377e3118f73560a13e4a5d828059d330d115cc2f0eb499bad870466" }, { "name": "core_eia923__monthly_generation_fuel", "type": "table", "description": "Monthly time series of generation and fuel consumption by fuel and prime mover.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, report_date, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis data can't be easily linked to individual boilers, generators, and\ngeneration units, but it is provides the most complete coverage\nof fuel consumption and electricity generation for the entire generation fleet. We use\nthe primary fuels and prime movers reported for each generator along with their\ncapacities to attribute fuel consumption and generation when it isn't directly reported\nin the ``core_eia923__monthly_generation`` and ``core_eia923__monthly_boiler_fuel`` tables in order to calculate\ncapacity factors, heat rates, and the marginal cost of electricity.\n\nThe table makes a distinction between all fuel consumed and fuel consumed for\nelectricity generation because some units are also combined heat and power (CHP) units,\nand also provide high temperature process heat at the expense of net electricity\ngeneration.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__monthly_generation_fuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_type_code_agg", "type": "string", "description": "A partial aggregation of the reported fuel type codes into larger categories used by EIA in, for example, the Annual Energy Review (AER) or Monthly Energy Review (MER). Two or three letter alphanumeric." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_consumed_for_electricity_units", "type": "number", "description": "Consumption for electric generation of the fuel type in physical unit." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "fuel_type_code_agg" ], "reference": { "resource": "core_eia__codes_fuel_types_agg", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 48762019, "hash": "sha256:05d5dced6b2930347cce10f538ab5436542999d037eeddb71612dc1823fba59a" }, { "name": "core_eia923__monthly_generation_fuel_nuclear", "type": "table", "description": "Monthly time series of generation and fuel consumption of nuclear generation units by fuel and prime mover.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, report_date, nuclear_unit_id, energy_source_code, prime_mover_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis data is originally reported\nalongside similar information for fossil fuel plants, but the nuclear data is reported\nby (nuclear) generation unit rather than fuel type and prime mover, and so has a\ndifferent primary key.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia923__monthly_generation_fuel_nuclear.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "nuclear_unit_id", "type": "string", "description": "For nuclear plants only, the unit number .One digit numeric. Nuclear plants are the only type of plants for which data are shown explicitly at the generating unit level.", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_type_code_agg", "type": "string", "description": "A partial aggregation of the reported fuel type codes into larger categories used by EIA in, for example, the Annual Energy Review (AER) or Monthly Energy Review (MER). Two or three letter alphanumeric." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_consumed_for_electricity_units", "type": "number", "description": "Consumption for electric generation of the fuel type in physical unit." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "nuclear_unit_id", "energy_source_code", "prime_mover_code" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "fuel_type_code_agg" ], "reference": { "resource": "core_eia__codes_fuel_types_agg", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 524732, "hash": "sha256:68372cf3fa8532e936213714594aae4fc4eb8ea27ca45057f4ad4f92594b5dda" }, { "name": "core_eia930__hourly_interchange", "type": "table", "description": "Hourly time series of balancing authority interchange.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, balancing_authority_code_eia, balancing_authority_code_adjacent_eia\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nInterchange is the net metered tie line flow from one BA to another directly\ninterconnected BA. Total net interchange is the net sum of all interchange occurring between a BA and its directly interconnected neighboring BAs.\nNegative interchange values indicate net inflows, and positive interchange values indicate net outflows.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "core_eia930__hourly_interchange.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Timestamp at the end of the hour for which the data is reported.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "balancing_authority_code_adjacent_eia", "type": "string", "description": "EIA short code for the other adjacent balancing authority, with which interchange is occurring. Includes Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "interchange_reported_mwh", "type": "number", "description": "Original reported energy interchange between adjacent balancing authorities.", "unit": "MWh" } ], "primaryKey": [ "datetime_utc", "balancing_authority_code_eia", "balancing_authority_code_adjacent_eia" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "balancing_authority_code_adjacent_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 83456691, "hash": "sha256:55c4db2009a393d84e5d8003ed046e8c571218171cf328c969572199f66001a4" }, { "name": "core_eia930__hourly_net_generation_by_energy_source", "type": "table", "description": "Hourly time series of balancing authority net generation by energy source.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, balancing_authority_code_eia, generation_energy_source\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains known calculation discrepancies.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nBAs report generation from dual-fuel (switching from one fuel to another) and\nmultiple-fuel (using multiple fuels simultaneously) generators under the actual energy source used, if known, and under the generator's primary energy source, if not known.\n\nTo maintain generator confidentiality, generation may sometimes be reported in the Other category if too few generators are reported for a particular energy source category.\n\nIn theory, the sum of net generation across all energy sources should equal the total net generation reported in the balancing authority operations table. In practice,\nthere are many cases in which these values diverge significantly, which require further investigation.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "core_eia930__hourly_net_generation_by_energy_source.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Timestamp at the end of the hour for which the data is reported.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "generation_energy_source", "type": "string", "description": "High level energy source used to produce electricity.", "constraints": { "required": true, "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "unknown", "wind", "battery_storage", "geothermal", "hydro_excluding_pumped_storage", "other_energy_storage", "pumped_storage", "solar_w_integrated_battery_storage", "solar_wo_integrated_battery_storage", "unknown_energy_storage", "wind_w_integrated_battery_storage", "wind_wo_integrated_battery_storage" ] } }, { "name": "net_generation_reported_mwh", "type": "number", "description": "Unaltered originally reported net generation for the specified period.", "unit": "MWh" }, { "name": "net_generation_adjusted_mwh", "type": "number", "description": "Reported net generation adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "net_generation_imputed_eia_mwh", "type": "number", "description": "Reported net generation with outlying values removed and missing values imputed by EIA.", "unit": "MWh" } ], "primaryKey": [ "datetime_utc", "balancing_authority_code_eia", "generation_energy_source" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 81181483, "hash": "sha256:5fe227a2785750afd43c2dadf4c7b8a0b3fd5139819c0c7fc509bb9fec998f9f" }, { "name": "core_eia930__hourly_operations", "type": "table", "description": "Hourly time series of balancing authority net generation, interchange, and demand.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, balancing_authority_code_eia\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nNet generation represents the metered output of electric generating units in a BA's electric system. This generation only includes generating units that are managed by a BA or whose operations are visible to a BA.\n\nGenerators on the distribution system\u2014both large-scale resources and small-scale distributed resources, such as rooftop solar photovoltaic (PV) systems\u2014are typically not included.\n\nIn some electricity publications, EIA reports generation from all utility-scale\ngenerating units in the United States. BAs only meter generating units that are from a subset of all utility-scale generating units. As a result, when hourly generation from the EIA-930 is aggregated to monthly or annual levels, the results will be lower than monthly and annual aggregations in other EIA electricity publications.\n\nInterchange is the net metered tie line flow from one BA to another directly\ninterconnected BA. This table includes the net sum of all interchange occurring between a BA and all of its directly interconnected neighboring BAs. For a detailed breakdown of interchange between each pair of adjacent BAs see\ncore_eia930__hourly_interchange.\n\nNegative interchange values indicate net inflows, and positive interchange values indicate net outflows.\n\nDemand is a calculated value representing the amount of electricity load within a BA's electric system. A BA derives its demand value by taking the total metered net electricity generation within its electric system and subtracting the total metered net electricity interchange occurring between the BA and its neighboring BAs.\n\nEach BA produces a day-ahead electricity demand forecast for every hour of the next day. These forecasts help BAs plan for and coordinate the reliable operation of their electric system.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "core_eia930__hourly_operations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Timestamp at the end of the hour for which the data is reported.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "net_generation_reported_mwh", "type": "number", "description": "Unaltered originally reported net generation for the specified period.", "unit": "MWh" }, { "name": "net_generation_adjusted_mwh", "type": "number", "description": "Reported net generation adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "net_generation_imputed_eia_mwh", "type": "number", "description": "Reported net generation with outlying values removed and missing values imputed by EIA.", "unit": "MWh" }, { "name": "interchange_reported_mwh", "type": "number", "description": "Original reported energy interchange between adjacent balancing authorities.", "unit": "MWh" }, { "name": "interchange_adjusted_mwh", "type": "number", "description": "Energy interchange between adjacent balancing authorities, adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "interchange_imputed_eia_mwh", "type": "number", "description": "Energy interchange between adjacent balancing authorities, with outliers and missing values imputed by EIA.", "unit": "MWh" }, { "name": "demand_reported_mwh", "type": "number", "description": "Originally reported electricity demand, calculated by taking the net generation within the BA and subtracting the interchange with adjacent BAs.", "unit": "MWh" }, { "name": "demand_adjusted_mwh", "type": "number", "description": "Electricity demand adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "demand_imputed_eia_mwh", "type": "number", "description": "Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed by EIA.", "unit": "MWh" }, { "name": "demand_forecast_mwh", "type": "number", "description": "Day ahead demand forecast.", "unit": "MWh" } ], "primaryKey": [ "datetime_utc", "balancing_authority_code_eia" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 87786607, "hash": "sha256:98641b6222584ed2a9b6e0af3a9a48ce92d1b85f8ebff58614798e9d148fdc68" }, { "name": "core_eia930__hourly_subregion_demand", "type": "table", "description": "Hourly time series of balancing authority subregion demand.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, balancing_authority_code_eia, balancing_authority_subregion_code_eia\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nFor select BAs, balancing authority subregion demand provides a further level of geographic disaggregation (for example, load zones, weather zones, operating company areas, local BAs, etc.) within a BA's electric system.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "core_eia930__hourly_subregion_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Timestamp at the end of the hour for which the data is reported.", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "balancing_authority_subregion_code_eia", "type": "string", "description": "Code identifying subregions of larger balancing authorities.", "constraints": { "required": true, "enum": [ "0001", "0004", "0006", "0027", "0035", "4001", "4002", "4003", "4004", "4005", "4006", "4007", "4008", "8910", "ACMA", "AE", "AEP", "AP", "ATSI", "BASI", "BC", "CE", "COAS", "CSWS", "CYGA", "DAY", "DEOK", "DOM", "DPL", "DUQ", "EAST", "EDE", "EKPC", "FREP", "FWES", "GRDA", "INDN", "JC", "JICA", "KACY", "KAFB", "KCEC", "KCPL", "LAC", "LES", "ME", "MPS", "NCEN", "NPPD", "NRTH", "NTUA", "OKGE", "OPPD", "PE", "PEP", "PGAE", "PL", "PN", "PNM", "PRPA", "PS", "RECO", "SCE", "SCEN", "SDE", "SDGE", "SECI", "SOUT", "SPRM", "SPS", "TSGT", "VEA", "WACM", "WAUE", "WAUW", "WEST", "WFEC", "WR", "WYE", "ZONA", "ZONB", "ZONC", "ZOND", "ZONE", "ZONF", "ZONG", "ZONH", "ZONI", "ZONJ", "ZONK" ] } }, { "name": "demand_reported_mwh", "type": "number", "description": "Originally reported electricity demand for the balancing area subregion. Note that different BAs have different methods of calculating and allocating subregion demand.", "unit": "MWh" } ], "primaryKey": [ "datetime_utc", "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authority_subregions", "fields": [ "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 14364598, "hash": "sha256:b713c47efada0ee92b74b2b9d64c7e9e3959a4f737c759d0c7b72f21168a8f5a" }, { "name": "core_eia__codes_averaging_periods", "type": "table", "description": "Code table containing descriptions of categorical codes for the averaging period specified by emissions statutes and regulations for the EIA 860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_averaging_periods.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4165, "hash": "sha256:998713607756bf90513b02039bf95e8b95d7233697638b17ade0332c810455c1" }, { "name": "core_eia__codes_balancing_authorities", "type": "table", "description": "Code table containing descriptions of categorical codes for balancing authorities in EIA 860, EIA 923, and EIA 930.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_balancing_authorities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." }, { "name": "balancing_authority_region_code_eia", "type": "string", "description": "EIA balancing authority region code.", "constraints": { "enum": [ "TEX", "CENT", "MEX", "CAR", "FLA", "MIDW", "CAL", "MIDA", "SE", "NE", "SW", "NW", "TEN", "NY", "CAN" ] } }, { "name": "balancing_authority_region_name_eia", "type": "string", "description": "Human-readable name of the EIA balancing region." }, { "name": "report_timezone", "type": "string", "description": "Timezone used by the reporting entity. For use in localizing UTC times.", "constraints": { "enum": [ "America/Anchorage", "America/Chicago", "America/Denver", "America/Los_Angeles", "America/New_York", "America/Phoenix", "Pacific/Honolulu" ] } }, { "name": "balancing_authority_retirement_date", "type": "date", "description": "Date on which the balancing authority ceased independent operation." }, { "name": "is_generation_only", "type": "boolean", "description": "Indicates whether the balancing authority is generation-only, meaning it does not serve retail customers and thus reports only net generation and interchange, but not demand." }, { "name": "interconnect_code_eia", "type": "string", "description": "EIA interconnect code.", "constraints": { "enum": [ "ercot", "western", "eastern" ] } } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 14379, "hash": "sha256:d042acf65dce72497fe565ba872be424cfb18ecb65d07024b34512de87c8eeb5" }, { "name": "core_eia__codes_balancing_authority_subregions", "type": "table", "description": "Code table containing descriptions of categorical codes for balancing authority subregions in EIA 930.\n\n\nMost-recent data:\n 2026half1\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n balancing_authority_code_eia, balancing_authority_subregion_code_eia", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "core_eia__codes_balancing_authority_subregions.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "balancing_authority_subregion_code_eia", "type": "string", "description": "Code identifying subregions of larger balancing authorities.", "constraints": { "required": true, "enum": [ "0001", "0004", "0006", "0027", "0035", "4001", "4002", "4003", "4004", "4005", "4006", "4007", "4008", "8910", "ACMA", "AE", "AEP", "AP", "ATSI", "BASI", "BC", "CE", "COAS", "CSWS", "CYGA", "DAY", "DEOK", "DOM", "DPL", "DUQ", "EAST", "EDE", "EKPC", "FREP", "FWES", "GRDA", "INDN", "JC", "JICA", "KACY", "KAFB", "KCEC", "KCPL", "LAC", "LES", "ME", "MPS", "NCEN", "NPPD", "NRTH", "NTUA", "OKGE", "OPPD", "PE", "PEP", "PGAE", "PL", "PN", "PNM", "PRPA", "PS", "RECO", "SCE", "SCEN", "SDE", "SDGE", "SECI", "SOUT", "SPRM", "SPS", "TSGT", "VEA", "WACM", "WAUE", "WAUW", "WEST", "WFEC", "WR", "WYE", "ZONA", "ZONB", "ZONC", "ZOND", "ZONE", "ZONF", "ZONG", "ZONH", "ZONI", "ZONJ", "ZONK" ] } }, { "name": "balancing_authority_subregion_name_eia", "type": "string", "description": "Name of the balancing authority subregion." } ], "primaryKey": [ "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6991, "hash": "sha256:c0745b6b07175c6e48eeb41824bcf44c1d4c65fe5215f2ba478b1c2507b22ab9" }, { "name": "core_eia__codes_boiler_generator_assn_types", "type": "table", "description": "Code table containing descriptions of categorical codes for boiler-generator associations in the EIA 860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_boiler_generator_assn_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3731, "hash": "sha256:0ad17773a3ef1ba4bbdc5bb1feb2bc15d982007802c797d0f4c7ee4305f44726" }, { "name": "core_eia__codes_boiler_status", "type": "table", "description": "Code table containing descriptions of categorical codes for boiler status in the EIA 860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_boiler_status.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4321, "hash": "sha256:0ec80a2ce34acad4282d3db47c2b2e9815fb33e40e55cdc51a535a230eea008d" }, { "name": "core_eia__codes_boiler_types", "type": "table", "description": "Code table containing descriptions of categorical codes for boiler regulatory types in the EIA 860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_boiler_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4133, "hash": "sha256:5610abdb8e3f2eb9b9142943df5f9c452d2356d308408dae6be6036344ec2f04" }, { "name": "core_eia__codes_coalmine_types", "type": "table", "description": "Code table containing descriptions of categorical codes for coalmines reported as fuel sources in the EIA-923.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_coalmine_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3992, "hash": "sha256:27cc20ab5687cca7706ea04afd71756c707593277322e727cbc5a6226c42412b" }, { "name": "core_eia__codes_contract_types", "type": "table", "description": "Code table containing descriptions of categorical codes for fuel supply contracts reported in EIA-923.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_contract_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4129, "hash": "sha256:dba1095bda87dbaf38ac84d4db5c88e88c8fbe81029238165862f9fe2bbd86cc" }, { "name": "core_eia__codes_cooling_system_types", "type": "table", "description": "Code table containing descriptions of categorical codes for cooling systems.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_cooling_system_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4409, "hash": "sha256:9ff3d8881734747b3f5d972302b2c64d251e747f543fea593b46290f32133422" }, { "name": "core_eia__codes_cooling_tower_types", "type": "table", "description": "Code table containing descriptions of categorical codes for cooling towers.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_cooling_tower_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3681, "hash": "sha256:a4ead68730103b1bb8aed2a2f5ec759051b8813860a2a80d1e6420c89f317f7c" }, { "name": "core_eia__codes_cooling_water_sources", "type": "table", "description": "Code table containing descriptions of categorical codes for cooling water sources in EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_cooling_water_sources.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3833, "hash": "sha256:355f9bc6ff7690f6c06bc6192f2462b003c1bc287c66b54c5757663db3ca56b3" }, { "name": "core_eia__codes_cooling_water_types", "type": "table", "description": "Code table containing descriptions of categorical codes for cooling water.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_cooling_water_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3675, "hash": "sha256:553cdf2b06dc87a5d21e6956af50d170d9064e13635d62bb17595dd54365a6e0" }, { "name": "core_eia__codes_emission_control_equipment_types", "type": "table", "description": "Code table containing descriptions of categorical codes for emissions control equipment installed on a boiler.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_emission_control_equipment_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4755, "hash": "sha256:25127f770c3fc58f0a7f3682ffff78ee16657877282395ae445edf1db0deb1c0" }, { "name": "core_eia__codes_energy_sources", "type": "table", "description": "Code table containing descriptions of categorical codes for energy sources reported to EIA.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nCompiled from EIA-860 instructions and EIA-923 file layout spreadsheets.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_energy_sources.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "fuel_units", "type": "string", "description": "Reported unit of measure for fuel.", "constraints": { "enum": [ "barrels", "mcf", "mwh", "short_tons" ] } }, { "name": "min_fuel_mmbtu_per_unit", "type": "number", "description": "Minimum heat content per physical unit of fuel in MMBTU.", "unit": "MMBTU" }, { "name": "max_fuel_mmbtu_per_unit", "type": "number", "description": "Maximum heat content per physical unit of fuel in MMBTU.", "unit": "MMBTU" }, { "name": "fuel_group_eia", "type": "string", "description": "High level fuel group defined in the 2021-2023 EIA Form 860 instructions, Table 28.", "constraints": { "enum": [ "fossil", "other", "renewable" ] } }, { "name": "fuel_derived_from", "type": "string", "description": "Original fuel from which this refined fuel was derived.", "constraints": { "enum": [ "biomass", "coal", "gas", "other", "petroleum" ] } }, { "name": "fuel_phase", "type": "string", "description": "Physical phase of matter of the fuel.", "constraints": { "enum": [ "gas", "liquid", "solid" ] } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 12744, "hash": "sha256:4b0da16419480ee74c1f56a1c3d95222c43ed3bfd8046bb52567634e250394e9" }, { "name": "core_eia__codes_environmental_equipment_manufacturers", "type": "table", "description": "Code table containing descriptions of categorical codes for manufacturers of boilers and environmental control equipment in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_environmental_equipment_manufacturers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 8743, "hash": "sha256:018fd872f6016a0f40f5df6b5cae5df22b22a4286173c199cc1c59873dc7bf5a" }, { "name": "core_eia__codes_firing_types", "type": "table", "description": "Code table containing descriptions of categorical codes for boiler firing types in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_firing_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4079, "hash": "sha256:854657d8b50a0e83a4b4690c05c4e890a66bff9bf011fed8d6e741f2acc2e86d" }, { "name": "core_eia__codes_fuel_transportation_modes", "type": "table", "description": "Code table containing descriptions of categorical codes for fuel transportation modes reported in the EIA-860 and EIA-923.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_fuel_transportation_modes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4844, "hash": "sha256:93b928fbfb2419f19fcfb64c9fdbb4dd7423692e12cb537dc7658d17e8a250e0" }, { "name": "core_eia__codes_fuel_types_agg", "type": "table", "description": "Code table containing descriptions of categorical codes for aggregated fuel types used in the Annual Energy Review or Monthly Energy Review.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nSee EIA-923 Fuel Code table for additional information.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_fuel_types_agg.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3756, "hash": "sha256:0251aca052aa5647b03c74d79994ff5212501d72a259efb1fd8e23ed4b95dd61" }, { "name": "core_eia__codes_mercury_compliance_strategies", "type": "table", "description": "Code table containing descriptions of categorical codes for compliance strategies used to control mercury in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_mercury_compliance_strategies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5011, "hash": "sha256:c8d927ea213943b70ea62057545b753598c6a2be5d4150468576317fb7dde6a6" }, { "name": "core_eia__codes_momentary_interruptions", "type": "table", "description": "Code table containing descriptions of categorical codes for utility definitions of momentary service interruptions.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "core_eia__codes_momentary_interruptions.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3951, "hash": "sha256:ef67ff908ff240df44b3aac3d728fa9dda34458f19814dd79a755f6a176908c7" }, { "name": "core_eia__codes_nox_compliance_strategies", "type": "table", "description": "Code table containing descriptions of categorical codes for compliance strategies used to control nitrogen oxide in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_nox_compliance_strategies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4798, "hash": "sha256:816291ce897e3d05c61425c0bb82eccfa480fd74378a6c6f8fcac9d16ff69248" }, { "name": "core_eia__codes_nox_control_status", "type": "table", "description": "Code table containing descriptions of categorical codes for the operational status of nitrogen oxide control units associated with boilers in the EIA-860 data.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_nox_control_status.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4331, "hash": "sha256:dde9511eee3e9900ab97712df51cf1f84c0bfd2b3ba3b00b553d7fbb4ba022bf" }, { "name": "core_eia__codes_nox_units", "type": "table", "description": "Code table containing descriptions of categorical codes for units of measurement for nitrogen oxide in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_nox_units.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4146, "hash": "sha256:a7d19731837262895d02f0cc4f3a3d7e3f04e3ddbd63593c1f6d35f449b78f47" }, { "name": "core_eia__codes_operational_status", "type": "table", "description": "Code table containing descriptions of categorical codes for operational status reported to EIA.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nCompiled from EIA-860 instructions and EIA-923 file layout spreadsheets.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_operational_status.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6449, "hash": "sha256:e61f5b0e5224e9a2d0bd34b55eb3973cc1e098a0884c0196b3b47696ab37827c" }, { "name": "core_eia__codes_particulate_compliance_strategies", "type": "table", "description": "Code table containing descriptions of categorical codes for compliance strategies used to control particulate matter in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_particulate_compliance_strategies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4200, "hash": "sha256:b4b55c5941c146da1164babb22ebed470d7a8bb87f8881c3896c2621d3201b01" }, { "name": "core_eia__codes_particulate_units", "type": "table", "description": "Code table containing descriptions of categorical codes for units of measurement for particulate matter in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_particulate_units.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4170, "hash": "sha256:671b08a8aef6926fe3194175f1a08ee70a14cc2d9b904b44c86df48e528c4d39" }, { "name": "core_eia__codes_prime_movers", "type": "table", "description": "Code table containing descriptions of categorical codes for prime movers reported in the EIA-860 and EIA-923.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_prime_movers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4996, "hash": "sha256:0d66aff690138aa51079f869786c62c89a3285b0e6126d46004c64f1c3da60b2" }, { "name": "core_eia__codes_regulations", "type": "table", "description": "Code table containing descriptions of categorical codes for levels of statutes and codes under which boilers operate in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_regulations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4250, "hash": "sha256:ca8412d1e407c0760b8adb5659087044a2cdd3fe1fc532b321c5642590d33920" }, { "name": "core_eia__codes_reporting_frequencies", "type": "table", "description": "Code table containing descriptions of categorical codes for the reporting frequencies used by plants in the EIA-923.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_reporting_frequencies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4620, "hash": "sha256:30976c184c612fdd69bf05398af5ebf4ff37863c174c4dc34a66b11d70056ace" }, { "name": "core_eia__codes_sector_consolidated", "type": "table", "description": "Code table containing descriptions of categorical codes for EIA consolidated NAICS sectors.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nCodes and descriptions taken from the EIA-923 File Layout spreadsheet.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__codes_sector_consolidated.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4637, "hash": "sha256:ab321f793a61f64e893f24a450feee8cac75782ea347a1680c7b0b9724ababae" }, { "name": "core_eia__codes_so2_compliance_strategies", "type": "table", "description": "Code table containing descriptions of categorical codes for compliance strategies used to control sulfur dioxide in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_so2_compliance_strategies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5130, "hash": "sha256:a92cdc7dfae1b269d246b526cae0889eba0431946be82e28f0650ab4896760c1" }, { "name": "core_eia__codes_so2_units", "type": "table", "description": "Code table containing descriptions of categorical codes for units of measurement for sulfur dioxide in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_so2_units.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4308, "hash": "sha256:3cf26ba12e39f4ae68ade2a393dc3ca38c9167bd7db38f8837dea4b272d70da4" }, { "name": "core_eia__codes_sorbent_types", "type": "table", "description": "Code table containing descriptions of categorical codes for flue gas desulfurization sorbent types used in EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_sorbent_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4647, "hash": "sha256:113ad66a4c54d309e5e7c9999c2d1433e2ab5d006e6bf5c845ee0de3828bb80e" }, { "name": "core_eia__codes_steam_plant_types", "type": "table", "description": "Code table containing descriptions of categorical codes for steam plants in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_steam_plant_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4795, "hash": "sha256:2b7481c77ca473ad7f302bade1ebc9c0bb71f68d64bbe929dc7408648906bbb2" }, { "name": "core_eia__codes_storage_enclosure_types", "type": "table", "description": "Code table containing descriptions of categorical codes for energy storage enclosures.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_storage_enclosure_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3606, "hash": "sha256:f3fb10b5650d2d302141328c872904de5f5f0ad076ab3246d44484001c705906" }, { "name": "core_eia__codes_storage_technology_types", "type": "table", "description": "Code table containing descriptions of categorical codes for energy storage technologies.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_storage_technology_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3944, "hash": "sha256:f86cfe393e3300095246e22ee31cdcd82e2e8481535c2d05ef42a655359a3b70" }, { "name": "core_eia__codes_wet_dry_bottom", "type": "table", "description": "Code table containing descriptions of categorical codes for boiler bottoms in the EIA-860.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_wet_dry_bottom.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4235, "hash": "sha256:0b7bde995f021413189faa7756ec37c16da697ff29fdce7a9dbb5d2da5900509" }, { "name": "core_eia__codes_wind_quality_class", "type": "table", "description": "Code table containing descriptions of categorical codes for wind quality classes.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "core_eia__codes_wind_quality_class.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." }, { "name": "wind_speed_avg_ms", "type": "number", "description": "Average wind speed in meters per second.", "unit": "ms" }, { "name": "extreme_fifty_year_gust_ms", "type": "number", "description": "The extreme 50-year wind gusts at this generator in meters per hour.", "unit": "ms" }, { "name": "turbulence_intensity_a", "type": "number", "description": "The upper bounds of the turbulence intensity at the wind site (ratio of standard deviation of fluctuating wind velocity to the mean wind speed)." }, { "name": "turbulence_intensity_b", "type": "number", "description": "The lower bounds of the turbulence intensity at the wind site (ratio of standard deviation of fluctuating wind velocity to the mean wind speed)." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7063, "hash": "sha256:14265b945ab8f0ae2a12916fda89adb9ee9c4fecab2f9fa34f99c3ec1529ce50" }, { "name": "core_eia__entity_boilers", "type": "table", "description": "Entity table containing static information about boilers compiled from the EIA-860 and EIA-923.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n plant_id_eia, boiler_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for boilers are set. It contains values which are expected to remain fixed, while\n:ref:`core_eia860__scd_boilers` contains those which may vary from year to year.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__entity_boilers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "boiler_manufacturer", "type": "string", "description": "Name of boiler manufacturer." }, { "name": "boiler_manufacturer_code", "type": "string", "description": "EIA short code for boiler manufacturer." } ], "primaryKey": [ "plant_id_eia", "boiler_id" ], "foreignKeys": [ { "fields": [ "boiler_manufacturer_code" ], "reference": { "resource": "core_eia__codes_environmental_equipment_manufacturers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 48433, "hash": "sha256:a02f369d4e7bb2134c1a88dfd7866997775521d30366543a0f7be872942f6832" }, { "name": "core_eia__entity_generators", "type": "table", "description": "Entity table containing static information about generators compiled from across the EIA-860 and EIA-923.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n plant_id_eia, generator_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for generators are set. It contains values which are expected to remain fixed, while\n:ref:`core_eia860__scd_generators` contains those which may vary from year to year.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__entity_generators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "duct_burners", "type": "boolean", "description": "Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas" }, { "name": "generator_operating_date", "type": "date", "description": "Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date." }, { "name": "topping_bottoming_code", "type": "string", "description": "If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle" }, { "name": "solid_fuel_gasification", "type": "boolean", "description": "Indicates whether the generator is part of a solid fuel gasification system" }, { "name": "pulverized_coal_tech", "type": "boolean", "description": "Indicates whether the generator uses pulverized coal technology" }, { "name": "fluidized_bed_tech", "type": "boolean", "description": "Indicates whether the generator uses fluidized bed technology" }, { "name": "subcritical_tech", "type": "boolean", "description": "Indicates whether the generator uses subcritical technology" }, { "name": "supercritical_tech", "type": "boolean", "description": "Indicates whether the generator uses supercritical technology" }, { "name": "ultrasupercritical_tech", "type": "boolean", "description": "Indicates whether the generator uses ultra-supercritical technology" }, { "name": "stoker_tech", "type": "boolean", "description": "Indicates whether the generator uses stoker technology" }, { "name": "other_combustion_tech", "type": "boolean", "description": "Indicates whether the generator uses other combustion technologies" }, { "name": "bypass_heat_recovery", "type": "boolean", "description": "Can this generator operate while bypassing the heat recovery steam generator?" }, { "name": "rto_iso_lmp_node_id", "type": "string", "description": "The designation used to identify the price node in RTO/ISO Locational Marginal Price reports" }, { "name": "rto_iso_location_wholesale_reporting_id", "type": "string", "description": "The designation used to report the specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report" }, { "name": "associated_combined_heat_power", "type": "boolean", "description": "Indicates whether the generator is associated with a combined heat and power system" }, { "name": "original_planned_generator_operating_date", "type": "date", "description": "The date the generator was originally scheduled to be operational" }, { "name": "can_switch_when_operating", "type": "boolean", "description": "Indicates whether a fuel switching generator can switch fuels while operating." }, { "name": "previously_canceled", "type": "boolean", "description": "Indicates whether the generator was previously reported as indefinitely postponed or canceled" } ], "primaryKey": [ "plant_id_eia", "generator_id" ], "foreignKeys": [ { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 501683, "hash": "sha256:883e1860c0858fec540c4af2de958f8812b32b078f31c080dc2d408d601f2cfd" }, { "name": "core_eia__entity_plants", "type": "table", "description": "Entity table containing static information about plants, compiled from across all EIA-860 and EIA-923 data.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n plant_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for plants are set. It contains values which are expected to remain fixed, while\n:ref:`core_eia860__scd_plants` contains those which may vary from year to year.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__entity_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "latitude", "type": "number", "description": "Latitude of the plant's location, in degrees." }, { "name": "longitude", "type": "number", "description": "Longitude of the plant's location, in degrees." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } } ], "primaryKey": [ "plant_id_eia" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1112530, "hash": "sha256:e5bdafcc73a6ad02d738343749a40287348fe42683923d0b69520445c35e99c3" }, { "name": "core_eia__entity_utilities", "type": "table", "description": "Entity table containing static information about utilities, compiled from all EIA data.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n utility_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is one of two tables where canonical\nvalues for utilities are set. It contains values which are expected to remain fixed, while\n:ref:`core_eia860__scd_utilities` contains those which may vary from year to year.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.\nAll tables downstream of this one inherit the canonical values established here.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_eia__entity_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." } ], "primaryKey": [ "utility_id_eia" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 377598, "hash": "sha256:f3374d218ff2d88541cde2867c97790b22dfa10d205b5a520aaabdd20ac998a4" }, { "name": "core_eia__yearly_fuel_receipts_costs_aggs", "type": "table", "description": "Annual time series of aggregated fuel receipts and costs from the EIA API.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n fuel_agg, geo_agg, sector_agg, temporal_agg, report_date", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eiaapi", "title": "EIA Bulk API Data", "path": "https://www.eia.gov/opendata/bulkfiles.php", "description": "All data made available in bulk through the EIA Open Data API. At present, PUDL integrates only a few specific data series related to fuel receipts and costs figures from the Bulk Electricity API.", "keywords": [ "MW", "MWh", "annual energy outlook", "ash", "carbon dioxide", "chlorine", "co2", "distribution", "eia", "eia aeo", "eia ieo", "eia seds", "eia seo", "electric", "electricity", "emissions", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "ghg", "government", "international energy outlook", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nems", "nox", "particulate", "pm2.5", "pollution", "power", "short-term energy outlook", "so2", "sox", "state energy data system", "sulfur", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.7067366", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947272", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaapi.html" } ], "path": "core_eia__yearly_fuel_receipts_costs_aggs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "fuel_agg", "type": "string", "description": "Category of fuel aggregation in EIA bulk electricity data.", "constraints": { "required": true } }, { "name": "geo_agg", "type": "string", "description": "Category of geographic aggregation in EIA bulk electricity data.", "constraints": { "required": true } }, { "name": "sector_agg", "type": "string", "description": "Category of sectoral aggregation in EIA bulk electricity data.", "constraints": { "required": true } }, { "name": "temporal_agg", "type": "string", "description": "Category of temporal aggregation in EIA bulk electricity data.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "fuel_received_mmbtu", "type": "number", "description": "Aggregated fuel receipts, in MMBTU, in EIA bulk electricity data.", "unit": "MMBTU" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" } ], "primaryKey": [ "fuel_agg", "geo_agg", "sector_agg", "temporal_agg", "report_date" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual energy outlook", "ash", "carbon dioxide", "chlorine", "co2", "distribution", "eia", "eia aeo", "eia ieo", "eia seds", "eia seo", "electric", "electricity", "emissions", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "ghg", "government", "international energy outlook", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nems", "nox", "particulate", "pm2.5", "pollution", "power", "short-term energy outlook", "so2", "sox", "state energy data system", "sulfur", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2469770, "hash": "sha256:a7e9a31546fe621018ddfee294221516236312705c3035b398be46aa092efe19" }, { "name": "core_eiaaeo__yearly_projected_electric_sales", "type": "table", "description": "Annual time series of projected electricity sales by region and customer class.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Annual Energy Outlook (AEO)\n\nPrimary key:\n report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, customer_class", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eiaaeo", "title": "EIA Annual Energy Outlook (AEO)", "path": "https://www.eia.gov/outlooks/aeo/", "description": "The EIA Annual Energy Outlook provides projections of future fuel prices, energy supply and consumption, and carbon dioxide emissions by sector and region.", "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10838487", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19535635", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaaeo.html" } ], "path": "core_eiaaeo__yearly_projected_electric_sales.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "electricity_market_module_region_eiaaeo", "type": "string", "description": "AEO projection region.", "constraints": { "required": true, "enum": [ "florida_reliability_coordinating_council", "midcontinent_central", "midcontinent_east", "midcontinent_south", "midcontinent_west", "northeast_power_coordinating_council_new_england", "northeast_power_coordinating_council_new_york_city_and_long_island", "northeast_power_coordinating_council_upstate_new_york", "pjm_commonwealth_edison", "pjm_dominion", "pjm_east", "pjm_west", "serc_reliability_corporation_central", "serc_reliability_corporation_east", "serc_reliability_corporation_southeastern", "southwest_power_pool_central", "southwest_power_pool_north", "southwest_power_pool_south", "texas_reliability_entity", "united_states", "western_electricity_coordinating_council_basin", "western_electricity_coordinating_council_california_north", "western_electricity_coordinating_council_california_south", "western_electricity_coordinating_council_northwest_power_pool_area", "western_electricity_coordinating_council_rockies", "western_electricity_coordinating_council_southwest" ] } }, { "name": "model_case_eiaaeo", "type": "string", "description": "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.", "constraints": { "required": true, "enum": [ "aeo2022", "aeo2023", "alternative_electricity", "alternative_transportation", "alternative_electricity_and_transportation", "counterfactual_baseline", "fast_builds_plus_high_lng_price", "high_economic_growth", "high_electricity_demand", "high_lng_price", "high_macro_and_high_zero_carbon_technology_cost", "high_macro_and_low_zero_carbon_technology_cost", "high_oil_and_gas_supply", "high_oil_price", "high_uptake_of_inflation_reduction_act", "high_zero_carbon_technology_cost", "low_economic_growth", "low_lng_price", "low_macro_and_high_zero_carbon_technology_cost", "low_macro_and_low_zero_carbon_technology_cost", "low_oil_and_gas_supply", "low_oil_price", "low_uptake_of_inflation_reduction_act", "low_zero_carbon_technology_cost", "no_inflation_reduction_act", "reference" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value.", "constraints": { "required": true } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type (e.g., commercial, residential).", "constraints": { "required": true, "enum": [ "commercial", "industrial", "direct_connection", "other", "residential", "total", "transportation", "commercial_other" ] } }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" } ], "primaryKey": [ "report_year", "electricity_market_module_region_eiaaeo", "model_case_eiaaeo", "projection_year", "customer_class" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 689648, "hash": "sha256:3e6d1a9f3ed3aec36542081bcfab5907c702801292266a637e01641c11b5ec10" }, { "name": "core_eiaaeo__yearly_projected_energy_use_by_sector_and_type", "type": "table", "description": "Annual time series of projected energy use for commercial, electric power, industrial, residential, and transportation sectors, drawn from AEO Table 2.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Annual Energy Outlook (AEO)\n\nPrimary key:\n report_year, region_name_eiaaeo, model_case_eiaaeo, projection_year, energy_use_sector, energy_use_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe series in Table 2 which track energy use by sector do not always define each type\nof use the same way across sectors. There is detailed information about what is\nincluded or excluded in each use type for each sector in the footnotes of the EIA's\nonline AEO data browser:\n\nhttps://www.eia.gov/outlooks/aeo/data/browser/#/?id=2-AEO2023\n\nUse caution when aggregating across use types! Energy Use has a tricky system of\nsubtotals, and summing all types within a sector will result in double-counting.\nConsult the EIA's data browser for visibility into which use types are subtotals, and\nwhat they contain: subtotal series are displayed indented, and include all lines\nabove them which are one level out, up to the next indented line. Delivered Energy\nand Total are special cases which include those plus all subtotals above. In this\nway, \"Delivered Energy\" includes purchased electricity, renewable energy, and an\narray of fuels based on sector, and explicitly excludes electricity-related losses.\n\nAEO Energy Use figures are variously referred to as delivered energy, energy\nconsumption, energy use, and energy demand, depending on which use types are\nbeing discussed, and which org and which document is describing them. In PUDL we\nsay energy use or energy consumption.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eiaaeo", "title": "EIA Annual Energy Outlook (AEO)", "path": "https://www.eia.gov/outlooks/aeo/", "description": "The EIA Annual Energy Outlook provides projections of future fuel prices, energy supply and consumption, and carbon dioxide emissions by sector and region.", "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10838487", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19535635", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaaeo.html" } ], "path": "core_eiaaeo__yearly_projected_energy_use_by_sector_and_type.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "region_name_eiaaeo", "type": "string", "description": "EIA AEO region for energy consumption. Includes US Census Divisions plus United States.", "constraints": { "required": true, "enum": [ "east_north_central", "east_south_central", "middle_atlantic", "mountain", "new_england", "pacific", "south_atlantic", "west_north_central", "west_south_central", "united_states" ] } }, { "name": "region_type_eiaaeo", "type": "string", "description": "Region type for EIA AEO energy consumption, indicating whether region_name_eiaaeo is a US Census Division or country (United States)", "constraints": { "enum": [ "us_census_division", "country" ] } }, { "name": "model_case_eiaaeo", "type": "string", "description": "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.", "constraints": { "required": true, "enum": [ "aeo2022", "aeo2023", "alternative_electricity", "alternative_transportation", "alternative_electricity_and_transportation", "counterfactual_baseline", "fast_builds_plus_high_lng_price", "high_economic_growth", "high_electricity_demand", "high_lng_price", "high_macro_and_high_zero_carbon_technology_cost", "high_macro_and_low_zero_carbon_technology_cost", "high_oil_and_gas_supply", "high_oil_price", "high_uptake_of_inflation_reduction_act", "high_zero_carbon_technology_cost", "low_economic_growth", "low_lng_price", "low_macro_and_high_zero_carbon_technology_cost", "low_macro_and_low_zero_carbon_technology_cost", "low_oil_and_gas_supply", "low_oil_price", "low_uptake_of_inflation_reduction_act", "low_zero_carbon_technology_cost", "no_inflation_reduction_act", "reference" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value.", "constraints": { "required": true } }, { "name": "energy_use_sector", "type": "string", "description": "Sector for energy use figures in AEO Table 2. Similar to customer class, but with some missing and some extra values.", "constraints": { "required": true, "enum": [ "unspecified", "commercial", "other", "total", "commercial_other", "electric_power", "transportation", "industrial_hydrogen_production", "residential", "industrial" ] } }, { "name": "energy_use_type", "type": "string", "description": "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.", "constraints": { "required": true, "enum": [ "biofuels_heat_and_coproducts", "byproduct_hydrogen", "coal", "coal_subtotal", "coal_to_liquids_heat_and_power", "delivered_energy", "distillate_fuel_oil", "e85", "electricity", "electricity_imports", "electricity_related_losses", "ev_charging_commercial", "ev_charging_residential", "hydrocarbon_gas_liquids", "hydrogen", "hydrogen_related_losses", "jet_fuel", "kerosene", "lease_and_plant_fuel", "liquefaction", "liquid_fuels_subtotal", "liquefied_petroleum_gases", "metallurgical_coal", "motor_gasoline", "natural_gas", "natural_gas_subtotal", "natural_gas_to_liquids_heat_and_power", "net_coal_coke_imports", "non_biogenic_municipal_waste", "nuclear", "other_industrial_coal", "other_petroleum", "other_coal", "passenger_rail", "petrochemical_feedstocks", "pipeline_fuel_natural_gas", "pipeline_natural_gas", "propane", "purchased_electricity", "renewable_energy", "residual_fuel_oil", "steam_coal", "total", "total_energy" ] } }, { "name": "energy_use_mmbtu", "type": "number", "description": "Energy use, in MMBTU; also referred to as energy consumption, energy demand, or delivered energy, depending on type.", "unit": "MMBTU" } ], "primaryKey": [ "report_year", "region_name_eiaaeo", "model_case_eiaaeo", "projection_year", "energy_use_sector", "energy_use_type" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4811380, "hash": "sha256:bd2e9a88617783bbd4f3681de177daef366e5c458b99ea4a60f85f5421c3ba19" }, { "name": "core_eiaaeo__yearly_projected_fuel_cost_in_electric_sector_by_type", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Annual Energy Outlook (AEO)\n\nPrimary key:\n report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, fuel_type_eiaaeo", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eiaaeo", "title": "EIA Annual Energy Outlook (AEO)", "path": "https://www.eia.gov/outlooks/aeo/", "description": "The EIA Annual Energy Outlook provides projections of future fuel prices, energy supply and consumption, and carbon dioxide emissions by sector and region.", "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10838487", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19535635", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaaeo.html" } ], "path": "core_eiaaeo__yearly_projected_fuel_cost_in_electric_sector_by_type.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "electricity_market_module_region_eiaaeo", "type": "string", "description": "AEO projection region.", "constraints": { "required": true, "enum": [ "florida_reliability_coordinating_council", "midcontinent_central", "midcontinent_east", "midcontinent_south", "midcontinent_west", "northeast_power_coordinating_council_new_england", "northeast_power_coordinating_council_new_york_city_and_long_island", "northeast_power_coordinating_council_upstate_new_york", "pjm_commonwealth_edison", "pjm_dominion", "pjm_east", "pjm_west", "serc_reliability_corporation_central", "serc_reliability_corporation_east", "serc_reliability_corporation_southeastern", "southwest_power_pool_central", "southwest_power_pool_north", "southwest_power_pool_south", "texas_reliability_entity", "united_states", "western_electricity_coordinating_council_basin", "western_electricity_coordinating_council_california_north", "western_electricity_coordinating_council_california_south", "western_electricity_coordinating_council_northwest_power_pool_area", "western_electricity_coordinating_council_rockies", "western_electricity_coordinating_council_southwest" ] } }, { "name": "model_case_eiaaeo", "type": "string", "description": "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.", "constraints": { "required": true, "enum": [ "aeo2022", "aeo2023", "alternative_electricity", "alternative_transportation", "alternative_electricity_and_transportation", "counterfactual_baseline", "fast_builds_plus_high_lng_price", "high_economic_growth", "high_electricity_demand", "high_lng_price", "high_macro_and_high_zero_carbon_technology_cost", "high_macro_and_low_zero_carbon_technology_cost", "high_oil_and_gas_supply", "high_oil_price", "high_uptake_of_inflation_reduction_act", "high_zero_carbon_technology_cost", "low_economic_growth", "low_lng_price", "low_macro_and_high_zero_carbon_technology_cost", "low_macro_and_low_zero_carbon_technology_cost", "low_oil_and_gas_supply", "low_oil_price", "low_uptake_of_inflation_reduction_act", "low_zero_carbon_technology_cost", "no_inflation_reduction_act", "reference" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value.", "constraints": { "required": true } }, { "name": "fuel_type_eiaaeo", "type": "string", "description": "Fuel type reported for AEO end-use sector generation data.", "constraints": { "required": true, "enum": [ "coal", "distillate_fuel_oil", "residual_fuel_oil", "petroleum", "natural_gas", "other_gaseous_fuels", "renewable_sources", "other" ] } }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_cost_real_per_mmbtu_eiaaeo", "type": "number", "description": "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``.", "unit": "USD_per_MMBTU" }, { "name": "real_cost_basis_year", "type": "integer", "description": "Four-digit year which is the basis for any 'real cost' monetary values (as opposed to nominal values)." } ], "primaryKey": [ "report_year", "electricity_market_module_region_eiaaeo", "model_case_eiaaeo", "projection_year", "fuel_type_eiaaeo" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 620783, "hash": "sha256:f21818b80edcc21aac1f29957185e99ef582ac32f43f616c9d274c9b067c3a3e" }, { "name": "core_eiaaeo__yearly_projected_generation_in_electric_sector_by_technology", "type": "table", "description": "Annual time series of projected generation capacity & total generation in the electric sector, broken out by technology.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Annual Energy Outlook (AEO)\n\nPrimary key:\n report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, technology_description_eiaaeo", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eiaaeo", "title": "EIA Annual Energy Outlook (AEO)", "path": "https://www.eia.gov/outlooks/aeo/", "description": "The EIA Annual Energy Outlook provides projections of future fuel prices, energy supply and consumption, and carbon dioxide emissions by sector and region.", "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10838487", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19535635", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaaeo.html" } ], "path": "core_eiaaeo__yearly_projected_generation_in_electric_sector_by_technology.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "electricity_market_module_region_eiaaeo", "type": "string", "description": "AEO projection region.", "constraints": { "required": true, "enum": [ "florida_reliability_coordinating_council", "midcontinent_central", "midcontinent_east", "midcontinent_south", "midcontinent_west", "northeast_power_coordinating_council_new_england", "northeast_power_coordinating_council_new_york_city_and_long_island", "northeast_power_coordinating_council_upstate_new_york", "pjm_commonwealth_edison", "pjm_dominion", "pjm_east", "pjm_west", "serc_reliability_corporation_central", "serc_reliability_corporation_east", "serc_reliability_corporation_southeastern", "southwest_power_pool_central", "southwest_power_pool_north", "southwest_power_pool_south", "texas_reliability_entity", "united_states", "western_electricity_coordinating_council_basin", "western_electricity_coordinating_council_california_north", "western_electricity_coordinating_council_california_south", "western_electricity_coordinating_council_northwest_power_pool_area", "western_electricity_coordinating_council_rockies", "western_electricity_coordinating_council_southwest" ] } }, { "name": "model_case_eiaaeo", "type": "string", "description": "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.", "constraints": { "required": true, "enum": [ "aeo2022", "aeo2023", "alternative_electricity", "alternative_transportation", "alternative_electricity_and_transportation", "counterfactual_baseline", "fast_builds_plus_high_lng_price", "high_economic_growth", "high_electricity_demand", "high_lng_price", "high_macro_and_high_zero_carbon_technology_cost", "high_macro_and_low_zero_carbon_technology_cost", "high_oil_and_gas_supply", "high_oil_price", "high_uptake_of_inflation_reduction_act", "high_zero_carbon_technology_cost", "low_economic_growth", "low_lng_price", "low_macro_and_high_zero_carbon_technology_cost", "low_macro_and_low_zero_carbon_technology_cost", "low_oil_and_gas_supply", "low_oil_price", "low_uptake_of_inflation_reduction_act", "low_zero_carbon_technology_cost", "no_inflation_reduction_act", "reference" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value.", "constraints": { "required": true } }, { "name": "technology_description_eiaaeo", "type": "string", "description": "Generation technology reported for AEO.", "constraints": { "required": true, "enum": [ "coal", "combined_cycle", "combustion_turbine_diesel", "distributed_generation", "diurnal_storage", "fossil_steam", "fuel_cells", "hydrogen", "hydrogen_turbine", "natural_gas", "nuclear", "oil_and_natural_gas_steam", "petroleum", "pumped_storage", "pumped_storage_other", "renewable_sources" ] } }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "summer_capacity_planned_additions_mw", "type": "number", "description": "The total planned additions to net summer generating capacity.", "unit": "mw" }, { "name": "summer_capacity_unplanned_additions_mw", "type": "number", "description": "The total unplanned additions to net summer generating capacity.", "unit": "mw" }, { "name": "summer_capacity_retirements_mw", "type": "number", "description": "The total retirements from net summer generating capacity.", "unit": "mw" }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" } ], "primaryKey": [ "report_year", "electricity_market_module_region_eiaaeo", "model_case_eiaaeo", "projection_year", "technology_description_eiaaeo" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1999319, "hash": "sha256:f1487a06a3c2f8e5313d53bbaf9522cf087ee41b2901ca68ccaf2191974114e9" }, { "name": "core_eiaaeo__yearly_projected_generation_in_end_use_sectors_by_fuel_type", "type": "table", "description": "Annual time series of projected generation capacity and total generation in the end-use sector, broken out by fuel type.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EIA Annual Energy Outlook (AEO)\n\nPrimary key:\n report_year, electricity_market_module_region_eiaaeo, model_case_eiaaeo, projection_year, fuel_type_eiaaeo\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The solar photovoltaic capacity portion of Renewable Sources is reported in megawatts direct current; other technologies are reported in megawatts of alternating current.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIncludes 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eiaaeo", "title": "EIA Annual Energy Outlook (AEO)", "path": "https://www.eia.gov/outlooks/aeo/", "description": "The EIA Annual Energy Outlook provides projections of future fuel prices, energy supply and consumption, and carbon dioxide emissions by sector and region.", "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10838487", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19535635", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eiaaeo.html" } ], "path": "core_eiaaeo__yearly_projected_generation_in_end_use_sectors_by_fuel_type.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "electricity_market_module_region_eiaaeo", "type": "string", "description": "AEO projection region.", "constraints": { "required": true, "enum": [ "florida_reliability_coordinating_council", "midcontinent_central", "midcontinent_east", "midcontinent_south", "midcontinent_west", "northeast_power_coordinating_council_new_england", "northeast_power_coordinating_council_new_york_city_and_long_island", "northeast_power_coordinating_council_upstate_new_york", "pjm_commonwealth_edison", "pjm_dominion", "pjm_east", "pjm_west", "serc_reliability_corporation_central", "serc_reliability_corporation_east", "serc_reliability_corporation_southeastern", "southwest_power_pool_central", "southwest_power_pool_north", "southwest_power_pool_south", "texas_reliability_entity", "united_states", "western_electricity_coordinating_council_basin", "western_electricity_coordinating_council_california_north", "western_electricity_coordinating_council_california_south", "western_electricity_coordinating_council_northwest_power_pool_area", "western_electricity_coordinating_council_rockies", "western_electricity_coordinating_council_southwest" ] } }, { "name": "model_case_eiaaeo", "type": "string", "description": "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.", "constraints": { "required": true, "enum": [ "aeo2022", "aeo2023", "alternative_electricity", "alternative_transportation", "alternative_electricity_and_transportation", "counterfactual_baseline", "fast_builds_plus_high_lng_price", "high_economic_growth", "high_electricity_demand", "high_lng_price", "high_macro_and_high_zero_carbon_technology_cost", "high_macro_and_low_zero_carbon_technology_cost", "high_oil_and_gas_supply", "high_oil_price", "high_uptake_of_inflation_reduction_act", "high_zero_carbon_technology_cost", "low_economic_growth", "low_lng_price", "low_macro_and_high_zero_carbon_technology_cost", "low_macro_and_low_zero_carbon_technology_cost", "low_oil_and_gas_supply", "low_oil_price", "low_uptake_of_inflation_reduction_act", "low_zero_carbon_technology_cost", "no_inflation_reduction_act", "reference" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value.", "constraints": { "required": true } }, { "name": "fuel_type_eiaaeo", "type": "string", "description": "Fuel type reported for AEO end-use sector generation data.", "constraints": { "required": true, "enum": [ "coal", "distillate_fuel_oil", "residual_fuel_oil", "petroleum", "natural_gas", "other_gaseous_fuels", "renewable_sources", "other" ] } }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" } ], "primaryKey": [ "report_year", "electricity_market_module_region_eiaaeo", "model_case_eiaaeo", "projection_year", "fuel_type_eiaaeo" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual energy outlook", "distribution", "eia", "eia aeo", "electric", "electricity", "energy", "energy consumption", "energy information administration", "energy supply", "federal", "fuel projections", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nems", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1067939, "hash": "sha256:a85090b33863faf22e9addd3bd63b93bc9d4d2933f35fe1bee7e462f7a436d64" }, { "name": "core_epa__assn_eia_epacamd", "type": "table", "description": "Association table providing connections between EPA units and EIA plants, boilers, and generators.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EPA -- Mix of multiple EPA sources\n\nPrimary key:\n This table has no primary key.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis crosswalk table comes from the\nPUDL fork of the EPA camd-eia-crosswalk Github repo:\nhttps://github.com/catalyst-cooperative/camd-eia-crosswalk-latest.\n\nThe camd-eia-crosswalk README and our Data Source documentation page on\n:doc:`../data_sources/epacems` depict the complicated relationship between EIA and EPA\ndata, specifically the nature of EPA vs. EIA \"units\" and the level of granularity that\none can connect the two sources.\n\nThe original EPA crosswalk runs on 2018 EIA data. We adapted the crosswalk code to run on\neach new year of EIA data, capturing changes in plant information over time.\n\nOur version of the crosswalk clarifies some of the column names and removes unmatched\nrows. The :func:`pudl.dagster.assets.core.glue.core_epa__assn_eia_epacamd` function doc strings explain\nwhat changes are made from the EPA's version.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "epacamd_eia", "title": "EPA CAMD to EIA Power Sector Data Crosswalk", "path": "https://github.com/USEPA/camd-eia-crosswalk", "description": "A file created collaboratively by EPA and EIA that connects EPA CAMD smokestacks (units) with corresponding EIA plant part ids reported in EIA Forms 860 and 923 (plant_id_eia, boiler_id, generator_id). This one-to-many connection is necessary because pollutants from various plant parts are collecitvely emitted and measured from one point-source.", "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "boilers", "capacity", "carbon dioxide", "cems", "chlorine", "co2", "combined_cycle", "combustion", "continuous emissions monitoring system", "crosswalk", "distribution", "eia", "electric", "electricity", "emissions", "energy", "energy information administration", "environmental protection agency", "epa", "federal", "generation", "generators", "ghg", "government", "heat rate", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "sox", "steam", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.6633769", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17582121", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/epacamd_eia.html" } ], "path": "core_epa__assn_eia_epacamd.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_id_epa", "type": "integer", "description": "The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia." }, { "name": "emissions_unit_id_epa", "type": "string", "description": "Emissions (smokestack) unit monitored by EPA CEMS." }, { "name": "generator_id_epa", "type": "string", "description": "Generator ID used by the EPA." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "plant_id_eia", "boiler_id" ], "reference": { "resource": "core_eia__entity_boilers", "fields": [ "plant_id_eia", "boiler_id" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } } ] }, "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "boilers", "capacity", "carbon dioxide", "cems", "chlorine", "co2", "combined_cycle", "combustion", "continuous emissions monitoring system", "crosswalk", "distribution", "eia", "electric", "electricity", "emissions", "energy", "energy information administration", "environmental protection agency", "epa", "federal", "generation", "generators", "ghg", "government", "heat rate", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "sox", "steam", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 234245, "hash": "sha256:12fd9712976ff12d7d46b96fef8646f6976251265de9a61a87724ff79cf8c3c2" }, { "name": "core_epa__assn_eia_epacamd_subplant_ids", "type": "table", "description": "Association table providing connections between EPA units and EIA units/generators, at the subplant level.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EPA -- Mix of multiple EPA sources\n\nPrimary key:\n This table has no primary key. The primary keys would have been: plant_id_eia, generator_id, subplant_id and emissions_unit_id_epa, but there are some null records in the generator_id column. ~2 percent of all EPA CAMD records are not successfully mapped to EIA generators.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is an augmented version of the core_epa__assn_eia_epacamd\ncrosswalk table which initially comes from the EPA's Github repo camd-eia-crosswalk:\nhttps://github.com/USEPA/camd-eia-crosswalk.\n\nThis table identifies subplants within plant_ids, which are the smallest coherent units\nfor aggregation. A plant_id refers to a legal entity that often contains multiple distinct\npower plants, even of different technology or fuel types.\n\nEPA CEMS data combines information from several parts of a power plant:\n\n* emissions from smokestacks\n* fuel use from combustors\n* electricity production from generators\n\nBut smokestacks, combustors, and generators can be connected in complex, many-to-many\nrelationships. This complexity makes attribution difficult for, as an example,\nallocating pollution to energy producers. Furthermore, heterogeneity within plant_ids\nmake aggregation to the parent entity difficult or inappropriate.\n\nThis table inherits from the EPA's crosswalk, the IDs from EPA CAMD\ncore_epacems__hourly_emissions table itself, the core_eia860__assn_boiler_generator table and the\ncore_eia860__scd_generators table. While the core_epa__assn_eia_epacamd table is the core backbone of the table,\nEPA CAMD IDs ensure there is complete coverage of EPA CAMD reporting units. The EIA 860\ntable addition ensures there is also complete coverage of those units as well.\n\nFor more information about the how this subplant_id is made, see the documentation for\n:func:`pudl.dagster.assets.core.glue.make_subplant_ids` and :func:`pudl.dagster.assets.core.glue.update_subplant_ids`.\n\nBut by analyzing the relationships between combustors and generators,\nas provided in the core_epa__assn_eia_epacamd crosswalk, we can identify distinct power plants.\nThese are the smallest coherent units of aggregation.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "epacamd_eia", "title": "EPA CAMD to EIA Power Sector Data Crosswalk", "path": "https://github.com/USEPA/camd-eia-crosswalk", "description": "A file created collaboratively by EPA and EIA that connects EPA CAMD smokestacks (units) with corresponding EIA plant part ids reported in EIA Forms 860 and 923 (plant_id_eia, boiler_id, generator_id). This one-to-many connection is necessary because pollutants from various plant parts are collecitvely emitted and measured from one point-source.", "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "boilers", "capacity", "carbon dioxide", "cems", "chlorine", "co2", "combined_cycle", "combustion", "continuous emissions monitoring system", "crosswalk", "distribution", "eia", "electric", "electricity", "emissions", "energy", "energy information administration", "environmental protection agency", "epa", "federal", "generation", "generators", "ghg", "government", "heat rate", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "sox", "steam", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.6633769", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17582121", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/epacamd_eia.html" } ], "path": "core_epa__assn_eia_epacamd_subplant_ids.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "plant_id_epa", "type": "integer", "description": "The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia." }, { "name": "subplant_id", "type": "integer", "description": "Sub-plant ID links EPA CEMS emissions units to EIA units." }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "emissions_unit_id_epa", "type": "string", "description": "Emissions (smokestack) unit monitored by EPA CEMS." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "boilers", "capacity", "carbon dioxide", "cems", "chlorine", "co2", "combined_cycle", "combustion", "continuous emissions monitoring system", "crosswalk", "distribution", "eia", "electric", "electricity", "emissions", "energy", "energy information administration", "environmental protection agency", "epa", "federal", "generation", "generators", "ghg", "government", "heat rate", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "sox", "steam", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 594666, "hash": "sha256:c9033d646a4731b246841480b51adeb5c3696479ea9f5e32c881003b2efd6edb" }, { "name": "core_epacems__hourly_emissions", "type": "table", "description": "Hourly time series of emissions and plant operational data as required by 40 CFR Part 75.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n EPA Hourly Continuous Emission Monitoring System (CEMS)\n\nPrimary key:\n plant_id_epa, emissions_unit_id_epa, operating_datetime_utc\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Large table; do not attempt to open with Excel.\n\n* Not all IDs are present.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nContinuous Emissions Monitoring Systems\n(CEMS) are used to determine the rate of gas or particulate matter exiting a point\nsource of emissions. The EPA Clean Air Markets Division (CAMD) has collected data on\npower plant emissions from CEMS units stretching back to 1995. The CEMS dataset\nincludes hourly gross load, SO2, CO2, and NOx emissions associated with a given\nemissions-unit during startup, shutdown, and instances of malfunction. An EPA CEMS\nemissions-unit or smokestack unit is not the same as an EIA unit. See\n:ref:`core_epa__assn_eia_epacamd` for details about how to connect CEMS data to\ncorresponding EIA units.\n\nOnly fossil-combustion units over 25 MW are required to install and use CEMS, so\nthere are some units that do report in EIA-860 or EIA-923 that do not have any\nCEMS data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "epacems", "title": "EPA Hourly Continuous Emission Monitoring System (CEMS)", "path": "https://campd.epa.gov/", "description": "US EPA hourly Continuous Emissions Monitoring System (CEMS) data.Hourly CO2, SO2, NOx emissions and gross load.", "keywords": [ "MW", "MWh", "air markets program data", "ampd", "ash", "carbon dioxide", "cems", "chlorine", "co2", "continuous emissions monitoring system", "distribution", "electric", "electricity", "emissions", "energy", "environmental protection agency", "epa", "federal", "generation", "ghg", "government", "hourly", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "mercury", "nox", "particulate", "pm2.5", "pollution", "power", "so2", "sox", "sulfur", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10233185", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.18731117", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/epacems.html" } ], "path": "core_epacems__hourly_emissions.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "plant_id_epa", "type": "integer", "description": "The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia.", "constraints": { "required": true } }, { "name": "emissions_unit_id_epa", "type": "string", "description": "Emissions (smokestack) unit monitored by EPA CEMS.", "constraints": { "required": true } }, { "name": "operating_datetime_utc", "type": "datetime", "description": "Date and time measurement began (UTC).", "constraints": { "required": true } }, { "name": "year", "type": "integer", "description": "Year the data was reported in, used for partitioning EPA CEMS.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "enum": [ "SC", "IA", "WA", "ND", "HI", "DE", "SD", "CO", "MT", "VA", "NC", "AL", "AR", "VT", "NH", "NJ", "OR", "LA", "NY", "IL", "RI", "FL", "ME", "WY", "MI", "MO", "PR", "NV", "MN", "TN", "PA", "GA", "DC", "WV", "WI", "OH", "MA", "TX", "AK", "AZ", "UT", "CA", "KS", "MD", "CT", "NM", "MS", "OK", "IN", "NE", "KY", "ID" ] } }, { "name": "operating_time_hours", "type": "number", "description": "Length of time interval measured.", "unit": "hr" }, { "name": "gross_load_mw", "type": "number", "description": "Average power in megawatts delivered during time interval measured.", "unit": "MW" }, { "name": "heat_content_mmbtu", "type": "number", "description": "The energy contained in fuel burned, measured in million BTU.", "unit": "MMBTU" }, { "name": "steam_load_lbs", "type": "number", "description": "Total steam pressure produced by a unit during the reported hour.", "unit": "lb" }, { "name": "so2_mass_lbs", "type": "number", "description": "Sulfur dioxide emissions in pounds.", "unit": "lb" }, { "name": "so2_mass_measurement_code", "type": "string", "description": "Identifies whether the reported value of emissions was measured, calculated, or measured and substitute.", "constraints": { "enum": [ "Calculated", "LME", "Measured", "Measured and Substitute", "Other", "Substitute" ] } }, { "name": "nox_mass_lbs", "type": "number", "description": "NOx emissions in pounds.", "unit": "lb" }, { "name": "nox_mass_measurement_code", "type": "string", "description": "Identifies whether the reported value of emissions was measured, calculated, or measured and substitute.", "constraints": { "enum": [ "Calculated", "LME", "Measured", "Measured and Substitute", "Other", "Substitute" ] } }, { "name": "co2_mass_tons", "type": "number", "description": "Carbon dioxide emissions in short tons.", "unit": "short_ton" }, { "name": "co2_mass_measurement_code", "type": "string", "description": "Identifies whether the reported value of emissions was measured, calculated, or measured and substitute.", "constraints": { "enum": [ "Calculated", "LME", "Measured", "Measured and Substitute", "Other", "Substitute" ] } } ], "primaryKey": [ "plant_id_epa", "emissions_unit_id_epa", "operating_datetime_utc" ], "foreignKeys": [ { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "air markets program data", "ampd", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "cems", "chlorine", "co2", "coal", "combined_cycle", "combustion", "continuous emissions monitoring system", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "environmental protection agency", "epa", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hourly", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4769290892, "hash": "sha256:224537f7474cb773a0413e9fec5c4396970894019d2e4ad7e0f71e6629bad52a" }, { "name": "core_ferc1__codes_power_purchase_types", "type": "table", "description": "Code table containing descriptions of categorical codes for electric power purchase types.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__codes_power_purchase_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "label", "type": "string", "description": "Longer human-readable code using snake_case" }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6510, "hash": "sha256:aa68262ae10b90e1a3dee4741cbd5a7077924d8b94cd3c602ce07fdead042709" }, { "name": "core_ferc1__yearly_balance_sheet_assets_sched110", "type": "table", "description": "Annual time series of utility assets and other debits.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110)\n\nPrimary key:\n utility_id_ferc1, report_year, asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_balance_sheet_assets_sched110.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "asset_type", "type": "string", "description": "Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "asset_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4208471, "hash": "sha256:027d73570bbdf56ee04fb0502bd4b0806ecc4127311d4feff751927019646f1c" }, { "name": "core_ferc1__yearly_balance_sheet_liabilities_sched110", "type": "table", "description": "Annual time series of utility liabilities and other credits.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110)\n\nPrimary key:\n utility_id_ferc1, report_year, liability_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_balance_sheet_liabilities_sched110.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "liability_type", "type": "string", "description": "Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.", "constraints": { "required": true } }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "liability_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3619396, "hash": "sha256:f8089a6a3ea5c2e5556fe596421d2bde55c4c29121efbc783855b782c14d786f" }, { "name": "core_ferc1__yearly_cash_flows_sched120", "type": "table", "description": "Annual time series of utility cash flow.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 120)\n\nPrimary key:\n utility_id_ferc1, report_year, amount_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_cash_flows_sched120.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "amount_type", "type": "string", "description": "Label describing the type of amount being reported. This could be a balance or a change in value.", "constraints": { "required": true, "enum": [ "net_increase_decrease_in_other_regulatory_assets_operating_activities", "gross_additions_to_common_utility_plant_investing_activities", "payments_for_retirement_of_long_term_debt_financing_activities", "deferred_income_taxes_net", "undistributed_earnings_from_subsidiary_companies_operating_activities", "net_increase_decrease_in_receivables_investing_activities", "cash_provided_by_outside_sources_correction", "net_income_loss_correction", "dividends_on_preferred_stock", "depreciation_and_depletion", "other_adjustments_to_cash_flows_from_operating_activities", "noncash_adjustments_to_cash_flows_from_operating_activities", "other_construction_and_acquisition_of_plant_investment_activities", "net_increase_decrease_in_cash_and_cash_equivalents", "cash_provided_by_outside_sources", "cash_flows_provided_from_used_in_financing_activities_correction", "net_increase_decrease_in_allowances_inventory_operating_activities", "proceeds_from_issuance_of_common_stock_financing_activities", "purchase_of_investment_securities", "cash_outflows_for_plant", "investment_tax_credit_adjustments_net", "net_increase_decrease_in_payables_and_accrued_expenses_operating_activities", "proceeds_from_sales_of_investment_securities", "cash_flows_provided_from_used_in_financing_activities", "ending_balance", "dividends_on_common_stock", "net_cash_flow_from_operating_activities_correction", "acquisition_of_other_noncurrent_assets", "net_income_loss", "net_increase_decrease_in_allowances_held_for_speculation_investing_activities", "contributions_and_advances_from_associated_and_subsidiary_companies", "net_increase_in_short_term_debt", "payments_for_retirement_of_common_stock_financing_activities", "allowance_for_other_funds_used_during_construction_investing_activities", "proceeds_from_issuance_of_preferred_stock_financing_activities", "net_cash_flow_from_operating_activities", "net_increase_decrease_in_inventory_investing_activities", "net_decrease_in_short_term_debt", "gross_additions_to_utility_plant_less_nuclear_fuel_investing_activities", "cash_flows_provided_from_used_in_investment_activities_correction", "net_increase_decrease_in_receivables_operating_activities", "cash_outflows_for_plant_correction", "net_increase_decrease_in_cash_and_cash_equivalents_abstract", "net_increase_decrease_in_other_regulatory_liabilities_operating_activities", "net_increase_decrease_in_inventory_operating_activities", "other_adjustments_to_cash_flows_from_investment_activities", "disposition_of_investments_in_and_advances_to_associated_and_subsidiary_companies", "payments_for_retirement_of_preferred_stock_financing_activities", "investments_in_and_advances_to_associated_and_subsidiary_companies", "loans_made_or_purchased", "collections_on_loans", "allowance_for_other_funds_used_during_construction_operating_activities", "net_increase_decrease_in_payables_and_accrued_expenses_investing_activities", "starting_balance", "gross_additions_to_nonutility_plant_investing_activities", "cash_flows_provided_from_used_in_investment_activities", "payments_for_retirement_abstract", "other_adjustments_by_outside_sources_to_cash_flows_from_financing_activities", "proceeds_from_issuance_of_long_term_debt_financing_activities", "disposition_of_investments_in_and_advances_to_associated_and_subsidiary_companies_abstract", "proceeds_from_disposal_of_noncurrent_assets", "other_retirements_of_balances_impacting_cash_flows_from_financing_activities", "gross_additions_to_nuclear_fuel_investing_activities", "other_adjustments_to_cash_flows_from_financing_activities" ] } }, { "name": "amount", "type": "number", "description": "Reported amount of dollars. This could be a balance or a change in value.", "unit": "USD" }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "amount_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2373503, "hash": "sha256:6b30ac728d38004e09b4653b83d48e273065d94def0e234b735243316b55b36d" }, { "name": "core_ferc1__yearly_depreciation_by_function_sched219", "type": "table", "description": "Annual time series of ending balances in accumulated provision for depreciation of electric utility plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section B)\n\nPrimary key:\n utility_id_ferc1, report_year, depreciation_type, plant_function, plant_status, utility_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric utility plant refers to FERC Account 108. Section B includes the Balances at End of Year According to Functional Classification (plant_function).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_depreciation_by_function_sched219.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "depreciation_type", "type": "string", "description": "Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.", "constraints": { "required": true, "enum": [ "accumulated_depreciation_subdimension_correction", "accumulated_depreciation_correction", "accumulated_depreciation" ] } }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).", "constraints": { "required": true } }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total).", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "depreciation_type", "plant_function", "plant_status", "utility_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1378432, "hash": "sha256:67d283a24c14d5adec2fe326337b5df58cbaf2ced522e656c89da2c616dd4ec0" }, { "name": "core_ferc1__yearly_depreciation_changes_sched219", "type": "table", "description": "Annual time series of changes in accumulated provision for depreciation of electric utility plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section A)\n\nPrimary key:\n utility_id_ferc1, report_year, depreciation_type, plant_status, utility_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric utility plant refers to FERC Account 108.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_depreciation_changes_sched219.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "depreciation_type", "type": "string", "description": "Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.", "constraints": { "required": true, "enum": [ "ending_balance_correction", "other_clearing_accounts_subdimension_correction", "starting_balance_subdimension_correction", "depreciation_expense_for_asset_retirement_costs_correction", "salvage_value_of_retired_plant_correction", "depreciation_provision", "net_charges_for_retired_plant", "salvage_value_of_retired_plant_subdimension_correction", "depreciation_expense_for_asset_retirement_costs", "cost_of_removal_of_plant_subdimension_correction", "other_accounts", "expenses_of_electric_plant_leased_to_others_correction", "salvage_value_of_retired_plant", "transportation_expenses_clearing", "transportation_expenses_clearing_subdimension_correction", "other_adjustments_to_accumulated_depreciation_subdimension_correction", "net_charges_for_retired_plant_correction", "expenses_of_electric_plant_leased_to_others_subdimension_correction", "other_accounts_subdimension_correction", "depreciation_expense_for_asset_retirement_costs_subdimension_correction", "book_cost_of_retired_plant_correction", "transportation_expenses_clearing_correction", "other_adjustments_to_accumulated_depreciation_correction", "depreciation_expense_excluding_adjustments_subdimension_correction", "other_accounts_correction", "cost_of_removal_of_plant", "expenses_of_electric_plant_leased_to_others", "book_cost_of_asset_retirement_costs", "book_cost_of_retired_plant_subdimension_correction", "other_clearing_accounts_correction", "starting_balance", "ending_balance", "ending_balance_subdimension_correction", "depreciation_expense_excluding_adjustments_correction", "book_cost_of_asset_retirement_costs_subdimension_correction", "cost_of_removal_of_plant_correction", "depreciation_provision_correction", "starting_balance_correction", "other_clearing_accounts", "other_adjustments_to_accumulated_depreciation", "depreciation_expense_excluding_adjustments", "depreciation_provision_subdimension_correction", "book_cost_of_asset_retirement_costs_correction", "net_charges_for_retired_plant_subdimension_correction", "book_cost_of_retired_plant" ] } }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total).", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "depreciation_type", "plant_status", "utility_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2002009, "hash": "sha256:7bff473f380e112a1334262a0c44056d9036174e2e1a195aff110e74731e2b82" }, { "name": "core_ferc1__yearly_depreciation_factors_sched336", "type": "table", "description": "Annual time series of factors used in estimating depreciation charges.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section C)\n\nPrimary key:\n This table has no primary key. This table is too unstructured to have a primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_depreciation_factors_sched336.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "depreciation_factors", "type": "string", "description": "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." }, { "name": "depreciable_plant_base", "type": "number", "description": "Depreciable plant balance (depreciable base) to which rates are applied.", "unit": "USD" }, { "name": "net_salvage_pct", "type": "number", "description": "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." }, { "name": "depreciation_rate", "type": "string", "description": "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." }, { "name": "mortality_curve_type", "type": "string", "description": "Description of the type of mortality curve selected in plant mortality studies prepared to assist in estimating average service lives." }, { "name": "order_num", "type": "number", "description": "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." }, { "name": "account_num", "type": "string", "description": "Account number(s) in connection with factors used in estimating depreciation charges." }, { "name": "service_life_avg", "type": "number", "description": "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." }, { "name": "remaining_life_avg", "type": "number", "description": "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." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4764491, "hash": "sha256:c8aa93c4c4adf97be1b33ff41d487b71f6dbca82f93fda86eccd0c215797f042" }, { "name": "core_ferc1__yearly_depreciation_summary_sched336", "type": "table", "description": "Annual time series of depreciation and amortization of electric plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section A)\n\nPrimary key:\n utility_id_ferc1, report_year, plant_function, ferc_account_label\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric Plant refers to FERC Accounts 403, 404, and 405. This table only contains information from Section A: Summary of depreciation and amortization changes.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_depreciation_summary_sched336.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).", "constraints": { "required": true } }, { "name": "ferc_account_label", "type": "string", "description": "Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.", "constraints": { "required": true, "enum": [ "depreciation_amortization_total_correction", "depreciation_expense_asset_retirement_correction", "amortization_limited_term_electric_plant_subdimension_correction", "amortization_other_electric_plant_subdimension_correction", "amortization_limited_term_electric_plant", "depreciation_expense_correction", "depreciation_expense", "amortization_other_electric_plant", "depreciation_expense_subdimension_correction", "depreciation_expense_asset_retirement", "amortization_limited_term_electric_plant_correction", "depreciation_expense_asset_retirement_subdimension_correction", "depreciation_amortization_total", "amortization_other_electric_plant_correction", "depreciation_amortization_total_subdimension_correction" ] } }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "plant_function", "ferc_account_label" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1840676, "hash": "sha256:db672c9442e79bd779ac3172bebd0ea8341a77775de26c92293ee5457ec08995" }, { "name": "core_ferc1__yearly_energy_dispositions_sched401", "type": "table", "description": "Annual time series of dispositions of electric energy sold, exchanged, or stored.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)\n\nPrimary key:\n utility_id_ferc1, report_year, energy_disposition_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric Energy Account, dispositions only. Schedule 401a. Electricity utilities delivered to end users, internal losses, etc.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_energy_dispositions_sched401.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "energy_disposition_type", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "energy_mwh", "type": "number", "description": "Sources and uses of energy in MWh.", "unit": "MWh" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "energy_disposition_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 373102, "hash": "sha256:60f69dad5389775ec908e5526407f74d359f255c4282db5dbfb894c5243d1ce7" }, { "name": "core_ferc1__yearly_energy_sources_sched401", "type": "table", "description": "Annual time series of sources of electric energy generated or purchased, exchanged and wheeled.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)\n\nPrimary key:\n utility_id_ferc1, report_year, energy_source_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric Energy Account, sources only. Schedule 401a. Amount of electricity the utility obtained from each of several sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_energy_sources_sched401.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "energy_source_type", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "energy_mwh", "type": "number", "description": "Sources and uses of energy in MWh.", "unit": "MWh" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "energy_source_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 504577, "hash": "sha256:9f495df11d450c321d5e247d5427ecfb36132a7f29205a1eed9e2c0b1ccd49c0" }, { "name": "core_ferc1__yearly_hydroelectric_plants_sched406", "type": "table", "description": "Annual time series of plant statistics for large hydroelectric generating plants.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 406)\n\nPrimary key:\n This table has no primary key. 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The ``plant_type`` and ``construction_type`` are standardized into categorical values from free-form strings.\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nLarge plants have an installed nameplate capacity of more than 10 MW.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_hydroelectric_plants_sched406.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "project_num", "type": "integer", "description": "FERC Licensed Project Number." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "run_of_river", "na_category", "run_of_river_with_storage", "storage", "hydro" ] } }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "net_capacity_favorable_conditions_mw", "type": "number", "description": "Net plant capability under the most favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "net_capacity_adverse_conditions_mw", "type": "number", "description": "Net plant capability under the least favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_facilities", "type": "number", "description": "Cost of plant: reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "capex_equipment", "type": "number", "description": "Cost of plant: equipment (USD).", "unit": "USD" }, { "name": "capex_roads", "type": "number", "description": "Cost of plant: roads, railroads, and bridges (USD).", "unit": "USD" }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_water_for_power", "type": "number", "description": "Production expenses: water for power (USD).", "unit": "USD" }, { "name": "opex_hydraulic", "type": "number", "description": "Production expenses: hydraulic expenses (USD).", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_generation_misc", "type": "number", "description": "Production expenses: miscellaneous power generation expenses (USD).", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_dams", "type": "number", "description": "Production expenses: maintenance of reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "opex_plant", "type": "number", "description": "Production expenses: maintenance of electric plant (USD).", "unit": "USD" }, { "name": "opex_misc_plant", "type": "number", "description": "Production expenses: maintenance of miscellaneous hydraulic plant (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 832330, "hash": "sha256:2a19ad6f85c06e02e59b3c4e576a3a074719bc9fb8dd4b116d49f64c151df3b3" }, { "name": "core_ferc1__yearly_identification_certification", "type": "table", "description": "Annual time series of respondent identification and corporate officer certification information.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Part I and II)\n\nPrimary key:\n utility_id_ferc1, report_year, report_filing_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_identification_certification.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "prior_utility_name_ferc1", "type": "string", "description": "Former name of the responding utility, when it changed within the last year." }, { "name": "name_change_date", "type": "date", "description": "Date of last name change of the company." }, { "name": "company_id_ferc", "type": "string", "description": "The Company Identifier (CID) obtained through FERC's Company Registration system." }, { "name": "entity_id_gleif", "type": "string", "description": "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)." }, { "name": "contact_name", "type": "string", "description": "Name of contact person for the respondent." }, { "name": "contact_title", "type": "string", "description": "Title of contact person for the respondent." }, { "name": "contact_email", "type": "string", "description": "Email for contact identified in contact_name." }, { "name": "contact_address", "type": "string", "description": "Street address for contact identified in contact_name." }, { "name": "contact_phone", "type": "string", "description": "Phone number for contact identified in contact_name." }, { "name": "contact_city", "type": "string", "description": "City for contact identified in contact_name." }, { "name": "contact_state", "type": "string", "description": "State for contact identified in contact_name.", "constraints": { "enum": [ "NS", "SC", "VI", "IA", "WA", "ND", "HI", "DE", "SD", "ON", "GU", "CO", "AS", "MT", "NB", "VA", "NC", "AL", "AR", "BC", "MB", "NH", "VT", "NJ", "OR", "LA", "NY", "IL", "RI", "FL", "ME", "NU", "WY", "MI", "AB", "MO", "NV", "PR", "MN", "NL", "PA", "GA", "DC", "TN", "WI", "OH", "WV", "MA", "TX", "SK", "AK", "AZ", "QC", "UT", "YT", "CA", "KS", "MD", "CT", "NM", "MS", "MP", "PE", "OK", "IN", "NE", "NT", "KY", "ID" ] } }, { "name": "contact_zip", "type": "string", "description": "Zip code for contact identified in contact_name." }, { "name": "office_street_address", "type": "string", "description": "Street address of principal office at end of period." }, { "name": "office_city", "type": "string", "description": "City of principal office at end of period." }, { "name": "office_state", "type": "string", "description": "State of principal office at end of period.", "constraints": { "enum": [ "NS", "SC", "VI", "IA", "WA", "ND", "HI", "DE", "SD", "ON", "GU", "CO", "AS", "MT", "NB", "VA", "NC", "AL", "AR", "BC", "MB", "NH", "VT", "NJ", "OR", "LA", "NY", "IL", "RI", "FL", "ME", "NU", "WY", "MI", "AB", "MO", "NV", "PR", "MN", "NL", "PA", "GA", "DC", "TN", "WI", "OH", "WV", "MA", "TX", "SK", "AK", "AZ", "QC", "UT", "YT", "CA", "KS", "MD", "CT", "NM", "MS", "MP", "PE", "OK", "IN", "NE", "NT", "KY", "ID" ] } }, { "name": "office_zip", "type": "string", "description": "Zipcode of principal office at end of period." }, { "name": "attestation_name", "type": "string", "description": "Name of person signing the corporate officer's certification." }, { "name": "attestation_title", "type": "string", "description": "Title of person signing the corporate officer's certification." }, { "name": "attestation_date", "type": "date", "description": "Date that corporate officer's certification was signed." }, { "name": "attestation_signature", "type": "string", "description": "Signature of corporate officer to certify the report." }, { "name": "filing_software_vendor_name", "type": "string", "description": "Name of software company used for creating the instance file submitted. If the filer created the submission, is null" }, { "name": "report_filing_type", "type": "string", "description": "Type of report submitted: O (original) or R (revision).", "constraints": { "required": true, "enum": [ "R", "O" ] } }, { "name": "filing_date", "type": "date", "description": "Date on which the filing was submitted." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "report_filing_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 326753, "hash": "sha256:2638695ebb43bb0ec193c81b53bed2ef87de402c9797af8f988e566501b72784" }, { "name": "core_ferc1__yearly_income_statements_sched114", "type": "table", "description": "Annual time series of utility income statements.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 114)\n\nPrimary key:\n utility_id_ferc1, report_year, utility_type, income_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_income_statements_sched114.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "income_type", "type": "string", "description": "Type of income reported in core_ferc1__yearly_income_statements_sched114 table.", "constraints": { "required": true } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "utility_type", "income_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3876366, "hash": "sha256:1622dea993f758c094631506fe66b27132bf96a3cc7f664a9bba05dd26b1de10" }, { "name": "core_ferc1__yearly_operating_expenses_sched320", "type": "table", "description": "Annual time series of operating and maintenance costs associated with producing electricity.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 320)\n\nPrimary key:\n utility_id_ferc1, report_year, expense_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_operating_expenses_sched320.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "expense_type", "type": "string", "description": "The type of expense.", "constraints": { "required": true, "enum": [ "maintenance_of_miscellaneous_other_power_generation_plant", "operation_supervision", "maintenance_of_reactor_plant_equipment_nuclear_power_generation", "maintenance_of_electric_plant_nuclear_power_generation", "nuclear_fuel_expense", "transmission_of_electricity_by_others", "power_production_expenses_hydraulic_power_correction", "hydraulic_power_generation_maintenance_expense", "steam_transferred_credit_nuclear_power_generation", "regional_market_expenses", "station_expenses_distribution", "electric_expenses_steam_power_generation", "operations_and_maintenance_expenses_electric", "customer_records_and_collection_expenses", "maintenance_of_electric_plant_hydraulic_power_generation", "other_power_generation_operations_expense_correction", "distribution_maintenance_expense_electric", "distribution_expenses", "reliability_planning_and_standards_development", "uncollectible_accounts", "regional_market_maintenance_expense_correction", "maintenance_supervision_and_engineering_other_power_generation", "hydraulic_power_generation_operations_expense_correction", "maintenance_of_boiler_plant_steam_power_generation", "power_production_expenses_hydraulic_power", "miscellaneous_steam_power_expenses", "administrative_and_general_operation_expense", "rents_hydraulic_power_generation", "underground_line_expenses_transmission_expense", "operation_supervision_and_engineering_steam_power_generation", "transmission_service_studies", "load_dispatching_transmission_expense", "load_dispatch_transmission_service_and_scheduling", "power_production_expenses", "maintenance_of_meters", "load_dispatch_monitor_and_operate_transmission_system", "maintenance_of_electric_plant_steam_power_generation", "hydraulic_power_generation_operations_expense", "steam_from_other_sources", "street_lighting_and_signal_system_expenses", "steam_power_generation_maintenance_expense_correction", "steam_expenses_steam_power_generation", "operation_supervision_and_engineering_electric_transmission_expenses", "other_power_generation_maintenance_expense_correction", "maintenance_of_overhead_lines", "power_production_expenses_other_power_correction", "nuclear_power_generation_maintenance_expense_correction", "customer_installations_expenses", "operation_supervision_and_engineering_hydraulic_power_generation", "load_dispatching", "customer_service_and_information_expenses", "outside_services_employed", "maintenance_of_miscellaneous_market_operation_plant", "maintenance_of_line_transformers", "maintenance_of_computer_hardware_transmission", "other_power_supply_expense_correction", "purchased_power", "administrative_and_general_expenses", "overhead_line_expenses", "miscellaneous_nuclear_power_expenses", "administrative_and_general_expenses_correction", "maintenance_of_structures_and_improvements_regional_market_expenses", "rents_regional_market_expenses", "distribution_maintenance_expense_electric_correction", "power_production_expenses_nuclear_power", "maintenance_of_structures_hydraulic_power_generation", "maintenance_of_general_plant", "electric_expenses_hydraulic_power_generation", "maintenance_supervision_and_engineering_steam_power_generation", "maintenance_of_structures_steam_power_generation", "maintenance_supervision_and_engineering", "nuclear_power_generation_operations_expense_correction", "maintenance_of_structures", "maintenance_of_computer_software_transmission", "operation_of_energy_storage_equipment", "rents_steam_power_generation", "miscellaneous_sales_expenses", "informational_and_instructional_advertising_expenses", "employee_pensions_and_benefits", "transmission_expenses_correction", "other_expenses_other_power_supply_expenses", "administrative_expenses_transferred_credit", "station_expenses_transmission_expense", "scheduling_system_control_and_dispatch_services", "generation_expenses", "operation_supervision_and_engineering_distribution_expense", "customer_assistance_expenses", "regional_market_expenses_correction", "other_power_generation_operations_expense", "transmission_operation_expense_correction", "maintenance_supervision_and_engineering_electric_transmission_expenses", "other_power_supply_expense", "administrative_and_general_salaries", "rents_nuclear_power_generation", "fuel_steam_power_generation", "power_purchased_for_storage_operations", "miscellaneous_hydraulic_power_generation_expenses", "power_production_expenses_other_power", "maintenance_of_computer_hardware", "operations_and_maintenance_expenses_electric_correction", "maintenance_of_communication_equipment_regional_market_expenses", "overhead_line_expense", "maintenance_of_miscellaneous_hydraulic_plant", "maintenance_of_computer_software", "rents_administrative_and_general_expense", "regional_market_operation_expense", "property_insurance", "administrative_and_general_operation_expense_correction", "distribution_operation_expenses_electric_correction", "maintenance_of_miscellaneous_steam_plant", "supervision_customer_account_expenses", "fuel", "operation_supervision_and_engineering_other_power_generation", "rents_other_power_generation", "sales_expenses", "market_monitoring_and_compliance", "ancillary_services_market_administration", "customer_account_expenses", "maintenance_supervision_and_engineering_nuclear_power_generation", "maintenance_of_structures_transmission_expense", "maintenance_of_miscellaneous_regional_transmission_plant", "maintenance_supervision_and_engineering_hydraulic_power_generation", "operation_supervision_and_engineering_nuclear_power_generation", "maintenance_of_energy_storage_equipment_other_power_generation", "steam_expenses_nuclear_power_generation", "duplicate_charges_credit", "maintenance_of_station_equipment_transmission", "maintenance_of_energy_storage_equipment_transmission", "maintenance_of_reservoirs_dams_and_waterways", "operation_of_energy_storage_equipment_transmission_expense", "steam_transferred_credit", "maintenance_of_miscellaneous_nuclear_plant", "hydraulic_power_generation_maintenance_expense_correction", "power_production_expenses_correction", "allowances", "customer_account_expenses_correction", "electric_expenses_nuclear_power_generation", "steam_power_generation_operations_expense_correction", "supervision_customer_service_and_information_expenses", "rents_distribution_expense", "distribution_operation_expenses_electric", "maintenance_of_miscellaneous_transmission_plant", "reliability_planning_and_standards_development_services", "regional_market_operation_expense_correction", "miscellaneous_general_expenses", "steam_power_generation_operations_expense", "maintenance_of_overhead_lines_transmission", "day_ahead_and_real_time_market_administration", "maintenance_of_generating_and_electric_plant", "water_for_power", "office_supplies_and_expenses", "generation_interconnection_studies", "maintenance_of_underground_lines_transmission", "sales_expenses_correction", "distribution_expenses_correction", "maintenance_of_communication_equipment_electric_transmission", "miscellaneous_other_power_generation_expenses", "meter_reading_expenses", "market_facilitation_monitoring_and_compliance_services", "maintenance_of_energy_storage_equipment", "general_advertising_expenses", "capacity_market_administration", "maintenance_of_underground_lines", "transmission_rights_market_administration", "maintenance_of_structures_distribution_expense", "miscellaneous_customer_service_and_informational_expenses", "regulatory_commission_expenses", "power_production_expenses_steam_power", "maintenance_of_structures_nuclear_power_generation", "maintenance_of_miscellaneous_distribution_plant", "coolants_and_water", "rents_transmission_electric_expense", "steam_from_other_sources_nuclear_power_generation", "injuries_and_damages", "other_power_generation_maintenance_expense", "franchise_requirements", "miscellaneous_distribution_expenses", "load_dispatch_reliability", "miscellaneous_transmission_expenses", "operation_of_energy_storage_equipment_distribution", "maintenance_of_street_lighting_and_signal_systems", "underground_line_expenses", "transmission_expenses", "meter_expenses", "hydraulic_expenses", "transmission_operation_expense", "steam_power_generation_maintenance_expense", "regional_market_maintenance_expense", "transmission_maintenance_expense_electric_correction", "transmission_maintenance_expense_electric", "customer_service_and_information_expenses_correction", "miscellaneous_customer_accounts_expenses", "nuclear_power_generation_maintenance_expense", "system_control_and_load_dispatching_electric", "supervision_sales_expense", "advertising_expenses", "demonstrating_and_selling_expenses", "nuclear_power_generation_operations_expense", "power_production_expenses_steam_power_correction", "power_production_expenses_nuclear_power_correction", "maintenance_of_station_equipment" ] } }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "expense_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6429882, "hash": "sha256:1ed00b026938a3060751294a363f98febe332f4aadaf50f80a909fa0ba209d12" }, { "name": "core_ferc1__yearly_operating_revenues_sched300", "type": "table", "description": "Annual time series of utilities' electric operating revenues.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 300)\n\nPrimary key:\n utility_id_ferc1, report_year, revenue_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_operating_revenues_sched300.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "revenue_type", "type": "string", "description": "Label describing types of revenues.", "constraints": { "required": true, "enum": [ "sales_for_resale_correction", "revenues_net_of_provision_for_refunds", "electric_operating_revenues", "public_street_and_highway_lighting", "small_or_commercial", "other_operating_revenues_correction", "interdepartmental_sales", "sales_to_ultimate_consumers", "revenues_from_transmission_of_electricity_of_others", "rent_from_electric_property", "public_street_and_highway_lighting_correction", "sales_for_resale", "sales_to_railroads_and_railways", "interdepartmental_sales_correction", "miscellaneous_revenue", "regional_transmission_service_revenues", "interdepartmental_rents", "miscellaneous_service_revenues", "sales_of_electricity", "other_electric_revenue", "large_or_industrial_correction", "small_or_commercial_correction", "other_operating_revenues", "revenues_net_of_provision_for_refunds_correction", "residential_sales", "electric_operating_revenues_correction", "sales_of_water_and_water_power", "other_miscellaneous_operating_revenues", "residential_sales_correction", "sales_to_railroads_and_railways_correction", "sales_of_electricity_correction", "forfeited_discounts", "sales_to_ultimate_consumers_correction", "other_sales_to_public_authorities_correction", "other_sales_to_public_authorities", "provision_for_rate_refunds", "large_or_industrial" ] } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "avg_customers_per_month", "type": "number", "description": "Average number of customers per month." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "revenue_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1311712, "hash": "sha256:69d6c6a46ef1ab494d0009a67bdcf6e1d63156d5ca39a4390e279bea3986617e" }, { "name": "core_ferc1__yearly_other_regulatory_assets_sched232", "type": "table", "description": "Annual time series of utilities' other regulatory assets, including rate order docket number.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 232)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_other_regulatory_assets_sched232.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "description", "type": "string", "description": "Free-form description and purpose of other regulatory assets." }, { "name": "additional_description", "type": "string", "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." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "debits", "type": "number", "description": "The increase (decrease) during the period in the value of other assets resulting from the ratemaking actions of regulatory agencies." }, { "name": "credits_written_off_recovered", "type": "number", "description": "Recovered amount of divestiture of other assets lacking physical substance resulting from the ratemaking actions of regulatory agencies." }, { "name": "account_detail", "type": "string", "description": "Description of the account number credited from making debit adjustment to other regulatory liabilities." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3466530, "hash": "sha256:418665ba02b3bb1d8e885edd003e69457626cc765821afef45843505bcddfe83" }, { "name": "core_ferc1__yearly_other_regulatory_liabilities_sched278", "type": "table", "description": "Annual time series of utilities' other regulatory liabilities, including rate order docket number.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 278)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_other_regulatory_liabilities_sched278.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." }, { "name": "additional_description", "type": "string", "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." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "increase_in_other_regulatory_liabilities", "type": "number", "description": "The increase during the reporting period of other regulatory liabilities.", "unit": "USD" }, { "name": "account_detail", "type": "string", "description": "Description of the account number credited from making debit adjustment to other regulatory liabilities." }, { "name": "decrease_in_other_regulatory_liabilities", "type": "number", "description": "The decrease during the reporting period of other regulatory liabilities.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1535793, "hash": "sha256:4a10bb9b9f43b09ea7155f174e90aab28cb0dbe7511039a91f66e2c16afc3b90" }, { "name": "core_ferc1__yearly_plant_in_service_sched204", "type": "table", "description": "Annual time series of utilities' balances and changes to FERC Electric Plant in Service accounts.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 204)\n\nPrimary key:\n utility_id_ferc1, report_year, ferc_account_label\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAccount 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_plant_in_service_sched204.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "ferc_account_label", "type": "string", "description": "Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.", "constraints": { "required": true, "enum": [ "roads_railroads_and_bridges_hydraulic_production", "land_and_land_rights_hydraulic_production", "electric_plant_in_service_and_completed_construction_not_classified_electric_correction", "other_production_plant_correction", "other_tangible_property_general_plant", "energy_storage_equipment_transmission_plant", "structures_and_improvements_steam_production", "miscellaneous_power_plant_equipment_steam_production", "franchises_and_consents", "poles_towers_and_fixtures_distribution_plant", "hydraulic_production_plant", "energy_storage_equipment_distribution_plant", "stores_equipment_general_plant", "underground_conductors_and_devices_distribution_plant", "turbogenerator_units_nuclear_production", "station_equipment_transmission_plant", "general_plant_excluding_other_tangible_property_and_asset_retirement_costs_for_general_plant_correction", "asset_retirement_costs_for_other_production_plant_other_production", "experimental_electric_plant_unclassified", "miscellaneous_equipment_general_plant", "distribution_plant_correction", "asset_retirement_costs_for_nuclear_production_plant_nuclear_production", "communication_equipment_general_plant", "structures_and_improvements_regional_transmission_and_market_operation_plant", "asset_retirement_costs_for_steam_production_plant_steam_production", "turbogenerator_units_steam_production", "transmission_plant_correction", "land_and_land_rights_regional_transmission_and_market_operation_plant", "nuclear_production_plant", "accessory_electric_equipment_steam_production", "computer_software_regional_transmission_and_market_operation_plant", "line_transformers_distribution_plant", "reactor_plant_equipment_nuclear_production", "miscellaneous_power_plant_equipment_hydraulic_production", "fuel_holders_products_and_accessories_other_production", "services_distribution_plant", "underground_conduit_distribution_plant", "structures_and_improvements_nuclear_production", "meters_distribution_plant", "underground_conductors_and_devices_transmission_plant", "transmission_and_market_operation_plant_regional_transmission_and_market_operation_plant", "communication_equipment_regional_transmission_and_market_operation_plant", "structures_and_improvements_general_plant", "asset_retirement_costs_for_distribution_plant_distribution_plant", "steam_production_plant_correction", "reservoirs_dams_and_waterways_hydraulic_production", "miscellaneous_intangible_plant", "office_furniture_and_equipment_general_plant", "land_and_land_rights_nuclear_production", "electric_plant_in_service_correction", "general_plant_excluding_other_tangible_property_and_asset_retirement_costs_for_general_plant", "electric_plant_sold", "prime_movers_other_production", "transportation_equipment_general_plant", "intangible_plant_correction", "accessory_electric_equipment_other_production", "accessory_electric_equipment_hydraulic_production", "production_plant_correction", "general_plant", "engines_and_engine_driven_generators_steam_production", "miscellaneous_power_plant_equipment_other_production", "laboratory_equipment_general_plant", "street_lighting_and_signal_systems_distribution_plant", "overhead_conductors_and_devices_distribution_plant", "installations_on_customer_premises_distribution_plant", "overhead_conductors_and_devices_transmission_plant", "computer_hardware_regional_transmission_and_market_operation_plant", "underground_conduit_transmission_plant", "electric_plant_in_service_and_completed_construction_not_classified_electric", "miscellaneous_regional_transmission_and_market_operation_plant_regional_transmission_and_market_operation_plant", "asset_retirement_costs_for_regional_transmission_and_market_operation_plant_regional_transmission_and_market_operation_plant", "land_and_land_rights_general_plant", "structures_and_improvements_other_production", "other_production_plant", "distribution_plant", "nuclear_production_plant_correction", "organization", "accessory_electric_equipment_nuclear_production", "structures_and_improvements_hydraulic_production", "transmission_plant", "transmission_and_market_operation_plant_regional_transmission_and_market_operation_plant_correction", "production_plant", "steam_production_plant", "structures_and_improvements_distribution_plant", "miscellaneous_power_plant_equipment_nuclear_production", "water_wheels_turbines_and_generators_hydraulic_production", "structures_and_improvements_transmission_plant", "boiler_plant_equipment_steam_production", "hydraulic_production_plant_correction", "tools_shop_and_garage_equipment_general_plant", "leased_property_on_customer_premises_distribution_plant", "station_equipment_distribution_plant", "asset_retirement_costs_for_general_plant_general_plant", "electric_plant_purchased", "energy_storage_equipment_other_production", "power_operated_equipment_general_plant", "land_and_land_rights_other_production", "electric_plant_in_service", "asset_retirement_costs_for_transmission_plant_transmission_plant", "roads_and_trails_transmission_plant", "poles_and_fixtures_transmission_plant", "general_plant_correction", "land_and_land_rights_distribution_plant", "towers_and_fixtures_transmission_plant", "land_and_land_rights_steam_production", "land_and_land_rights_transmission_plant", "asset_retirement_costs_for_hydraulic_production_plant_hydraulic_production", "intangible_plant", "generators_other_production" ] } }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "adjustments", "type": "number", "description": "Cost of adjustments to the account.", "unit": "USD" }, { "name": "transfers", "type": "number", "description": "Cost of transfers into (out of) the account.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total)." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "ferc_account_label" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7825002, "hash": "sha256:d6cfd50e4c2a4d41ec63b2e22b7dfb315b174f3485b2e07794d5be0544af67f4" }, { "name": "core_ferc1__yearly_pumped_storage_plants_sched408", "type": "table", "description": "Annual time series of plant statistics for hydroelectric pumped storage plants with an installed nameplate capacity of 10+ MW.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 408)\n\nPrimary key:\n This table has no primary key. 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAs reported in Schedule 408 of FERC Form 1.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_pumped_storage_plants_sched408.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "project_num", "type": "integer", "description": "FERC Licensed Project Number." }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_capability_mw", "type": "number", "description": "Net plant capability in megawatts.", "unit": "MW" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "energy_used_for_pumping_mwh", "type": "number", "description": "Energy used for pumping, in megawatt-hours.", "unit": "MWh" }, { "name": "net_load_mwh", "type": "number", "description": "Net output for load (net generation - energy used for pumping) in megawatt-hours.", "unit": "MWh" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_facilities", "type": "number", "description": "Cost of plant: reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "capex_wheels_turbines_generators", "type": "number", "description": "Cost of plant: water wheels, turbines, and generators (USD).", "unit": "USD" }, { "name": "capex_equipment_electric", "type": "number", "description": "Cost of plant: accessory electric equipment (USD).", "unit": "USD" }, { "name": "capex_equipment_misc", "type": "number", "description": "Cost of plant: miscellaneous power plant equipment (USD).", "unit": "USD" }, { "name": "capex_roads", "type": "number", "description": "Cost of plant: roads, railroads, and bridges (USD).", "unit": "USD" }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_water_for_power", "type": "number", "description": "Production expenses: water for power (USD).", "unit": "USD" }, { "name": "opex_pumped_storage", "type": "number", "description": "Production expenses: pumped storage (USD).", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_generation_misc", "type": "number", "description": "Production expenses: miscellaneous power generation expenses (USD).", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_dams", "type": "number", "description": "Production expenses: maintenance of reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "opex_plant", "type": "number", "description": "Production expenses: maintenance of electric plant (USD).", "unit": "USD" }, { "name": "opex_misc_plant", "type": "number", "description": "Production expenses: maintenance of miscellaneous hydraulic plant (USD).", "unit": "USD" }, { "name": "opex_production_before_pumping", "type": "number", "description": "Total production expenses before pumping (USD).", "unit": "USD" }, { "name": "opex_pumping", "type": "number", "description": "Production expenses: We are here to PUMP YOU UP! (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 112973, "hash": "sha256:e83bab714bcf718e74a5803ccae5ac09a0748d8a6cac34774b74dd9e1c2639c4" }, { "name": "core_ferc1__yearly_purchased_power_and_exchanges_sched326", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 326)\n\nPrimary key:\n This table has no primary key. The primary key for this table would be record_id,\n however a small number of these values are duplicated in 2021, 2022, and 2024.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.\n\nPurchased Power is considered FERC Account 555 according to FERC's Uniform System of Accounts. Reported on pages 326-327 of FERC Form 1.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_purchased_power_and_exchanges_sched326.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "seller_name", "type": "string", "description": "Name of the seller, or the other party in an exchange transaction." }, { "name": "purchase_type_code", "type": "string", "description": "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." }, { "name": "tariff", "type": "string", "description": "FERC Rate Schedule Number or Tariff. (Note: may be incomplete if originally reported on multiple lines.)" }, { "name": "billing_demand_mw", "type": "number", "description": "Monthly average billing demand (for requirements purchases, and any transactions involving demand charges). In megawatts.", "unit": "MW" }, { "name": "non_coincident_peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "coincident_peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "purchased_mwh", "type": "number", "description": "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.", "unit": "MWh" }, { "name": "purchased_storage_mwh", "type": "number", "description": "Number of megawatt hours purchased during the period for energy storage.", "unit": "MWh" }, { "name": "purchased_other_than_storage_mwh", "type": "number", "description": "Number of megawatt hours purchased during the period for other than energy storage.", "unit": "MWh" }, { "name": "received_mwh", "type": "number", "description": "Gross megawatt-hours received in power exchanges and used as the basis for settlement.", "unit": "MWh" }, { "name": "delivered_mwh", "type": "number", "description": "Gross megawatt-hours delivered in power exchanges and used as the basis for settlement.", "unit": "MWh" }, { "name": "demand_charges", "type": "number", "description": "Demand charges (USD).", "unit": "USD" }, { "name": "energy_charges", "type": "number", "description": "Energy charges (USD).", "unit": "USD" }, { "name": "other_charges", "type": "number", "description": "Other charges, including out-of-period adjustments (USD).", "unit": "USD" }, { "name": "total_settlement", "type": "number", "description": "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.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "purchase_type_code" ], "reference": { "resource": "core_ferc1__codes_power_purchase_types", "fields": [ "code" ] } }, { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6118707, "hash": "sha256:ad52e23d153f1b3bb2b24ba8ced1ff5693219922c9182501a5778b0072d58970" }, { "name": "core_ferc1__yearly_retained_earnings_sched118", "type": "table", "description": "Annual time series of utilities' statements of retained earnings.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 118)\n\nPrimary key:\n utility_id_ferc1, report_year, earnings_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_retained_earnings_sched118.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "earnings_type", "type": "string", "description": "Label describing types of earnings.", "constraints": { "required": true, "enum": [ "adjustments_to_retained_earnings_debit", "transfers_from_unappropriated_undistributed_subsidiary_earnings", "changes_unappropriated_undistributed_subsidiary_earnings_credits", "unappropriated_undistributed_subsidiary_earnings_correction", "appropriated_retained_earnings_amortization_reserve_federal", "unappropriated_retained_earnings_correction", "appropriations_of_retained_earnings", "retained_earnings", "balance_transferred_from_income", "unappropriated_undistributed_subsidiary_earnings_previous_year", "dividends_declared_common_stock", "dividends_declared_preferred_stock", "dividends_received", "unappropriated_retained_earnings", "appropriated_retained_earnings_including_reserve_amortization_correction", "appropriated_retained_earnings", "unappropriated_undistributed_subsidiary_earnings", "adjustments_to_retained_earnings_credit", "equity_in_earnings_of_subsidiary_companies", "retained_earnings_correction", "unappropriated_retained_earnings_previous_year", "appropriated_retained_earnings_including_reserve_amortization" ] } }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "earnings_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 971401, "hash": "sha256:0e557caccbe26c5cdd3728b5220b3d288a25497cc913714a757eb97e828d3ee3" }, { "name": "core_ferc1__yearly_sales_by_rate_schedules_sched304", "type": "table", "description": "Annual time series of utilities' electric sales from all rate schedules in effect throughout the year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 304)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Values in rate_schedule_description are free-form strings.\n\n* Data prior to 2021 does not include information in columns: rate_schedule_type and billing_status.\n\n* Units of revenue_per_kwh are suspected to include a mix of dollars and possibly cents.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe pre-2021 data in this table (extracted from FoxProDB vs. XBRL) is\nextremely unstructured. Where the post-2020 data (from XBRL) sorts the data\ninto rate schedule types: residential, industrial, commercial,\npublic_lighting, public_authorities, railroads, interdepartmental,\nprovision_for_rate_refund, commercial_and_industrial, total, and billing\nstatus: billed, unbilled, total, the pre-2021 data stuffs all of that\ninformation (if you're lucky) into the rate_schedule_description column.\nThere's no point trying to parse through the pre 2021\nrate_schedule_description column en masse because it's just too messy. The\ncontents of rate_schedule_description often contain numbers and acronyms\nthat have little to no meaning out of context. The table is structured\nsomewhat like the FERC1 small generators table with headings about rate\nstructure type also embedded into the rate_schedule_description column. To\nall who dare, beware.\n\nThis table is a combination of one pre-2021 (DBF) table and nine post-2020\n(XBRL) tables--one for each rate schedule type plus totals--hence increase\nin data clarity post-2020. The rate_schedule_type and billing_status\ncolumns are only relevant for post-2020 data as they can be reliably parsed\nfrom each of the tables and incorporated into columns. The\nrate_schedule_description is supposed to contain sub-rate_schedule_type\nnames for charges (Ex: Residential 1, Residential 2, etc.). However, the\npre-2021 data contains a little bit of everything (or nothing) and the\npost-2020 has some totals or wonky data thrown in. That's to say, even when\nworking with post-2020 data, be wary of aggregating the data. That's what\nthe \"total\" rows are for.\n\nThe values that come from from the totals table are marked with the string\n\"total\" in the rate_schedule_description column. The totals table is a\nproduct of the transition to XBRL, so these distinguishable totals are only\navailable for data post-2020 (otherwise you could try keyword searching for\n\"total\" in rate_schedule_description). The total table contains two types of\ntotals, the utility totals across all rate schedules in a given year\n(marked with rate_schedule_description = \"total\" and rate_schedule_type =\n\"total\") and each of the utility's individual rate schedule totals in a\ngiven year (marked with rate_schedule_description = \"total\" and\nrate_schedule_type = \"residential\" or any other rate schedule type).\n\nThe rate schedule based XBRL tables only report billed values whereas the\ntotal tables report billed, unbilled, and total values. (See the column\ndescription for more info on the difference between billed and unbilled).\nThis is important to consider if you're endeavoring to compare the subtotal\nvalues with the total values. We have not attempted to fix or verify any\nsubtotals or totals that don't add up.\n\nAnother important note is the possibility of unit discrepancies in certain\ncolumns. The revenue_per_kwh column does not specify reporting units, and\ncloser inspection of the data reveals two clear peaks approximate two orders\nof magnitude apart. This indicates that values may be reported in both\ndollars and cents. However, because the price of energy per kwh varies\nso much regionally, we cannot guarantee which is which and have not put\nany cleaning mechanisms in place to account for this.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_sales_by_rate_schedules_sched304.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "rate_schedule_type", "type": "string", "description": "Categorization of rate schedule type." }, { "name": "billing_status", "type": "string", "description": "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." }, { "name": "rate_schedule_description", "type": "string", "description": "Free-form description of what the rate schedule name is. Not standardized. Often a sub-category of rate_schedule_type." }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "avg_customers_per_month", "type": "number", "description": "Average number of customers per month." }, { "name": "kwh_per_customer", "type": "number", "description": "kWh per customer." }, { "name": "revenue_per_kwh", "type": "number", "description": "The amount of revenue per kWh by rate schedule acquired in the given report year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7492262, "hash": "sha256:7e5129dace3320ca451940654f4103381e3fc847e12224a12bf60970a618dde2" }, { "name": "core_ferc1__yearly_small_plants_sched410", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 410)\n\nPrimary key:\n This table has no primary key. 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAs reported on FERC Form 1 Schedule 410 (pages 410-411)\nand extracted from the FERC Visual FoxPro and XBRL. See our\n``pudl.extract.ferc1.TABLE_NAME_MAP_FERC1`` for links to the raw tables.\n\nThe raw version of this table is more like a digitized PDF than an actual data table.\nThe rows contain lots of information in addition to what the columns might suggest.\nFor instance, a single column may contain header rows, note rows, and total rows. This\nextraneous information is useful, but it prevents proper analysis when mixed in with the\nrest of the values data in the column. We employ a couple of data transformations to\nextract these rows from the data and preserve some of the information they contain\n(fuel type, plant type, FERC license, or general notes about the plant) in separate\ncolumns.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_small_plants_sched410.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "plant_type", "type": "string", "description": "Type of plant." }, { "name": "license_id_ferc1", "type": "integer", "description": "FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible." }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_fuel", "type": "number", "description": "Production expenses: fuel (USD).", "unit": "USD" }, { "name": "opex_maintenance", "type": "number", "description": "Production expenses: Maintenance (USD).", "unit": "USD" }, { "name": "fuel_type", "type": "string", "description": "Type of fuel." }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 694431, "hash": "sha256:dfdb5eb7e5b92f026cfc15df1eef354b52f7d9cafc535664048487fae3176d52" }, { "name": "core_ferc1__yearly_steam_plants_fuel_sched402", "type": "table", "description": "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. \n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The ``fuel_type_code_pudl`` is inferred from a free-form string field.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is a subset of the steam plant table reported on page 402 of FERC Form 1.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_steam_plants_fuel_sched402.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_units", "type": "string", "description": "Reported unit of measure for fuel.", "constraints": { "enum": [ "mmbtu", "gramsU", "kg", "mwhth", "kgal", "bbl", "klbs", "mcf", "gal", "mwdth", "btu", "ton" ] } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_cost_per_unit_burned", "type": "number", "description": "Average cost of fuel consumed in the report year per reported fuel unit (USD).", "unit": "USD" }, { "name": "fuel_cost_per_unit_delivered", "type": "number", "description": "Average cost of fuel delivered in the report year per reported fuel unit (USD).", "unit": "USD" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1416365, "hash": "sha256:093949eda55009575e99f0f0ca51923421d9ab4e11d2eb9db5f563d2333e887a" }, { "name": "core_ferc1__yearly_steam_plants_sched402", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)\n\nPrimary key:\n This table has no primary key. 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_steam_plants_sched402.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "steam", "geothermal", "combined_cycle", "internal_combustion", "photovoltaic", "solar_thermal", "nuclear", "na_category", "wind", "combustion_turbine" ] } }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_capability_mw", "type": "number", "description": "Net plant capability in megawatts.", "unit": "MW" }, { "name": "water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when limited by condenser water.", "unit": "MW" }, { "name": "not_water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when not limited by condenser water.", "unit": "MW" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_equipment", "type": "number", "description": "Cost of plant: equipment (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_fuel", "type": "number", "description": "Production expenses: fuel (USD).", "unit": "USD" }, { "name": "opex_coolants", "type": "number", "description": "Cost of coolants and water (nuclear plants only)", "unit": "USD" }, { "name": "opex_steam", "type": "number", "description": "Steam expenses.", "unit": "USD" }, { "name": "opex_steam_other", "type": "number", "description": "Steam from other sources.", "unit": "USD" }, { "name": "opex_transfer", "type": "number", "description": "Steam transferred (Credit)." }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_misc_power", "type": "number", "description": "Miscellaneous steam (or nuclear) expenses.", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_allowances", "type": "number", "description": "Allowances.", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_boiler", "type": "number", "description": "Maintenance of boiler (or reactor) plant.", "unit": "USD" }, { "name": "opex_plants", "type": "number", "description": "Maintenance of electrical plant.", "unit": "USD" }, { "name": "opex_misc_steam", "type": "number", "description": "Maintenance of miscellaneous steam (or nuclear) plant.", "unit": "USD" }, { "name": "opex_production_total", "type": "number", "description": "Total operating expenses.", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3616800, "hash": "sha256:0b06ac2c4e13cd9e8b06fdc7e4e5a979a7af07aa7fcf938b950c0796a4595570" }, { "name": "core_ferc1__yearly_transmission_lines_sched422", "type": "table", "description": "Annual time series of statistics about transmission lines.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 422)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nInformation 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_transmission_lines_sched422.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "start_point", "type": "string", "description": "The starting point of a transmission line." }, { "name": "end_point", "type": "string", "description": "The end point of a transmission line." }, { "name": "operating_voltage_kv", "type": "number", "description": "The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines.", "unit": "KV" }, { "name": "designed_voltage_kv", "type": "number", "description": "Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines", "unit": "KV" }, { "name": "supporting_structure_type", "type": "string", "description": "Supporting structure of the transmission line." }, { "name": "transmission_line_length_miles", "type": "number", "description": "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)." }, { "name": "transmission_line_and_structures_length_miles", "type": "number", "description": "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)." }, { "name": "num_transmission_circuits", "type": "integer", "description": "Number of circuits in a transmission line." }, { "name": "conductor_size_and_material", "type": "string", "description": "Size of transmission conductor and material of the transmission line." }, { "name": "capex_land", "type": "number", "description": "Cost of Land and land rights for the transmission line.", "unit": "USD" }, { "name": "capex_other", "type": "number", "description": "Construction and other costs for the transmission line.", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total costs for the transmission line.", "unit": "USD" }, { "name": "opex_operations", "type": "number", "description": "Operating expenses for the transmission line.", "unit": "USD" }, { "name": "opex_maintenance", "type": "number", "description": "Maintenance expenses for the transmission line.", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Rent expenses for the transmission line.", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Overall expenses for the transmission line.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 13437292, "hash": "sha256:af5e5900c601db0b735d8ea1eaf8c1270de71de97f26c7cfbd7d03236c5180fc" }, { "name": "core_ferc1__yearly_utility_plant_summary_sched200", "type": "table", "description": "Annual time series of utility plant and accumulated provisions for depreciation, amortization and depletion of utility plant assets.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 200)\n\nPrimary key:\n utility_id_ferc1, report_year, utility_type, utility_plant_asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc1__yearly_utility_plant_summary_sched200.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "utility_type_other", "type": "string", "description": "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)." }, { "name": "utility_plant_asset_type", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "utility_type", "utility_plant_asset_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1339312, "hash": "sha256:1145d597ed5d166bd046171f773f33abdad3cf558cb8f4ea0387961cec2a00bf" }, { "name": "core_ferc714__hourly_planning_area_demand", "type": "table", "description": "Hourly time series of electricity demand by planning area.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report (Part III, Schedule 2a)\n\nPrimary key:\n respondent_id_ferc714, datetime_utc\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The datetime_utc timestamps have been cleaned due to inconsistent datetime reporting. See below for additional details.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes data from the pre-2021 CSV raw source as well as the newer 2021 through present XBRL raw source.\n\nThis table includes three respondent ID columns: one from the CSV raw source, one from the XBRL raw source and another that is PUDL-derived that links those two source ID's together. This table has filled in source IDs for all records so you can select the full timeseries for a given respondent from any of these three IDs.\n\nAn important caveat to note is that there was some cleaning done to the datetime_utc timestamps. The Form 714 includes sparse documentation for respondents for how to interpret timestamps - the form asks respondents to provide 24 instances of hourly demand for each day. The form is labeled with hour 1-24. There is no indication if hour 1 begins at midnight.\n\nThe XBRL data contained several formats of timestamps. Most records corresponding to hour 1 of the Form have a timestamp with hour 1 as T1. About two thirds of the records in the hour 24 location of the form have a timestamp with an hour reported as T24 while the remaining third report this as T00 of the next day. T24 is not a valid format for the hour of a datetime, so we convert these T24 hours into T00 of the next day. A smaller subset of the respondents reports the 24th hour as the last second of the day - we also convert these records to the T00 of the next day.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "core_ferc714__hourly_planning_area_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714_csv", "type": "integer", "description": "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." }, { "name": "respondent_id_ferc714_xbrl", "type": "string", "description": "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." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } }, { "name": "demand_mwh", "type": "number", "description": "Electricity demand (energy) within a given timeframe.", "unit": "MWh" } ], "primaryKey": [ "respondent_id_ferc714", "datetime_utc" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 162009236, "hash": "sha256:d7dc0a8dd1dfe349b0bb9e11cb0835a7ca226b8b9a92c0819b7b4ad8924df84f" }, { "name": "core_ferc714__respondent_id", "type": "table", "description": "Respondent identification.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report (Part I, Schedule 1)\n\nPrimary key:\n respondent_id_ferc714\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "core_ferc714__respondent_id.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714_csv", "type": "integer", "description": "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." }, { "name": "respondent_id_ferc714_xbrl", "type": "string", "description": "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." }, { "name": "respondent_name_ferc714", "type": "string", "description": "Name of the utility, balancing area authority, or planning authority responding to FERC Form 714." }, { "name": "eia_code", "type": "integer", "description": "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." } ], "primaryKey": [ "respondent_id_ferc714" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 16346, "hash": "sha256:9bb2371426153a1f064a398f5cfd1c33640283bc6a8d486f26164d46a4e7ee1c" }, { "name": "core_ferc714__yearly_planning_area_demand_forecast", "type": "table", "description": "Annual time series of 10-year forecasted summer and winter peak demand and annual net energy per planning area.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report (Part III, Schedule 2b)\n\nPrimary key:\n respondent_id_ferc714, report_year, forecast_year\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This table includes data from the pre-2021 CSV raw source as well as the newer 2021 through present XBRL raw source. We created the respondent_id_ferc714 field to blend disparate IDs from the CSV and XBRL data over time. See the :ref:`core_ferc714__respondent_id` table for links to the original source IDs.\n\n* There is a small handful of respondents (~11) that report more than 10 years and an even smaller handful that report less than 10 (~9).\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table contains forecasted net demand (MWh) as well as summer and winter peak demand (MW) for the next ten years after after the report_year.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "core_ferc714__yearly_planning_area_demand_forecast.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "forecast_year", "type": "integer", "description": "Four-digit year that applies to a particular forecasted value.", "constraints": { "required": true } }, { "name": "summer_peak_demand_forecast_mw", "type": "number", "description": "The maximum forecasted hourly sumemr load (for the months of June through September).", "unit": "MW" }, { "name": "winter_peak_demand_forecast_mw", "type": "number", "description": "The maximum forecasted hourly winter load (for the months of January through March).", "unit": "MW" }, { "name": "net_demand_forecast_mwh", "type": "number", "description": "Net forecasted electricity demand for the specific period in megawatt-hours (MWh).", "unit": "MWh" } ], "primaryKey": [ "respondent_id_ferc714", "report_year", "forecast_year" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 272931, "hash": "sha256:7f5bd367da5569d92bb54516f1353fa228dc88dd44d64f872e183d4d3150af8f" }, { "name": "core_ferc__codes_accounts", "type": "table", "description": "Code table containing descriptions of categorical codes for account numbers from the FERC Uniform System of Accounts for Electric Plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC -- Mix of multiple FERC Forms\n\nPrimary key:\n ferc_account_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThese 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).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_ferc__codes_accounts.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "ferc_account_id", "type": "string", "description": "Account identifier from FERC's Uniform System of Accounts for Electric Plant. Includes higher level labeled categories.", "constraints": { "required": true } }, { "name": "ferc_account_description", "type": "string", "description": "Description of the FERC account." } ], "primaryKey": [ "ferc_account_id" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7050, "hash": "sha256:f43a5b70a7a030ba56abb5b1ba9a1520f402543b4d925d0f9b74fcc09387fda8" }, { "name": "core_ferc__entity_companies", "type": "table", "description": "Entity table containing static information about the companies that submit required filings to FERC.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n FERC -- Mix of multiple FERC Forms\n\nPrimary key:\n company_id_ferc\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [], "path": "core_ferc__entity_companies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "company_id_ferc", "type": "string", "description": "The Company Identifier (CID) obtained through FERC's Company Registration system.", "constraints": { "required": true } }, { "name": "company_name", "type": "string", "description": "The name of the FERC-reporting organization or company." }, { "name": "program", "type": "string", "description": "The specific program or initiative associated with the FERC organization, which can provide context for the company's activities.", "constraints": { "enum": [ "FPA (Market Based Rate) Public Utilities", "FPA (Traditional Cost of Service and Market Based Rates) Public Utilities", "ICA Oil Pipelines", "NGA Gas Pipelines", "NGPA 311 and NGA Hinshaw Gas Pipelines", "Power Administrations" ] } }, { "name": "company_website", "type": "string", "description": "The website URL of the company, which can provide additional information about the organization." }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "address_2", "type": "string", "description": "Second line of the address." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "zip_code_4", "type": "string", "description": "Four digit US Zip Code suffix.", "constraints": { "pattern": "^\\d{4}$" } } ], "primaryKey": [ "company_id_ferc" ], "foreignKeys": [] }, "bytes": 289291, "hash": "sha256:4dd958fe87bdd18835045e249a3e6c3b788c059aa1e10bd962e695ed009f0f6c" }, { "name": "core_gridpathratoolkit__assn_generator_aggregation_group", "type": "table", "description": "Association table providing connections between individual generator IDs and their corresponding aggregation group when creating aggregated profiles.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n GridPath Resource Adequacy Toolkit Data\n\nPrimary key:\n plant_id_eia, generator_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table defines which individual generator profiles are combined when creating aggregated capacity factors / generation profiles. Generator capacity is used to weight the contribution of each generator in the resulting aggregated profiles, and is made available in this table for convenience and legibility. The resulting aggregated profiles are stored in :ref:`out_gridpathratoolkit__hourly_available_capacity_factor`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "gridpathratoolkit", "title": "GridPath Resource Adequacy Toolkit Data", "path": "https://gridlab.org/gridpathratoolkit/", "email": "elaine@sylvan.energy", "description": "Hourly renewable generation profiles compiled for the Western United States as part of the GridPath Resource Adequacy Toolkit. Profiles are stated as a capacity factor (a fraction of nameplate capacity). There are 3 different levels of processing or aggregation provided, all at hourly resolution: Individual plant (wind) or generator (solar) output, capacity-weighted averages of wind and solar output aggregated to the level of balancing authority territories (or transmission zones for larger balancing authorities), and that same aggregated output but with some problematic individual generator profiles modified such that they match the overall production curve of the balancing authority they are within. This data also contains some daily weather data from several sites across the western US and tables describing the way in which individual wind and solar projects were aggregated up to the level of balancing authority or transmission zone.", "keywords": [ "capacity factor", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "weather", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.10844661", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Elaine Hart", "path": "https://www.sylvan.energy/", "email": "elaine@sylvan.energy", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Sylvan Energy Analytics", "name": "elaine-hart" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.10892394", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/gridpathratoolkit.html" } ], "path": "core_gridpathratoolkit__assn_generator_aggregation_group.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "aggregation_group", "type": "string", "description": "A label identifying a group of aggregated generator capacity factors." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "include_generator", "type": "boolean", "description": "Every row in the aggregation table describes a single generator. Groups of rows with the same aggregation are combined using a capacity weighted average to produce an aggregate generation profile. A few generators are not included in that aggregation process. This column determines whether a generator is included." } ], "primaryKey": [ "plant_id_eia", "generator_id" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } } ] }, "keywords": [ "capacity factor", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "weather", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Elaine Hart", "path": "https://www.sylvan.energy/", "email": "elaine@sylvan.energy", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Sylvan Energy Analytics", "name": "elaine-hart" } ], "bytes": 30166, "hash": "sha256:473aeece5d3bb07af9ee2d5901e45a7436ec941879d609ce5383c572de69ab60" }, { "name": "core_nrelatb__yearly_projected_cost_performance", "type": "table", "description": "Annual time series of projections of costs and performance for various technologies.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n NREL Annual Technology Baseline (ATB) for Electricity\n\nPrimary key:\n This table has no primary key. The fields technology_description_detail_1 and technology_description_detail_2 occasionally contain nulls, preventing this table from having a primary key.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes NREL's projections\nfor capital and operational costs as well as operational attributes for a variety of\ntechnologies for each of the NREL ATB scenarios. Each new year of ATB data includes\nprojections for the next 25 years.\n\nAll of the NREL tables are related. If you want to understand the financial assumptions\nof a given scenario in this table, see :ref:`core_nrelatb__yearly_projected_financial_cases`.\nThe other two ``core_nrealatb`` tables include attributes about technologies in these\nprojections.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "nrelatb", "title": "NREL Annual Technology Baseline (ATB) for Electricity", "path": "https://atb.nrel.gov/", "description": "The NREL Annual Technology Baseline (ATB) for Electricity publishes annual projections of operational and capital expenditures (by technology and vintage), as well as operating characteristics (by technology).", "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10839267", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.12658647", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/nrelatb.html" } ], "path": "core_nrelatb__yearly_projected_cost_performance.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "model_case_nrelatb", "type": "string", "description": "NREL's financial assumption cases. There are two cases which effect project financial assumptions: R&D Only Case and Market + Policies Case. R&D Only includes only projected R&D improvements while Market + Policy case includes policy and tax incentives. https://atb.nrel.gov/electricity/2024/financial_cases_&_methods", "constraints": { "enum": [ "Market", "R&D" ] } }, { "name": "model_tax_credit_case_nrelatb", "type": "string", "description": "NREL's tax credit assumption cases. There are two types of tax credits: production tax credit (PTC) and investment tax credit (ITC). For more detail, see: https://atb.nrel.gov/electricity/2024/financial_cases_&_methods", "constraints": { "enum": [ "ITC", "PTC + ITC", "PTC" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity.", "constraints": { "enum": [ "Coal_Retrofits", "DistributedWind", "OffShoreWind", "Utility-Scale PV-Plus-Battery", "Residential Battery Storage", "Coal_FE", "Pumped Storage Hydropower", "NaturalGas_FE", "Utility-Scale Battery Storage", "CSP", "Biopower", "CommPV", "LandbasedWind", "ResPV", "Geothermal", "UtilityPV", "Nuclear", "AEO", "NaturalGas_Retrofits", "Commercial Battery Storage", "Hydropower" ] } }, { "name": "cost_recovery_period_years", "type": "integer", "description": "The period over which the initial capital investment to build a plant is recovered." }, { "name": "scenario_atb", "type": "string", "description": "Technology innovation scenarios. https://atb.nrel.gov/electricity/2023/definitions#scenarios", "constraints": { "enum": [ "Advanced", "Moderate", "Conservative" ] } }, { "name": "technology_description_detail_1", "type": "string", "description": "Technology details indicate resource levels and specific technology subcategories." }, { "name": "technology_description_detail_2", "type": "string", "description": "Technology details indicate resource levels and specific technology subcategories." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capex_per_kw", "type": "number", "description": "Capital cost (USD). Expenditures required to achieve commercial operation of the generation plant.", "unit": "USD" }, { "name": "capex_overnight_per_kw", "type": "number", "description": "capex if plant could be constructed overnight (i.e., excludes construction period financing); includes on-site electrical equipment (e.g., switchyard), a nominal-distance spur line (<1 mi), and necessary upgrades at a transmission substation.", "unit": "USD" }, { "name": "capex_overnight_additional_per_kw", "type": "number", "description": "capex for retrofits if plant could be constructed overnight (i.e., excludes construction period financing); includes on-site electrical equipment (e.g., switchyard), a nominal-distance spur line (<1 mi), and necessary upgrades at a transmission substation.", "unit": "USD" }, { "name": "capex_grid_connection_per_kw", "type": "number", "description": "Overnight capital cost includes a nominal-distance spur line (<1 mi) for all technologies, and for offshore wind, it includes export cable and construction period transit costs for a 30-km distance from shore. Project-specific costs lines that are based on distance to existing transmission are not included. This only applies to offshore wind." }, { "name": "capex_construction_finance_factor", "type": "number", "description": "Portion of all-in capital cost associated with construction period financing. This factor is applied to an overnight capital cost to represent the financing costs incurred during the construction period." }, { "name": "fuel_cost_per_mwh", "type": "number", "description": "Fuel costs in USD$/MWh. NREL-derived values using heat rates.", "unit": "USD_per_MWh" }, { "name": "heat_rate_mmbtu_per_mwh", "type": "number", "description": "Fuel content per unit of electricity generated.", "unit": "MMBTU_MWh" }, { "name": "heat_rate_penalty", "type": "number", "description": "Heat rate penalty for retrofitting. This column only has contents to retrofit technologies. It seems to be a rate between 0.35 and 0.09", "unit": "MMBTU_MWh" }, { "name": "levelized_cost_of_energy_per_mwh", "type": "number", "description": "Levelized cost of energy (LCOE) is a summary metric that combines the primary technology cost and performance parameters: capital expenditures, operations expenditures, and capacity factor.", "unit": "USD_per_Mwh" }, { "name": "net_output_penalty", "type": "number", "description": "Penalty for retrofitting for net output. This column only has contents to retrofit technologies. It seems to be a rate between -0.25 and -0.08" }, { "name": "opex_fixed_per_kw", "type": "number", "description": "Fixed operation and maintenance expenses. Annual expenditures to operate and maintain equipment that are not incurred on a per-unit-energy basis.", "unit": "USD_per_kw" }, { "name": "opex_variable_per_mwh", "type": "number", "description": "Operation and maintenance costs incurred on a per-unit-energy basis.", "unit": "USD_per_MWh" } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2139622, "hash": "sha256:179480de84d6af54871608d549dae229f61278d743621ff208b3ec7986e8d5f8" }, { "name": "core_nrelatb__yearly_projected_financial_cases", "type": "table", "description": "Annual time series of financial assumptions for each model case (model_case_nrelatb), and sub-type of technology (technology_description).\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n NREL Annual Technology Baseline (ATB) for Electricity\n\nPrimary key:\n report_year, model_case_nrelatb, projection_year, technology_description", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "nrelatb", "title": "NREL Annual Technology Baseline (ATB) for Electricity", "path": "https://atb.nrel.gov/", "description": "The NREL Annual Technology Baseline (ATB) for Electricity publishes annual projections of operational and capital expenditures (by technology and vintage), as well as operating characteristics (by technology).", "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10839267", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.12658647", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/nrelatb.html" } ], "path": "core_nrelatb__yearly_projected_financial_cases.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "model_case_nrelatb", "type": "string", "description": "NREL's financial assumption cases. There are two cases which effect project financial assumptions: R&D Only Case and Market + Policies Case. R&D Only includes only projected R&D improvements while Market + Policy case includes policy and tax incentives. https://atb.nrel.gov/electricity/2024/financial_cases_&_methods", "constraints": { "required": true, "enum": [ "Market", "R&D" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value.", "constraints": { "required": true } }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity.", "constraints": { "required": true, "enum": [ "Coal_Retrofits", "DistributedWind", "OffShoreWind", "Utility-Scale PV-Plus-Battery", "Residential Battery Storage", "Coal_FE", "Pumped Storage Hydropower", "NaturalGas_FE", "Utility-Scale Battery Storage", "CSP", "Biopower", "CommPV", "LandbasedWind", "ResPV", "Geothermal", "UtilityPV", "Nuclear", "AEO", "NaturalGas_Retrofits", "Commercial Battery Storage", "Hydropower" ] } }, { "name": "inflation_rate", "type": "number", "description": "Rate of inflation. All dollar values are given in 2021 USD, using the Consumer Price Index for All Urban Consumers for dollar year conversions where the source year dollars do not match 2021." }, { "name": "interest_rate_during_construction_nominal", "type": "number", "description": "Also referred to as construction finance cost. Portion of all-in capital cost associated with construction period financing. It is a function of construction duration, capital fraction during construction, and interest during construction." }, { "name": "interest_rate_calculated_real", "type": "number", "description": "Calculated real interest rate." }, { "name": "interest_rate_nominal", "type": "number", "description": "Nominal interest rate." }, { "name": "rate_of_return_on_equity_calculated_real", "type": "number", "description": "Calculated real rate of return on equity." }, { "name": "rate_of_return_on_equity_nominal", "type": "number", "description": "Nomial rate of return on equity." }, { "name": "tax_rate_federal_state", "type": "number", "description": "Combined federal and state tax rate. The R&D model_case_nrelatb holds tax and inflation rates constant at assumed long-term values: 21 percent federal tax rate, 6 percent state tax rate (though actual state tax rates vary), and 2.5 percent inflation rate excludes effects of tax credits. The Market + Policy model_case_nrelatb applies federal tax credits and expires them as consistent with existing law and guidelines." } ], "primaryKey": [ "report_year", "model_case_nrelatb", "projection_year", "technology_description" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 17737, "hash": "sha256:b7a410bc8b9c95eb6d7f6c01845295a9b33ac3c18fad1a9b2dbbe5ffa25ad20f" }, { "name": "core_nrelatb__yearly_projected_financial_cases_by_scenario", "type": "table", "description": "Annual time series of additional financial assumptions for NREL ATB projections that also vary by technology innovation scenario (scenario_atb), tax credit case (model_tax_credit_case_nrelatb), and cost recovery period (cost_recovery_period_years).\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n NREL Annual Technology Baseline (ATB) for Electricity\n\nPrimary key:\n This table has no primary key. There are a small number of records which have nulls in the cost_recovery_period_years column. Based on NREL's documentation, this seems to indicate that those records apply to any relevant cost_recovery_period_years. If those records were non-null, the primary keys of this table would be: ['report_year', 'model_case_nrelatb', 'model_tax_credit_case_nrelatb', 'projection_year', 'technology_description', 'scenario_atb', 'cost_recovery_period_years']", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "nrelatb", "title": "NREL Annual Technology Baseline (ATB) for Electricity", "path": "https://atb.nrel.gov/", "description": "The NREL Annual Technology Baseline (ATB) for Electricity publishes annual projections of operational and capital expenditures (by technology and vintage), as well as operating characteristics (by technology).", "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10839267", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.12658647", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/nrelatb.html" } ], "path": "core_nrelatb__yearly_projected_financial_cases_by_scenario.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "model_case_nrelatb", "type": "string", "description": "NREL's financial assumption cases. There are two cases which effect project financial assumptions: R&D Only Case and Market + Policies Case. R&D Only includes only projected R&D improvements while Market + Policy case includes policy and tax incentives. https://atb.nrel.gov/electricity/2024/financial_cases_&_methods", "constraints": { "enum": [ "Market", "R&D" ] } }, { "name": "model_tax_credit_case_nrelatb", "type": "string", "description": "NREL's tax credit assumption cases. There are two types of tax credits: production tax credit (PTC) and investment tax credit (ITC). For more detail, see: https://atb.nrel.gov/electricity/2024/financial_cases_&_methods", "constraints": { "enum": [ "ITC", "PTC + ITC", "PTC" ] } }, { "name": "projection_year", "type": "integer", "description": "The year of the projected value." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity.", "constraints": { "enum": [ "Coal_Retrofits", "DistributedWind", "OffShoreWind", "Utility-Scale PV-Plus-Battery", "Residential Battery Storage", "Coal_FE", "Pumped Storage Hydropower", "NaturalGas_FE", "Utility-Scale Battery Storage", "CSP", "Biopower", "CommPV", "LandbasedWind", "ResPV", "Geothermal", "UtilityPV", "Nuclear", "AEO", "NaturalGas_Retrofits", "Commercial Battery Storage", "Hydropower" ] } }, { "name": "scenario_atb", "type": "string", "description": "Technology innovation scenarios. https://atb.nrel.gov/electricity/2023/definitions#scenarios", "constraints": { "enum": [ "Advanced", "Moderate", "Conservative" ] } }, { "name": "cost_recovery_period_years", "type": "integer", "description": "The period over which the initial capital investment to build a plant is recovered." }, { "name": "capital_recovery_factor", "type": "number", "description": "Ratio of a constant annuity to the present value of receiving that annuity for a given length of time." }, { "name": "debt_fraction", "type": "number", "description": "Fraction of capital financed with debt; Debt fraction is assumed financed with equity; also referred to as the leverage ratio." }, { "name": "fixed_charge_rate", "type": "number", "description": "Amount of revenue per dollar of investment required that must be collected annually from customers to pay the carrying charges on that investment." }, { "name": "wacc_nominal", "type": "number", "description": "Nominal weighted average cost of capital - average expected rate that is paid to finance assets." }, { "name": "wacc_real", "type": "number", "description": "Real weighted average cost of capital - average expected rate that is paid to finance assets." } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 82712, "hash": "sha256:2fc739d22c127e19740ab0ec16418be6e47b7be760a7293b129551288a2b72a3" }, { "name": "core_nrelatb__yearly_technology_status", "type": "table", "description": "Annual time series of technology statuses, indicating whether technologies in the ATB scenarios are mature, and whether they are the default technologies.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n NREL Annual Technology Baseline (ATB) for Electricity\n\nPrimary key:\n This table has no primary key.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "nrelatb", "title": "NREL Annual Technology Baseline (ATB) for Electricity", "path": "https://atb.nrel.gov/", "description": "The NREL Annual Technology Baseline (ATB) for Electricity publishes annual projections of operational and capital expenditures (by technology and vintage), as well as operating characteristics (by technology).", "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10839267", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.12658647", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/nrelatb.html" } ], "path": "core_nrelatb__yearly_technology_status.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity.", "constraints": { "enum": [ "Coal_Retrofits", "DistributedWind", "OffShoreWind", "Utility-Scale PV-Plus-Battery", "Residential Battery Storage", "Coal_FE", "Pumped Storage Hydropower", "NaturalGas_FE", "Utility-Scale Battery Storage", "CSP", "Biopower", "CommPV", "LandbasedWind", "ResPV", "Geothermal", "UtilityPV", "Nuclear", "AEO", "NaturalGas_Retrofits", "Commercial Battery Storage", "Hydropower" ] } }, { "name": "technology_description_detail_1", "type": "string", "description": "Technology details indicate resource levels and specific technology subcategories." }, { "name": "technology_description_detail_2", "type": "string", "description": "Technology details indicate resource levels and specific technology subcategories." }, { "name": "is_technology_mature", "type": "boolean", "description": "Indicator of whether the technology is mature. Technologies are definedas mature if a representative plant is operating or under constructionin the United States in the Base Year." }, { "name": "is_default", "type": "boolean", "description": "Indicator of whether the technology is default." } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual technology baseline", "capex", "distribution", "eia", "electric", "electricity", "energy", "energy information administration", "federal", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "nrel atb", "opex", "power", "technology", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 9877, "hash": "sha256:dda84c46b76b3772d68e6b0ce55c89ecc66c45a32ca6538a637b05f184cf47e1" }, { "name": "core_phmsagas__yearly_distribution_operators", "type": "table", "description": "Annual time series of distribution operator information.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report (Part A)\n\nPrimary key:\n report_id, report_date, operator_id_phmsa\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table contains operator-level information including office and headquarter location.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "phmsagas", "title": "Pipelines and Hazardous Materials Safety Administration (PHMSA) Annual Natural Gas Report", "path": "https://www.phmsa.dot.gov/data-and-statistics/pipeline/gas-distribution-gas-gathering-gas-transmission-hazardous-liquids", "email": "phmsa.pipelinesafety@dot.gov", "description": "Annual reports submitted to PHMSA from gas distribution, gas gathering, gas transmission, liquefied natural gas, and underground gas storage system operators. Annual reports include information such as total pipeline mileage, facilities, commodities transported, miles by material, and installation dates.", "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.7683351", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" } ], "doi": "https://doi.org/10.5281/zenodo.17076661", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/phmsagas.html" } ], "path": "core_phmsagas__yearly_distribution_operators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_id", "type": "integer", "description": "Report number of the PHMSA Gas utility submission.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "operator_id_phmsa", "type": "integer", "description": "PHMSA unique operator ID. A value of zero represents an unknown operator ID.", "constraints": { "required": true } }, { "name": "operator_name_phmsa", "type": "string", "description": "PHMSA operator name." }, { "name": "office_street_address", "type": "string", "description": "Street address of an operator's office." }, { "name": "office_city", "type": "string", "description": "City where an operator's office is located." }, { "name": "office_county", "type": "string", "description": "County where an operator's office is located." }, { "name": "office_zip", "type": "string", "description": "Zipcode where an operator's office is located.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "office_state", "type": "string", "description": "State where an operator's office is located." }, { "name": "headquarters_street_address", "type": "string", "description": "Street address for an operator's headquarters." }, { "name": "headquarters_city", "type": "string", "description": "City where an operator's headquarters are located." }, { "name": "headquarters_county", "type": "string", "description": "County where an operator's headquarters are located." }, { "name": "headquarters_state", "type": "string", "description": "State where an operator's headquarters are located." }, { "name": "headquarters_zip", "type": "string", "description": "Zipcode where an operator's headquarters are located.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "additional_information", "type": "string", "description": "Any additional information which will assist in clarifying or classifying the reported data." } ], "primaryKey": [ "report_id", "report_date", "operator_id_phmsa" ], "foreignKeys": [] }, "keywords": [ "department of transportation", "distribution", "federal", "gathering", "government", "liquified natural gas", "lng", "natural gas", "phmsa", "phmsagas", "pipelines", "pipelines and hazardous materials safety administration", "transmission", "underground natural gas storage", "united states", "us", "us dot", "usa" ], "contributors": [ { "title": "SwitchBox", "path": "https://www.switch.box/", "email": "hello@switch.box", "roles": [ "contributor" ], "zenodo_role": "project member", "organization": "SwitchBox", "name": "switchbox" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2764180, "hash": "sha256:83533ee34697746e6a8b8ab955f0dd4b22677b27ba03859a0d1ba3c213d783e3" }, { "name": "core_pudl__assn_eia_pudl_plants", "type": "table", "description": "Association table providing connections between EIA plant IDs and manually assigned PUDL plant IDs.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n plant_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_pudl__assn_eia_pudl_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." } ], "primaryKey": [ "plant_id_eia" ], "foreignKeys": [ { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 515865, "hash": "sha256:016de33208b22bfbd940d613b136fc8a4fbdd9ec91f4eb4ac37b527a88281ac4" }, { "name": "core_pudl__assn_eia_pudl_utilities", "type": "table", "description": "Association table providing connections between EIA utility IDs and manually assigned PUDL utility IDs.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_pudl__assn_eia_pudl_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." } ], "primaryKey": [ "utility_id_eia" ], "foreignKeys": [ { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 474817, "hash": "sha256:b94a6b53c7b913ca5584a8ddca167225cd60e587eedd8b396e8ce5758dc10bb6" }, { "name": "core_pudl__assn_ferc1_dbf_pudl_utilities", "type": "table", "description": "Association table providing connections between PUDL-assigned FERC1 utility IDs and the native FERC1 DBF utility IDs originally reported as ``respondent_id``.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_ferc1_dbf\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_pudl__assn_ferc1_dbf_pudl_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year.", "constraints": { "required": true } } ], "primaryKey": [ "utility_id_ferc1_dbf" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 8500, "hash": "sha256:41dd8c758bafa7bf17e78b01194bebda255b893a120f5f38b1ce4abf807dc14a" }, { "name": "core_pudl__assn_ferc1_pudl_plants", "type": "table", "description": "Association table providing connections between FERC 1 plants and their manually assigned PUDL plant IDs.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_ferc1, plant_name_ferc1\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nFERC does not assign IDs to plants, so each FERC 1 plant is identified by a ``utility_id_ferc1`` and a ``plant_name_ferc1``.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_pudl__assn_ferc1_pudl_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." } ], "primaryKey": [ "utility_id_ferc1", "plant_name_ferc1" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 134815, "hash": "sha256:5b40587511128bf659bc04ea29c6f430160ea3b0e194b85871847937faab0927" }, { "name": "core_pudl__assn_ferc1_pudl_utilities", "type": "table", "description": "Association table providing connections between PUDL utility IDs and PUDL-assigned FERC1 utility IDs.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_ferc1\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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 :ref:`core_pudl__assn_ferc1_dbf_pudl_utilities` and :ref:`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", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_pudl__assn_ferc1_pudl_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." } ], "primaryKey": [ "utility_id_ferc1" ], "foreignKeys": [ { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 17914, "hash": "sha256:bfaeb5166ed2eb4e76e61715870b5d698d6a701be3b43e81b39528da49430eb2" }, { "name": "core_pudl__assn_ferc1_xbrl_pudl_utilities", "type": "table", "description": "Association table providing connections between PUDL-assigned FERC1 utility IDs and the native FERC1 XBRL utility IDs originally reported as ``entity_id``.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_ferc1_xbrl\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "core_pudl__assn_ferc1_xbrl_pudl_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year.", "constraints": { "required": true } } ], "primaryKey": [ "utility_id_ferc1_xbrl" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7405, "hash": "sha256:ad8bccbbe3eb19220f56ee113745a36db48421946f02697823a7f3d620992076" }, { "name": "core_pudl__assn_ferc714_csv_pudl_respondents", "type": "table", "description": "Association table providing connections between PUDL-assigned FERC714 respondent IDs and native FERC714 CSV respondent IDs originally reported as ``respondent_id``.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n respondent_id_ferc714, respondent_id_ferc714_csv\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] }, { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "core_pudl__assn_ferc714_csv_pudl_respondents.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714_csv", "type": "integer", "description": "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.", "constraints": { "required": true } } ], "primaryKey": [ "respondent_id_ferc714", "respondent_id_ferc714_csv" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "open data", "open source", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6947, "hash": "sha256:37f6f7046982c62e6c47ca09ca61d2593a1ca72c670204cf56a379c7aae9b639" }, { "name": "core_pudl__assn_ferc714_pudl_respondents", "type": "table", "description": "Entity table containing static information about PUDL-derived FERC 714 respondent IDs.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n respondent_id_ferc714\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThese IDs are used to connect older CSV data which uses different respondent IDs than the newer XBRL entity IDs. These IDs are manually assigned when new FERC 714 data is integrated, and any newly found utilities are added to the list with a new ID. This table is read in from a CSV stored in the PUDL repository: src/pudl/package_data/glue/respondent_id_ferc714.xlsx", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] }, { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "core_pudl__assn_ferc714_pudl_respondents.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } } ], "primaryKey": [ "respondent_id_ferc714" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "open data", "open source", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5409, "hash": "sha256:f44142643b433e2c07322bfaf231a8314089dbefab644c80cd85935c55f0bc24" }, { "name": "core_pudl__assn_ferc714_xbrl_pudl_respondents", "type": "table", "description": "Association table providing connections between PUDL-assigned FERC714 respondent IDs and native FERC714 XBRL respondent IDs originally reported as ``entity_id``.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n respondent_id_ferc714, respondent_id_ferc714_xbrl\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] }, { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "core_pudl__assn_ferc714_xbrl_pudl_respondents.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714_xbrl", "type": "string", "description": "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.", "constraints": { "required": true } } ], "primaryKey": [ "respondent_id_ferc714", "respondent_id_ferc714_xbrl" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "open data", "open source", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6158, "hash": "sha256:dd9437a416b4fc8f41d5f7bcfe98f2855752ecd2908adb7f951c86def57bac09" }, { "name": "core_pudl__assn_utilities_plants", "type": "table", "title": "PUDL Utility-Plant Associations", "description": "Association table providing connections between PUDL utility IDs and PUDL plant IDs.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_pudl, plant_id_pudl\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] } ], "path": "core_pudl__assn_utilities_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time.", "constraints": { "required": true } } ], "primaryKey": [ "utility_id_pudl", "plant_id_pudl" ], "foreignKeys": [ { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "electricity", "open data", "open source", "us" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 170865, "hash": "sha256:9fd7e9065e73390001372d70f31fbc1fe26ee897d651fd2828af6a7062d2b54d" }, { "name": "core_pudl__codes_data_maturities", "type": "table", "description": "Code table containing descriptions of categorical codes for maturity levels of data records. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "core_pudl__codes_data_maturities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5199, "hash": "sha256:fdfc42822ea0fd8d6dea98e911cb573e95ed74440afd8a516899dfea2a8bf23b" }, { "name": "core_pudl__codes_datasources", "type": "table", "title": "PUDL Data Sources", "description": "Code table containing descriptions of categorical codes for the data sources that PUDL integrates.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n datasource", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] } ], "path": "core_pudl__codes_datasources.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datasource", "type": "string", "description": "Code identifying a dataset available within PUDL.", "constraints": { "required": true, "enum": [ "censusdp1tract", "censuspep", "eia176", "eia191", "eia757a", "eia860", "eia860m", "eia861", "eia923", "eia930", "eiaaeo", "eiaapi", "eiawater", "epacems", "epacamd_eia", "ferc1", "ferc2", "ferc6", "ferc60", "ferc714", "ferccid", "ferceqr", "gridpathratoolkit", "mshamines", "nrelatb", "phmsagas", "pudl", "sec10k", "rus7", "rus12", "vcerare" ] } }, { "name": "partitions", "type": "string", "description": "The data partitions used to generate this instance of the database." }, { "name": "doi", "type": "string", "description": "Unique digital object identifier of Zenodo archive." }, { "name": "pudl_version", "type": "string", "description": "The version of PUDL used to generate this database." } ], "primaryKey": [ "datasource" ], "foreignKeys": [] }, "keywords": [ "electricity", "open data", "open source", "us" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 13840, "hash": "sha256:bcd84df680343c6bb90910fdcdf90449c3e753e87c87f51cd0f1671badabede7" }, { "name": "core_pudl__codes_imputation_reasons", "type": "table", "title": "Imputation Reason Codes", "description": "Code table containing descriptions of categorical codes for the reasons a value might be flagged for imputation.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n code\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAny time a column is imputed, there should be a corresponding column which contains codes for every value in the column that was imputed.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] } ], "path": "core_pudl__codes_imputation_reasons.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "keywords": [ "electricity", "open data", "open source", "us" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4324, "hash": "sha256:008317f9a7e69bd5c260c936e0076162909a505cffa3354ef2e92a3230a6fab0" }, { "name": "core_pudl__codes_subdivisions", "type": "table", "title": "Political Subdivisions", "description": "Code table containing descriptions of categorical codes for states, provinces, and other sub-national political subdivisions.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n country_code, subdivision_code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] } ], "path": "core_pudl__codes_subdivisions.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "country_code", "type": "string", "description": "Three letter ISO-3166 country code (e.g. USA or CAN).", "constraints": { "required": true, "enum": [ "USA", "CAN" ] } }, { "name": "country_name", "type": "string", "description": "Full country name (e.g. United States of America)." }, { "name": "subdivision_code", "type": "string", "description": "Two-letter ISO-3166 political subdivision code (e.g. US state or Canadian province abbreviations like CA or AB).", "constraints": { "required": true, "enum": [ "NS", "SC", "VI", "WA", "IA", "ND", "HI", "DE", "SD", "ON", "GU", "AS", "MT", "CO", "NB", "VA", "NC", "AL", "AR", "BC", "MB", "NH", "VT", "NJ", "OR", "LA", "NY", "IL", "RI", "FL", "ME", "NU", "WY", "MI", "AB", "MO", "NV", "PR", "MN", "NL", "PA", "GA", "DC", "TN", "WI", "OH", "WV", "MA", "TX", "SK", "AK", "AZ", "QC", "UT", "YT", "CA", "KS", "MD", "CT", "NM", "MS", "MP", "PE", "OK", "IN", "NE", "NT", "KY", "ID" ] } }, { "name": "subdivision_name", "type": "string", "description": "Full name of political subdivision (e.g. US state or Canadian province names like California or Alberta." }, { "name": "subdivision_type", "type": "string", "description": "ISO-3166 political subdivision type. E.g. state, province, outlying_area." }, { "name": "timezone_approx", "type": "string", "description": "IANA timezone name of the timezone which encompasses the largest portion of the population in the associated geographic area.", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } }, { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "pattern": "^\\d{2}$" } }, { "name": "division_name_us_census", "type": "string", "description": "Longer human readable name describing the US Census division." }, { "name": "division_code_us_census", "type": "string", "description": "Three-letter US Census division code as it appears in the bulk electricity data published by the EIA. Note that EIA splits the Pacific division into distinct contiguous (CA, OR, WA) and non-contiguous (AK, HI) states. For reference see this US Census region and division map: https://www2.census.gov/geo/pdfs/maps-data/maps/reference/us_regdiv.pdf", "constraints": { "enum": [ "PCN", "WSC", "ESC", "NEW", "WNC", "MTN", "SAT", "ENC", "PCC", "MAT" ] } }, { "name": "region_name_us_census", "type": "string", "description": "Human-readable name of a US Census region." }, { "name": "is_epacems_state", "type": "boolean", "description": "Indicates whether the associated state reports data within the EPA's Continuous Emissions Monitoring System." } ], "primaryKey": [ "country_code", "subdivision_code" ], "foreignKeys": [] }, "keywords": [ "electricity", "open data", "open source", "us" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 19112, "hash": "sha256:00418fca27b4c2b138588850ee6dbf00a3501f8c24e8a2954107c0cf5bf70559" }, { "name": "core_pudl__entity_plants_pudl", "type": "table", "title": "PUDL Plants", "description": "Entity table containing static information about PUDL-assigned plant IDs.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n plant_id_pudl\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThese IDs are manually generated each year when new FERC and EIA reporting is integrated, and any newly identified plants are added to the list with a new ID. Each ID maps to a power plant which is reported in at least one FERC or EIA data set. This table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] } ], "path": "core_pudl__entity_plants_pudl.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time.", "constraints": { "required": true } }, { "name": "plant_name_pudl", "type": "string", "description": "Plant name, chosen arbitrarily from the several possible plant names available in the plant matching process. Included for human readability only." } ], "primaryKey": [ "plant_id_pudl" ], "foreignKeys": [] }, "keywords": [ "electricity", "open data", "open source", "us" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 435851, "hash": "sha256:a5ae67712dde11fdeeff64301e972865cb5267043aa537ce1ae5342af9817d0e" }, { "name": "core_pudl__entity_utilities_pudl", "type": "table", "title": "PUDL Utilities", "description": "Entity table containing static information about PUDL-assigned utility IDs.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n utility_id_pudl\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThese IDs are manually generated each year when new FERC and EIA reporting is integrated, and any newly found utilities are added to the list with a new ID. Each ID maps to a power plant owning or operating entity which is reported in at least one FERC or EIA data set. This table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "pudl", "title": "The Public Utility Data Liberation (PUDL) Project", "path": "https://catalyst.coop/pudl", "email": "pudl@catalyst.coop", "description": "PUDL is a data processing pipeline created by Catalyst Cooperative that cleans, integrates, and standardizes some of the most widely used public energy datasets in the US. The data serve researchers, activists, journalists, and policy makers that might not have the technical expertise to access it in its raw form, the time to clean and prepare the data for bulk analysis, or the means to purchase it from existing commercial providers.", "keywords": [ "us", "electricity", "open data", "open source" ], "concept_doi": "https://doi.org/10.5281/zenodo.3404014", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ] } ], "path": "core_pudl__entity_utilities_pudl.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time.", "constraints": { "required": true } }, { "name": "utility_name_pudl", "type": "string", "description": "Utility name, chosen arbitrarily from the several possible utility names available in the utility matching process. Included for human readability only." } ], "primaryKey": [ "utility_id_pudl" ], "foreignKeys": [] }, "keywords": [ "electricity", "open data", "open source", "us" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 378258, "hash": "sha256:9d316859a914613d923103a83b944c4322d58e78844e5b02133c49814cab547f" }, { "name": "core_rus12__entity_borrowers", "type": "table", "description": "Entity table containing static information about active RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply\n\nPrimary key:\n borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table contains canonical values for borrowers are set. It contains values which are expected to remain fixed over time.RUS reports many attributes in many different tables\nacross throughout RUS-7 and RUS-12. In order to compile tidy, well-normalized database\ntables, PUDL collects all instances of these values and and chooses a canonical value.\nBy default, PUDL chooses the most consistently reported value of a given attribute as\nlong as it is at least 70% of the given instances reported. For the ``borrower_name_rus``\nPUDL chooses the most consistently reported value regardless of if it meets this 70%\nthreshold so that all borrowers will have a name. We chose this because most name\nchanges were insignificant (eg. \"and\" changed to \"&\" or \"coop\" changed to \"cooperative\").\nAll tables downstream of this one inherit the canonical values established\nhere..\n\nThis table contains all of the Active Distribution Borrowers as of each report year who were eligible to report to RUS Form 12. If these Borrowers have reported to RUS they will have records in the enclosed data tables, however a small number of these Borrowers did not report for various reasons and these Borrowers will not be represented in any of the other tables.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__entity_borrowers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } } ], "primaryKey": [ "borrower_id_rus" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 10630, "hash": "sha256:ef33e80cd92265adcfedf494c77f20ed6f14ea3c2c8ffdc12965225e0b75d163" }, { "name": "core_rus12__monthly_demand_and_energy_at_delivery_points", "type": "table", "description": "Monthly time series of demand and energy delivered to distribution utilities.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section E)\n\nPrimary key:\n report_date, borrower_id_rus, delivery_recipient", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__monthly_demand_and_energy_at_delivery_points.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "delivery_recipient", "type": "string", "description": "The recipient of the delivered energy or demand.", "constraints": { "required": true } }, { "name": "delivered_demand_mw", "type": "number", "description": "The amount of demand delivered in MW.", "unit": "MW" }, { "name": "delivered_energy_mwh", "type": "number", "description": "The amount of energy delivered in MWh.", "unit": "MWh" } ], "primaryKey": [ "report_date", "borrower_id_rus", "delivery_recipient" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 176132, "hash": "sha256:76e1dbdade39c16cd18e613cdf1ee4c0252b634cceb2060df2c8fe6be0c95a21" }, { "name": "core_rus12__monthly_demand_and_energy_at_power_sources", "type": "table", "description": "Monthly time series of demand and energy at point of generation.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section D)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThere are some peak demand dates that have an hour component and others that don't. This is because there is inconsistent reporting of peak_demand_hour in the raw data. If there is no hour reported, we record the hour as 0 and only the date will show in the data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__monthly_demand_and_energy_at_power_sources.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "energy_output_mwh", "type": "number", "description": "The amount of energy output in MWh.", "unit": "MWh" }, { "name": "peak_demand_mw", "type": "number", "description": "peak demand in a given timeframe.", "unit": "MW" }, { "name": "peak_demand_date", "type": "datetime", "description": "The date of the peak demand." }, { "name": "is_peak_coincident", "type": "boolean", "description": "Whether or not the peak_mw is coincident or non-coincident peak." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 111681, "hash": "sha256:3def13caec14db941955e9fd6e4d79f1f52d2dc5c288ea078a1123f0906c5a65" }, { "name": "core_rus12__yearly_balance_sheet_assets", "type": "table", "description": "Annual time series of assets and other debts from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part A - Section B)\n\nPrimary key:\n report_date, borrower_id_rus, asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_balance_sheet_assets.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "asset_type", "type": "string", "description": "Type of asset being reported to the core_rus12__yearly_balance_sheet_assets table.", "constraints": { "required": true, "enum": [ "utility_plant_in_service", "construction_work_in_progress", "total_utility_plant", "depreciation_and_amortization", "net_utility_plant", "non_utility_property_asset", "investments_subsidiary_companies", "investments_associated_orgs_patronage_capital", "investments_associated_orgs_other_general_funds", "investments_associated_orgs_other_non_general_funds", "investments_economic_development", "investments_other", "special_funds", "total_other_property_and_investments", "cash_general_funds", "cash_construction_funds_trustee", "special_deposits", "investments_temporary", "notes_receivable", "accounts_receivable_sales_of_energy", "accounts_receivable_other", "fuel_stock", "renewable_energy_credits", "materials_and_supplies", "prepayments", "other_current_and_accrued", "total_current_and_accrued", "unamortized_debt_discount_property_losses", "regulatory", "other_deferred_debits", "accumulated_deferred_income_taxes_debits", "total" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "asset_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 110528, "hash": "sha256:1bf5ce2e1d1e79d0360eab4e751142bce1e12578150748e8a53485d4ff617b4c" }, { "name": "core_rus12__yearly_balance_sheet_liabilities", "type": "table", "description": "Annual time series of liabilities and other credits from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part A - Section B)\n\nPrimary key:\n report_date, borrower_id_rus, liability_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_balance_sheet_liabilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "liability_type", "type": "string", "description": "Type of liability being reported to the core_rus12__yearly_balance_sheet_liabilities table.", "constraints": { "required": true, "enum": [ "memberships", "assigned_and_assignable_patronage_capital", "retired_this_year_patronage_capital", "retired_prior_years_patronage_capital", "patronage_capital", "operating_margins_prior_years", "operating_margins_current_year", "non_operating_margins", "other_margins_and_equities", "total_margins_and_equities", "long_term_debt_rus", "payments_unapplied", "long_term_debt_rus_economic_development", "long_term_debt_ffb_rus_guaranteed", "long_term_debt_other_rus_guaranteed", "long_term_debt_other", "total_long_term_debt", "noncurrent_obligations_under_capital_leases", "accumulated_operating_provisions", "total_other_noncurrent_liabilities", "notes_payable", "accounts_payable", "current_maturities_long_term_debt", "rural_development", "current_maturities_capital_leases", "taxes_accrued", "interest_accrued", "other_current_and_accrued", "total_current_and_accrued", "deferred_credits", "accumulated_deferred_income_taxes_credits", "total_liabilities_and_other_credits" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "liability_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 106696, "hash": "sha256:573432b938c64b4e864d4d887171ad627d09e9bf8ceabb5b34b4f97853607f1a" }, { "name": "core_rus12__yearly_depreciation_changes", "type": "table", "description": "Annual time series of changes in accumulated depreciation.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section B)\n\nPrimary key:\n report_date, borrower_id_rus, depreciation_and_amortization_group, depreciation_and_amortization_item", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_depreciation_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "depreciation_and_amortization_group", "type": "string", "description": "High-level category of depreciation and amortization items.", "constraints": { "required": true, "enum": [ "electric_plant_in_service", "provision_for_depreciation_and_amortization" ] } }, { "name": "depreciation_and_amortization_item", "type": "string", "description": "Category of depreciation and amortization items.", "constraints": { "required": true, "enum": [ "depreciation_distribution_plant", "depreciation_general_plant", "depreciation_hydraulic_production_plant", "depreciation_nuclear_production_plant", "depreciation_other_production_plant", "depreciation_steam_production_plant", "depreciation_transmission_plant", "retirement_work_in_progress", "total_depreciation", "amortization_acquisition_adj", "amortization_electric_plant_in_service", "amortization_leased_plant", "amortization_nuclear_fuel", "amortization_plant_held_for_future_use", "depreciation_and_amortization_other_plant", "depreciation_plant_held_for_future_use", "depreciation_plant_leased_to_others", "total" ] } }, { "name": "composite_depreciation_rate", "type": "number", "description": "The composite depreciation rate within a given category. This is typically expressed as a number between 0 and 100." }, { "name": "accruals", "type": "number", "description": "Value of additions into an asset class a.k.a accruals.", "unit": "USD" }, { "name": "retirements_less_net_salvage", "type": "number", "description": "Cost of retirements minus any net salvage value.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "depreciation_and_amortization_group", "depreciation_and_amortization_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 100587, "hash": "sha256:bc11ebf114794ffdcf1676169a57431be0b7153c071dca2c86b31c2887fa5acd" }, { "name": "core_rus12__yearly_depreciation_misc", "type": "table", "description": "Annual time series of accumulated depreciation.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - 2nd part of Section B)\n\nPrimary key:\n report_date, borrower_id_rus, depreciation_and_amortization_item\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is the second half of the depreciation table. It includes ending balances of six depreciation and amortization values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_depreciation_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "depreciation_and_amortization_item", "type": "string", "description": "Category of depreciation and amortization items.", "constraints": { "required": true, "enum": [ "annual_accrual_charged_to_expense", "annual_accrual_charged_to_other_accounts", "book_cost_property_retired", "removal_cost_property_retired", "salvage_material_from_property_retired", "renewal_and_replacement_cost" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "depreciation_and_amortization_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 22623, "hash": "sha256:a45545f78488503e692c56df9955fd87365e77824854f05d0fde24653793cffe" }, { "name": "core_rus12__yearly_external_financial_risk_ratio", "type": "table", "description": "Annual time series of ratio of investments and loan guarantee balances to total utility plant assets.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section F - Subsection III)\n\nPrimary key:\n report_date, borrower_id_rus", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_external_financial_risk_ratio.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "external_financial_risk_ratio", "type": "number", "description": "total investments + loan guarantee balances / total utility plant assets. This ratio shows how much a utility is financially exposed to outside entities relative to its own assets." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 8223, "hash": "sha256:9e0e117d38087c5237ef34471661f09c23803a4a6b4eca3221fc67495bd1214a" }, { "name": "core_rus12__yearly_investments", "type": "table", "description": "Annual time series of investments, loan guarantees and loans.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section F, Sub-section I)\n\nPrimary key:\n This table has no primary key. This is a list of all investments or loans in each year and borrowers can have multiple records with the same ``investment_description``.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReporting of investments is required by 7 CFR 1717, Subpart N. Investment categories reported on this Part correspond to Balance Sheet items in Part A Section B in table :ref:`core_rus12__yearly_balance_sheet_assets`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_investments.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "investment_description", "type": "string", "description": "Description of investment. This is a free-form text field and thus contains a wide variety of values." }, { "name": "investment_type_code", "type": "integer", "description": "Investment type code.", "constraints": { "minimum": 1, "maximum": 11 } }, { "name": "included_investments", "type": "number", "description": "Included investment." }, { "name": "excluded_investments", "type": "number", "description": "Excluded investment." }, { "name": "income_or_loss", "type": "number", "description": "Income or loss from investment." }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "investment_type_code" ], "reference": { "resource": "core_rus__codes_investment_types", "fields": [ "code" ] } }, { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 257973, "hash": "sha256:baa4700134cf2eebb79b50ef09304165de46ecc94357bdc3bfd1ca6a9800d8b4" }, { "name": "core_rus12__yearly_lines_stations_labor_materials_cost", "type": "table", "description": "Annual time series of labor and material cost for lines and stations operated by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part I - Section C)\n\nPrimary key:\n report_date, borrower_id_rus, labor_or_material, operation_or_maintenance, lines_or_stations", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_lines_stations_labor_materials_cost.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "labor_or_material", "type": "string", "description": "Indicates whether the cost reported is for labor or material.", "constraints": { "required": true, "enum": [ "labor", "material" ] } }, { "name": "operation_or_maintenance", "type": "string", "description": "Indicates whether the expenditure is for operation or maintenance.", "constraints": { "required": true, "enum": [ "operation", "maintenance" ] } }, { "name": "lines_or_stations", "type": "string", "description": "Indicates whether the cost reported pertains to lines or stations.", "constraints": { "required": true, "enum": [ "lines", "stations" ] } }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "labor_or_material", "operation_or_maintenance", "lines_or_stations" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 28083, "hash": "sha256:5663af43f91f22393802a8b917bf1b64eb2eba52ea1082be03b2ef711afdc105" }, { "name": "core_rus12__yearly_loans", "type": "table", "description": "Annual time series of loans provided by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section F - Subsections II & IV)\n\nPrimary key:\n This table has no primary key. This table has no primary key because some borrowers report multiple loan values from the same entity in a given year.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table also includes loan guarantees where the RUS borrower backs a loan from another entity and is therefore liable to pay any remaining balance should the original borrower default.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_loans.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "loan_recipient", "type": "string", "description": "The organization that received a loan." }, { "name": "loan_maturity_date", "type": "date", "description": "The date on which a loan is scheduled to be fully paid." }, { "name": "loan_original_amount", "type": "number", "description": "The original amount of a loan.", "unit": "USD" }, { "name": "loan_balance", "type": "number", "description": "The amount of money still owned on a loan at the end of the reporting year." }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." }, { "name": "is_loan_guarantee", "type": "boolean", "description": "Indicates a third-party loan that the reporting utility (referred as a borrower) has co-signed, taking on responsibility for repayment if the primary borrower defaults." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 20140, "hash": "sha256:cea2855eb7fd41789d01243e52108f598ab7a0d097d9306567ef534881ddca2c" }, { "name": "core_rus12__yearly_long_term_debt", "type": "table", "description": "Annual time series of long-term debt and debt service requirements for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section H)\n\nPrimary key:\n This table has no primary key. This table has no primary key because some borrowers report multiple debt values from the same entity in a given year.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_long_term_debt.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "debt_description", "type": "string", "description": "Description of debt or loan. On the original form, there are nine provided descriptions and a section to add other free-form descriptions." }, { "name": "debt_ending_balance", "type": "number", "description": "The amount of principal still owned on the debt at the end of the report year.", "unit": "USD" }, { "name": "debt_interest", "type": "number", "description": "The interest expense on the debt for the report year.", "unit": "USD" }, { "name": "debt_principal", "type": "number", "description": "The principal paid on the debt during the report year.", "unit": "USD" }, { "name": "debt_total", "type": "number", "description": "The total amount of debt.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 99741, "hash": "sha256:17a8fbf18b9ced1c89698f5b6a776e838e5137320b6bc823f2b1782ef6a88d6e" }, { "name": "core_rus12__yearly_meeting_and_board", "type": "table", "description": "Annual time series of annual meeting and board information for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section I)\n\nPrimary key:\n report_date, borrower_id_rus", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_meeting_and_board.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "last_annual_meeting_date", "type": "datetime", "description": "The date of the last annual meeting." }, { "name": "members_num", "type": "integer", "description": "The total number of members." }, { "name": "members_present_at_meeting_num", "type": "integer", "description": "The number of members present at the last annual meeting." }, { "name": "was_quorum_present", "type": "boolean", "description": "Whether or not quorum was met." }, { "name": "members_voting_by_proxy_or_mail_num", "type": "integer", "description": "The number of members voting by mail or by proxy." }, { "name": "board_members_num", "type": "integer", "description": "The total number of board members." }, { "name": "fees_and_expenses_for_board_members", "type": "integer", "description": "The total amount of fees and expenses for board members.", "unit": "USD" }, { "name": "does_manager_have_written_contract", "type": "boolean", "description": "Whether or not the RUS borrower's manager has a written contract." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 21279, "hash": "sha256:fd923bc053482e8f604ba12e271eb5070ee303c90417aac8637e59bd84b4d9dd" }, { "name": "core_rus12__yearly_non_utility_plant_changes", "type": "table", "description": "Annual time series of changes in non-utility plant.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section C)\n\nPrimary key:\n report_date, borrower_id_rus, non_utility_plant_item", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_non_utility_plant_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "non_utility_plant_item", "type": "string", "description": "Category describing non-utility plant asset items.", "constraints": { "required": true, "enum": [ "property", "provision_for_depreciation_and_amortization" ] } }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "non_utility_plant_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 10922, "hash": "sha256:0c3acbaa80746faba9476d0d971be88dc85dab5bbd60be93c64f19f1ec5e0bea" }, { "name": "core_rus12__yearly_plant_costs", "type": "table", "description": "Annual time series of costs of net energy generated by plant.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part F - Section D)\n\nPrimary key:\n This table has no primary key. This table has no primary key because there is one plant (Walter Scott) that has duplicate records every year. Based on other RUS-12 tables, it is likely that these duplicate records are the borrowers' ownership portion of the plant as well as the total plant but there is no clear indication in this table.\n\nThe primary key of this table otherwise would be: ['report_date', 'borrower_id_rus', 'plant_name_rus', 'cost_group', 'cost_type'].\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe cost column in this table is expected to be largely non-null, the cost_per_mwh and cost_per_mmbtu columns only apply to some cost_type's and even plant_type's and thus are expected to contain many nulls.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_plant_costs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "cost_group", "type": "string", "description": "High-level category of cost type.", "constraints": { "enum": [ "opex", "total", "capex" ] } }, { "name": "cost_type", "type": "string", "description": "Detailed category of cost type.", "constraints": { "enum": [ "allowances", "coal_fuel", "coolants_and_water", "depreciation", "electric", "energy_for_compressed_air", "energy_for_pumped_storage", "fuel", "gas_fuel", "generation", "hydraulic", "interest", "less_fuel_acquisition_adjustment", "maintenance_boiler_plant", "maintenance_electric_plant", "maintenance_generating_and_electric_plant", "maintenance_miscellaneous_plant", "maintenance_other_plant", "maintenance_reactor_plant_equipment", "maintenance_reservoirs_dams_waterways", "maintenance_structures", "maintenance_supervision_and_engineering", "maintenance_total", "miscellaneous_power_generation", "net_fuel", "non_fuels_subtotal", "oil_fuel", "operations_total", "other_fuel", "other_generation", "other_nuclear_power", "plant_acquisition_adjustment", "power", "reactor_credits", "rents", "steam", "steam_other_sources", "steam_power", "supervision_and_engineering", "total", "total_fixed", "total_fuel", "water_for_power" ] } }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" }, { "name": "cost_per_mwh", "type": "number", "description": "Unit cost of energy production in cost per MWh", "unit": "USD_per_MWh" }, { "name": "cost_per_mmbtu", "type": "number", "description": "Unit cost of energy production in cost per MMBTU", "unit": "USD_per_MMBTU" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 386676, "hash": "sha256:db3a629ede412a8afaf0c7c61a7cf4f6ec67709b6126632666e15ad7ddb4f9aa" }, { "name": "core_rus12__yearly_plant_factors_and_maximum_demand", "type": "table", "description": "Annual time series of plant factors and maximum demand for plants owned by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Parts D, E, F IC, F CC, G - Section C)\n\nPrimary key:\n This table has no primary key. The primary key for this table would be report_date, borrower_id_rus, plant_name_rus, and plant_type but the plant_type column is not reported before 2009 causing lots of duplicate records. Because none of the other fields are static year-over-year, there is no reliable way to backfill the plant_type column in instances where there are different plant_types reported for the same plant in later years.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe plant_type field was only included in the data starting in 2009. We backfill records with only one reported plant_type per borrower/plant name/year. Records with multiple plant_types per borrower/plant name/year are left with null plant_type because there is no reliable way to determine which plant_type is associated with which record back in time. Plants who's names are reported differently pre and post 2009 will also miss being backfilled.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_plant_factors_and_maximum_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_factor_running", "type": "number", "description": "Fraction of potential generation over the time period a plant was in operation. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "load_factor", "type": "number", "description": "Fraction of consumption vs demand reported for a plant over a given timeframe. Energy consumed over time period / peak demand * time period (hours/years/etc.)." }, { "name": "peak_gross_demand_mw", "type": "number", "description": "The highest average power output recorded over any single 15 minute interval during the reporting period.", "unit": "MW" }, { "name": "peak_gross_demand_nameplate_mw", "type": "number", "description": "The theoretical or nameplate peak the plant could produce under the best operating conditions during the reporting period.", "unit": "MW" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 61867, "hash": "sha256:ec9fed3e13de0342d813811a8466e519c760a0a9441a485f0d8170ba5fff49a8" }, { "name": "core_rus12__yearly_plant_labor", "type": "table", "description": "Annual time series of labor and payroll information for plants owned by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Parts D, E, F, G - Section B)\n\nPrimary key:\n This table has no primary key. The primary key should be report_date, borrower_id_rus, plant_name_rus, and plant_type, but this table did not report plant_type before 2009 and there are respondents who report multiple rows per plant pre-2009. The data cannot be backfilled because there is no way to distinguish between duplicate rows pre-2009.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nNote the lack of plant_type pre-2009 leading to a lack of reliable primary keys.\n\nPlant-level data from :ref:`core_rus12__yearly_plant_operations_by_plant` can be matched to data from this table, but you must also join this data usingthe ``borrower_id_rus`` column as well as the ``report_date`` and ``plant_name``. This is because the :ref:`core_rus12__yearly_plant_operations_by_plant` table includes records from each plant owner. The RUS instructions note that:\n\nyou should use caution when using total plant data since there are cases where more than one Borrower shares units at the same plant which means that you will be getting duplicate plant total records (and there is no guarantee that the total plant records entered by two borrowers for the same plant will be identical).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_plant_labor.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "employees_full_time_num", "type": "integer", "description": "Number of employees hired full-time for normal operations of the system." }, { "name": "employees_part_time_num", "type": "integer", "description": "Number employees regularly employed on a part-time basis. Exclude employees hired for short periods of time to complete special jobs." }, { "name": "employee_hours_worked_total", "type": "number", "description": "Total number of hours worked by employees." }, { "name": "payroll_maintenance", "type": "number", "description": "The amount of payroll spent on plant maintenance.", "unit": "USD" }, { "name": "payroll_operations", "type": "number", "description": "The amount of payroll spent on plant operations.", "unit": "USD" }, { "name": "payroll_other_accounts", "type": "number", "description": "The amount of plant payroll spent on accounts other than maintenance and operations.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 63272, "hash": "sha256:8412e5eb5fb40887798f65500e63692d826b58ab2dd7e1500c79959545f081b2" }, { "name": "core_rus12__yearly_plant_operations_by_borrower", "type": "table", "description": "Annual time series of borrower portion of plant operational data including fuel consumption and operational hours.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part D, E, F (CC), F (IC) & G - Section A)\n\nPrimary key:\n This table has no primary key. This table has no primary key because there are a handful of plants that have duplicate records. The primary key of this table otherwise would be: [`report_date`, `borrower_id_rus`, `plant_name_rus`, `plant_name_rus`, `unit_id_rus`, `plant_type`, `is_full_ownership_portion`, `is_partly_owned_by_borrower`].\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe data in this table comes from five different portions of RUS 12 corresponding to different plant types (steam, hydroelectric, combined_cycle, internal_combustion and nuclear).\nThe original form includes plant operations data for each plant type reported in multiple ways: with records corresponding to the portion of plants that borrowers own as well as the whole plant. We split these records into two tables, :ref:`core_rus12__yearly_plant_operations_by_borrower`, which contains records reported at the borrower level, and :ref:`core_rus12__yearly_plant_operations_by_plant`, which contains records reported at the plant level.Records that are wholly owned by one borrower show up in both :ref:`core_rus12__yearly_plant_operations_by_borrower` and :ref:`core_rus12__yearly_plant_operations_by_plant`.\n\nThere are two boolean columns used to delineate which records are associated with the borrowers' share vs the whole plant - which is documented in ``_OR_PowerSupply Plant File Documentation.rtf`` in the newer years in the RUS 12 archive. One of these two fields - ``is_partly_owned_by_borrower`` - was not reported before 2009. For the pre-2009 years, we assume that all records that report TRUE for is_full_ownership_portion should end up in the by-plant table while all records should end up in the by-borrower portion of the table.Like the post-2009 records, this involves records from the original tables ending up in both of these PUDL tables.\n\nAlso there are two cleaning steps that we performed that alter the original data slightly:\n\n* **One dropped with unexpected ownership label and duplicate data**: There is a Wisdom steam plant record that is labeled to be both fully owned by borrower and partly owned for one year, which is an unexpected combo based on the `_OR_PowerSupply Plant File Documentation.rst` documentation file in the rus12 archive. Luckily this plant has exactly the same records as the other Wisdom steam plant that year with more expected ownership labels.* **Replaced two string values for unit_id_rus**: There are two instances from 2018 of unit_id_rus's that have string values in them - ``WSL GT 12`` and ``WSL ST 10``. Based on pre-cleaned data, we were able to clearly identify that we can use just the numeric values in these bad strings - 12 and 10 respectively. This enables us to have an integer type for this unit_id_rus column.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_plant_operations_by_borrower.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "unit_id_rus", "type": "integer", "description": "RUS-assigned unit identification code." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "ownership_pct", "type": "number", "description": "Percentage of the plant owned by the respondent." }, { "name": "is_full_ownership_portion", "type": "boolean", "description": "Whether or not the plant record represents the full plant - regardless of whether its fully owned by the borrower." }, { "name": "is_partly_owned_by_borrower", "type": "boolean", "description": "Whether or not the plant record is partially owned by the borrower. This column was not reported before 2009." }, { "name": "fuel_consumption_coal_lbs", "type": "number", "description": "Annual pounds of coal consumed for fuel.This field is only reported for plant_type steam.", "unit": "lb" }, { "name": "fuel_consumption_gas_cubic_feet", "type": "number", "description": "Annual cubic feet of natural gas consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "cf" }, { "name": "fuel_consumption_oil_gallons", "type": "number", "description": "Annual gallons of oil consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "gal" }, { "name": "fuel_consumption_other", "type": "number", "description": "Annual other fuel consumed. Neither units nor type of fuel are documented.This field is only reported for plant_type's combined_cycle, combined_cycle and steam." }, { "name": "operating_hours_in_service", "type": "number", "description": "Number of operating hours in service.", "unit": "hours" }, { "name": "operating_hours_on_standby", "type": "number", "description": "Number of operating hours on standby.", "unit": "hours" }, { "name": "operating_hours_out_of_service_scheduled", "type": "number", "description": "Number of operating hours out of service which were scheduled.", "unit": "hours" }, { "name": "operating_hours_out_of_service_unscheduled", "type": "number", "description": "Number of operating hours out of service which were unscheduled.", "unit": "hours" }, { "name": "times_started", "type": "number", "description": "Number of times the plant was started. This field is only reported for plant_type's steam and nuclear." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 193730, "hash": "sha256:8a645f7f0b61488a329c73e8b4ce1bb77de01c5a7ef5a806264b6dccc9142c55" }, { "name": "core_rus12__yearly_plant_operations_by_plant", "type": "table", "description": "Annual time series of whole plant operational data including fuel consumption and operational hours.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part D, E, F (CC), F (IC) & G - Section A)\n\nPrimary key:\n This table has no primary key. This table has no primary key because there are a handful of plants that have duplicate records. The primary key of this table otherwise would be: [`report_date`, `borrower_id_rus`, `plant_name_rus`, `plant_name_rus`, `unit_id_rus`, `plant_type`, `is_full_ownership_portion`, `is_partly_owned_by_borrower`].\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe data in this table comes from five different portions of RUS 12 corresponding to different plant types (steam, hydroelectric, combined_cycle, internal_combustion and nuclear).\nThe original form includes plant operations data for each plant type reported in multiple ways: with records corresponding to the portion of plants that borrowers own as well as the whole plant. We split these records into two tables, :ref:`core_rus12__yearly_plant_operations_by_borrower`, which contains records reported at the borrower level, and :ref:`core_rus12__yearly_plant_operations_by_plant`, which contains records reported at the plant level.Records that are wholly owned by one borrower show up in both :ref:`core_rus12__yearly_plant_operations_by_borrower` and :ref:`core_rus12__yearly_plant_operations_by_plant`.\n\nThere are two boolean columns used to delineate which records are associated with the borrowers' share vs the whole plant - which is documented in ``_OR_PowerSupply Plant File Documentation.rtf`` in the newer years in the RUS 12 archive. One of these two fields - ``is_partly_owned_by_borrower`` - was not reported before 2009. For the pre-2009 years, we assume that all records that report TRUE for is_full_ownership_portion should end up in the by-plant table while all records should end up in the by-borrower portion of the table.Like the post-2009 records, this involves records from the original tables ending up in both of these PUDL tables.\n\nAlso there are two cleaning steps that we performed that alter the original data slightly:\n\n* **One dropped with unexpected ownership label and duplicate data**: There is a Wisdom steam plant record that is labeled to be both fully owned by borrower and partly owned for one year, which is an unexpected combo based on the `_OR_PowerSupply Plant File Documentation.rst` documentation file in the rus12 archive. Luckily this plant has exactly the same records as the other Wisdom steam plant that year with more expected ownership labels.* **Replaced two string values for unit_id_rus**: There are two instances from 2018 of unit_id_rus's that have string values in them - ``WSL GT 12`` and ``WSL ST 10``. Based on pre-cleaned data, we were able to clearly identify that we can use just the numeric values in these bad strings - 12 and 10 respectively. This enables us to have an integer type for this unit_id_rus column..\n\nPlant-level data can be matched to the :ref:core_rus12__yearly_plant_labor` and forthcoming core_rus12__yearly_plant_factors_and_maximum_demand, which report Section B and C data for all plants. The RUS instructions note that:\n\nyou should use caution when using total plant data since there are cases where more than one Borrower shares units at the same plant which means that you will be getting duplicate plant total records (and there is no guarantee that the total plant records entered by two borrowers for the same plant will be identical).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_plant_operations_by_plant.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "unit_id_rus", "type": "integer", "description": "RUS-assigned unit identification code." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "ownership_pct", "type": "number", "description": "Percentage of the plant owned by the respondent." }, { "name": "is_partly_owned_by_borrower", "type": "boolean", "description": "Whether or not the plant record is partially owned by the borrower. This column was not reported before 2009." }, { "name": "fuel_consumption_coal_lbs", "type": "number", "description": "Annual pounds of coal consumed for fuel.This field is only reported for plant_type steam.", "unit": "lb" }, { "name": "fuel_consumption_gas_cubic_feet", "type": "number", "description": "Annual cubic feet of natural gas consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "cf" }, { "name": "fuel_consumption_oil_gallons", "type": "number", "description": "Annual gallons of oil consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "gal" }, { "name": "fuel_consumption_other", "type": "number", "description": "Annual other fuel consumed. Neither units nor type of fuel are documented.This field is only reported for plant_type's combined_cycle, combined_cycle and steam." }, { "name": "operating_hours_in_service", "type": "number", "description": "Number of operating hours in service.", "unit": "hours" }, { "name": "operating_hours_on_standby", "type": "number", "description": "Number of operating hours on standby.", "unit": "hours" }, { "name": "operating_hours_out_of_service_scheduled", "type": "number", "description": "Number of operating hours out of service which were scheduled.", "unit": "hours" }, { "name": "operating_hours_out_of_service_unscheduled", "type": "number", "description": "Number of operating hours out of service which were unscheduled.", "unit": "hours" }, { "name": "times_started", "type": "number", "description": "Number of times the plant was started. This field is only reported for plant_type's steam and nuclear." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 168892, "hash": "sha256:981746e654a9211966471a38959027d7e370cab27d048c3f5c23ca2f79b17f9c" }, { "name": "core_rus12__yearly_renewable_plants", "type": "table", "description": "Annual time series of renewable energy plant generation information for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part C RE)\n\nPrimary key:\n report_date, borrower_id_rus, plant_name_rus, prime_mover_id", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_renewable_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS.", "constraints": { "required": true } }, { "name": "prime_mover_id", "type": "integer", "description": "Unique numeric identifier for each prime mover type used by RUS borrowers.", "constraints": { "required": true } }, { "name": "prime_mover_type", "type": "string", "description": "Type of prime mover (e.g. Hydro, Internal Combustion).", "constraints": { "enum": [ "Hydro", "Internal Combustion", "Large Wind", "Steam", "Photovoltaic" ] } }, { "name": "primary_renewable_fuel_type_id", "type": "integer", "description": "Unique numeric identifier for each renewable fuel type.", "constraints": { "minimum": 1, "maximum": 15 } }, { "name": "primary_renewable_fuel_type", "type": "string", "description": "Primary renewable fuel type used by the plant.", "constraints": { "enum": [ "Hydro", "Methane - landfill gas", "Wind", "Biomass - wood", "Methane - waste", "Hybrid", "Solar - photovoltaic", "Solar - thermal generation", "Other" ] } }, { "name": "renewable_fuel_pct", "type": "number", "description": "Percentage of renewable fuel used." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "employees_num", "type": "integer", "description": "Number of employees." }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "power_cost_per_mwh", "type": "number", "description": "The cost of power per mwh.", "unit": "USD_per_MWh" }, { "name": "invested", "type": "number", "description": "The amount of money invested.", "unit": "USD" }, { "name": "ownership_pct", "type": "number", "description": "Percentage of the plant owned by the respondent." }, { "name": "rus_funding", "type": "number", "description": "Amount of funding received from the Rural Utilities Service (RUS).", "unit": "USD" }, { "name": "comments", "type": "string", "description": "General comments field." } ], "primaryKey": [ "report_date", "borrower_id_rus", "plant_name_rus", "prime_mover_id" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 33554, "hash": "sha256:53241d2d2569b7d6c0b7eea237a791af66d0b7e7d9402f3a5b03827d4df48263" }, { "name": "core_rus12__yearly_sources_and_distribution", "type": "table", "description": "Annual time series of MWh and cost of energy sources and distribution by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, source_of_energy\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nSee the ``sources_and_distribution_by_plant_type`` table for a breakdown of plant-type-specific cost, capacity, plant_num, and net_energy_received values. Also note that there are several ``source_of_energy`` values that don't have a corresponding cost value.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_sources_and_distribution.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "source_of_energy", "type": "string", "description": "The source of energy (not plant type).", "constraints": { "required": true, "enum": [ "energy_available_for_sale", "energy_used_by_borrower", "purchased_power", "total_energy_accounted", "total_energy_losses", "total_plant", "total_sales", "delivered_out_of_system_gross", "net_interchange", "received_into_system_gross", "delivered_out_of_system_wheeling", "net_energy_wheeled", "received_into_system_wheeling", "energy_furnished_without_charge" ] } }, { "name": "net_energy_received_mwh", "type": "number", "description": "The net amount of energy received into the system.", "unit": "MWh" }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "source_of_energy" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 41455, "hash": "sha256:4fc4dd8226459c459bb23f83eb2e7d6298a8ff03faf38aeb3bf6d04ab2039e31" }, { "name": "core_rus12__yearly_sources_and_distribution_by_plant_type", "type": "table", "description": "Annual time series of capacity, plant num, MWh, and cost of energy by plant type for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, plant_type\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_sources_and_distribution_by_plant_type.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "required": true, "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "plant_num", "type": "integer", "description": "Number of plants." }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" }, { "name": "net_energy_received_mwh", "type": "number", "description": "The net amount of energy received into the system.", "unit": "MWh" } ], "primaryKey": [ "report_date", "borrower_id_rus", "plant_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 26627, "hash": "sha256:bc6d4e71c578aff0ac2c060270c981a268e1df58edbbe8dbf556df9d5ed399f8" }, { "name": "core_rus12__yearly_statement_of_operations", "type": "table", "description": "Annual time series of opex and cost of electric service for RUS borrowers by time period.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part A - Section A)\n\nPrimary key:\n report_date, borrower_id_rus, opex_group, opex_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_statement_of_operations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "opex_group", "type": "string", "description": "High level section from the statement of operations table. Most of these types have subcomponents broken out in the ``opex_type`` column.", "constraints": { "required": true } }, { "name": "opex_type", "type": "string", "description": "Type of item from the statement of operations.", "constraints": { "required": true } }, { "name": "opex_report_month", "type": "number", "description": "Amount of operational expense, cost or income during the report month.", "unit": "USD" }, { "name": "opex_ytd", "type": "number", "description": "The year-to-date amount of operational expense, cost or income.", "unit": "USD" }, { "name": "opex_ytd_budget", "type": "number", "description": "The year-to-date budget for amount of operational expense, cost or income.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "opex_group", "opex_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 305171, "hash": "sha256:775364654bd24c38cfc09f469ab43943d5ae3ea74817dbbf27207f00c98b36d0" }, { "name": "core_rus12__yearly_utility_plant_changes", "type": "table", "description": "Annual time series of changes in utility plant\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section A)\n\nPrimary key:\n report_date, borrower_id_rus, utility_plant_group, utility_plant_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThere are a few layers of nesting in this table, which can be distinguished by the categories in the `utility_plant_group` column:\n\n * intangible_plant: only has one total utility_plant_item\n * production_plant: has several sub-component utility_plant_item and a standard total\n * transmission_plant: has several sub-component utility_plant_item and a standard total\n * distribution_plant: has several sub-component utility_plant_item and a standard total\n * electric_plant_in_service: has two sub-components and a total which includes those sub-components and the totals of the above categories\n * utility_plant_in_service: has several sub-components and the total is the sum of those sub-components as well as the total of electric_plant_in_service\n * total_utility_plant: has one sub-component and the total is the sum of the sub-component and utility_plant_in_service", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "core_rus12__yearly_utility_plant_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "utility_plant_group", "type": "string", "description": "High-level category of utility plant asset type.", "constraints": { "required": true, "enum": [ "intangible_plant", "production_plant", "transmission_plant", "distribution_plant", "electric_plant_in_service", "utility_plant_in_service", "total_utility_plant" ] } }, { "name": "utility_plant_item", "type": "string", "description": "Sub-category of utility_plant_group describing utility plant asset item.", "constraints": { "required": true, "enum": [ "land_and_land_rights", "other", "station_equipment", "structures_and_improvements", "total", "general_plant", "hydro", "nuclear", "steam", "construction_work_in_progress", "acquisition_adjustments", "completed_construction", "electric_plant_held_for_future_use", "electric_plant_leased_to_others", "electric_plant_purchased_or_sold", "nuclear_fuel_assemblies", "rto_iso_plant" ] } }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "utility_plant_group", "utility_plant_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 177683, "hash": "sha256:6e7221599774d093ce2e3fcfed07cb5ce44db5f963ec902e2e1eabe5d7b49d1b" }, { "name": "core_rus7__entity_borrowers", "type": "table", "description": "Entity table containing static information about active RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution\n\nPrimary key:\n borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table contains canonical values for borrowers are set. It contains values which are expected to remain fixed over time.RUS reports many attributes in many different tables\nacross throughout RUS-7 and RUS-12. In order to compile tidy, well-normalized database\ntables, PUDL collects all instances of these values and and chooses a canonical value.\nBy default, PUDL chooses the most consistently reported value of a given attribute as\nlong as it is at least 70% of the given instances reported. For the ``borrower_name_rus``\nPUDL chooses the most consistently reported value regardless of if it meets this 70%\nthreshold so that all borrowers will have a name. We chose this because most name\nchanges were insignificant (eg. \"and\" changed to \"&\" or \"coop\" changed to \"cooperative\").\nAll tables downstream of this one inherit the canonical values established\nhere..\n\nThis table contains all of the Active Distribution Borrowers as of each report year who were eligible to report to RUS Form 7. If these Borrowers have reported to RUS they will have records in the enclosed data tables, however a small number of these Borrowers did not report for various reasons and these Borrowers will not be represented in any of the other tables.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__entity_borrowers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } } ], "primaryKey": [ "borrower_id_rus" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 21882, "hash": "sha256:a8d0450c6af2c72ea1cf93131d0157d33e2e1afc166882f56393d4f7fc0cd677" }, { "name": "core_rus7__yearly_balance_sheet_assets", "type": "table", "description": "Annual time series of assets and other debts from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_balance_sheet_assets.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "asset_type", "type": "string", "description": "Type of asset being reported to the core_rus7__yearly_balance_sheet_assets table.", "constraints": { "required": true, "enum": [ "utility_plant_in_service", "construction_work_in_progress", "total_utility_plant", "net_utility_plant", "depreciation_and_amortization", "non_utility_property", "investments_subsidiary_companies", "investments_associated_orgs_patronage_capital", "investments_associated_orgs_other_general_funds", "investments_associated_orgs_other_non_general_funds", "investments_economic_development", "investments_other", "special_funds", "total_other_property_and_investments", "cash_general_funds", "cash_construction_funds_trustee", "special_deposits", "investments_temporary", "notes_receivable", "accounts_receivable_sales_of_energy", "accounts_receivable_other", "renewable_energy_credits", "materials_and_supplies", "prepayments", "other_current_and_accrued", "total_current_and_accrued", "regulatory", "other_deferred_debits", "total" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "asset_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 1162247, "hash": "sha256:fb1ec75806834dfadb8b3649a4f09af299174596de60dbe03c51948fe6645724" }, { "name": "core_rus7__yearly_balance_sheet_liabilities", "type": "table", "description": "Annual time series of liabilities and other credits from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, liability_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_balance_sheet_liabilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "liability_type", "type": "string", "description": "Type of liability being reported to the core_rus7__yearly_balance_sheet_liabilities table.", "constraints": { "required": true, "enum": [ "memberships", "patronage_capital", "operating_margins_prior_years", "operating_margins_current_year", "non_operating_margins", "other_margins_and_equities", "total_margins_and_equities", "long_term_debt_rus", "long_term_debt_ffb_rus_guaranteed", "long_term_debt_other_rus_guaranteed", "long_term_debt_other", "long_term_debt_rus_economic_development", "payments_unapplied", "total_long_term_debt", "noncurrent_obligations_under_capital_leases", "noncurrent_obligations_asset_retirement", "total_noncurrent_obligations", "notes_payable", "accounts_payable", "consumer_deposits", "current_maturities_long_term_debt", "economic_development", "current_maturities_capital_leases", "other_current_and_accrued_liabilities", "total_current_and_accrued_liabilities", "regulatory", "other_deferred_credits", "total_liabilities_and_other_credits" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "liability_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 1101867, "hash": "sha256:8315af8d1e8a6de5d73c216bb6b13d7d1644974d88d9662ffdd60934c19c596a" }, { "name": "core_rus7__yearly_customer_energy_efficiency_and_conservation_loans", "type": "table", "description": "Annual time series of the repayment status of loans made by a borrower to customers for investments in energy efficiency and conservation initiatives.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part J)\n\nPrimary key:\n report_date, borrower_id_rus, loan_status\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nEnergy Resources Conservation (ERC) loans are defined by the RUS as loans made by an RUS borrower to its consumers for the cost of labor and materials for the following energy conservation measures: caulking, weather-stripping, ceiling insulation, wall insulation, floor insulation, duct insulation, pipe insulation, water heater insulation storm windows, thermal windows, storm or thermal doors, clock thermostats and attic ventilation fans.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_customer_energy_efficiency_and_conservation_loans.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "loan_status", "type": "string", "description": "The repayment status of a loan.", "constraints": { "required": true, "enum": [ "loan_default", "loan_delinquency" ] } }, { "name": "actual_pct", "type": "number", "description": "Observed percentage." }, { "name": "anticipated_pct", "type": "number", "description": "Expected percentage." }, { "name": "ytd_dollars", "type": "number", "description": "Balance this current year, in U.S. dollars.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "loan_status" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 10105, "hash": "sha256:e74d4b92b6a60ef04c91c177aeca91b0331dc29bc8698117468cf9c3ff1a8522" }, { "name": "core_rus7__yearly_distribution_services", "type": "table", "description": "Annual time series of distribution services.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part B)\n\nPrimary key:\n report_date, borrower_id_rus, service_status\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_distribution_services.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "service_status", "type": "string", "description": "Status of services (e.g., idle, retired) in report period. Idle services exclude seasonals.", "constraints": { "required": true, "enum": [ "connected", "idle", "retired", "total" ] } }, { "name": "services", "type": "number", "description": "Number of services in system at end of year." }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "service_status" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 146533, "hash": "sha256:8bd1540cb4b460a8ce2e588d2177409dd5d18ded8e985347b406825b6c8d2bcc" }, { "name": "core_rus7__yearly_employee_statistics", "type": "table", "description": "Annual time series of statistics about employment and payroll.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part H)\n\nPrimary key:\n report_date, borrower_id_rus", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_employee_statistics.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "employees_fte_num", "type": "integer", "description": "The number of full time employees." }, { "name": "employee_hours_worked_regular_time", "type": "integer", "description": "The number of regular (non-overtime) hours worked by employees." }, { "name": "employee_hours_worked_over_time", "type": "integer", "description": "The number of overtime hours worked by employees." }, { "name": "payroll_expensed", "type": "integer", "description": "The amount of payroll spent that was expensed." }, { "name": "payroll_capitalized", "type": "integer", "description": "The amount of payroll spent that was capitalized." }, { "name": "payroll_other", "type": "integer", "description": "The amount of payroll spent that was funded by other means - not capitalized or expensed." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 255962, "hash": "sha256:258fb007c6efcbef605d78ad3b4e6d702699cf188ed8eb368ca58a495bf67bf4" }, { "name": "core_rus7__yearly_energy_efficiency", "type": "table", "description": "Annual time series of investments in and impacts of energy efficiency programs.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part P)\n\nPrimary key:\n report_date, borrower_id_rus, customer_class, observation_period\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The savings_mmbtu likely contains values with incorrect units.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_energy_efficiency.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type.", "constraints": { "required": true, "enum": [ "residential_excluding_seasonal", "other_electric", "public_street_lighting", "sales_for_resale_rus_borrowers", "transmission", "irrigation", "public_other", "total", "sales_for_resale_other", "commercial_and_industrial_large", "commercial_and_industrial_small", "residential_seasonal" ] } }, { "name": "observation_period", "type": "string", "description": "The date range that any given record pertains to. Ex: 'december' implies that this record covers the month of December only, while 'avg' implies this record pertains to the average of the reporting period.", "constraints": { "required": true, "enum": [ "ytd", "new_in_report_year", "avg", "report_month", "report_year", "december", "cumulative", "ytd_budget" ] } }, { "name": "customers_num", "type": "number", "description": "Number of customers." }, { "name": "invested", "type": "number", "description": "The amount of money invested.", "unit": "USD" }, { "name": "savings_mmbtu", "type": "number", "description": "The estimated amount of energy savings from energy efficiency programs. Warning: We found values much larger than expected that we have not yet cleaned - this is likely a reporting unit error.", "unit": "MMBTU" } ], "primaryKey": [ "report_date", "borrower_id_rus", "customer_class", "observation_period" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 289964, "hash": "sha256:747b779dc7efc4b7777fd28949d5b4b5fa11ad23e0660c973182b1b2e7288e61" }, { "name": "core_rus7__yearly_energy_purchased", "type": "table", "description": "Annual time series of energy purchased by RUS borrowers.\n\n\nMost-recent data:\n 2020\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part K)\n\nPrimary key:\n This table has no primary key. The primary key would probably be report_date, borrower_id_rus, fuel_type_code, supplier_code_rus, renewable_energy_program if not for certain EIA utilities represented as Miscellaneous (supplier code 700000).\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nA number of records report purchases from an unspecified entity. These fields all have reported utility names beginning with an \\*, including \\*Miscellaneous, \\*Adjustments, and \\*Residential Renewable Supplier.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_energy_purchased.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "purchased_mwh", "type": "number", "description": "The total electricity purchased.", "unit": "MWh" }, { "name": "purchased_energy_cost_total", "type": "number", "description": "The total cost of purchased energy. Includes fuel cost adjustment and wheeling and other charges.", "unit": "USD" }, { "name": "average_energy_cost_dollars_per_mwh", "type": "number", "description": "The average cost of energy per MWh.", "unit": "dollars_per_MWh" }, { "name": "wheeling_and_other_charges", "type": "number", "description": "The cost of wheeling and other charges or credits related to fuel. Included in the total cost." }, { "name": "fuel_cost_adjustment", "type": "number", "description": "The variable fuel surcharge component of a distribution cooperative's wholesale purchased power bill, reflecting pass-through of actual fuel cost fluctuations from the supplying utility, reported separately from base power charges and wheeling costs. Included in the total cost." }, { "name": "fuel_type_code_rus", "type": "integer", "description": "Unique numeric identifier for RUS fuel types.", "constraints": { "minimum": 1, "maximum": 17 } }, { "name": "is_supplier_eia_respondent", "type": "boolean", "description": "Whether the utility supplying energy to a RUS borrower is an EIA respondent." }, { "name": "supplier_code_rus", "type": "string", "description": "Unique numeric identifier for the utility supplying energy to a RUS borrower." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "comments", "type": "string", "description": "General comments field." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 337366, "hash": "sha256:4861a54951d1f56766af25e48c8a0ca632c866e57892c9eeaa7e57f8320b9780" }, { "name": "core_rus7__yearly_external_financial_risk_ratio", "type": "table", "description": "Annual time series of ratio of investments and loan guarantee balances to total utility plant assets.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part Q - Section III)\n\nPrimary key:\n report_date, borrower_id_rus", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_external_financial_risk_ratio.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "external_financial_risk_ratio", "type": "number", "description": "total investments + loan guarantee balances / total utility plant assets. This ratio shows how much a utility is financially exposed to outside entities relative to its own assets." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 31969, "hash": "sha256:bcb5761bdabfbcaca0e7264a5a73d8049172f6a00be0ff879e2f65a0f816a583" }, { "name": "core_rus7__yearly_investments", "type": "table", "description": "Annual time series of investments, loan guarantees and loans.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part P - Section I)\n\nPrimary key:\n This table has no primary key. This is a list of all investments or loans in each year and borrowers can have multiple records with the same ``investment_description``.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReporting of investments is required by 7 CFR 1717, Subpart N. Investment categories reported on this Part correspond to Balance Sheet items in Part C.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_investments.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "investment_description", "type": "string", "description": "Description of investment. This is a free-form text field and thus contains a wide variety of values." }, { "name": "investment_type_code", "type": "integer", "description": "Investment type code.", "constraints": { "minimum": 1, "maximum": 11 } }, { "name": "included_investments", "type": "number", "description": "Included investment." }, { "name": "excluded_investments", "type": "number", "description": "Excluded investment." }, { "name": "income_or_loss", "type": "number", "description": "Income or loss from investment." }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "investment_type_code" ], "reference": { "resource": "core_rus__codes_investment_types", "fields": [ "code" ] } }, { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 3045603, "hash": "sha256:4a08316865656f09a0696dba4d72bae53b2d3ab89b53531aefdef0989fcbeed0" }, { "name": "core_rus7__yearly_loans", "type": "table", "description": "Annual time series of loans provided by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part Q - Sections II & IV)\n\nPrimary key:\n This table has no primary key. Borrowers may receive multiple loans from ``lending_organizations`` in a given year.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table also includes loan guarantees where the RUS borrower backs a loan from another entity and is therefore liable to pay any remaining balance should the original borrower default. \n\nIn 2006, the loan maturity date for borrower ND0051's loan from ERC - Paulson, David was reported as 2/8/2820. There is no clear way to determine the correct maturity date given that 2006 is the first year of data we have and the same loan does not appear in future years. For this reason we've nulled the date.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_loans.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "loan_recipient", "type": "string", "description": "The organization that received a loan." }, { "name": "loan_balance", "type": "number", "description": "The amount of money still owned on a loan at the end of the reporting year." }, { "name": "loan_maturity_date", "type": "date", "description": "The date on which a loan is scheduled to be fully paid." }, { "name": "loan_original_amount", "type": "number", "description": "The original amount of a loan.", "unit": "USD" }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." }, { "name": "is_loan_guarantee", "type": "boolean", "description": "Indicates a third-party loan that the reporting utility (referred as a borrower) has co-signed, taking on responsibility for repayment if the primary borrower defaults." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 187599, "hash": "sha256:1e62e943b6330a3e2d9e4bf234d768681988a33226c964e4ebb1f334e994fb4d" }, { "name": "core_rus7__yearly_long_term_debt", "type": "table", "description": "Annual time series of long term debt and debt service requirements.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part N)\n\nPrimary key:\n This table has no primary key. This table has no native primary key. It is a list of all debts in each year and borrowers can have multiple records with the same ``investment_description``.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_long_term_debt.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "debt_description", "type": "string", "description": "Description of debt or loan. On the original form, there are nine provided descriptions and a section to add other free-form descriptions." }, { "name": "debt_ending_balance", "type": "number", "description": "The amount of principal still owned on the debt at the end of the report year.", "unit": "USD" }, { "name": "debt_interest", "type": "number", "description": "The interest expense on the debt for the report year.", "unit": "USD" }, { "name": "debt_principal", "type": "number", "description": "The principal paid on the debt during the report year.", "unit": "USD" }, { "name": "debt_total", "type": "number", "description": "The total amount of debt.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 859625, "hash": "sha256:c631d2dbae186e709d45f88f9c52a03106e7c14ee4783d030d458cbda486cbba" }, { "name": "core_rus7__yearly_long_term_leases", "type": "table", "description": "Annual time series of long term leases by property type.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part L)\n\nPrimary key:\n This table has no primary key. Borrowers may receive multiple leases from ``lending_organizations`` in a given year.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_long_term_leases.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "lending_organization", "type": "string", "description": "The organization that provided a lease or loan." }, { "name": "property_type", "type": "string", "description": "The type of property leased." }, { "name": "rental_cost_ytd", "type": "number", "description": "Year-to-date rental cost for leased property." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 37970, "hash": "sha256:928771b8c4c12b1ad02c2c84f51bd653ec9197be8fac7c174cbd32144387a54d" }, { "name": "core_rus7__yearly_materials_and_supplies", "type": "table", "description": "Annual time series of cost of electric vs. other materials that were purchased, salvaged, used, or sold.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part F)\n\nPrimary key:\n report_date, borrower_id_rus, electric_or_other_materials", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_materials_and_supplies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "electric_or_other_materials", "type": "string", "description": "Whether the cost is for electric materials or other materials", "constraints": { "required": true, "enum": [ "electric_materials", "other_materials" ] } }, { "name": "materials_adjustment", "type": "number", "description": "An adjustment value for the cost of materials and supplies.", "unit": "USD" }, { "name": "materials_ending_balance", "type": "number", "description": "The balance at the end of the report year for materials and supplies.", "unit": "USD" }, { "name": "materials_purchased", "type": "number", "description": "The cost of materials and supplies purchased.", "unit": "USD" }, { "name": "materials_salvaged", "type": "number", "description": "The cost of materials and supplies salvaged.", "unit": "USD" }, { "name": "materials_sold", "type": "number", "description": "The cost of materials and supplies sold.", "unit": "USD" }, { "name": "materials_used", "type": "number", "description": "The cost of materials and supplies used.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "electric_or_other_materials" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 428561, "hash": "sha256:cb1718c7fa5eefc394523324dc0980d3d3d3355ab010db56bb18cdc01244864c" }, { "name": "core_rus7__yearly_meeting_and_board", "type": "table", "description": "Annual time series of governance information about RUS borrowers' annual member meetings as well as information about their board.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part M)\n\nPrimary key:\n report_date, borrower_id_rus", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_meeting_and_board.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "last_annual_meeting_date", "type": "datetime", "description": "The date of the last annual meeting." }, { "name": "members_num", "type": "integer", "description": "The total number of members." }, { "name": "members_present_at_meeting_num", "type": "integer", "description": "The number of members present at the last annual meeting." }, { "name": "was_quorum_present", "type": "boolean", "description": "Whether or not quorum was met." }, { "name": "members_voting_by_proxy_or_mail_num", "type": "integer", "description": "The number of members voting by mail or by proxy." }, { "name": "board_members_num", "type": "integer", "description": "The total number of board members." }, { "name": "fees_and_expenses_for_board_members", "type": "integer", "description": "The total amount of fees and expenses for board members.", "unit": "USD" }, { "name": "does_manager_have_written_contract", "type": "boolean", "description": "Whether or not the RUS borrower's manager has a written contract." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 178520, "hash": "sha256:89a126567b3a15d08a7c0b08ac921326932a24e21d23e9c61d5bb03ac27c135a" }, { "name": "core_rus7__yearly_owed_by_customers", "type": "table", "description": "Annual time series of debt owed by customers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part J)\n\nPrimary key:\n report_date, borrower_id_rus", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_owed_by_customers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "amount_due_over_60_days", "type": "number", "description": "Reported amount of dollars due over 60 days from consumers for electric service. Includes both connected and disconnected customers.", "unit": "USD" }, { "name": "amount_written_off_ytd", "type": "number", "description": "Total charges due from consumers for electric service written off during the current year to Account 144.1, representing the write-off of uncollectible accounts.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 104008, "hash": "sha256:115574a47f8a76335f54945b90a75f6e0557644f96304c9f0f5d999fc17a2bfa" }, { "name": "core_rus7__yearly_patronage_capital", "type": "table", "description": "Annual time series of patronage capital distributed and received.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part I)\n\nPrimary key:\n report_date, borrower_id_rus, patronage_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_patronage_capital.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "patronage_type", "type": "string", "description": "Type of patronage capital distributed or received.", "constraints": { "required": true, "enum": [ "total_received", "total_distributions_retirements", "received_lenders_of_electric_power", "distributions_special_retirements", "distributions_general_retirements", "received_supplier_of_electric_power" ] } }, { "name": "patronage_report_year", "type": "number", "description": "Amount of patronage distributed or received within report year.", "unit": "USD" }, { "name": "patronage_cumulative", "type": "number", "description": "Amount of patronage distributed or received cumulatively. Received patronage capital is not reported cumulatively and thus will be null.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "patronage_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 341477, "hash": "sha256:f7c830215431bd75dedad12489a5bc9136f7b5e4a576b95d8d094ce95f3b03df" }, { "name": "core_rus7__yearly_power_requirements", "type": "table", "description": "Annual time series of power requirements - revenue and generation summary.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part O)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes totals of electric sales and revenue which also appear in :ref:`core_rus7__yearly_power_requirements_electric_sales` with a ``customer_class`` of ``total``. This table includes all other power requirements - not broken out by customer class, so we include these electric requirements in this table as well.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_power_requirements.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "electric_sales_revenue", "type": "integer", "description": "Total Revenue Received From Sales of Electric Energy. Total of lines 1c thru 9c on the original form.", "unit": "USD" }, { "name": "transmission_revenue", "type": "integer", "description": "Transmission revenue.", "unit": "USD" }, { "name": "other_electric_revenue", "type": "integer", "description": "Electric revenue other than electric_sales_revenue.", "unit": "USD" }, { "name": "purchases_and_generation_cost", "type": "integer", "description": "The cost of purchases and generation of electricity.", "unit": "UDS" }, { "name": "electric_sales_mwh", "type": "number", "description": "Total MWh Sold to electric sales. Total of lines 1b thru 9b on the original form.", "unit": "MWh" }, { "name": "own_use_mwh", "type": "number", "description": "The electricity in MWh used for the borrower's own internal use.", "unit": "MWh" }, { "name": "purchased_mwh", "type": "number", "description": "The total electricity purchased.", "unit": "MWh" }, { "name": "generated_mwh", "type": "number", "description": "The total electricity generated.", "unit": "MWh" }, { "name": "interchange_mwh", "type": "number", "description": "The net interchange of electricity. The net amount of electricity exchanged in purchases and sales.", "unit": "MWh" }, { "name": "peak_mw", "type": "number", "description": "The peak system MWh - the sum of all MW.", "unit": "MW" }, { "name": "is_peak_coincident", "type": "boolean", "description": "Whether or not the peak_mw is coincident or non-coincident peak." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 364057, "hash": "sha256:41b45389e10cbe07b1faab0fa7915e8eab386c148072f9027352e2e64cdb184d" }, { "name": "core_rus7__yearly_power_requirements_electric_customers", "type": "table", "description": "Annual time series of power requirements - number of customers served by customer type.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part O)\n\nPrimary key:\n report_date, borrower_id_rus, customer_class, observation_period", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_power_requirements_electric_customers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type.", "constraints": { "required": true, "enum": [ "residential_excluding_seasonal", "other_electric", "public_street_lighting", "sales_for_resale_rus_borrowers", "transmission", "irrigation", "public_other", "total", "sales_for_resale_other", "commercial_and_industrial_large", "commercial_and_industrial_small", "residential_seasonal" ] } }, { "name": "observation_period", "type": "string", "description": "The date range that any given record pertains to. Ex: 'december' implies that this record covers the month of December only, while 'avg' implies this record pertains to the average of the reporting period.", "constraints": { "required": true, "enum": [ "ytd", "new_in_report_year", "avg", "report_month", "report_year", "december", "cumulative", "ytd_budget" ] } }, { "name": "customers_num", "type": "number", "description": "Number of customers." } ], "primaryKey": [ "report_date", "borrower_id_rus", "customer_class", "observation_period" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 342463, "hash": "sha256:b74f008b9ddab61b1139a6292b8fa79fd39c579089e82030006925b45692e70d" }, { "name": "core_rus7__yearly_power_requirements_electric_sales", "type": "table", "description": "Annual time series of power requirements - revenue and energy sold by customer type.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part O)\n\nPrimary key:\n report_date, borrower_id_rus, customer_class", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_power_requirements_electric_sales.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type.", "constraints": { "required": true, "enum": [ "residential_excluding_seasonal", "other_electric", "public_street_lighting", "sales_for_resale_rus_borrowers", "transmission", "irrigation", "public_other", "total", "sales_for_resale_other", "commercial_and_industrial_large", "commercial_and_industrial_small", "residential_seasonal" ] } }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "revenue", "type": "number", "description": "Amount of revenue.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "customer_class" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 731936, "hash": "sha256:adf4555d628f6ddd6c2d081eaac3bc6bb10ee0764d5b1385063e715f74f57df6" }, { "name": "core_rus7__yearly_service_interruptions", "type": "table", "description": "Annual time series of service interruptions by cause.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part G)\n\nPrimary key:\n report_date, borrower_id_rus, service_interruption_cause, observation_period\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_service_interruptions.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "service_interruption_cause", "type": "string", "description": "Source of service interruption.", "constraints": { "required": true, "enum": [ "major_event", "other", "planned", "power_supplier", "total" ] } }, { "name": "observation_period", "type": "string", "description": "The date range that any given record pertains to. Ex: 'december' implies that this record covers the month of December only, while 'avg' implies this record pertains to the average of the reporting period.", "constraints": { "required": true, "enum": [ "five_year_average", "annual" ] } }, { "name": "saidi_minutes", "type": "number", "description": "Cumulative duration (minutes) of interruption for the average customer during the report year.", "unit": "min" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "service_interruption_cause", "observation_period" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 331775, "hash": "sha256:65cff9751657bbc104764ae4b1d4c097d3ce0347c3895a561a2fb31895fe9b88" }, { "name": "core_rus7__yearly_statement_of_operations", "type": "table", "description": "Annual time series of opex and cost of electric service for RUS borrowers by time period.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part A)\n\nPrimary key:\n report_date, borrower_id_rus, opex_group, opex_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_statement_of_operations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "opex_group", "type": "string", "description": "High level section from the statement of operations table. Most of these types have subcomponents broken out in the ``opex_type`` column.", "constraints": { "required": true, "enum": [ "cost_of_electric_service", "opex", "patronage_capital_or_margins", "patronage_and_operating_margins" ] } }, { "name": "opex_type", "type": "string", "description": "Type of item from the statement of operations.", "constraints": { "required": true, "enum": [ "interest_charged_to_construction", "customer_service", "generation_and_transmission_capital", "power_production", "distribution_operation", "non_operating_margins_other", "non_operating_margins_interest", "distribution_maintenance", "other_deductions", "admin", "regional_market", "total_minus", "total", "extraordinary_items", "depreciation", "other_capital_credits_ytd", "tax_property", "transmission", "tax_other", "purchased_power", "construction_funds_allowance", "interest_long_term_debt", "interest_other", "other_capital_credits", "equity_investment_losses", "sales", "customer_accounts", "operating_revenue", "cost_of_electric_service" ] } }, { "name": "opex_report_month", "type": "number", "description": "Amount of operational expense, cost or income during the report month.", "unit": "USD" }, { "name": "opex_ytd", "type": "number", "description": "The year-to-date amount of operational expense, cost or income.", "unit": "USD" }, { "name": "opex_ytd_budget", "type": "number", "description": "The year-to-date budget for amount of operational expense, cost or income.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "opex_group", "opex_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 2924200, "hash": "sha256:9b5bfdb5688356cd7d985db95a5a49aab69e28118eb92c264651aa62b9c59aff" }, { "name": "core_rus7__yearly_transmission_and_distribution_mileage", "type": "table", "description": "Annual time series of miles of transmission and distribution infrastructure.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part B)\n\nPrimary key:\n report_date, borrower_id_rus, line_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nNote that according to RUS, 'underbuild in overhead lines or joint runs in underground installations do not increase the number of line miles except for distribution underbuild on transmission poles. In such cases, distribution pole line miles would be increased by the number of underbuild miles involved.'", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_transmission_and_distribution_mileage.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "line_type", "type": "string", "description": "The type of line mileage reported (e.g., transmission, overhead distribution).", "constraints": { "required": true, "enum": [ "distribution_overhead", "distribution_underground", "transmission_line", "total" ] } }, { "name": "miles", "type": "number", "description": "Line length at the end of the reported period, in miles.", "unit": "miles" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "line_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 190008, "hash": "sha256:dfec46ebbb142ca9417e4408e7d14d5eb0eb51b5a8be4caca073e1c25e28b973" }, { "name": "core_rus7__yearly_utility_plant_changes", "type": "table", "description": "Annual time series of changes in utility plant\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part E)\n\nPrimary key:\n report_date, borrower_id_rus, utility_plant_group, utility_plant_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "core_rus7__yearly_utility_plant_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "utility_plant_group", "type": "string", "description": "High-level category of utility plant asset type.", "constraints": { "required": true, "enum": [ "utility_plant_in_service", "total_utility_plant" ] } }, { "name": "utility_plant_item", "type": "string", "description": "Sub-category of utility_plant_group describing utility plant asset item.", "constraints": { "required": true, "enum": [ "construction_work_in_progress", "total", "all_other", "distribution", "general", "headquarters", "intangibles", "transmission", "regional_transmission_and_market_operation" ] } }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "utility_plant_group", "utility_plant_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 962126, "hash": "sha256:22941d286e90f40940dd9bc934397b05ac4ce164ff4209040b094c7170983c25" }, { "name": "core_rus__codes_fuel_types", "type": "table", "description": "Code table containing descriptions of categorical codes for fuel types in RUS.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n RUS -- Mix of multiple RUS forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [], "path": "core_rus__codes_fuel_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "bytes": 3081, "hash": "sha256:6c33ca307411f712bf2336786b78b9d927179d5701fe51c965fa19e654da9dcb" }, { "name": "core_rus__codes_investment_types", "type": "table", "description": "Code table containing descriptions of categorical codes for investment types.\n\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n RUS -- Mix of multiple RUS forms\n\nPrimary key:\n code", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [], "path": "core_rus__codes_investment_types.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "code", "type": "string", "description": "Originally reported short code.", "constraints": { "required": true } }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." } ], "primaryKey": [ "code" ], "foreignKeys": [] }, "bytes": 3234, "hash": "sha256:405038028b88df285582dc0eb7ab254ccaa40b2ee59f45f31ce8a8733c89137a" }, { "name": "core_sec10k__assn_exhibit_21_subsidiaries_and_eia_utilities", "type": "table", "description": "Association table providing connections between subsidiaries listed in Exhibit 21 and EIA utilities.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n subsidiary_company_id_sec10k\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAn Exhibit 21 subsidiary is considered matched to an EIA utility if their names are identical. Only subsidiaries that don't file SEC 10-K themselves are included in this table. SEC 10-K filers have much more information available and are matched to EIA utilities using probabilistic record linkage in :ref:`core_sec10k__assn_sec10k_filers_and_eia_utilities`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__assn_exhibit_21_subsidiaries_and_eia_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "subsidiary_company_id_sec10k", "type": "string", "description": "PUDL-assigned ID for subsidiaries found in SEC 10-K Exhibit 21. The ID is created by concatenating the CIK of the company whose filing the subsidiary was found in, the subsidiary company's name, and location of incorporation. It is not guaranteed to be stable across different releases of PUDL and so should never be hard-coded in analyses.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." } ], "primaryKey": [ "subsidiary_company_id_sec10k" ], "foreignKeys": [ { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 112908, "hash": "sha256:2d711024afa2d4ad06db7f63585de24a59af7b6e2e5a43513724dd7ec24b84d1" }, { "name": "core_sec10k__assn_exhibit_21_subsidiaries_and_filers", "type": "table", "description": "Association table providing connections between subsidiaries listed in Exhibit 21 and their SEC central index key, if the subsidiary also files Form 10-K.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n subsidiary_company_id_sec10k\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nExhibit 21 subsidiaries and SEC 10-K filers are considered matched if they have identical names and the same location of incorporation.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__assn_exhibit_21_subsidiaries_and_filers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "subsidiary_company_id_sec10k", "type": "string", "description": "PUDL-assigned ID for subsidiaries found in SEC 10-K Exhibit 21. The ID is created by concatenating the CIK of the company whose filing the subsidiary was found in, the subsidiary company's name, and location of incorporation. It is not guaranteed to be stable across different releases of PUDL and so should never be hard-coded in analyses.", "constraints": { "required": true } }, { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database." } ], "primaryKey": [ "subsidiary_company_id_sec10k" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 492040, "hash": "sha256:29f00567c68e969572cdb800721294aaa715c4b8da81d592e19f78c8798e4d26" }, { "name": "core_sec10k__assn_sec10k_filers_and_eia_utilities", "type": "table", "description": "Association table providing connections between SEC 10-K filers and EIA utilities.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n central_index_key, utility_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This data has been matched probabilistically using a machine learning model and contains some incompletions and errors. It should not be treated as ground truth data.\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nSEC central index keys are matched to EIA\nutility IDs using probabilistic record linkage based on associated company information\nlike company name, business and mailing addresses, and state of incorporation.\nThe match between ``central_index_key`` and ``utility_id_eia`` is one to one and is not\nallowed to change over time. In cases where there were multiple candidate matches,\nthe match with the highest probability is selected.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__assn_sec10k_filers_and_eia_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } } ], "primaryKey": [ "central_index_key", "utility_id_eia" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 12022, "hash": "sha256:41a631d213cc7a18723e8d359750ed1b184568efd55690e807f7c76f22b943f9" }, { "name": "core_sec10k__changelog_company_name", "type": "table", "description": "Changelog table tracking changes in the names each SEC 10-K filer has used.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nThis table is extracted from the same SEC 10-K filing header information as\n:ref:`core_sec10k__quarterly_company_information`. Each filing reports the full history of\nname change associated with a company up to the date of that filing. Because individual\ncompanies may appear in multiple filings in the same year, and the same historical name\nchanges will be reported in multiple years, the raw input data contains many duplicate\nentries, which are deduplicated to create this table. The original name change data only\ncontains the former name and the date of the change.\n\nRoughly 2% of all records describe multiple name changes happening on the same date\n(they are duplicates on the basis of ``central_index_key`` and ``name_change_date``).\nThis may be due to company name reporting inconsistencies or reporting errors in which\nthe old and new company names have been swapped.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__changelog_company_name.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database.", "constraints": { "required": true } }, { "name": "name_change_date", "type": "date", "description": "Date of last name change of the company.", "constraints": { "required": true } }, { "name": "company_name_old", "type": "string", "description": "Name of company prior to name change." }, { "name": "company_name", "type": "string", "description": "Name of the reporting company." } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 720483, "hash": "sha256:b9b17b3c956f1cd05c462c6307b2db3f5ca4a1700e4356fa97b2da41db9d2595" }, { "name": "core_sec10k__quarterly_company_information", "type": "table", "description": "Quarterly time series of company and filing information extracted from SEC 10-K filing headers.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n filename_sec10k, central_index_key\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nWhile the SEC 10-K filings are submitted by a single company, they often contain\nreferences to many other related companies. Information about these companies and the\nfiling itself are contained in text headers at the beginning of the filing. This table\ncontains data extracted from those headers. Each record in this table represents a\nsingle observation of a company in a single filing. The ``filer_count`` indicates which\nreferenced company within a filing header the record corresponds to.\n\nBecause the same company may be referenced in a number of different filings submitted in\nthe same reporting period or even on the same day, this table contains apparently\nduplicative records about many companies, that may be distinguished only by the filename\nassociated with the filing they appeared in and their filer count. Note that all\nreferences to a particular company may not be perfectly consistent across all filings in\nwhich they appear. The various company names, addresses, and other information\nassociated with the company's unique and permanent ``central_index_key`` are later used\nas inputs into the probabilistic record linkage process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__quarterly_company_information.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "filename_sec10k", "type": "string", "description": "Unique portion of the filename associated with the SEC 10-K filing in the EDGAR database. The full source URL can be reconstructed by prepending https://www.sec.gov/Archives/edgar/data/ and adding the .txt file type extension.", "constraints": { "required": true } }, { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database.", "constraints": { "required": true } }, { "name": "filer_count", "type": "integer", "description": "A counter indicating which observation of company data within an SEC 10-K filing header the record pertains to." }, { "name": "company_name", "type": "string", "description": "Name of the reporting company." }, { "name": "fiscal_year_end", "type": "string", "description": "The end date of an SEC filing company's fiscal year, in MMDD format.", "constraints": { "pattern": "^(?:(?:0[1-9]|1[0-2])(?:0[1-9]|1\\d|2\\d|3[01])|(?:0[13-9]|1[0-2])(?:29|30)|(?:0[13578]|1[02])31)$" } }, { "name": "taxpayer_id_irs", "type": "string", "description": "Taxpayer ID of the company with the IRS.", "constraints": { "pattern": "^\\d{2}-\\d{7}$" } }, { "name": "incorporation_state", "type": "string", "description": "Two letter state code where company is incorporated." }, { "name": "industry_name_sic", "type": "string", "description": "Text description of Standard Industrial Classification (SIC)" }, { "name": "industry_id_sic", "type": "string", "description": "Four-digit Standard Industrial Classification (SIC) code identifying the company's primary industry. SIC codes have been replaced by NAICS codes in many applications, but are still used by the SEC. See e.g. https://www.osha.gov/data/sic-manual for code definitions.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "film_number", "type": "string", "description": "Document control number used in the SEC EDGAR database. The first four digits can be used to access scans of the document in the SEC's Virtual Private Reference Room." }, { "name": "sec10k_type", "type": "string", "description": "Specific version of SEC 10-K that was filed. 10-k: the standard annual report. 10-k/a: an amended version of the annual report. 10-k405: filed to report insider trading that was not reported in a timely fashion. 10-k405/a: an amended version of the 10-k405. 10-kt: submitted in lieu of or in addition to a standard 10-K annual report when a company changes the end of its fiscal year (e.g. due to a merger) leaving the company with a longer or shorter reporting period. 10-kt/a: an amended version of the 10-kt. 10-ksb: the annual report for small businesses, also known as penny stocks. 10-ksb/a: an amended version of the 10-ksb.", "constraints": { "enum": [ "10-k", "10-k/a", "10-k405", "10-k405/a", "10-kt", "10-kt/a", "10-ksb", "10-ksb/a" ] } }, { "name": "sec_act", "type": "string", "description": "SEC Act through which the form was enacted, e.g. 1934 act.", "constraints": { "enum": [ "1934 act" ] } }, { "name": "filing_number_sec", "type": "string", "description": "Filing number used internally by the SEC commission to track filing." }, { "name": "phone_number", "type": "string", "description": "Phone number for utility contact 1." }, { "name": "business_street_address", "type": "string", "description": "Street address of the company's place of business." }, { "name": "business_street_address_2", "type": "string", "description": "Second line of the street address of the company's place of business." }, { "name": "business_city", "type": "string", "description": "City where the company's place of business is located." }, { "name": "business_state", "type": "string", "description": "State where the company's place of business is located." }, { "name": "business_zip_code", "type": "string", "description": "Zip code of the company's place of business.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "business_zip_code_4", "type": "string", "description": "Zip code suffix of the company's place of business.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "business_postal_code", "type": "string", "description": "Non-US postal code of the company's place of business." }, { "name": "mail_street_address", "type": "string", "description": "Street portion of the company's mailing address." }, { "name": "mail_street_address_2", "type": "string", "description": "Second line of the street portion of the company's mailing address." }, { "name": "mail_city", "type": "string", "description": "City of the company's mailing address." }, { "name": "mail_state", "type": "string", "description": "State of the company's mailing address." }, { "name": "mail_zip_code", "type": "string", "description": "Zip code of the company's mailing address.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "mail_zip_code_4", "type": "string", "description": "Zip code suffix of the company's mailing address.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "mail_postal_code", "type": "string", "description": "Non-US postal code of the company's mailing address." } ], "primaryKey": [ "filename_sec10k", "central_index_key" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 14555117, "hash": "sha256:96a9efee93679283c1407c415c7ff2cc839ed28a5fdde9dda5a0e595c4786e7e" }, { "name": "core_sec10k__quarterly_exhibit_21_company_ownership", "type": "table", "description": "Quarterly time series of subsidiary company ownership data from the SEC 10-K Exhibit 21 attachments.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n filename_sec10k, subsidiary_company_id_sec10k\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This data has been extracted probabilistically using a machine learning model and contains some incompletions and errors. It should not be treated as ground truth data.\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nExhibit 21 is an unstructured text or PDF attachment to the main SEC 10-K filing\nthat is used to describe the subsidiaries owned by the filing company. It may or may not\nprovide the percentage of the subsidiary that is owned by the filing company, or the\nlocation of the subsidiary.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__quarterly_exhibit_21_company_ownership.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "filename_sec10k", "type": "string", "description": "Unique portion of the filename associated with the SEC 10-K filing in the EDGAR database. The full source URL can be reconstructed by prepending https://www.sec.gov/Archives/edgar/data/ and adding the .txt file type extension.", "constraints": { "required": true } }, { "name": "subsidiary_company_name", "type": "string", "description": "Name of subsidiary company." }, { "name": "subsidiary_company_location", "type": "string", "description": "Location of subsidiary company. This is the full US state name or country name and occasionally a two digit code that was not mapped to a full name during cleaning." }, { "name": "subsidiary_company_id_sec10k", "type": "string", "description": "PUDL-assigned ID for subsidiaries found in SEC 10-K Exhibit 21. The ID is created by concatenating the CIK of the company whose filing the subsidiary was found in, the subsidiary company's name, and location of incorporation. It is not guaranteed to be stable across different releases of PUDL and so should never be hard-coded in analyses.", "constraints": { "required": true } }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." } ], "primaryKey": [ "filename_sec10k", "subsidiary_company_id_sec10k" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 76295459, "hash": "sha256:33d1c846bf36e76862e94ee4b84bf0d694012fb18f0fe9b2b087552076e3db95" }, { "name": "core_sec10k__quarterly_filings", "type": "table", "description": "Quarterly time series of metadata describing SEC 10-K filings.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been cleaned and organized into well-modeled tables that serve as building blocks for downstream wide tables and analyses.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n filename_sec10k\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nEach SEC 10-K filing is submitted by a single company, but may contain information about\nnumerous other companies. This table indicates the company submitting the filing, as\nwell as some information about the overall filing. Each filing is guaranteed to have a\nunique filename, but ~1% of all filings are one company submitting the same form\nmultiple times on the same day, so the filename is the only available natural primary\nkey.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "core_sec10k__quarterly_filings.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "filename_sec10k", "type": "string", "description": "Unique portion of the filename associated with the SEC 10-K filing in the EDGAR database. The full source URL can be reconstructed by prepending https://www.sec.gov/Archives/edgar/data/ and adding the .txt file type extension.", "constraints": { "required": true } }, { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database." }, { "name": "company_name", "type": "string", "description": "Name of the reporting company." }, { "name": "sec10k_type", "type": "string", "description": "Specific version of SEC 10-K that was filed. 10-k: the standard annual report. 10-k/a: an amended version of the annual report. 10-k405: filed to report insider trading that was not reported in a timely fashion. 10-k405/a: an amended version of the 10-k405. 10-kt: submitted in lieu of or in addition to a standard 10-K annual report when a company changes the end of its fiscal year (e.g. due to a merger) leaving the company with a longer or shorter reporting period. 10-kt/a: an amended version of the 10-kt. 10-ksb: the annual report for small businesses, also known as penny stocks. 10-ksb/a: an amended version of the 10-ksb.", "constraints": { "enum": [ "10-k", "10-k/a", "10-k405", "10-k405/a", "10-kt", "10-kt/a", "10-ksb", "10-ksb/a" ] } }, { "name": "filing_date", "type": "date", "description": "Date on which the filing was submitted." }, { "name": "exhibit_21_version", "type": "string", "description": "Version of exhibit 21 submitted (if applicable).", "constraints": { "pattern": "^21\\.*\\d*$" } }, { "name": "report_date", "type": "date", "description": "Date reported." } ], "primaryKey": [ "filename_sec10k" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 8506885, "hash": "sha256:6cc48e3e7cd5e0cf4caf1b7b400dac7af6131e321d7a4c1cc4ef758df0ebf218" }, { "name": "out_censusdp1tract__counties", "type": "table", "description": "County-level summarized US Census demographic information, along with a geometry describing county boundaries.\n\n\nMost-recent data:\n 2010\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n Census DP1 -- Profile of General Demographic Characteristics\n\nPrimary key:\n county_id_fips\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nBased on the 2010 Census. Used as a convenient source of geospatial information within PUDL, but should not be treated as authoritative.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "censusdp1tract", "title": "Census DP1 -- Profile of General Demographic Characteristics", "path": "https://www.census.gov/geographies/mapping-files/2010/geo/tiger-data.html", "description": "US Census Demographic Profile 1 (DP1) County and Tract GeoDatabase.", "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127048", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15685568", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censusdp1tract.html" } ], "path": "out_censusdp1tract__counties.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "required": true, "pattern": "^\\d{5}$" } }, { "name": "geometry", "type": "string", "description": "Geospatial representation of the feature.", "geometry_format": "wkt" }, { "name": "county", "type": "string", "description": "County name." }, { "name": "functional_status_code_census", "type": "string", "description": "The functional status (FUNCSTAT) code defines the current functional status of a geographic entity. These codes can be found in the TIGER/Line products, gazetteer files, and other products.", "constraints": { "enum": [ "A", "B", "C", "E", "F", "G", "I", "L", "M", "N", "S", "T" ] } }, { "name": "land_area", "type": "number", "description": "Land area in square meters.", "unit": "square meters" }, { "name": "water_area", "type": "number", "description": "Water area in square meters.", "unit": "square meters" }, { "name": "internal_point_latitude", "type": "number", "description": "Internal point latitude in decimal degrees.", "unit": "degrees" }, { "name": "internal_point_longitude", "type": "number", "description": "Internal point longitude in decimal degrees.", "unit": "degrees" }, { "name": "shape_length", "type": "number", "description": "Length of the feature's perimeter in degrees.", "unit": "degrees" }, { "name": "shape_area", "type": "number", "description": "Area of the feature in square degrees.", "unit": "square degrees" }, { "name": "dp0010001", "type": "integer", "description": "DPSF1. Sex and age - Total population" }, { "name": "dp0010002", "type": "integer", "description": "DPSF1. Sex and age - Total population under 5 years" }, { "name": "dp0010003", "type": "integer", "description": "DPSF1. Sex and age - Total population 5 to 9 years" }, { "name": "dp0010004", "type": "integer", "description": "DPSF1. Sex and age - Total population 10 to 14 years" }, { "name": "dp0010005", "type": "integer", "description": "DPSF1. Sex and age - Total population 15 to 19 years" }, { "name": "dp0010006", "type": "integer", "description": "DPSF1. Sex and age - Total population 20 to 24 years" }, { "name": "dp0010007", "type": "integer", "description": "DPSF1. Sex and age - Total population 25 to 29 years" }, { "name": "dp0010008", "type": "integer", "description": "DPSF1. Sex and age - Total population 30 to 34 years" }, { "name": "dp0010009", "type": "integer", "description": "DPSF1. Sex and age - Total population 35 to 39 years" }, { "name": "dp0010010", "type": "integer", "description": "DPSF1. Sex and age - Total population 40 to 44 years" }, { "name": "dp0010011", "type": "integer", "description": "DPSF1. Sex and age - Total population 45 to 49 years" }, { "name": "dp0010012", "type": "integer", "description": "DPSF1. Sex and age - Total population 50 to 54 years" }, { "name": "dp0010013", "type": "integer", "description": "DPSF1. Sex and age - Total population 55 to 59 years" }, { "name": "dp0010014", "type": "integer", "description": "DPSF1. Sex and age - Total population 60 to 64 years" }, { "name": "dp0010015", "type": "integer", "description": "DPSF1. Sex and age - Total population 65 to 69 years" }, { "name": "dp0010016", "type": "integer", "description": "DPSF1. Sex and age - Total population 70 to 74 years" }, { "name": "dp0010017", "type": "integer", "description": "DPSF1. Sex and age - Total population 75 to 79 years" }, { "name": "dp0010018", "type": "integer", "description": "DPSF1. Sex and age - Total population 80 to 84 years" }, { "name": "dp0010019", "type": "integer", "description": "DPSF1. Sex and age - Total population 85 years and over" }, { "name": "dp0010020", "type": "integer", "description": "DPSF1. Sex and age - Male population total" }, { "name": "dp0010021", "type": "integer", "description": "DPSF1. Sex and age - Male population under 5 years" }, { "name": "dp0010022", "type": "integer", "description": "DPSF1. Sex and age - Male population 5 to 9 years" }, { "name": "dp0010023", "type": "integer", "description": "DPSF1. Sex and age - Male population 10 to 14 years" }, { "name": "dp0010024", "type": "integer", "description": "DPSF1. Sex and age - Male population 15 to 19 years" }, { "name": "dp0010025", "type": "integer", "description": "DPSF1. Sex and age - Male population 20 to 24 years" }, { "name": "dp0010026", "type": "integer", "description": "DPSF1. Sex and age - Male population 25 to 29 years" }, { "name": "dp0010027", "type": "integer", "description": "DPSF1. Sex and age - Male population 30 to 34 years" }, { "name": "dp0010028", "type": "integer", "description": "DPSF1. Sex and age - Male population 35 to 39 years" }, { "name": "dp0010029", "type": "integer", "description": "DPSF1. Sex and age - Male population 40 to 44 years" }, { "name": "dp0010030", "type": "integer", "description": "DPSF1. Sex and age - Male population 45 to 49 years" }, { "name": "dp0010031", "type": "integer", "description": "DPSF1. Sex and age - Male population 50 to 54 years" }, { "name": "dp0010032", "type": "integer", "description": "DPSF1. Sex and age - Male population 55 to 59 years" }, { "name": "dp0010033", "type": "integer", "description": "DPSF1. Sex and age - Male population 60 to 64 years" }, { "name": "dp0010034", "type": "integer", "description": "DPSF1. Sex and age - Male population 65 to 69 years" }, { "name": "dp0010035", "type": "integer", "description": "DPSF1. Sex and age - Male population 70 to 74 years" }, { "name": "dp0010036", "type": "integer", "description": "DPSF1. Sex and age - Male population 75 to 79 years" }, { "name": "dp0010037", "type": "integer", "description": "DPSF1. Sex and age - Male population 80 to 84 years" }, { "name": "dp0010038", "type": "integer", "description": "DPSF1. Sex and age - Male population 85 years and over" }, { "name": "dp0010039", "type": "integer", "description": "DPSF1. Sex and age - Female population total" }, { "name": "dp0010040", "type": "integer", "description": "DPSF1. Sex and age - Female population under 5 years" }, { "name": "dp0010041", "type": "integer", "description": "DPSF1. Sex and age - Female population 5 to 9 years" }, { "name": "dp0010042", "type": "integer", "description": "DPSF1. Sex and age - Female population 10 to 14 years" }, { "name": "dp0010043", "type": "integer", "description": "DPSF1. Sex and age - Female population 15 to 19 years" }, { "name": "dp0010044", "type": "integer", "description": "DPSF1. Sex and age - Female population 20 to 24 years" }, { "name": "dp0010045", "type": "integer", "description": "DPSF1. Sex and age - Female population 25 to 29 years" }, { "name": "dp0010046", "type": "integer", "description": "DPSF1. Sex and age - Female population 30 to 34 years" }, { "name": "dp0010047", "type": "integer", "description": "DPSF1. Sex and age - Female population 35 to 39 years" }, { "name": "dp0010048", "type": "integer", "description": "DPSF1. Sex and age - Female population 40 to 44 years" }, { "name": "dp0010049", "type": "integer", "description": "DPSF1. Sex and age - Female population 45 to 49 years" }, { "name": "dp0010050", "type": "integer", "description": "DPSF1. Sex and age - Female population 50 to 54 years" }, { "name": "dp0010051", "type": "integer", "description": "DPSF1. Sex and age - Female population 55 to 59 years" }, { "name": "dp0010052", "type": "integer", "description": "DPSF1. Sex and age - Female population 60 to 64 years" }, { "name": "dp0010053", "type": "integer", "description": "DPSF1. Sex and age - Female population 65 to 69 years" }, { "name": "dp0010054", "type": "integer", "description": "DPSF1. Sex and age - Female population 70 to 74 years" }, { "name": "dp0010055", "type": "integer", "description": "DPSF1. Sex and age - Female population 75 to 79 years" }, { "name": "dp0010056", "type": "integer", "description": "DPSF1. Sex and age - Female population 80 to 84 years" }, { "name": "dp0010057", "type": "integer", "description": "DPSF1. Sex and age - Female population 85 years and over" }, { "name": "dp0020001", "type": "number", "description": "DPSF2. Median age by sex - Both sexes" }, { "name": "dp0020002", "type": "number", "description": "DPSF2. Median age by sex - Male" }, { "name": "dp0020003", "type": "number", "description": "DPSF2. Median age by sex - Female" }, { "name": "dp0030001", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Total" }, { "name": "dp0030002", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Male" }, { "name": "dp0030003", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Female" }, { "name": "dp0040001", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Total" }, { "name": "dp0040002", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Male" }, { "name": "dp0040003", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Female" }, { "name": "dp0050001", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Total" }, { "name": "dp0050002", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Male" }, { "name": "dp0050003", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Female" }, { "name": "dp0060001", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Total" }, { "name": "dp0060002", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Male" }, { "name": "dp0060003", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Female" }, { "name": "dp0070001", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Total" }, { "name": "dp0070002", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Male" }, { "name": "dp0070003", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Female" }, { "name": "dp0080001", "type": "integer", "description": "DPSF8. Race - Total population" }, { "name": "dp0080002", "type": "integer", "description": "DPSF8. Race - Population of one race" }, { "name": "dp0080003", "type": "integer", "description": "DPSF8. Race - White" }, { "name": "dp0080004", "type": "integer", "description": "DPSF8. Race - Black or African American" }, { "name": "dp0080005", "type": "integer", "description": "DPSF8. Race - American Indian and Alaska Native" }, { "name": "dp0080006", "type": "integer", "description": "DPSF8. Race - Asian total" }, { "name": "dp0080007", "type": "integer", "description": "DPSF8. Race - Asian Indian" }, { "name": "dp0080008", "type": "integer", "description": "DPSF8. Race - Chinese" }, { "name": "dp0080009", "type": "integer", "description": "DPSF8. Race - Filipino" }, { "name": "dp0080010", "type": "integer", "description": "DPSF8. Race - Japanese" }, { "name": "dp0080011", "type": "integer", "description": "DPSF8. Race - Korean" }, { "name": "dp0080012", "type": "integer", "description": "DPSF8. Race - Vietnamese" }, { "name": "dp0080013", "type": "integer", "description": "DPSF8. Race - Other Asian" }, { "name": "dp0080014", "type": "integer", "description": "DPSF8. Race - Native Hawaiian and Other Pacific Islander total" }, { "name": "dp0080015", "type": "integer", "description": "DPSF8. Race - Native Hawaiian" }, { "name": "dp0080016", "type": "integer", "description": "DPSF8. Race - Guamanian or Chamorro" }, { "name": "dp0080017", "type": "integer", "description": "DPSF8. Race - Samoan" }, { "name": "dp0080018", "type": "integer", "description": "DPSF8. Race - Other Pacific Islander" }, { "name": "dp0080019", "type": "integer", "description": "DPSF8. Race - Some Other Race" }, { "name": "dp0080020", "type": "integer", "description": "DPSF8. Race - Population of Two or More Races" }, { "name": "dp0080021", "type": "integer", "description": "DPSF8. Race - White; American Indian and Alaska Native" }, { "name": "dp0080022", "type": "integer", "description": "DPSF8. Race - White; Asian" }, { "name": "dp0080023", "type": "integer", "description": "DPSF8. Race - White; Black or African American" }, { "name": "dp0080024", "type": "integer", "description": "DPSF8. Race - White; Some Other Race" }, { "name": "dp0090001", "type": "integer", "description": "DPSF9. Race (total races tallied) - White alone or in combination with one or more other races" }, { "name": "dp0090002", "type": "integer", "description": "DPSF9. Race (total races tallied) - Black or African American alone or in combination with one or more other races" }, { "name": "dp0090003", "type": "integer", "description": "DPSF9. Race (total races tallied) - American Indian and Alaska Native alone or in combination with one or more other races" }, { "name": "dp0090004", "type": "integer", "description": "DPSF9. Race (total races tallied) - Asian alone or in combination with one or more other races" }, { "name": "dp0090005", "type": "integer", "description": "DPSF9. Race (total races tallied) - Native Hawaiian and Other Pacific Islander alone or in combination with one or more other races" }, { "name": "dp0090006", "type": "integer", "description": "DPSF9. Race (total races tallied) - Some Other Race alone or in combination with one or more other races" }, { "name": "dp0100001", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Total population" }, { "name": "dp0100002", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Hispanic or Latino (of any race)" }, { "name": "dp0100003", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Mexican" }, { "name": "dp0100004", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Puerto Rican" }, { "name": "dp0100005", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Cuban" }, { "name": "dp0100006", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Other Hispanic or Latino" }, { "name": "dp0100007", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Not Hispanic or Latino" }, { "name": "dp0110001", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Total population" }, { "name": "dp0110002", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino total" }, { "name": "dp0110003", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: White alone" }, { "name": "dp0110004", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Black or African American alone" }, { "name": "dp0110005", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: American Indian and Alaska Native alone" }, { "name": "dp0110006", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Asian alone" }, { "name": "dp0110007", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Native Hawaiian and Other Pacific Islander alone" }, { "name": "dp0110008", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Some Other Race alone" }, { "name": "dp0110009", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Two or More Races" }, { "name": "dp0110010", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino total" }, { "name": "dp0110011", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: White alone" }, { "name": "dp0110012", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Black or African American alone" }, { "name": "dp0110013", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: American Indian and Alaska Native alone" }, { "name": "dp0110014", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Asian alone" }, { "name": "dp0110015", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Native Hawaiian and Other Pacific Islander alone" }, { "name": "dp0110016", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Some Other Race alone" }, { "name": "dp0110017", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Two or More Races" }, { "name": "dp0120001", "type": "integer", "description": "DPSF12. Relationship - Total population" }, { "name": "dp0120002", "type": "integer", "description": "DPSF12. Relationship - In households" }, { "name": "dp0120003", "type": "integer", "description": "DPSF12. Relationship - Householder" }, { "name": "dp0120004", "type": "integer", "description": "DPSF12. Relationship - Spouse" }, { "name": "dp0120005", "type": "integer", "description": "DPSF12. Relationship - Child" }, { "name": "dp0120006", "type": "integer", "description": "DPSF12. Relationship - Own child under 18 years" }, { "name": "dp0120007", "type": "integer", "description": "DPSF12. Relationship - Other relatives" }, { "name": "dp0120008", "type": "integer", "description": "DPSF12. Relationship - Other relatives under 18 years" }, { "name": "dp0120009", "type": "integer", "description": "DPSF12. Relationship - Other relatives 65 years and over" }, { "name": "dp0120010", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives" }, { "name": "dp0120011", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives under 18 years" }, { "name": "dp0120012", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives 65 years and over" }, { "name": "dp0120013", "type": "integer", "description": "DPSF12. Relationship - Unmarried partner" }, { "name": "dp0120014", "type": "integer", "description": "DPSF12. Relationship - In group quarters" }, { "name": "dp0120015", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population" }, { "name": "dp0120016", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population: Male" }, { "name": "dp0120017", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population: Female" }, { "name": "dp0120018", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population" }, { "name": "dp0120019", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population: Male" }, { "name": "dp0120020", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population: Female" }, { "name": "dp0130001", "type": "integer", "description": "DPSF13. Households by type - Total households" }, { "name": "dp0130002", "type": "integer", "description": "DPSF13. Households by type - Family households (families)" }, { "name": "dp0130003", "type": "integer", "description": "DPSF13. Households by type - Family households with own children under 18 years" }, { "name": "dp0130004", "type": "integer", "description": "DPSF13. Households by type - Husband-wife family" }, { "name": "dp0130005", "type": "integer", "description": "DPSF13. Households by type - Husband-wife family with own children under 18 years" }, { "name": "dp0130006", "type": "integer", "description": "DPSF13. Households by type - Male householder, no wife present" }, { "name": "dp0130007", "type": "integer", "description": "DPSF13. Households by type - Male householder, no wife present, with own children under 18 years" }, { "name": "dp0130008", "type": "integer", "description": "DPSF13. Households by type - Female householder, no husband present" }, { "name": "dp0130009", "type": "integer", "description": "DPSF13. Households by type - Female householder, no husband present, with own children under 18 years" }, { "name": "dp0130010", "type": "integer", "description": "DPSF13. Households by type - Nonfamily households" }, { "name": "dp0130011", "type": "integer", "description": "DPSF13. Households by type - Householder living alone" }, { "name": "dp0130012", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Male" }, { "name": "dp0130013", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Male 65 years and over" }, { "name": "dp0130014", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Female" }, { "name": "dp0130015", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Female 65 years and over" }, { "name": "dp0140001", "type": "integer", "description": "DPSF14. Households with individuals under 18 years - Total" }, { "name": "dp0150001", "type": "integer", "description": "DPSF15. Households with individuals 65 years and over - Total" }, { "name": "dp0160001", "type": "number", "description": "DPSF16. Average household size - Average household size" }, { "name": "dp0170001", "type": "number", "description": "DPSF17. Average family size - Average family size" }, { "name": "dp0180001", "type": "integer", "description": "DPSF18. Housing occupancy - Total housing units" }, { "name": "dp0180002", "type": "integer", "description": "DPSF18. Housing occupancy - Occupied housing units" }, { "name": "dp0180003", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units" }, { "name": "dp0180004", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for rent" }, { "name": "dp0180005", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units rented, not occupied" }, { "name": "dp0180006", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for sale only" }, { "name": "dp0180007", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units sold, not occupied" }, { "name": "dp0180008", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for seasonal, recreational, or occasional use" }, { "name": "dp0180009", "type": "integer", "description": "DPSF18. Housing occupancy - All other vacant housing units" }, { "name": "dp0190001", "type": "number", "description": "DPSF19. Homeowner vacancy rate - Homeowner vacancy rate (percent)" }, { "name": "dp0200001", "type": "number", "description": "DPSF20. Rental vacancy rate - Rental vacancy rate (percent)" }, { "name": "dp0210001", "type": "integer", "description": "DPSF21. Housing tenure - Total occupied housing units" }, { "name": "dp0210002", "type": "integer", "description": "DPSF21. Housing tenure - Owner-occupied housing units" }, { "name": "dp0210003", "type": "integer", "description": "DPSF21. Housing tenure - Renter-occupied housing units" }, { "name": "dp0220001", "type": "integer", "description": "DPSF22. Population in occupied housing units by tenure - Owner-occupied housing units" }, { "name": "dp0220002", "type": "integer", "description": "DPSF22. Population in occupied housing units by tenure - Renter-occupied housing units" }, { "name": "dp0230001", "type": "number", "description": "DPSF23. Average household size by tenure - Owner occupied" }, { "name": "dp0230002", "type": "number", "description": "DPSF23. Average household size by tenure - Renter occupied" } ], "primaryKey": [ "county_id_fips" ], "foreignKeys": [] }, "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 112225914, "hash": "sha256:2a5035a76f9b45469fc4ffc2a9c1ad866464e4c01cd3ee58c5c4985f101ee9ec" }, { "name": "out_censusdp1tract__states", "type": "table", "description": "State-level summarized US Census demographic information, along with a geometry describing state boundaries.\n\n\nMost-recent data:\n 2010\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n Census DP1 -- Profile of General Demographic Characteristics\n\nPrimary key:\n state_id_fips\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nBased on the 2010 Census. Used as a convenient source of geospatial information within PUDL, but should not be treated as authoritative.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "censusdp1tract", "title": "Census DP1 -- Profile of General Demographic Characteristics", "path": "https://www.census.gov/geographies/mapping-files/2010/geo/tiger-data.html", "description": "US Census Demographic Profile 1 (DP1) County and Tract GeoDatabase.", "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127048", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15685568", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censusdp1tract.html" } ], "path": "out_censusdp1tract__states.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "required": true, "pattern": "^\\d{2}$" } }, { "name": "geometry", "type": "string", "description": "Geospatial representation of the feature.", "geometry_format": "wkt" }, { "name": "state_name", "type": "string", "description": "Full name of the state." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "land_area", "type": "number", "description": "Land area in square meters.", "unit": "square meters" }, { "name": "water_area", "type": "number", "description": "Water area in square meters.", "unit": "square meters" }, { "name": "internal_point_latitude", "type": "number", "description": "Internal point latitude in decimal degrees.", "unit": "degrees" }, { "name": "internal_point_longitude", "type": "number", "description": "Internal point longitude in decimal degrees.", "unit": "degrees" }, { "name": "shape_length", "type": "number", "description": "Length of the feature's perimeter in degrees.", "unit": "degrees" }, { "name": "shape_area", "type": "number", "description": "Area of the feature in square degrees.", "unit": "square degrees" }, { "name": "dp0010001", "type": "integer", "description": "DPSF1. Sex and age - Total population" }, { "name": "dp0010002", "type": "integer", "description": "DPSF1. Sex and age - Total population under 5 years" }, { "name": "dp0010003", "type": "integer", "description": "DPSF1. Sex and age - Total population 5 to 9 years" }, { "name": "dp0010004", "type": "integer", "description": "DPSF1. Sex and age - Total population 10 to 14 years" }, { "name": "dp0010005", "type": "integer", "description": "DPSF1. Sex and age - Total population 15 to 19 years" }, { "name": "dp0010006", "type": "integer", "description": "DPSF1. Sex and age - Total population 20 to 24 years" }, { "name": "dp0010007", "type": "integer", "description": "DPSF1. Sex and age - Total population 25 to 29 years" }, { "name": "dp0010008", "type": "integer", "description": "DPSF1. Sex and age - Total population 30 to 34 years" }, { "name": "dp0010009", "type": "integer", "description": "DPSF1. Sex and age - Total population 35 to 39 years" }, { "name": "dp0010010", "type": "integer", "description": "DPSF1. Sex and age - Total population 40 to 44 years" }, { "name": "dp0010011", "type": "integer", "description": "DPSF1. Sex and age - Total population 45 to 49 years" }, { "name": "dp0010012", "type": "integer", "description": "DPSF1. Sex and age - Total population 50 to 54 years" }, { "name": "dp0010013", "type": "integer", "description": "DPSF1. Sex and age - Total population 55 to 59 years" }, { "name": "dp0010014", "type": "integer", "description": "DPSF1. Sex and age - Total population 60 to 64 years" }, { "name": "dp0010015", "type": "integer", "description": "DPSF1. Sex and age - Total population 65 to 69 years" }, { "name": "dp0010016", "type": "integer", "description": "DPSF1. Sex and age - Total population 70 to 74 years" }, { "name": "dp0010017", "type": "integer", "description": "DPSF1. Sex and age - Total population 75 to 79 years" }, { "name": "dp0010018", "type": "integer", "description": "DPSF1. Sex and age - Total population 80 to 84 years" }, { "name": "dp0010019", "type": "integer", "description": "DPSF1. Sex and age - Total population 85 years and over" }, { "name": "dp0010020", "type": "integer", "description": "DPSF1. Sex and age - Male population total" }, { "name": "dp0010021", "type": "integer", "description": "DPSF1. Sex and age - Male population under 5 years" }, { "name": "dp0010022", "type": "integer", "description": "DPSF1. Sex and age - Male population 5 to 9 years" }, { "name": "dp0010023", "type": "integer", "description": "DPSF1. Sex and age - Male population 10 to 14 years" }, { "name": "dp0010024", "type": "integer", "description": "DPSF1. Sex and age - Male population 15 to 19 years" }, { "name": "dp0010025", "type": "integer", "description": "DPSF1. Sex and age - Male population 20 to 24 years" }, { "name": "dp0010026", "type": "integer", "description": "DPSF1. Sex and age - Male population 25 to 29 years" }, { "name": "dp0010027", "type": "integer", "description": "DPSF1. Sex and age - Male population 30 to 34 years" }, { "name": "dp0010028", "type": "integer", "description": "DPSF1. Sex and age - Male population 35 to 39 years" }, { "name": "dp0010029", "type": "integer", "description": "DPSF1. Sex and age - Male population 40 to 44 years" }, { "name": "dp0010030", "type": "integer", "description": "DPSF1. Sex and age - Male population 45 to 49 years" }, { "name": "dp0010031", "type": "integer", "description": "DPSF1. Sex and age - Male population 50 to 54 years" }, { "name": "dp0010032", "type": "integer", "description": "DPSF1. Sex and age - Male population 55 to 59 years" }, { "name": "dp0010033", "type": "integer", "description": "DPSF1. Sex and age - Male population 60 to 64 years" }, { "name": "dp0010034", "type": "integer", "description": "DPSF1. Sex and age - Male population 65 to 69 years" }, { "name": "dp0010035", "type": "integer", "description": "DPSF1. Sex and age - Male population 70 to 74 years" }, { "name": "dp0010036", "type": "integer", "description": "DPSF1. Sex and age - Male population 75 to 79 years" }, { "name": "dp0010037", "type": "integer", "description": "DPSF1. Sex and age - Male population 80 to 84 years" }, { "name": "dp0010038", "type": "integer", "description": "DPSF1. Sex and age - Male population 85 years and over" }, { "name": "dp0010039", "type": "integer", "description": "DPSF1. Sex and age - Female population total" }, { "name": "dp0010040", "type": "integer", "description": "DPSF1. Sex and age - Female population under 5 years" }, { "name": "dp0010041", "type": "integer", "description": "DPSF1. Sex and age - Female population 5 to 9 years" }, { "name": "dp0010042", "type": "integer", "description": "DPSF1. Sex and age - Female population 10 to 14 years" }, { "name": "dp0010043", "type": "integer", "description": "DPSF1. Sex and age - Female population 15 to 19 years" }, { "name": "dp0010044", "type": "integer", "description": "DPSF1. Sex and age - Female population 20 to 24 years" }, { "name": "dp0010045", "type": "integer", "description": "DPSF1. Sex and age - Female population 25 to 29 years" }, { "name": "dp0010046", "type": "integer", "description": "DPSF1. Sex and age - Female population 30 to 34 years" }, { "name": "dp0010047", "type": "integer", "description": "DPSF1. Sex and age - Female population 35 to 39 years" }, { "name": "dp0010048", "type": "integer", "description": "DPSF1. Sex and age - Female population 40 to 44 years" }, { "name": "dp0010049", "type": "integer", "description": "DPSF1. Sex and age - Female population 45 to 49 years" }, { "name": "dp0010050", "type": "integer", "description": "DPSF1. Sex and age - Female population 50 to 54 years" }, { "name": "dp0010051", "type": "integer", "description": "DPSF1. Sex and age - Female population 55 to 59 years" }, { "name": "dp0010052", "type": "integer", "description": "DPSF1. Sex and age - Female population 60 to 64 years" }, { "name": "dp0010053", "type": "integer", "description": "DPSF1. Sex and age - Female population 65 to 69 years" }, { "name": "dp0010054", "type": "integer", "description": "DPSF1. Sex and age - Female population 70 to 74 years" }, { "name": "dp0010055", "type": "integer", "description": "DPSF1. Sex and age - Female population 75 to 79 years" }, { "name": "dp0010056", "type": "integer", "description": "DPSF1. Sex and age - Female population 80 to 84 years" }, { "name": "dp0010057", "type": "integer", "description": "DPSF1. Sex and age - Female population 85 years and over" }, { "name": "dp0020001", "type": "number", "description": "DPSF2. Median age by sex - Both sexes" }, { "name": "dp0020002", "type": "number", "description": "DPSF2. Median age by sex - Male" }, { "name": "dp0020003", "type": "number", "description": "DPSF2. Median age by sex - Female" }, { "name": "dp0030001", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Total" }, { "name": "dp0030002", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Male" }, { "name": "dp0030003", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Female" }, { "name": "dp0040001", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Total" }, { "name": "dp0040002", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Male" }, { "name": "dp0040003", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Female" }, { "name": "dp0050001", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Total" }, { "name": "dp0050002", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Male" }, { "name": "dp0050003", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Female" }, { "name": "dp0060001", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Total" }, { "name": "dp0060002", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Male" }, { "name": "dp0060003", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Female" }, { "name": "dp0070001", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Total" }, { "name": "dp0070002", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Male" }, { "name": "dp0070003", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Female" }, { "name": "dp0080001", "type": "integer", "description": "DPSF8. Race - Total population" }, { "name": "dp0080002", "type": "integer", "description": "DPSF8. Race - Population of one race" }, { "name": "dp0080003", "type": "integer", "description": "DPSF8. Race - White" }, { "name": "dp0080004", "type": "integer", "description": "DPSF8. Race - Black or African American" }, { "name": "dp0080005", "type": "integer", "description": "DPSF8. Race - American Indian and Alaska Native" }, { "name": "dp0080006", "type": "integer", "description": "DPSF8. Race - Asian total" }, { "name": "dp0080007", "type": "integer", "description": "DPSF8. Race - Asian Indian" }, { "name": "dp0080008", "type": "integer", "description": "DPSF8. Race - Chinese" }, { "name": "dp0080009", "type": "integer", "description": "DPSF8. Race - Filipino" }, { "name": "dp0080010", "type": "integer", "description": "DPSF8. Race - Japanese" }, { "name": "dp0080011", "type": "integer", "description": "DPSF8. Race - Korean" }, { "name": "dp0080012", "type": "integer", "description": "DPSF8. Race - Vietnamese" }, { "name": "dp0080013", "type": "integer", "description": "DPSF8. Race - Other Asian" }, { "name": "dp0080014", "type": "integer", "description": "DPSF8. Race - Native Hawaiian and Other Pacific Islander total" }, { "name": "dp0080015", "type": "integer", "description": "DPSF8. Race - Native Hawaiian" }, { "name": "dp0080016", "type": "integer", "description": "DPSF8. Race - Guamanian or Chamorro" }, { "name": "dp0080017", "type": "integer", "description": "DPSF8. Race - Samoan" }, { "name": "dp0080018", "type": "integer", "description": "DPSF8. Race - Other Pacific Islander" }, { "name": "dp0080019", "type": "integer", "description": "DPSF8. Race - Some Other Race" }, { "name": "dp0080020", "type": "integer", "description": "DPSF8. Race - Population of Two or More Races" }, { "name": "dp0080021", "type": "integer", "description": "DPSF8. Race - White; American Indian and Alaska Native" }, { "name": "dp0080022", "type": "integer", "description": "DPSF8. Race - White; Asian" }, { "name": "dp0080023", "type": "integer", "description": "DPSF8. Race - White; Black or African American" }, { "name": "dp0080024", "type": "integer", "description": "DPSF8. Race - White; Some Other Race" }, { "name": "dp0090001", "type": "integer", "description": "DPSF9. Race (total races tallied) - White alone or in combination with one or more other races" }, { "name": "dp0090002", "type": "integer", "description": "DPSF9. Race (total races tallied) - Black or African American alone or in combination with one or more other races" }, { "name": "dp0090003", "type": "integer", "description": "DPSF9. Race (total races tallied) - American Indian and Alaska Native alone or in combination with one or more other races" }, { "name": "dp0090004", "type": "integer", "description": "DPSF9. Race (total races tallied) - Asian alone or in combination with one or more other races" }, { "name": "dp0090005", "type": "integer", "description": "DPSF9. Race (total races tallied) - Native Hawaiian and Other Pacific Islander alone or in combination with one or more other races" }, { "name": "dp0090006", "type": "integer", "description": "DPSF9. Race (total races tallied) - Some Other Race alone or in combination with one or more other races" }, { "name": "dp0100001", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Total population" }, { "name": "dp0100002", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Hispanic or Latino (of any race)" }, { "name": "dp0100003", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Mexican" }, { "name": "dp0100004", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Puerto Rican" }, { "name": "dp0100005", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Cuban" }, { "name": "dp0100006", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Other Hispanic or Latino" }, { "name": "dp0100007", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Not Hispanic or Latino" }, { "name": "dp0110001", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Total population" }, { "name": "dp0110002", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino total" }, { "name": "dp0110003", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: White alone" }, { "name": "dp0110004", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Black or African American alone" }, { "name": "dp0110005", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: American Indian and Alaska Native alone" }, { "name": "dp0110006", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Asian alone" }, { "name": "dp0110007", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Native Hawaiian and Other Pacific Islander alone" }, { "name": "dp0110008", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Some Other Race alone" }, { "name": "dp0110009", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Two or More Races" }, { "name": "dp0110010", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino total" }, { "name": "dp0110011", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: White alone" }, { "name": "dp0110012", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Black or African American alone" }, { "name": "dp0110013", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: American Indian and Alaska Native alone" }, { "name": "dp0110014", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Asian alone" }, { "name": "dp0110015", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Native Hawaiian and Other Pacific Islander alone" }, { "name": "dp0110016", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Some Other Race alone" }, { "name": "dp0110017", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Two or More Races" }, { "name": "dp0120001", "type": "integer", "description": "DPSF12. Relationship - Total population" }, { "name": "dp0120002", "type": "integer", "description": "DPSF12. Relationship - In households" }, { "name": "dp0120003", "type": "integer", "description": "DPSF12. Relationship - Householder" }, { "name": "dp0120004", "type": "integer", "description": "DPSF12. Relationship - Spouse" }, { "name": "dp0120005", "type": "integer", "description": "DPSF12. Relationship - Child" }, { "name": "dp0120006", "type": "integer", "description": "DPSF12. Relationship - Own child under 18 years" }, { "name": "dp0120007", "type": "integer", "description": "DPSF12. Relationship - Other relatives" }, { "name": "dp0120008", "type": "integer", "description": "DPSF12. Relationship - Other relatives under 18 years" }, { "name": "dp0120009", "type": "integer", "description": "DPSF12. Relationship - Other relatives 65 years and over" }, { "name": "dp0120010", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives" }, { "name": "dp0120011", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives under 18 years" }, { "name": "dp0120012", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives 65 years and over" }, { "name": "dp0120013", "type": "integer", "description": "DPSF12. Relationship - Unmarried partner" }, { "name": "dp0120014", "type": "integer", "description": "DPSF12. Relationship - In group quarters" }, { "name": "dp0120015", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population" }, { "name": "dp0120016", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population: Male" }, { "name": "dp0120017", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population: Female" }, { "name": "dp0120018", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population" }, { "name": "dp0120019", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population: Male" }, { "name": "dp0120020", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population: Female" }, { "name": "dp0130001", "type": "integer", "description": "DPSF13. Households by type - Total households" }, { "name": "dp0130002", "type": "integer", "description": "DPSF13. Households by type - Family households (families)" }, { "name": "dp0130003", "type": "integer", "description": "DPSF13. Households by type - Family households with own children under 18 years" }, { "name": "dp0130004", "type": "integer", "description": "DPSF13. Households by type - Husband-wife family" }, { "name": "dp0130005", "type": "integer", "description": "DPSF13. Households by type - Husband-wife family with own children under 18 years" }, { "name": "dp0130006", "type": "integer", "description": "DPSF13. Households by type - Male householder, no wife present" }, { "name": "dp0130007", "type": "integer", "description": "DPSF13. Households by type - Male householder, no wife present, with own children under 18 years" }, { "name": "dp0130008", "type": "integer", "description": "DPSF13. Households by type - Female householder, no husband present" }, { "name": "dp0130009", "type": "integer", "description": "DPSF13. Households by type - Female householder, no husband present, with own children under 18 years" }, { "name": "dp0130010", "type": "integer", "description": "DPSF13. Households by type - Nonfamily households" }, { "name": "dp0130011", "type": "integer", "description": "DPSF13. Households by type - Householder living alone" }, { "name": "dp0130012", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Male" }, { "name": "dp0130013", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Male 65 years and over" }, { "name": "dp0130014", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Female" }, { "name": "dp0130015", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Female 65 years and over" }, { "name": "dp0140001", "type": "integer", "description": "DPSF14. Households with individuals under 18 years - Total" }, { "name": "dp0150001", "type": "integer", "description": "DPSF15. Households with individuals 65 years and over - Total" }, { "name": "dp0160001", "type": "number", "description": "DPSF16. Average household size - Average household size" }, { "name": "dp0170001", "type": "number", "description": "DPSF17. Average family size - Average family size" }, { "name": "dp0180001", "type": "integer", "description": "DPSF18. Housing occupancy - Total housing units" }, { "name": "dp0180002", "type": "integer", "description": "DPSF18. Housing occupancy - Occupied housing units" }, { "name": "dp0180003", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units" }, { "name": "dp0180004", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for rent" }, { "name": "dp0180005", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units rented, not occupied" }, { "name": "dp0180006", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for sale only" }, { "name": "dp0180007", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units sold, not occupied" }, { "name": "dp0180008", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for seasonal, recreational, or occasional use" }, { "name": "dp0180009", "type": "integer", "description": "DPSF18. Housing occupancy - All other vacant housing units" }, { "name": "dp0190001", "type": "number", "description": "DPSF19. Homeowner vacancy rate - Homeowner vacancy rate (percent)" }, { "name": "dp0200001", "type": "number", "description": "DPSF20. Rental vacancy rate - Rental vacancy rate (percent)" }, { "name": "dp0210001", "type": "integer", "description": "DPSF21. Housing tenure - Total occupied housing units" }, { "name": "dp0210002", "type": "integer", "description": "DPSF21. Housing tenure - Owner-occupied housing units" }, { "name": "dp0210003", "type": "integer", "description": "DPSF21. Housing tenure - Renter-occupied housing units" }, { "name": "dp0220001", "type": "integer", "description": "DPSF22. Population in occupied housing units by tenure - Owner-occupied housing units" }, { "name": "dp0220002", "type": "integer", "description": "DPSF22. Population in occupied housing units by tenure - Renter-occupied housing units" }, { "name": "dp0230001", "type": "number", "description": "DPSF23. Average household size by tenure - Owner occupied" }, { "name": "dp0230002", "type": "number", "description": "DPSF23. Average household size by tenure - Renter occupied" } ], "primaryKey": [ "state_id_fips" ], "foreignKeys": [] }, "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 13066871, "hash": "sha256:044a1e9493a0df45e3de40919ac2ee668adbdfa9b59fd6f75fe0a48d7e705f7e" }, { "name": "out_censusdp1tract__tracts", "type": "table", "description": "Census tract-level summarized US Census demographic information, along with a geometry describing tract boundaries.\n\n\nMost-recent data:\n 2010\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n Census DP1 -- Profile of General Demographic Characteristics\n\nPrimary key:\n tract_id_fips\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nBased on the 2010 Census. Used as a convenient source of geospatial information within PUDL, but should not be treated as authoritative.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "censusdp1tract", "title": "Census DP1 -- Profile of General Demographic Characteristics", "path": "https://www.census.gov/geographies/mapping-files/2010/geo/tiger-data.html", "description": "US Census Demographic Profile 1 (DP1) County and Tract GeoDatabase.", "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127048", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15685568", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censusdp1tract.html" } ], "path": "out_censusdp1tract__tracts.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "tract_id_fips", "type": "string", "description": "Census tract 10-digit FIPS code", "constraints": { "required": true } }, { "name": "geometry", "type": "string", "description": "Geospatial representation of the feature.", "geometry_format": "wkt" }, { "name": "tract_name", "type": "string", "description": "Census tract legal/statistical area description" }, { "name": "land_area", "type": "number", "description": "Land area in square meters.", "unit": "square meters" }, { "name": "water_area", "type": "number", "description": "Water area in square meters.", "unit": "square meters" }, { "name": "internal_point_latitude", "type": "number", "description": "Internal point latitude in decimal degrees.", "unit": "degrees" }, { "name": "internal_point_longitude", "type": "number", "description": "Internal point longitude in decimal degrees.", "unit": "degrees" }, { "name": "shape_length", "type": "number", "description": "Length of the feature's perimeter in degrees.", "unit": "degrees" }, { "name": "shape_area", "type": "number", "description": "Area of the feature in square degrees.", "unit": "square degrees" }, { "name": "dp0010001", "type": "integer", "description": "DPSF1. Sex and age - Total population" }, { "name": "dp0010002", "type": "integer", "description": "DPSF1. Sex and age - Total population under 5 years" }, { "name": "dp0010003", "type": "integer", "description": "DPSF1. Sex and age - Total population 5 to 9 years" }, { "name": "dp0010004", "type": "integer", "description": "DPSF1. Sex and age - Total population 10 to 14 years" }, { "name": "dp0010005", "type": "integer", "description": "DPSF1. Sex and age - Total population 15 to 19 years" }, { "name": "dp0010006", "type": "integer", "description": "DPSF1. Sex and age - Total population 20 to 24 years" }, { "name": "dp0010007", "type": "integer", "description": "DPSF1. Sex and age - Total population 25 to 29 years" }, { "name": "dp0010008", "type": "integer", "description": "DPSF1. Sex and age - Total population 30 to 34 years" }, { "name": "dp0010009", "type": "integer", "description": "DPSF1. Sex and age - Total population 35 to 39 years" }, { "name": "dp0010010", "type": "integer", "description": "DPSF1. Sex and age - Total population 40 to 44 years" }, { "name": "dp0010011", "type": "integer", "description": "DPSF1. Sex and age - Total population 45 to 49 years" }, { "name": "dp0010012", "type": "integer", "description": "DPSF1. Sex and age - Total population 50 to 54 years" }, { "name": "dp0010013", "type": "integer", "description": "DPSF1. Sex and age - Total population 55 to 59 years" }, { "name": "dp0010014", "type": "integer", "description": "DPSF1. Sex and age - Total population 60 to 64 years" }, { "name": "dp0010015", "type": "integer", "description": "DPSF1. Sex and age - Total population 65 to 69 years" }, { "name": "dp0010016", "type": "integer", "description": "DPSF1. Sex and age - Total population 70 to 74 years" }, { "name": "dp0010017", "type": "integer", "description": "DPSF1. Sex and age - Total population 75 to 79 years" }, { "name": "dp0010018", "type": "integer", "description": "DPSF1. Sex and age - Total population 80 to 84 years" }, { "name": "dp0010019", "type": "integer", "description": "DPSF1. Sex and age - Total population 85 years and over" }, { "name": "dp0010020", "type": "integer", "description": "DPSF1. Sex and age - Male population total" }, { "name": "dp0010021", "type": "integer", "description": "DPSF1. Sex and age - Male population under 5 years" }, { "name": "dp0010022", "type": "integer", "description": "DPSF1. Sex and age - Male population 5 to 9 years" }, { "name": "dp0010023", "type": "integer", "description": "DPSF1. Sex and age - Male population 10 to 14 years" }, { "name": "dp0010024", "type": "integer", "description": "DPSF1. Sex and age - Male population 15 to 19 years" }, { "name": "dp0010025", "type": "integer", "description": "DPSF1. Sex and age - Male population 20 to 24 years" }, { "name": "dp0010026", "type": "integer", "description": "DPSF1. Sex and age - Male population 25 to 29 years" }, { "name": "dp0010027", "type": "integer", "description": "DPSF1. Sex and age - Male population 30 to 34 years" }, { "name": "dp0010028", "type": "integer", "description": "DPSF1. Sex and age - Male population 35 to 39 years" }, { "name": "dp0010029", "type": "integer", "description": "DPSF1. Sex and age - Male population 40 to 44 years" }, { "name": "dp0010030", "type": "integer", "description": "DPSF1. Sex and age - Male population 45 to 49 years" }, { "name": "dp0010031", "type": "integer", "description": "DPSF1. Sex and age - Male population 50 to 54 years" }, { "name": "dp0010032", "type": "integer", "description": "DPSF1. Sex and age - Male population 55 to 59 years" }, { "name": "dp0010033", "type": "integer", "description": "DPSF1. Sex and age - Male population 60 to 64 years" }, { "name": "dp0010034", "type": "integer", "description": "DPSF1. Sex and age - Male population 65 to 69 years" }, { "name": "dp0010035", "type": "integer", "description": "DPSF1. Sex and age - Male population 70 to 74 years" }, { "name": "dp0010036", "type": "integer", "description": "DPSF1. Sex and age - Male population 75 to 79 years" }, { "name": "dp0010037", "type": "integer", "description": "DPSF1. Sex and age - Male population 80 to 84 years" }, { "name": "dp0010038", "type": "integer", "description": "DPSF1. Sex and age - Male population 85 years and over" }, { "name": "dp0010039", "type": "integer", "description": "DPSF1. Sex and age - Female population total" }, { "name": "dp0010040", "type": "integer", "description": "DPSF1. Sex and age - Female population under 5 years" }, { "name": "dp0010041", "type": "integer", "description": "DPSF1. Sex and age - Female population 5 to 9 years" }, { "name": "dp0010042", "type": "integer", "description": "DPSF1. Sex and age - Female population 10 to 14 years" }, { "name": "dp0010043", "type": "integer", "description": "DPSF1. Sex and age - Female population 15 to 19 years" }, { "name": "dp0010044", "type": "integer", "description": "DPSF1. Sex and age - Female population 20 to 24 years" }, { "name": "dp0010045", "type": "integer", "description": "DPSF1. Sex and age - Female population 25 to 29 years" }, { "name": "dp0010046", "type": "integer", "description": "DPSF1. Sex and age - Female population 30 to 34 years" }, { "name": "dp0010047", "type": "integer", "description": "DPSF1. Sex and age - Female population 35 to 39 years" }, { "name": "dp0010048", "type": "integer", "description": "DPSF1. Sex and age - Female population 40 to 44 years" }, { "name": "dp0010049", "type": "integer", "description": "DPSF1. Sex and age - Female population 45 to 49 years" }, { "name": "dp0010050", "type": "integer", "description": "DPSF1. Sex and age - Female population 50 to 54 years" }, { "name": "dp0010051", "type": "integer", "description": "DPSF1. Sex and age - Female population 55 to 59 years" }, { "name": "dp0010052", "type": "integer", "description": "DPSF1. Sex and age - Female population 60 to 64 years" }, { "name": "dp0010053", "type": "integer", "description": "DPSF1. Sex and age - Female population 65 to 69 years" }, { "name": "dp0010054", "type": "integer", "description": "DPSF1. Sex and age - Female population 70 to 74 years" }, { "name": "dp0010055", "type": "integer", "description": "DPSF1. Sex and age - Female population 75 to 79 years" }, { "name": "dp0010056", "type": "integer", "description": "DPSF1. Sex and age - Female population 80 to 84 years" }, { "name": "dp0010057", "type": "integer", "description": "DPSF1. Sex and age - Female population 85 years and over" }, { "name": "dp0020001", "type": "number", "description": "DPSF2. Median age by sex - Both sexes" }, { "name": "dp0020002", "type": "number", "description": "DPSF2. Median age by sex - Male" }, { "name": "dp0020003", "type": "number", "description": "DPSF2. Median age by sex - Female" }, { "name": "dp0030001", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Total" }, { "name": "dp0030002", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Male" }, { "name": "dp0030003", "type": "integer", "description": "DPSF3. Sex for population 16 years and over - Female" }, { "name": "dp0040001", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Total" }, { "name": "dp0040002", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Male" }, { "name": "dp0040003", "type": "integer", "description": "DPSF4. Sex for population 18 years and over - Female" }, { "name": "dp0050001", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Total" }, { "name": "dp0050002", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Male" }, { "name": "dp0050003", "type": "integer", "description": "DPSF5. Sex for population 21 years and over - Female" }, { "name": "dp0060001", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Total" }, { "name": "dp0060002", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Male" }, { "name": "dp0060003", "type": "integer", "description": "DPSF6. Sex for population 62 years and over - Female" }, { "name": "dp0070001", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Total" }, { "name": "dp0070002", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Male" }, { "name": "dp0070003", "type": "integer", "description": "DPSF7. Sex for population 65 years and over - Female" }, { "name": "dp0080001", "type": "integer", "description": "DPSF8. Race - Total population" }, { "name": "dp0080002", "type": "integer", "description": "DPSF8. Race - Population of one race" }, { "name": "dp0080003", "type": "integer", "description": "DPSF8. Race - White" }, { "name": "dp0080004", "type": "integer", "description": "DPSF8. Race - Black or African American" }, { "name": "dp0080005", "type": "integer", "description": "DPSF8. Race - American Indian and Alaska Native" }, { "name": "dp0080006", "type": "integer", "description": "DPSF8. Race - Asian total" }, { "name": "dp0080007", "type": "integer", "description": "DPSF8. Race - Asian Indian" }, { "name": "dp0080008", "type": "integer", "description": "DPSF8. Race - Chinese" }, { "name": "dp0080009", "type": "integer", "description": "DPSF8. Race - Filipino" }, { "name": "dp0080010", "type": "integer", "description": "DPSF8. Race - Japanese" }, { "name": "dp0080011", "type": "integer", "description": "DPSF8. Race - Korean" }, { "name": "dp0080012", "type": "integer", "description": "DPSF8. Race - Vietnamese" }, { "name": "dp0080013", "type": "integer", "description": "DPSF8. Race - Other Asian" }, { "name": "dp0080014", "type": "integer", "description": "DPSF8. Race - Native Hawaiian and Other Pacific Islander total" }, { "name": "dp0080015", "type": "integer", "description": "DPSF8. Race - Native Hawaiian" }, { "name": "dp0080016", "type": "integer", "description": "DPSF8. Race - Guamanian or Chamorro" }, { "name": "dp0080017", "type": "integer", "description": "DPSF8. Race - Samoan" }, { "name": "dp0080018", "type": "integer", "description": "DPSF8. Race - Other Pacific Islander" }, { "name": "dp0080019", "type": "integer", "description": "DPSF8. Race - Some Other Race" }, { "name": "dp0080020", "type": "integer", "description": "DPSF8. Race - Population of Two or More Races" }, { "name": "dp0080021", "type": "integer", "description": "DPSF8. Race - White; American Indian and Alaska Native" }, { "name": "dp0080022", "type": "integer", "description": "DPSF8. Race - White; Asian" }, { "name": "dp0080023", "type": "integer", "description": "DPSF8. Race - White; Black or African American" }, { "name": "dp0080024", "type": "integer", "description": "DPSF8. Race - White; Some Other Race" }, { "name": "dp0090001", "type": "integer", "description": "DPSF9. Race (total races tallied) - White alone or in combination with one or more other races" }, { "name": "dp0090002", "type": "integer", "description": "DPSF9. Race (total races tallied) - Black or African American alone or in combination with one or more other races" }, { "name": "dp0090003", "type": "integer", "description": "DPSF9. Race (total races tallied) - American Indian and Alaska Native alone or in combination with one or more other races" }, { "name": "dp0090004", "type": "integer", "description": "DPSF9. Race (total races tallied) - Asian alone or in combination with one or more other races" }, { "name": "dp0090005", "type": "integer", "description": "DPSF9. Race (total races tallied) - Native Hawaiian and Other Pacific Islander alone or in combination with one or more other races" }, { "name": "dp0090006", "type": "integer", "description": "DPSF9. Race (total races tallied) - Some Other Race alone or in combination with one or more other races" }, { "name": "dp0100001", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Total population" }, { "name": "dp0100002", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Hispanic or Latino (of any race)" }, { "name": "dp0100003", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Mexican" }, { "name": "dp0100004", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Puerto Rican" }, { "name": "dp0100005", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Cuban" }, { "name": "dp0100006", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Other Hispanic or Latino" }, { "name": "dp0100007", "type": "integer", "description": "DPSF10. Hispanic or Latino by specific origin - Not Hispanic or Latino" }, { "name": "dp0110001", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Total population" }, { "name": "dp0110002", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino total" }, { "name": "dp0110003", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: White alone" }, { "name": "dp0110004", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Black or African American alone" }, { "name": "dp0110005", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: American Indian and Alaska Native alone" }, { "name": "dp0110006", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Asian alone" }, { "name": "dp0110007", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Native Hawaiian and Other Pacific Islander alone" }, { "name": "dp0110008", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Some Other Race alone" }, { "name": "dp0110009", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Hispanic or Latino: Two or More Races" }, { "name": "dp0110010", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino total" }, { "name": "dp0110011", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: White alone" }, { "name": "dp0110012", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Black or African American alone" }, { "name": "dp0110013", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: American Indian and Alaska Native alone" }, { "name": "dp0110014", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Asian alone" }, { "name": "dp0110015", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Native Hawaiian and Other Pacific Islander alone" }, { "name": "dp0110016", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Some Other Race alone" }, { "name": "dp0110017", "type": "integer", "description": "DPSF11. Hispanic or Latino and race - Not Hispanic or Latino: Two or More Races" }, { "name": "dp0120001", "type": "integer", "description": "DPSF12. Relationship - Total population" }, { "name": "dp0120002", "type": "integer", "description": "DPSF12. Relationship - In households" }, { "name": "dp0120003", "type": "integer", "description": "DPSF12. Relationship - Householder" }, { "name": "dp0120004", "type": "integer", "description": "DPSF12. Relationship - Spouse" }, { "name": "dp0120005", "type": "integer", "description": "DPSF12. Relationship - Child" }, { "name": "dp0120006", "type": "integer", "description": "DPSF12. Relationship - Own child under 18 years" }, { "name": "dp0120007", "type": "integer", "description": "DPSF12. Relationship - Other relatives" }, { "name": "dp0120008", "type": "integer", "description": "DPSF12. Relationship - Other relatives under 18 years" }, { "name": "dp0120009", "type": "integer", "description": "DPSF12. Relationship - Other relatives 65 years and over" }, { "name": "dp0120010", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives" }, { "name": "dp0120011", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives under 18 years" }, { "name": "dp0120012", "type": "integer", "description": "DPSF12. Relationship - Nonrelatives 65 years and over" }, { "name": "dp0120013", "type": "integer", "description": "DPSF12. Relationship - Unmarried partner" }, { "name": "dp0120014", "type": "integer", "description": "DPSF12. Relationship - In group quarters" }, { "name": "dp0120015", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population" }, { "name": "dp0120016", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population: Male" }, { "name": "dp0120017", "type": "integer", "description": "DPSF12. Relationship - Institutionalized population: Female" }, { "name": "dp0120018", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population" }, { "name": "dp0120019", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population: Male" }, { "name": "dp0120020", "type": "integer", "description": "DPSF12. Relationship - Noninstitutionalized population: Female" }, { "name": "dp0130001", "type": "integer", "description": "DPSF13. Households by type - Total households" }, { "name": "dp0130002", "type": "integer", "description": "DPSF13. Households by type - Family households (families)" }, { "name": "dp0130003", "type": "integer", "description": "DPSF13. Households by type - Family households with own children under 18 years" }, { "name": "dp0130004", "type": "integer", "description": "DPSF13. Households by type - Husband-wife family" }, { "name": "dp0130005", "type": "integer", "description": "DPSF13. Households by type - Husband-wife family with own children under 18 years" }, { "name": "dp0130006", "type": "integer", "description": "DPSF13. Households by type - Male householder, no wife present" }, { "name": "dp0130007", "type": "integer", "description": "DPSF13. Households by type - Male householder, no wife present, with own children under 18 years" }, { "name": "dp0130008", "type": "integer", "description": "DPSF13. Households by type - Female householder, no husband present" }, { "name": "dp0130009", "type": "integer", "description": "DPSF13. Households by type - Female householder, no husband present, with own children under 18 years" }, { "name": "dp0130010", "type": "integer", "description": "DPSF13. Households by type - Nonfamily households" }, { "name": "dp0130011", "type": "integer", "description": "DPSF13. Households by type - Householder living alone" }, { "name": "dp0130012", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Male" }, { "name": "dp0130013", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Male 65 years and over" }, { "name": "dp0130014", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Female" }, { "name": "dp0130015", "type": "integer", "description": "DPSF13. Households by type - Householder living alone: Female 65 years and over" }, { "name": "dp0140001", "type": "integer", "description": "DPSF14. Households with individuals under 18 years - Total" }, { "name": "dp0150001", "type": "integer", "description": "DPSF15. Households with individuals 65 years and over - Total" }, { "name": "dp0160001", "type": "number", "description": "DPSF16. Average household size - Average household size" }, { "name": "dp0170001", "type": "number", "description": "DPSF17. Average family size - Average family size" }, { "name": "dp0180001", "type": "integer", "description": "DPSF18. Housing occupancy - Total housing units" }, { "name": "dp0180002", "type": "integer", "description": "DPSF18. Housing occupancy - Occupied housing units" }, { "name": "dp0180003", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units" }, { "name": "dp0180004", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for rent" }, { "name": "dp0180005", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units rented, not occupied" }, { "name": "dp0180006", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for sale only" }, { "name": "dp0180007", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units sold, not occupied" }, { "name": "dp0180008", "type": "integer", "description": "DPSF18. Housing occupancy - Vacant housing units for seasonal, recreational, or occasional use" }, { "name": "dp0180009", "type": "integer", "description": "DPSF18. Housing occupancy - All other vacant housing units" }, { "name": "dp0190001", "type": "number", "description": "DPSF19. Homeowner vacancy rate - Homeowner vacancy rate (percent)" }, { "name": "dp0200001", "type": "number", "description": "DPSF20. Rental vacancy rate - Rental vacancy rate (percent)" }, { "name": "dp0210001", "type": "integer", "description": "DPSF21. Housing tenure - Total occupied housing units" }, { "name": "dp0210002", "type": "integer", "description": "DPSF21. Housing tenure - Owner-occupied housing units" }, { "name": "dp0210003", "type": "integer", "description": "DPSF21. Housing tenure - Renter-occupied housing units" }, { "name": "dp0220001", "type": "integer", "description": "DPSF22. Population in occupied housing units by tenure - Owner-occupied housing units" }, { "name": "dp0220002", "type": "integer", "description": "DPSF22. Population in occupied housing units by tenure - Renter-occupied housing units" }, { "name": "dp0230001", "type": "number", "description": "DPSF23. Average household size by tenure - Owner occupied" }, { "name": "dp0230002", "type": "number", "description": "DPSF23. Average household size by tenure - Renter occupied" } ], "primaryKey": [ "tract_id_fips" ], "foreignKeys": [] }, "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 547382153, "hash": "sha256:734a6fdacd75cf0bf5c984ab8b2ed17a86edd482c8bc56a429443c8475767168" }, { "name": "out_eia860__yearly_emissions_control_equipment", "type": "table", "description": "Annual time series of the cost, type, operating status, retirement date, and install year of emissions control equipment reported to EIA.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report\n\nPrimary key:\n report_date, plant_id_eia, emission_control_id_pudl\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIncludes control ids for sulfur dioxide\n(SO2), particulate matter, mercury, nitrogen oxide (NOX), and acid (HCl) gas monitoring.\n\nThis denormalized version includes plant name, utility id, pudl id, and utility name\ncolumns.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia860__yearly_emissions_control_equipment.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "emission_control_id_pudl", "type": "number", "description": "A PUDL-generated ID used to distinguish emission control units in the same report year and plant id. This ID should not be used to track units over time or between plants.", "constraints": { "required": true } }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "emission_control_equipment_type_code", "type": "string", "description": "Short code indicating the type of emission control equipment installed." }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "mercury_control_id_eia", "type": "string", "description": "Mercury control identification number. This ID is not a unique identifier." }, { "name": "nox_control_id_eia", "type": "string", "description": "Nitrogen oxide control identification number. This ID is not a unique identifier." }, { "name": "particulate_control_id_eia", "type": "string", "description": "Particulate matter control identification number. This ID is not a unique identifier." }, { "name": "so2_control_id_eia", "type": "string", "description": "Sulfur dioxide control identification number. This ID is not a unique identifier." }, { "name": "acid_gas_control", "type": "boolean", "description": "Indicates whether the emissions control equipment controls acid (HCl) gas." }, { "name": "emission_control_equipment_cost", "type": "number", "description": "The total cost to install a piece of emission control equipment.", "unit": "USD" }, { "name": "emission_control_operating_date", "type": "date", "description": "The date a piece of emissions control equipment began operating. Derived from month and year columns in the raw data." }, { "name": "emission_control_retirement_date", "type": "date", "description": "The expected or actual retirement date for a piece of emissions control equipment. Derived from month and year columns in the raw data." } ], "primaryKey": [ "report_date", "plant_id_eia", "emission_control_id_pudl" ], "foreignKeys": [ { "fields": [ "emission_control_equipment_type_code" ], "reference": { "resource": "core_eia__codes_emission_control_equipment_types", "fields": [ "code" ] } }, { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 681869, "hash": "sha256:33edea2b4c388fb7608ce8efb7af88ae03e0b8673fdfe487028b01d98b6ac845" }, { "name": "out_eia860__yearly_ownership", "type": "table", "description": "Annual time series of generator ownership. Includes only jointly or third-party owned generators.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 860 -- Annual Electric Generator Report (Schedule 4)\n\nPrimary key:\n report_date, plant_id_eia, generator_id, owner_utility_id_eia\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nDenormalized to include plant and utility names and other associated IDs.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia860__yearly_ownership.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "owner_utility_id_eia", "type": "integer", "description": "The EIA utility Identification number for the owner company that is responsible for the day-to-day operations of the generator, not the operator utility.", "constraints": { "required": true } }, { "name": "operator_utility_id_eia", "type": "integer", "description": "The EIA utility Identification number for the operator utility." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID for the owner company that is responsible for the day-to-day operations of the generator, not the operator utility. May not be stable over time." }, { "name": "owner_utility_name_eia", "type": "string", "description": "The name of the EIA owner utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "owner_state", "type": "string", "description": "Two letter ISO-3166 political subdivision code.", "constraints": { "enum": [ "NS", "SC", "VI", "WA", "IA", "ND", "HI", "DE", "SD", "ON", "GU", "AS", "MT", "CO", "NB", "VA", "NC", "AL", "AR", "BC", "MB", "NH", "VT", "NJ", "OR", "LA", "NY", "IL", "RI", "FL", "ME", "NU", "WY", "MI", "AB", "MO", "NV", "PR", "MN", "NL", "PA", "GA", "DC", "TN", "WI", "OH", "WV", "MA", "TX", "SK", "AK", "AZ", "QC", "UT", "YT", "CA", "KS", "MD", "CT", "NM", "MS", "MP", "PE", "OK", "IN", "NE", "NT", "KY", "ID" ] } }, { "name": "owner_city", "type": "string", "description": "City of owner." }, { "name": "owner_country", "type": "string", "description": "Three letter ISO-3166 country code.", "constraints": { "enum": [ "USA", "CAN" ] } }, { "name": "owner_street_address", "type": "string", "description": "Steet address of owner." }, { "name": "owner_zip_code", "type": "string", "description": "Zip code of owner.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id", "owner_utility_id_eia" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "owner_utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 663331, "hash": "sha256:0cff3bc141e40eada43370e15cd8a26576e7d9d67fa45c8a1f94a39469a7abb1" }, { "name": "out_eia861__yearly_balancing_authority_service_territory", "type": "table", "description": "Annual time series of counties in balancing authority service territories.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n balancing_authority_id_eia, report_date, county_id_fips, county", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "out_eia861__yearly_balancing_authority_service_territory.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "required": true, "pattern": "^\\d{5}$" } }, { "name": "county_name_census", "type": "string", "description": "County name as specified in Census DP1 Data." }, { "name": "population", "type": "number", "description": "County population, sourced from Census DP1 data." }, { "name": "area_km2", "type": "number", "description": "County area in km2.", "unit": "km2" }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "balancing_authority_id_eia", "type": "integer", "description": "EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "county", "type": "string", "description": "County name.", "constraints": { "required": true } }, { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "pattern": "^\\d{2}$" } } ], "primaryKey": [ "balancing_authority_id_eia", "report_date", "county_id_fips", "county" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1066811, "hash": "sha256:a65780de461acd2aa77002686d8fa67b180be8823a8160bc5545484ef1dafd1e" }, { "name": "out_eia861__yearly_utility_service_territory", "type": "table", "description": "Annual time series of counties in utility service territories.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 861 -- Annual Electric Power Industry Report\n\nPrimary key:\n utility_id_eia, report_date, county_id_fips\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nContains additional information about counties.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "out_eia861__yearly_utility_service_territory.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "required": true, "pattern": "^\\d{5}$" } }, { "name": "county_name_census", "type": "string", "description": "County name as specified in Census DP1 Data." }, { "name": "population", "type": "number", "description": "County population, sourced from Census DP1 data." }, { "name": "area_km2", "type": "number", "description": "County area in km2.", "unit": "km2" }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "pattern": "^\\d{2}$" } } ], "primaryKey": [ "utility_id_eia", "report_date", "county_id_fips" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2537951, "hash": "sha256:65eb137d89e4749e110a7e50e2036c24b5a9631473cb1741dc9d35404c6cfcfe" }, { "name": "out_eia923__boiler_fuel", "type": "table", "description": "Monthly time series of boiler fuel consumption and emissions.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, boiler_id, energy_source_code, prime_mover_code, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReports the quantity of each type of fuel consumed by each boiler on a monthly basis, as\nwell as the sulfur and ash content of those fuels. Fuel quantity is reported in standard\nEIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported,\nmaking this table useful for calculating the thermal efficiency (heat rate) of various\ngeneration units.\n\nThis table provides better coverage of the entire fleet of generators than the\n``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly\nassociated with a generator. This complicates the heat rate calculation, since the\nassociations between individual boilers and generators are incomplete and can be\ncomplex.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__boiler_fuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "boiler_id", "energy_source_code", "prime_mover_code", "report_date" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "boiler_id" ], "reference": { "resource": "core_eia__entity_boilers", "fields": [ "plant_id_eia", "boiler_id" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 13124350, "hash": "sha256:b098cafb81b294629acd2fe8c7ea5a95cb40272428ce8a205a37f7e4d8f3136e" }, { "name": "out_eia923__fuel_receipts_costs", "type": "table", "description": "Individual fuel deliveries to power plants, organized by fuel type and supplier.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 2 - Part A)\n\nPrimary key:\n This table has no primary key. Each record describes an individual fuel delivery. There can be multiple deliveries of the same type of fuel from the same supplier to the same plant in a single month, so the table has no natural primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Some values have been redacted.\n\n* Time of fuel deliveries is not necessarily connected with time of fuel consumption.\n\n* 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.\n\n* Contains estimated values.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThere can be a significant delay between the receipt of fuel and its consumption, so\nusing this table to infer monthly attributes associated with power generation may not be\nentirely accurate. However, this is the most granular data we have describing fuel\ncosts, and we use it in calculating the marginal cost of electricity for individual\ngeneration units.\n\nUnder some circumstances utilities are allowed to treat the price of fuel as proprietary\nbusiness data, meaning it is redacted from the publicly available spreadsheets. It's\nstill reported to EIA and influences the aggregated (state, region, annual, etc.) fuel\nprices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing\ndata is not randomly distributed. Deregulated markets dominated by merchant generators\n(independent power producers) redact much more data, and natural gas is by far the most\nlikely fuel to have its price redacted. This means, for instance, that the entire\nNortheastern US reports essentially no fine-grained data about its natural gas prices.\n\nAdditional data which we haven't yet integrated is available in a similar format from\n2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__fuel_receipts_costs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "contract_type_code", "type": "string", "description": "Purchase type under which receipts occurred in the reporting month. C: Contract, NC: New Contract, S: Spot Purchase, T: Tolling Agreement.", "constraints": { "enum": [ "S", "C", "NC", "T" ] } }, { "name": "contract_expiration_date", "type": "date", "description": "Date contract expires.Format: MMYY." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record." }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_group_code", "type": "string", "description": "Fuel groups used in the Electric Power Monthly", "constraints": { "enum": [ "petroleum", "other_gas", "petroleum_coke", "natural_gas", "coal" ] } }, { "name": "supplier_name", "type": "string", "description": "Company that sold the fuel to the plant or, in the case of Natural Gas, pipeline owner." }, { "name": "fuel_received_units", "type": "number", "description": "Quantity of fuel received in tons, barrel, or Mcf." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "bulk_agg_fuel_cost_per_mmbtu", "type": "number", "description": "Fuel cost per MMBTU reported in the EIA bulk electricity data. This is an aggregate average fuel price for a whole state, region, month, sector, etc. Used to fill in missing fuel prices." }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "fuel_cost_per_mmbtu_source", "type": "string", "description": "Indicates the source of the values in the fuel_cost_per_mmbtu column. The fuel cost either comes directly from the EIA forms (original), was filled in from the EIA's API using state-level averages (eiaapi), was filled in using a rolling average (rolling_avg) or When the records get aggregated together and contain multiple sources (mixed).", "constraints": { "enum": [ "original", "eiaapi", "rolling_avg", "mixed" ] } }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "mercury_content_ppm", "type": "number", "description": "Mercury content in parts per million (ppm) to the nearest 0.001 ppm.", "unit": "ppm" }, { "name": "primary_transportation_mode_code", "type": "string", "description": "Transportation mode for the longest distance transported." }, { "name": "secondary_transportation_mode_code", "type": "string", "description": "Transportation mode for the second longest distance transported." }, { "name": "natural_gas_transport_code", "type": "string", "description": "Contract type for natural gas transportation service.", "constraints": { "enum": [ "firm", "interruptible" ] } }, { "name": "natural_gas_delivery_contract_type_code", "type": "string", "description": "Contract type for natural gas delivery service:", "constraints": { "enum": [ "firm", "interruptible" ] } }, { "name": "moisture_content_pct", "type": "number", "description": "For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent." }, { "name": "chlorine_content_ppm", "type": "number", "description": "For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.", "unit": "ppm" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "mine_id_msha", "type": "integer", "description": "MSHA issued mine identifier." }, { "name": "mine_name", "type": "string", "description": "Coal mine name." }, { "name": "mine_state", "type": "string", "description": "State where the coal mine is located. Two letter abbreviation." }, { "name": "coalmine_county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4. This is the county where the coal mine is located.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "mine_type_code", "type": "string", "description": "Type of coal mine." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "mine_type_code" ], "reference": { "resource": "core_eia__codes_coalmine_types", "fields": [ "code" ] } }, { "fields": [ "contract_type_code" ], "reference": { "resource": "core_eia__codes_contract_types", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "primary_transportation_mode_code" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "secondary_transportation_mode_code" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 21162975, "hash": "sha256:2c4e212fd301a90c52d948e475be967954e31eb3916f9e1539a2df12b16255ed" }, { "name": "out_eia923__generation", "type": "table", "description": "Monthly time series of net electricity generated by power plant generators.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Not all IDs are present.\n\n* Table has known low coverage - either geographic or temporal or otherwise.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is the most granular information we have about how much electricity individual\ngenerators are producing, but only about half of all the generation reported in the\n``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting\nrequirements imposed on different types and sizes of generators.\n\nWhenever possible, we use this generator-level net generation to estimate the heat rates\nof generation units and the marginal cost of electricity on a per-generator basis, but\nthose calculations depend on plant-level fuel costs and sometimes uncertain or\nincomplete boiler-generator associations.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__generation.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3186584, "hash": "sha256:60733597e5317a37ca727c4c3b79b22c826270084229ad01fd9e580abe0ccca2" }, { "name": "out_eia923__generation_fuel_combined", "type": "table", "description": "Monthly time series of generation and fuel consumption of all generation units.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, report_date, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nDenormalized, combined data from the ``core_eia923__monthly_generation_fuel`` and\n``core_eia923__monthly_generation_fuel_nuclear`` with nuclear generation aggregated from the nuclear\ngeneration unit level up to the plant prime mover level, so as to be compatible with\nfossil fuel generation data.\n\nThis data can't be easily linked to individual boilers, generators, and\ngeneration units, but it is provides the most complete coverage\nof fuel consumption and electricity generation for the entire generation fleet. We use\nthe primary fuels and prime movers reported for each generator along with their\ncapacities to attribute fuel consumption and generation when it isn't directly reported\nin the ``core_eia923__monthly_generation`` and ``core_eia923__monthly_boiler_fuel`` tables in order to calculate\ncapacity factors, heat rates, and the marginal cost of electricity.\n\nThe table makes a distinction between all fuel consumed and fuel consumed for\nelectricity generation because some units are also combined heat and power (CHP) units,\nand also provide high temperature process heat at the expense of net electricity\ngeneration.\n\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__generation_fuel_combined.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_type_code_agg", "type": "string", "description": "A partial aggregation of the reported fuel type codes into larger categories used by EIA in, for example, the Annual Energy Review (AER) or Monthly Energy Review (MER). Two or three letter alphanumeric." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_consumed_for_electricity_units", "type": "number", "description": "Consumption for electric generation of the fuel type in physical unit." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "fuel_type_code_agg" ], "reference": { "resource": "core_eia__codes_fuel_types_agg", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 89957645, "hash": "sha256:b0023596dd026ca031429dc6274a45be03c8b93de306e55d2eeaf794219ac5d0" }, { "name": "out_eia923__monthly_boiler_fuel", "type": "table", "description": "Monthly time series of boiler fuel consumption and emissions.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, boiler_id, energy_source_code, prime_mover_code, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReports the quantity of each type of fuel consumed by each boiler on a monthly basis, as\nwell as the sulfur and ash content of those fuels. Fuel quantity is reported in standard\nEIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported,\nmaking this table useful for calculating the thermal efficiency (heat rate) of various\ngeneration units.\n\nThis table provides better coverage of the entire fleet of generators than the\n``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly\nassociated with a generator. This complicates the heat rate calculation, since the\nassociations between individual boilers and generators are incomplete and can be\ncomplex.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__monthly_boiler_fuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "boiler_id", "energy_source_code", "prime_mover_code", "report_date" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "boiler_id" ], "reference": { "resource": "core_eia__entity_boilers", "fields": [ "plant_id_eia", "boiler_id" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 12405881, "hash": "sha256:3474403be4b9846f1a39bced07fd4b6344e8adb25de83f64d2f9334154eb71f2" }, { "name": "out_eia923__monthly_fuel_receipts_costs", "type": "table", "description": "Monthly time series of fuel deliveries to power plants aggregated by plant, fuel type, and time period.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 2 - Part A)\n\nPrimary key:\n plant_id_eia, fuel_type_code_pudl, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Contains estimated values.\n\n* Some values have been redacted.\n\n* Time of fuel deliveries is not necessarily connected with time of fuel consumption.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is an aggregation of the more detailed data in the\n:ref:`core_eia923__fuel_receipts_costs` table. It provides a tidy timeseries\nof deliveries by fuel type for each plant. However, not all values in the\noriginal table can be aggregated meaningfully, so this table contains only a\nsubset of the source table columns -- primarily numerical values and a\nhandful of categorical variables, plus additional attributes that are\nconstant within each plant-fuel-time period grouping and associated with the\nplant or utility. When aggregating numerical values any sum that contains an\nNA value is treated as NA.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__monthly_fuel_receipts_costs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "required": true, "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_received_units", "type": "number", "description": "Quantity of fuel received in tons, barrel, or Mcf." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "fuel_cost_per_mmbtu_source", "type": "string", "description": "Indicates the source of the values in the fuel_cost_per_mmbtu column. The fuel cost either comes directly from the EIA forms (original), was filled in from the EIA's API using state-level averages (eiaapi), was filled in using a rolling average (rolling_avg) or When the records get aggregated together and contain multiple sources (mixed).", "constraints": { "enum": [ "original", "eiaapi", "rolling_avg", "mixed" ] } }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "mercury_content_ppm", "type": "number", "description": "Mercury content in parts per million (ppm) to the nearest 0.001 ppm.", "unit": "ppm" }, { "name": "moisture_content_pct", "type": "number", "description": "For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent." }, { "name": "chlorine_content_ppm", "type": "number", "description": "For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.", "unit": "ppm" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "fuel_type_code_pudl", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7482323, "hash": "sha256:200a4b26ab199e44f0063c140bc03a43f07c9370251124d1026c393f9f9d934c" }, { "name": "out_eia923__monthly_generation", "type": "table", "description": "Monthly time series of net electricity generated by power plant generators.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Not all IDs are present.\n\n* Table has known low coverage - either geographic or temporal or otherwise.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is the most granular information we have about how much electricity individual\ngenerators are producing, but only about half of all the generation reported in the\n``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting\nrequirements imposed on different types and sizes of generators.\n\nWhenever possible, we use this generator-level net generation to estimate the heat rates\nof generation units and the marginal cost of electricity on a per-generator basis, but\nthose calculations depend on plant-level fuel costs and sometimes uncertain or\nincomplete boiler-generator associations.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__monthly_generation.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2698089, "hash": "sha256:eb7cdcae83e40974a3e9ca419db4c9a556b7db91e381de877896376e9167f2ca" }, { "name": "out_eia923__monthly_generation_fuel_by_generator", "type": "table", "description": "Monthly time series of of estimated net generation and fuel consumption by generator.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n report_date, plant_id_eia, generator_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* This downscaling process used to create this table does not distinguish between primary and secondary energy_sources for generators (see below for implications).\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nBased on allocating net electricity generation and fuel consumption reported in the EIA-923 generation and generation_fuel tables to individual generators.\n\nThe net generation and fuel consumption allocation\nmethod PUDL employs begins with the following context of the originally reported\nEIA-860 and EIA-923 data:\n\n* The :ref:`core_eia923__monthly_generation_fuel` table is the authoritative source of\n information about how much generation and fuel consumption is attributable to an\n entire plant. This table has the most complete data coverage, but it is not the most\n granular data reported.\n* The :ref:`core_eia923__monthly_generation` table contains the most granular net\n generation data. It is reported at the ``plant_id_eia``, ``generator_id`` and\n ``report_date`` level. This table includes only ~40% of the total MWhs reported in\n the :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia923__monthly_boiler_fuel` table contains the most granular fuel\n consumption data. It is reported at the boiler/prime mover/energy source level. This\n table includes only ~40% of the total MMBTUs reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia860__scd_generators` table provides an exhaustive list of all\n generators whose generation is being reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n\n\n\nIn this table, PUDL aggregates the net generation and fuel consumption that has been allocated to the ``generator_id``/``energy_source_code``/``prime_mover_code`` level in the:ref:`out_eia923__monthly_generation_fuel_by_generator_energy_source` to the generator level.This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity.\n\nThis table inherits canonicalized values for generators, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia923__monthly_generation_fuel_by_generator.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 109569943, "hash": "sha256:c048fddaa62c37ddaf91af0eef010d5ece2e982723430f1007a464d1914726cf" }, { "name": "out_eia923__monthly_generation_fuel_by_generator_energy_source", "type": "table", "description": "Monthly time series of of estimated net generation and fuel consumption associated with each combination of generator, energy source, and prime mover.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n report_date, plant_id_eia, generator_id, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* This downscaling process used to create this table does not distinguish between primary and secondary energy_sources for generators (see below for implications).\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe net generation and fuel consumption allocation\nmethod PUDL employs begins with the following context of the originally reported\nEIA-860 and EIA-923 data:\n\n* The :ref:`core_eia923__monthly_generation_fuel` table is the authoritative source of\n information about how much generation and fuel consumption is attributable to an\n entire plant. This table has the most complete data coverage, but it is not the most\n granular data reported.\n* The :ref:`core_eia923__monthly_generation` table contains the most granular net\n generation data. It is reported at the ``plant_id_eia``, ``generator_id`` and\n ``report_date`` level. This table includes only ~40% of the total MWhs reported in\n the :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia923__monthly_boiler_fuel` table contains the most granular fuel\n consumption data. It is reported at the boiler/prime mover/energy source level. This\n table includes only ~40% of the total MMBTUs reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia860__scd_generators` table provides an exhaustive list of all\n generators whose generation is being reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n\n\n\nIn this table, PUDL has allocated the net electricity generation and fuel consumption from :ref:`core_eia923__monthly_generation_fuel` to the ``generator_id``/``energy_source_code``/``prime_mover_code`` level.\n\nThe allocation process entails generating a fraction for each record based on the net generation in the :ref:`core_eia923__monthly_generation` table and the capacity from the :ref:`core_eia860__scd_generators` table. This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia923__monthly_generation_fuel_by_generator_energy_source.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "energy_source_code_num", "type": "string", "description": "Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record.", "constraints": { "enum": [ "energy_source_code_1", "energy_source_code_10", "energy_source_code_11", "energy_source_code_12", "energy_source_code_2", "energy_source_code_3", "energy_source_code_4", "energy_source_code_5", "energy_source_code_6", "energy_source_code_7", "energy_source_code_8", "energy_source_code_9" ] } }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 103364674, "hash": "sha256:b92c21e31a8681118565a05dcd4b6605da0769197dceaeb7ee5f2bd2b3ca88ff" }, { "name": "out_eia923__monthly_generation_fuel_combined", "type": "table", "description": "Monthly time series of generation and fuel consumption of all generation units.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, report_date, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nDenormalized, combined data from the ``core_eia923__monthly_generation_fuel`` and\n``core_eia923__monthly_generation_fuel_nuclear`` with nuclear generation aggregated from the nuclear\ngeneration unit level up to the plant prime mover level, so as to be compatible with\nfossil fuel generation data.\n\nThis data can't be easily linked to individual boilers, generators, and\ngeneration units, but it is provides the most complete coverage\nof fuel consumption and electricity generation for the entire generation fleet. We use\nthe primary fuels and prime movers reported for each generator along with their\ncapacities to attribute fuel consumption and generation when it isn't directly reported\nin the ``core_eia923__monthly_generation`` and ``core_eia923__monthly_boiler_fuel`` tables in order to calculate\ncapacity factors, heat rates, and the marginal cost of electricity.\n\nThe table makes a distinction between all fuel consumed and fuel consumed for\nelectricity generation because some units are also combined heat and power (CHP) units,\nand also provide high temperature process heat at the expense of net electricity\ngeneration.\n\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__monthly_generation_fuel_combined.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_consumed_for_electricity_units", "type": "number", "description": "Consumption for electric generation of the fuel type in physical unit." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia" ], "reference": { "resource": "core_eia__entity_plants", "fields": [ "plant_id_eia" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 91431273, "hash": "sha256:761d599cd16a47469d7dc920021de150dff572c32a35c3900d5b2cf95ae392e7" }, { "name": "out_eia923__yearly_boiler_fuel", "type": "table", "description": "Annual time series of boiler fuel consumption and emissions.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, boiler_id, energy_source_code, prime_mover_code, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReports the quantity of each type of fuel consumed by each boiler on a monthly basis, as\nwell as the sulfur and ash content of those fuels. Fuel quantity is reported in standard\nEIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported,\nmaking this table useful for calculating the thermal efficiency (heat rate) of various\ngeneration units.\n\nThis table provides better coverage of the entire fleet of generators than the\n``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly\nassociated with a generator. This complicates the heat rate calculation, since the\nassociations between individual boilers and generators are incomplete and can be\ncomplex.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__yearly_boiler_fuel.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "boiler_id", "energy_source_code", "prime_mover_code", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "boiler_id", "report_date" ], "reference": { "resource": "core_eia860__scd_boilers", "fields": [ "plant_id_eia", "boiler_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2175389, "hash": "sha256:370dfb7c09d0f89bde3ea6e3c91ad935f093e0ac0c48b8eda8df5154cc24b410" }, { "name": "out_eia923__yearly_fuel_receipts_costs", "type": "table", "description": "Annual time series of fuel deliveries to power plants aggregated by plant, fuel type, and time period.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 2 - Part A)\n\nPrimary key:\n plant_id_eia, fuel_type_code_pudl, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Contains estimated values.\n\n* Some values have been redacted.\n\n* Time of fuel deliveries is not necessarily connected with time of fuel consumption.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is an aggregation of the more detailed data in the\n:ref:`core_eia923__fuel_receipts_costs` table. It provides a tidy timeseries\nof deliveries by fuel type for each plant. However, not all values in the\noriginal table can be aggregated meaningfully, so this table contains only a\nsubset of the source table columns -- primarily numerical values and a\nhandful of categorical variables, plus additional attributes that are\nconstant within each plant-fuel-time period grouping and associated with the\nplant or utility. When aggregating numerical values any sum that contains an\nNA value is treated as NA.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__yearly_fuel_receipts_costs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "required": true, "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_received_units", "type": "number", "description": "Quantity of fuel received in tons, barrel, or Mcf." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "fuel_cost_per_mmbtu_source", "type": "string", "description": "Indicates the source of the values in the fuel_cost_per_mmbtu column. The fuel cost either comes directly from the EIA forms (original), was filled in from the EIA's API using state-level averages (eiaapi), was filled in using a rolling average (rolling_avg) or When the records get aggregated together and contain multiple sources (mixed).", "constraints": { "enum": [ "original", "eiaapi", "rolling_avg", "mixed" ] } }, { "name": "sulfur_content_pct", "type": "number", "description": "Sulfur content percentage by weight to the nearest 0.01 percent." }, { "name": "ash_content_pct", "type": "number", "description": "Ash content percentage by weight to the nearest 0.1 percent." }, { "name": "mercury_content_ppm", "type": "number", "description": "Mercury content in parts per million (ppm) to the nearest 0.001 ppm.", "unit": "ppm" }, { "name": "moisture_content_pct", "type": "number", "description": "For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent." }, { "name": "chlorine_content_ppm", "type": "number", "description": "For coal only: the chlorine content in parts per million (ppm) to the nearest 0.001 ppm. If lab tests of the coal do not include the chlorine content, this field contains the amount specified in the contract with the supplier.", "unit": "ppm" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "fuel_type_code_pudl", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1006220, "hash": "sha256:9379789be361193009949030430cd3f1906a3bc7093b7c0dd17f03890bead399" }, { "name": "out_eia923__yearly_generation", "type": "table", "description": "Annual time series of net electricity generated by power plant generators.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, generator_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* Not all IDs are present.\n\n* Table has known low coverage - either geographic or temporal or otherwise.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is the most granular information we have about how much electricity individual\ngenerators are producing, but only about half of all the generation reported in the\n``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting\nrequirements imposed on different types and sizes of generators.\n\nWhenever possible, we use this generator-level net generation to estimate the heat rates\nof generation units and the marginal cost of electricity on a per-generator basis, but\nthose calculations depend on plant-level fuel costs and sometimes uncertain or\nincomplete boiler-generator associations.\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__yearly_generation.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "generator_id", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 507980, "hash": "sha256:514df17eb98ea948c92714670cf98e0dd6a4d626d919364781f727ba52a6542c" }, { "name": "out_eia923__yearly_generation_fuel_by_generator", "type": "table", "description": "Annual time series of of estimated net generation and fuel consumption by generator.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n report_date, plant_id_eia, generator_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* This downscaling process used to create this table does not distinguish between primary and secondary energy_sources for generators (see below for implications).\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nBased on allocating net electricity generation and fuel consumption reported in the EIA-923 generation and generation_fuel tables to individual generators.\n\nThe net generation and fuel consumption allocation\nmethod PUDL employs begins with the following context of the originally reported\nEIA-860 and EIA-923 data:\n\n* The :ref:`core_eia923__monthly_generation_fuel` table is the authoritative source of\n information about how much generation and fuel consumption is attributable to an\n entire plant. This table has the most complete data coverage, but it is not the most\n granular data reported.\n* The :ref:`core_eia923__monthly_generation` table contains the most granular net\n generation data. It is reported at the ``plant_id_eia``, ``generator_id`` and\n ``report_date`` level. This table includes only ~40% of the total MWhs reported in\n the :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia923__monthly_boiler_fuel` table contains the most granular fuel\n consumption data. It is reported at the boiler/prime mover/energy source level. This\n table includes only ~40% of the total MMBTUs reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia860__scd_generators` table provides an exhaustive list of all\n generators whose generation is being reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n\n\n\nIn this table, PUDL aggregates the net generation and fuel consumption that has been allocated to the ``generator_id``/``energy_source_code``/``prime_mover_code`` level in the:ref:`out_eia923__yearly_generation_fuel_by_generator_energy_source` to the generator level.This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity.\n\nThis table inherits canonicalized values for generators, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia923__yearly_generation_fuel_by_generator.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 10649194, "hash": "sha256:4a666c675c050a6c568f9cf3897cd1d131fc08feb206f6ed9204e62a97049df5" }, { "name": "out_eia923__yearly_generation_fuel_by_generator_energy_source", "type": "table", "description": "Annual time series of of estimated net generation and fuel consumption associated with each combination of generator, energy source, and prime mover.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n report_date, plant_id_eia, generator_id, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* This downscaling process used to create this table does not distinguish between primary and secondary energy_sources for generators (see below for implications).\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe net generation and fuel consumption allocation\nmethod PUDL employs begins with the following context of the originally reported\nEIA-860 and EIA-923 data:\n\n* The :ref:`core_eia923__monthly_generation_fuel` table is the authoritative source of\n information about how much generation and fuel consumption is attributable to an\n entire plant. This table has the most complete data coverage, but it is not the most\n granular data reported.\n* The :ref:`core_eia923__monthly_generation` table contains the most granular net\n generation data. It is reported at the ``plant_id_eia``, ``generator_id`` and\n ``report_date`` level. This table includes only ~40% of the total MWhs reported in\n the :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia923__monthly_boiler_fuel` table contains the most granular fuel\n consumption data. It is reported at the boiler/prime mover/energy source level. This\n table includes only ~40% of the total MMBTUs reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia860__scd_generators` table provides an exhaustive list of all\n generators whose generation is being reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n\n\n\nIn this table, PUDL has allocated the net electricity generation and fuel consumption from :ref:`core_eia923__monthly_generation_fuel` to the ``generator_id``/``energy_source_code``/``prime_mover_code`` level.\n\nThe allocation process entails generating a fraction for each record based on the net generation in the :ref:`core_eia923__monthly_generation` table and the capacity from the :ref:`core_eia860__scd_generators` table. This process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia923__yearly_generation_fuel_by_generator_energy_source.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "energy_source_code_num", "type": "string", "description": "Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record.", "constraints": { "enum": [ "energy_source_code_1", "energy_source_code_10", "energy_source_code_11", "energy_source_code_12", "energy_source_code_2", "energy_source_code_3", "energy_source_code_4", "energy_source_code_5", "energy_source_code_6", "energy_source_code_7", "energy_source_code_8", "energy_source_code_9" ] } }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 9909306, "hash": "sha256:e4c433e7f6a0535cc09201c589db96b4b5bcf73ea59742bd79fa5680344d9890" }, { "name": "out_eia923__yearly_generation_fuel_by_generator_energy_source_owner", "type": "table", "description": "Annual time series of of estimated net generation and fuel consumption for each generator, associated with each combination of generator, energy source, prime mover, and owner.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n report_date, plant_id_eia, generator_id, prime_mover_code, energy_source_code, utility_id_eia, ownership_record_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* This downscaling process used to create this table does not distinguish between primary and secondary energy_sources for generators (see below for implications).\n\n* Date column arbitrarily uses the first of the month.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe net generation and fuel consumption allocation\nmethod PUDL employs begins with the following context of the originally reported\nEIA-860 and EIA-923 data:\n\n* The :ref:`core_eia923__monthly_generation_fuel` table is the authoritative source of\n information about how much generation and fuel consumption is attributable to an\n entire plant. This table has the most complete data coverage, but it is not the most\n granular data reported.\n* The :ref:`core_eia923__monthly_generation` table contains the most granular net\n generation data. It is reported at the ``plant_id_eia``, ``generator_id`` and\n ``report_date`` level. This table includes only ~40% of the total MWhs reported in\n the :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia923__monthly_boiler_fuel` table contains the most granular fuel\n consumption data. It is reported at the boiler/prime mover/energy source level. This\n table includes only ~40% of the total MMBTUs reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n* The :ref:`core_eia860__scd_generators` table provides an exhaustive list of all\n generators whose generation is being reported in the\n :ref:`core_eia923__monthly_generation_fuel` table.\n\n\n\nIn this table, PUDL has scaled the net electricity generation and fuel consumption from :ref:`core_eia923__monthly_generation_fuel` by ownership from :ref:`out_eia860__yearly_ownership`. Note that the utility_id_eia in this table refers to the OWNER of the generator, not the operator.\n\nThis process does not distinguish between primary and secondary energy_sources for generators. Net generation is allocated equally between energy source codes, so if a plant has multiple generators with the same prime_mover_code but different energy source codes the core_eia923__monthly_generation_fuel records will be associated similarly between these two generators. Allocated net generation will still be proportional to each generator's net generation or capacity.\n\nThis table inherits canonicalized values for generators and plants.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia923__yearly_generation_fuel_by_generator_energy_source_owner.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "ownership_record_type", "type": "string", "description": "Whether each generator record is for one owner or represents a total of all ownerships.", "constraints": { "required": true, "enum": [ "owned", "total" ] } }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "energy_source_code_num", "type": "string", "description": "Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record.", "constraints": { "enum": [ "energy_source_code_1", "energy_source_code_10", "energy_source_code_11", "energy_source_code_12", "energy_source_code_2", "energy_source_code_3", "energy_source_code_4", "energy_source_code_5", "energy_source_code_6", "energy_source_code_7", "energy_source_code_8", "energy_source_code_9" ] } }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id", "prime_mover_code", "energy_source_code", "utility_id_eia", "ownership_record_type" ], "foreignKeys": [ { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 23443097, "hash": "sha256:9bfc0776ea9510e6663882d6ddb26334c2e032f6a175c63e707d7fa6a97c6087" }, { "name": "out_eia923__yearly_generation_fuel_combined", "type": "table", "description": "Annual time series of generation and fuel consumption of all generation units.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA Form 923 -- Power Plant Operations Report (Schedule 3)\n\nPrimary key:\n plant_id_eia, report_date, prime_mover_code, energy_source_code\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Date column arbitrarily uses the first of the month.\n\n* A small number of respondents only report annual fuel consumption, and all of it is reported in December.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nDenormalized, combined data from the ``core_eia923__monthly_generation_fuel`` and\n``core_eia923__monthly_generation_fuel_nuclear`` with nuclear generation aggregated from the nuclear\ngeneration unit level up to the plant prime mover level, so as to be compatible with\nfossil fuel generation data.\n\nThis data can't be easily linked to individual boilers, generators, and\ngeneration units, but it is provides the most complete coverage\nof fuel consumption and electricity generation for the entire generation fleet. We use\nthe primary fuels and prime movers reported for each generator along with their\ncapacities to attribute fuel consumption and generation when it isn't directly reported\nin the ``core_eia923__monthly_generation`` and ``core_eia923__monthly_boiler_fuel`` tables in order to calculate\ncapacity factors, heat rates, and the marginal cost of electricity.\n\nThe table makes a distinction between all fuel consumed and fuel consumed for\nelectricity generation because some units are also combined heat and power (CHP) units,\nand also provide high temperature process heat at the expense of net electricity\ngeneration.\n\n\nThis table inherits canonicalized values for plants and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia923__yearly_generation_fuel_combined.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "energy_source_code", "type": "string", "description": "A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record.", "constraints": { "required": true } }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)", "constraints": { "required": true } }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_consumed_for_electricity_units", "type": "number", "description": "Consumption for electric generation of the fuel type in physical unit." }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_for_electricity_mmbtu", "type": "number", "description": "Total consumption of fuel to produce electricity, in physical unit, year to date.", "unit": "MMBTU" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "plant_id_eia", "report_date", "prime_mover_code", "energy_source_code" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 9787429, "hash": "sha256:419735fd1904f4983788775ef1e0b488e3356b1cc968fe63b74767f5bcf14484" }, { "name": "out_eia930__hourly_aggregated_demand", "type": "table", "description": "Hourly time series of aggregated balancing authority demand by EIA region, interconnect, and continental US.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, aggregation_level, aggregation_group\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* This table is experimental and/or a work in progress and may change in the future.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe spatial granularity of each record is indicated by `aggregation_level`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "out_eia930__hourly_aggregated_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "aggregation_level", "type": "string", "description": "Indicates the spacial granularity of aggregated value.", "constraints": { "required": true, "enum": [ "region", "interconnect", "conus" ] } }, { "name": "aggregation_group", "type": "string", "description": "Label identifying a group of balancing authorities to be used in aggregating demand E.g. a region of the US or a whole interconnect.", "constraints": { "required": true } }, { "name": "demand_imputed_pudl_mwh", "type": "number", "description": "Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed in PUDL.", "unit": "MWh" } ], "primaryKey": [ "datetime_utc", "aggregation_level", "aggregation_group" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 10006862, "hash": "sha256:1f85c526518568dd28130ea7fff66995c861bd1214c43cebddb12157c51e4019" }, { "name": "out_eia930__hourly_operations", "type": "table", "description": "Hourly time series of balancing authority net generation, interchange, and demand with imputed demand.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, balancing_authority_code_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains rows where missing values were imputed.\n\n* This table is experimental and/or a work in progress and may change in the future.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is based on ``core_eia930__hourly_operations``,\nbut adds imputed demand where the original data was missing or anomalous. Codes\nexplaining why values have been imputed can be found in the\n``core_pudl__codes_imputation_reasons`` table.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "out_eia930__hourly_operations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "net_generation_reported_mwh", "type": "number", "description": "Unaltered originally reported net generation for the specified period.", "unit": "MWh" }, { "name": "net_generation_adjusted_mwh", "type": "number", "description": "Reported net generation adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "net_generation_imputed_eia_mwh", "type": "number", "description": "Reported net generation with outlying values removed and missing values imputed by EIA.", "unit": "MWh" }, { "name": "interchange_reported_mwh", "type": "number", "description": "Original reported energy interchange between adjacent balancing authorities.", "unit": "MWh" }, { "name": "interchange_adjusted_mwh", "type": "number", "description": "Energy interchange between adjacent balancing authorities, adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "interchange_imputed_eia_mwh", "type": "number", "description": "Energy interchange between adjacent balancing authorities, with outliers and missing values imputed by EIA.", "unit": "MWh" }, { "name": "demand_reported_mwh", "type": "number", "description": "Originally reported electricity demand, calculated by taking the net generation within the BA and subtracting the interchange with adjacent BAs.", "unit": "MWh" }, { "name": "demand_adjusted_mwh", "type": "number", "description": "Electricity demand adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling.", "unit": "MWh" }, { "name": "demand_imputed_pudl_mwh", "type": "number", "description": "Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed in PUDL.", "unit": "MWh" }, { "name": "demand_imputed_pudl_mwh_imputation_code", "type": "string", "description": "Code describing why a demand value was flagged for imputation.", "constraints": { "enum": [ "local_outlier_high", "global_outlier_neighbor", "identical_run", "anomalous_region", "global_outlier", "local_outlier_low", "single_delta", "bad_year", "missing_value", "simulated", "double_delta", "negative_or_zero" ] } }, { "name": "demand_imputed_eia_mwh", "type": "number", "description": "Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed by EIA.", "unit": "MWh" }, { "name": "demand_forecast_mwh", "type": "number", "description": "Day ahead demand forecast.", "unit": "MWh" } ], "primaryKey": [ "datetime_utc", "balancing_authority_code_eia" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 109413768, "hash": "sha256:1ef824ca0a263b500d95016d5ed4ffece37399fc426eca1968636b5d9629ad32" }, { "name": "out_eia930__hourly_subregion_demand", "type": "table", "description": "Hourly time series of balancing authority subregion demand with imputed demand.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report\n\nPrimary key:\n datetime_utc, balancing_authority_code_eia, balancing_authority_subregion_code_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains rows where missing values were imputed.\n\n* This table is experimental and/or a work in progress and may change in the future.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is based on ``core_eia930__hourly_subregion_demand``, but adds imputed demand 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia930", "title": "EIA Form 930 -- Hourly and Daily Balancing Authority Operations Report", "path": "https://www.eia.gov/electricity/gridmonitor/", "description": "The EIA Form 930 provides hourly demand and generation statistics by balancing area (or sub-balancing area in the case of some larger areas). These statistics include a breakdown by energy source (coal, gas, hydro, wind, solar, etc.) as well as interchange between the balancing areas, including international exchanges with Canada and Mexico.", "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.10840077", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19947291", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia930.html" } ], "path": "out_eia930__hourly_subregion_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs.", "constraints": { "required": true } }, { "name": "balancing_authority_subregion_code_eia", "type": "string", "description": "Code identifying subregions of larger balancing authorities.", "constraints": { "required": true, "enum": [ "0001", "0004", "0006", "0027", "0035", "4001", "4002", "4003", "4004", "4005", "4006", "4007", "4008", "8910", "ACMA", "AE", "AEP", "AP", "ATSI", "BASI", "BC", "CE", "COAS", "CSWS", "CYGA", "DAY", "DEOK", "DOM", "DPL", "DUQ", "EAST", "EDE", "EKPC", "FREP", "FWES", "GRDA", "INDN", "JC", "JICA", "KACY", "KAFB", "KCEC", "KCPL", "LAC", "LES", "ME", "MPS", "NCEN", "NPPD", "NRTH", "NTUA", "OKGE", "OPPD", "PE", "PEP", "PGAE", "PL", "PN", "PNM", "PRPA", "PS", "RECO", "SCE", "SCEN", "SDE", "SDGE", "SECI", "SOUT", "SPRM", "SPS", "TSGT", "VEA", "WACM", "WAUE", "WAUW", "WEST", "WFEC", "WR", "WYE", "ZONA", "ZONB", "ZONC", "ZOND", "ZONE", "ZONF", "ZONG", "ZONH", "ZONI", "ZONJ", "ZONK" ] } }, { "name": "demand_reported_mwh", "type": "number", "description": "Originally reported electricity demand, calculated by taking the net generation within the BA and subtracting the interchange with adjacent BAs.", "unit": "MWh" }, { "name": "demand_imputed_pudl_mwh", "type": "number", "description": "Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed in PUDL.", "unit": "MWh" }, { "name": "demand_imputed_pudl_mwh_imputation_code", "type": "string", "description": "Code describing why a demand value was flagged for imputation.", "constraints": { "enum": [ "local_outlier_high", "global_outlier_neighbor", "identical_run", "anomalous_region", "global_outlier", "local_outlier_low", "single_delta", "bad_year", "missing_value", "simulated", "double_delta", "negative_or_zero" ] } } ], "primaryKey": [ "datetime_utc", "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authority_subregions", "fields": [ "balancing_authority_code_eia", "balancing_authority_subregion_code_eia" ] } } ] }, "keywords": [ "MW", "MWh", "balancing authorities", "distribution", "eia", "eia930", "electric", "electricity", "energy", "energy information administration", "federal", "form 930", "generation", "government", "grid operations", "hourly", "interchange", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net generation", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 28762502, "hash": "sha256:02b552101e3585580c451908f4b183810d1e1e35f3b71edc6d97f09a339853c3" }, { "name": "out_eia__monthly_generators", "type": "table", "description": "Monthly time series of all generator attributes including calculated capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n report_date, plant_id_eia, generator_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* Due to coverage problems in other tables, some generators have heat rate estimates but not fuel cost estimates.\n\n* Not all columns are originally reported in or calculable from the input tables. Expect nulls.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes all monthly attributes\nfor all generators reported to EIA-860 and EIA-923.\n\nTo provide a complete picture of generator data, this table compiles data from many\ndifferent EIA tables, including directly reported, imputed and calculated columns.\nWe suggest using this table if you want to explore monthly attributes about generators\nand would rather use a more complete and denormalized table. If you are more interested\nin the originally reported values, we recommend searching for core_eia with the column\nyou are most interested in.\n\nThe calculations of capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh\nare based on the allocation of net generation reported on the basis of plant, prime mover\nand energy source to individual generators - which comes from this table:\n:ref:`out_eia923__monthly_generation_fuel_by_generator`.\n\nHeat rates by generator-monthly are estimated by using\nallocated estimates for per-generator net generation and fuel consumption as well as the\n:ref:`core_eia923__monthly_boiler_fuel` table, which reports fuel consumed by boiler.\nHeat rates are necessary to estimate the amount of fuel consumed by a generation unit,\nand thus the fuel cost per MWh generated.\n\nPlant specific fuel prices are taken from the\n:ref:`core_eia923__fuel_receipts_costs` table, which only has ~70% coverage,\nleading to some generators with heat rate estimates still lacking fuel cost\nestimates.\n\nThis table inherits canonicalized values for generators, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia__monthly_generators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "generator_operating_date", "type": "date", "description": "Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date." }, { "name": "generator_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the generator." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "planned_generator_retirement_date", "type": "date", "description": "Planned effective date of the scheduled retirement of the generator." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "fuel_cost_per_mmbtu_source", "type": "string", "description": "Indicates the source of the values in the fuel_cost_per_mmbtu column. The fuel cost either comes directly from the EIA forms (original), was filled in from the EIA's API using state-level averages (eiaapi), was filled in using a rolling average (rolling_avg) or When the records get aggregated together and contain multiple sources (mixed).", "constraints": { "enum": [ "original", "eiaapi", "rolling_avg", "mixed" ] } }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_cost_per_mwh", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "unit_heat_rate_mmbtu_per_mwh", "type": "number", "description": "Fuel content per unit of electricity generated. Coming from MCOE calculation.", "unit": "MMBTU_MWh" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "total_mmbtu", "type": "number", "description": "Total annual heat content of fuel consumed by a plant part record in the plant parts list." }, { "name": "associated_combined_heat_power", "type": "boolean", "description": "Indicates whether the generator is associated with a combined heat and power system" }, { "name": "bga_source", "type": "string", "description": "The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections)." }, { "name": "bypass_heat_recovery", "type": "boolean", "description": "Can this generator operate while bypassing the heat recovery steam generator?" }, { "name": "carbon_capture", "type": "boolean", "description": "Indicates whether the generator uses carbon capture technology." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "can_cofire_fuels", "type": "boolean", "description": "Whether the generator can co-fire fuels." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "current_planned_generator_operating_date", "type": "date", "description": "The most recently updated effective date on which the generator is scheduled to start operation" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "deliver_power_transgrid", "type": "boolean", "description": "Indicate whether the generator can deliver power to the transmission grid." }, { "name": "distributed_generation", "type": "boolean", "description": "Whether the generator is considered distributed generation" }, { "name": "duct_burners", "type": "boolean", "description": "Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas" }, { "name": "energy_source_1_transport_1", "type": "string", "description": "Primary mode of transport for energy source 1." }, { "name": "energy_source_1_transport_2", "type": "string", "description": "Secondary mode of transport for energy source 1." }, { "name": "energy_source_1_transport_3", "type": "string", "description": "Tertiary mode of transport for energy source 1." }, { "name": "energy_source_2_transport_1", "type": "string", "description": "Primary mode of transport for energy source 2." }, { "name": "energy_source_2_transport_2", "type": "string", "description": "Secondary mode of transport for energy source 2." }, { "name": "energy_source_2_transport_3", "type": "string", "description": "Tertiary mode of transport for energy source 2." }, { "name": "energy_source_code_2", "type": "string", "description": "The code representing the second most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_3", "type": "string", "description": "The code representing the third most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_4", "type": "string", "description": "The code representing the fourth most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_5", "type": "string", "description": "The code representing the fifth most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_6", "type": "string", "description": "The code representing the sixth most predominant type of energy that fuels the generator" }, { "name": "energy_storage_capacity_mwh", "type": "number", "description": "Energy storage capacity in MWh (e.g. for batteries).", "unit": "MWh" }, { "name": "ferc_qualifying_facility", "type": "boolean", "description": "Indicates whether or not a generator is a qualifying FERC cogeneration facility." }, { "name": "fluidized_bed_tech", "type": "boolean", "description": "Indicates whether the generator uses fluidized bed technology" }, { "name": "fuel_type_count", "type": "integer", "description": "A count of how many different simple energy sources there are associated with a generator." }, { "name": "latitude", "type": "number", "description": "Latitude of the plant's location, in degrees." }, { "name": "longitude", "type": "number", "description": "Longitude of the plant's location, in degrees." }, { "name": "minimum_load_mw", "type": "number", "description": "The minimum load at which the generator can operate at continuosuly.", "unit": "MW" }, { "name": "can_burn_multiple_fuels", "type": "boolean", "description": "Whether the generator can burn multiple fuels." }, { "name": "nameplate_power_factor", "type": "number", "description": "The nameplate power factor of the generator." }, { "name": "net_capacity_mwdc", "type": "number", "description": "Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.", "unit": "MW" }, { "name": "can_switch_when_operating", "type": "boolean", "description": "Indicates whether a fuel switching generator can switch fuels while operating." }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "original_planned_generator_operating_date", "type": "date", "description": "The date the generator was originally scheduled to be operational" }, { "name": "other_combustion_tech", "type": "boolean", "description": "Indicates whether the generator uses other combustion technologies" }, { "name": "other_modifications_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete." }, { "name": "other_planned_modifications", "type": "boolean", "description": "Indicates whether there are there other modifications planned for the generator." }, { "name": "owned_by_non_utility", "type": "boolean", "description": "Whether any part of generator is owned by a nonutilty" }, { "name": "ownership_code", "type": "string", "description": "Identifies the ownership for each generator." }, { "name": "planned_derate_date", "type": "date", "description": "Planned effective month that the generator is scheduled to enter operation after the derate modification." }, { "name": "planned_energy_source_code_1", "type": "string", "description": "New energy source code for the planned repowered generator." }, { "name": "planned_modifications", "type": "boolean", "description": "Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years." }, { "name": "planned_net_summer_capacity_derate_mw", "type": "number", "description": "Decrease in summer capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_net_summer_capacity_uprate_mw", "type": "number", "description": "Increase in summer capacity expected to be realized from the modification to the equipment.", "unit": "MW" }, { "name": "planned_net_winter_capacity_derate_mw", "type": "number", "description": "Decrease in winter capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_net_winter_capacity_uprate_mw", "type": "number", "description": "Increase in winter capacity expected to be realized from the uprate modification to the equipment.", "unit": "MW" }, { "name": "planned_new_capacity_mw", "type": "number", "description": "The expected new namplate capacity for the generator.", "unit": "MW" }, { "name": "planned_new_prime_mover_code", "type": "string", "description": "New prime mover for the planned repowered generator." }, { "name": "planned_repower_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the repowering is complete." }, { "name": "planned_uprate_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the uprate modification." }, { "name": "previously_canceled", "type": "boolean", "description": "Indicates whether the generator was previously reported as indefinitely postponed or canceled" }, { "name": "pulverized_coal_tech", "type": "boolean", "description": "Indicates whether the generator uses pulverized coal technology" }, { "name": "reactive_power_output_mvar", "type": "number", "description": "Reactive Power Output (MVAr)", "unit": "MVAr" }, { "name": "rto_iso_lmp_node_id", "type": "string", "description": "The designation used to identify the price node in RTO/ISO Locational Marginal Price reports" }, { "name": "rto_iso_location_wholesale_reporting_id", "type": "string", "description": "The designation used to report the specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report" }, { "name": "solid_fuel_gasification", "type": "boolean", "description": "Indicates whether the generator is part of a solid fuel gasification system" }, { "name": "startup_source_code_1", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_2", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_3", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_4", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "stoker_tech", "type": "boolean", "description": "Indicates whether the generator uses stoker technology" }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "subcritical_tech", "type": "boolean", "description": "Indicates whether the generator uses subcritical technology" }, { "name": "summer_capacity_estimate", "type": "boolean", "description": "Whether the summer capacity value was an estimate" }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "summer_estimated_capability_mw", "type": "number", "description": "EIA estimated summer capacity (in MWh).", "unit": "MWh" }, { "name": "supercritical_tech", "type": "boolean", "description": "Indicates whether the generator uses supercritical technology" }, { "name": "can_switch_oil_gas", "type": "boolean", "description": "Whether the generator can switch between oil and natural gas." }, { "name": "synchronized_transmission_grid", "type": "boolean", "description": "Indicates whether standby generators (SB status) can be synchronized to the grid." }, { "name": "time_cold_shutdown_full_load_code", "type": "string", "description": "The minimum amount of time required to bring the unit to full load from shutdown." }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } }, { "name": "topping_bottoming_code", "type": "string", "description": "If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle" }, { "name": "turbines_inverters_hydrokinetics", "type": "integer", "description": "Number of wind turbines, or hydrokinetic buoys." }, { "name": "turbines_num", "type": "integer", "description": "Number of wind turbines, or hydrokinetic buoys." }, { "name": "ultrasupercritical_tech", "type": "boolean", "description": "Indicates whether the generator uses ultra-supercritical technology" }, { "name": "uprate_derate_completed_date", "type": "date", "description": "The date when the uprate or derate was completed." }, { "name": "uprate_derate_during_year", "type": "boolean", "description": "Was an uprate or derate completed on this generator during the reporting year?" }, { "name": "winter_capacity_estimate", "type": "boolean", "description": "Whether the winter capacity value was an estimate" }, { "name": "winter_capacity_mw", "type": "number", "description": "The net winter capacity.", "unit": "MW" }, { "name": "winter_estimated_capability_mw", "type": "number", "description": "EIA estimated winter capacity (in MWh).", "unit": "MWh" }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_5" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_6" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "planned_energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_1" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_2" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_3" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_1" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_2" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_3" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id" ], "reference": { "resource": "core_eia__entity_generators", "fields": [ "plant_id_eia", "generator_id" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "planned_new_prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia" ], "reference": { "resource": "core_eia__entity_utilities", "fields": [ "utility_id_eia" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 56008412, "hash": "sha256:e9bba5e862e1efa54306f45851eee0cca26d684f1466132a5b7366d8a14c2a4a" }, { "name": "out_eia__yearly_assn_plant_parts_plant_gen", "type": "table", "description": "Annual Association table providing connections between plant parts (identified as ``record_id_eia``) and 'plant_gen' records (identified as ``record_id_eia_plant_gen``) from the :ref:`out_eia__yearly_plant_parts` table.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n record_id_eia, record_id_eia_plant_gen\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nThe purpose of this table is to help determine what generator records are associated\nwith every plant part record. The plant part records have a one to many relationship\nto the associated 'plant_gen' records. The 'plant_gen' records are also included in\nthe plant part records, so for these records there is a one to one relationship and\nthe ``record_id_eia`` and the ``record_id_eia_plant_gen`` are the same.\n\nAll of the columns in this table that have a suffix of '_plant_gen' are attributes of\nthe ``record_id_eia_plant_gen`` record.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia__yearly_assn_plant_parts_plant_gen.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id_eia", "type": "string", "description": "Identifier for EIA plant parts analysis records.", "constraints": { "required": true } }, { "name": "record_id_eia_plant_gen", "type": "string", "description": "Identifier for EIA plant parts analysis records which is at the plant_part level of plant_gen - meaning each record pertains to one generator.", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "ownership_record_type", "type": "string", "description": "Whether each generator record is for one owner or represents a total of all ownerships.", "constraints": { "enum": [ "owned", "total" ] } }, { "name": "generator_id_plant_gen", "type": "string", "description": "Generator ID of the record_id_eia_plant_gen record. This is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" }, { "name": "energy_source_code_1_plant_gen", "type": "string", "description": "Code representing the most predominant type of energy that fuels the record_id_eia_plant_gen's generator." }, { "name": "prime_mover_code_plant_gen", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG) associated with the record_id_eia_plant_gen." }, { "name": "unit_id_pudl_plant_gen", "type": "integer", "description": "Dynamically assigned PUDL unit id of the record_id_eia_plant_gen. WARNING: This ID is not guaranteed to be static long term as the input data and algorithm may evolve over time." }, { "name": "technology_description_plant_gen", "type": "string", "description": "High level description of the technology used by the record_id_eia_plant_gen's generator to produce electricity." }, { "name": "ferc_acct_name_plant_gen", "type": "string", "description": "Name of FERC account, derived from technology description and prime mover code. This name is associated with the record_id_eia_plant_gen record.", "constraints": { "enum": [ "Hydraulic", "Nuclear", "Steam", "Other" ] } }, { "name": "ferc1_generator_agg_id_plant_gen", "type": "integer", "description": "ID dynamically assigned by PUDL to EIA records with multiple matches to a single FERC ID in the FERC-EIA manual matching process. This ID is associated with the record_id_eia_plant_gen record. It depends on ferc1_generator_agg_id, which has not been updated since 2020, but only affects a couple hundred records total across all years." }, { "name": "generator_operating_year_plant_gen", "type": "integer", "description": "The year an associated plant_gen's generator went into service." }, { "name": "operational_status_pudl_plant_gen", "type": "string", "description": "The operating status of the asset using PUDL categories of the record_id_eia_plant_gen record .", "constraints": { "enum": [ "operating", "retired", "proposed" ] } }, { "name": "generators_number", "type": "integer", "description": "The number of generators associated with each ``record_id_eia``." } ], "primaryKey": [ "record_id_eia", "record_id_eia_plant_gen" ], "foreignKeys": [ { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "record_id_eia" ], "reference": { "resource": "out_eia__yearly_plant_parts", "fields": [ "record_id_eia" ] } }, { "fields": [ "record_id_eia_plant_gen" ], "reference": { "resource": "out_eia__yearly_plant_parts", "fields": [ "record_id_eia" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 122840821, "hash": "sha256:de8051a7dbed181a24d7a8160d5a0808cfa84247a095320edd8467a66cc16cfc" }, { "name": "out_eia__yearly_boilers", "type": "table", "description": "Annual time series of all EIA boiler attributes.\n\n\nMost-recent data:\n 2025\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n plant_id_eia, boiler_id, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table inherits canonicalized values for boilers, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia__yearly_boilers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "boiler_id", "type": "string", "description": "Alphanumeric boiler ID.", "constraints": { "required": true } }, { "name": "air_flow_100pct_load_cubic_feet_per_minute", "type": "number", "description": "Total air flow including excess air at 100 percent load, reported at standard temperature and pressure (i.e. 68 F and one atmosphere pressure).", "unit": "cfm" }, { "name": "boiler_fuel_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the boiler." }, { "name": "boiler_fuel_code_2", "type": "string", "description": "The code representing the second most predominant type of energy that fuels the boiler." }, { "name": "boiler_fuel_code_3", "type": "string", "description": "The code representing the third most predominant type of energy that fuels the boiler." }, { "name": "boiler_fuel_code_4", "type": "string", "description": "The code representing the fourth most predominant type of energy that fuels the boiler." }, { "name": "boiler_manufacturer", "type": "string", "description": "Name of boiler manufacturer." }, { "name": "boiler_manufacturer_code", "type": "string", "description": "EIA short code for boiler manufacturer." }, { "name": "boiler_operating_date", "type": "date", "description": "Date the boiler began or is planned to begin commercial operation." }, { "name": "boiler_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the boiler." }, { "name": "boiler_status", "type": "string", "description": "EIA short code identifying boiler operational status." }, { "name": "boiler_type", "type": "string", "description": "EIA short code indicating the standards under which the boiler is operating as described in the U.S. EPA regulation under 40 CFR." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "compliance_year_mercury", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for mercury emissions." }, { "name": "compliance_year_nox", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for nitrogen oxide emissions." }, { "name": "compliance_year_particulate", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for particulate matter emissions." }, { "name": "compliance_year_so2", "type": "integer", "description": "Year boiler was or is expected to be in compliance with federal, state and/or local regulations for sulfur dioxide emissions." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "efficiency_100pct_load", "type": "number", "description": "Boiler efficiency percentage when burning at 100 percent load to the nearest 0.1 percent." }, { "name": "efficiency_50pct_load", "type": "number", "description": "Boiler efficiency percentage when burning at 50 percent load to the nearest 0.1 percent." }, { "name": "firing_rate_using_coal_tons_per_hour", "type": "number", "description": "Design firing rate at maximum continuous steam flow for coal to the nearest 0.1 ton per hour.", "unit": "tons_per_hour" }, { "name": "firing_rate_using_gas_mcf_per_hour", "type": "number", "description": "Design firing rate at maximum continuous steam flow for gas to the nearest 0.1 cubic feet per hour.", "unit": "mcf_per_hour" }, { "name": "firing_rate_using_oil_bbls_per_hour", "type": "number", "description": "Design firing rate at maximum continuous steam flow for pet coke to the nearest 0.1 barrels per hour.", "unit": "bbls_per_hour" }, { "name": "firing_rate_using_other_fuels", "type": "number", "description": "Design firing rate at maximum continuous steam flow for energy sources other than coal, petroleum, or natural gas." }, { "name": "firing_type_1", "type": "string", "description": "EIA short code indicating the type of firing used by this boiler." }, { "name": "firing_type_2", "type": "string", "description": "EIA short code indicating the type of firing used by this boiler." }, { "name": "firing_type_3", "type": "string", "description": "EIA short code indicating the type of firing used by this boiler." }, { "name": "fly_ash_reinjection", "type": "boolean", "description": "Indicates whether the boiler is capable of re-injecting fly ash." }, { "name": "hrsg", "type": "boolean", "description": "indicates if the boiler is a heat recovery steam generator (HRSG)." }, { "name": "latitude", "type": "number", "description": "Latitude of the plant's location, in degrees." }, { "name": "longitude", "type": "number", "description": "Longitude of the plant's location, in degrees." }, { "name": "max_steam_flow_lbs_per_hour", "type": "number", "description": "Maximum continuous steam flow at 100 percent load.", "unit": "lb_per_hour" }, { "name": "mercury_control_existing_strategy_1", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_2", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_3", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_4", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_5", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_existing_strategy_6", "type": "string", "description": "Existing strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_proposed_strategy_1", "type": "string", "description": "Proposed strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_proposed_strategy_2", "type": "string", "description": "Proposed strategy to comply with the most stringent mercury regulation." }, { "name": "mercury_control_proposed_strategy_3", "type": "string", "description": "Proposed strategy to comply with the most stringent mercury regulation." }, { "name": "new_source_review", "type": "boolean", "description": "Indicates whether the boiler is subject to New Source Review requirements." }, { "name": "new_source_review_date", "type": "date", "description": "Month of issued New Source Review permit." }, { "name": "new_source_review_permit", "type": "string", "description": "New Source Review permit number." }, { "name": "nox_control_existing_caaa_compliance_strategy_1", "type": "string", "description": "Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_existing_caaa_compliance_strategy_2", "type": "string", "description": "Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_existing_caaa_compliance_strategy_3", "type": "string", "description": "Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_existing_strategy_1", "type": "string", "description": "Existing strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_existing_strategy_2", "type": "string", "description": "Existing strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_existing_strategy_3", "type": "string", "description": "Existing strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_manufacturer", "type": "string", "description": "Name of nitrogen oxide control manufacturer." }, { "name": "nox_control_manufacturer_code", "type": "string", "description": "Code indicating the nitrogen oxide control burner manufacturer." }, { "name": "nox_control_out_of_compliance_strategy_1", "type": "string", "description": "If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance." }, { "name": "nox_control_out_of_compliance_strategy_2", "type": "string", "description": "If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance." }, { "name": "nox_control_out_of_compliance_strategy_3", "type": "string", "description": "If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance." }, { "name": "nox_control_planned_caaa_compliance_strategy_1", "type": "string", "description": "Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_planned_caaa_compliance_strategy_2", "type": "string", "description": "Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_planned_caaa_compliance_strategy_3", "type": "string", "description": "Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "nox_control_proposed_strategy_1", "type": "string", "description": "Proposed strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_proposed_strategy_2", "type": "string", "description": "Proposed strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_proposed_strategy_3", "type": "string", "description": "Proposed strategy to comply with the most stringent nitrogen oxide regulation." }, { "name": "nox_control_status_code", "type": "string", "description": "Nitrogen oxide control status code." }, { "name": "particulate_control_out_of_compliance_strategy_1", "type": "string", "description": "If boiler is not in compliance with particulate matter regulations, strategy for compliance." }, { "name": "particulate_control_out_of_compliance_strategy_2", "type": "string", "description": "If boiler is not in compliance with particulate matter regulations, strategy for compliance." }, { "name": "particulate_control_out_of_compliance_strategy_3", "type": "string", "description": "If boiler is not in compliance with particulate matter regulations, strategy for compliance." }, { "name": "regulation_mercury", "type": "string", "description": "Most stringent type of statute or regulation code under which the boiler is operating for mercury control standards." }, { "name": "regulation_nox", "type": "string", "description": "EIA short code for most stringent type of statute or regulation code under which the boiler is operating for nitrogen oxide control standards." }, { "name": "regulation_particulate", "type": "string", "description": "EIA short code for most stringent type of statute or regulation code under which the boiler is operating for particulate matter control standards." }, { "name": "regulation_so2", "type": "string", "description": "EIA short code for most stringent type of statute or regulation code under which the boiler is operating for sulfur dioxide control standards." }, { "name": "so2_control_existing_caaa_compliance_strategy_1", "type": "string", "description": "Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_existing_caaa_compliance_strategy_2", "type": "string", "description": "Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_existing_caaa_compliance_strategy_3", "type": "string", "description": "Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_existing_strategy_1", "type": "string", "description": "Existing strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_existing_strategy_2", "type": "string", "description": "Existing strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_existing_strategy_3", "type": "string", "description": "Existing strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_out_of_compliance_strategy_1", "type": "string", "description": "If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance." }, { "name": "so2_control_out_of_compliance_strategy_2", "type": "string", "description": "If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance." }, { "name": "so2_control_out_of_compliance_strategy_3", "type": "string", "description": "If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance." }, { "name": "so2_control_planned_caaa_compliance_strategy_1", "type": "string", "description": "Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_planned_caaa_compliance_strategy_2", "type": "string", "description": "Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_planned_caaa_compliance_strategy_3", "type": "string", "description": "Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990." }, { "name": "so2_control_proposed_strategy_1", "type": "string", "description": "Proposed strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_proposed_strategy_2", "type": "string", "description": "Proposed strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "so2_control_proposed_strategy_3", "type": "string", "description": "Proposed strategy to comply with the most stringent sulfur dioxide regulation." }, { "name": "standard_nox_rate", "type": "number", "description": "Numeric value for the unit of measurement specified for nitrogen oxide." }, { "name": "standard_particulate_rate", "type": "number", "description": "Numeric value for the unit of measurement specified for particulate matter." }, { "name": "standard_so2_percent_scrubbed", "type": "number", "description": "The percent of sulfur dioxide to be scrubbed specified by the most stringent sulfur dioxide regulation." }, { "name": "standard_so2_rate", "type": "number", "description": "Numeric value for the unit of measurement specified for sulfur dioxide." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } }, { "name": "turndown_ratio", "type": "number", "description": "The turndown ratio for the boiler." }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "unit_nox", "type": "string", "description": "Numeric value for the unit of measurement specified for nitrogen oxide." }, { "name": "unit_particulate", "type": "string", "description": "Numeric value for the unit of measurement specified for particulate matter." }, { "name": "unit_so2", "type": "string", "description": "Numeric value for the unit of measurement specified for sulfur dioxide." }, { "name": "waste_heat_input_mmbtu_per_hour", "type": "number", "description": "Design waste-heat input rate at maximum continuous steam flow where a waste-heat boiler is a boiler that receives all or a substantial portion of its energy input from the noncumbustible exhaust gases of a separate fuel-burning process (MMBTU per hour).", "unit": "MMBTU_per_hour" }, { "name": "wet_dry_bottom", "type": "string", "description": "Wet or Dry Bottom where Wet Bottom is defined as slag tanks that are installed at furnace throat to contain and remove molten ash from the furnace, and Dry Bottom is defined as having no slag tanks at furnace throat area, throat area is clear, and bottom ash drops through throat to bottom ash water hoppers.", "unit": "MMBTU_per_hour" }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } } ], "primaryKey": [ "plant_id_eia", "boiler_id", "report_date" ], "foreignKeys": [ { "fields": [ "boiler_type" ], "reference": { "resource": "core_eia__codes_boiler_types", "fields": [ "code" ] } }, { "fields": [ "boiler_status" ], "reference": { "resource": "core_eia__codes_boiler_status", "fields": [ "code" ] } }, { "fields": [ "boiler_manufacturer_code" ], "reference": { "resource": "core_eia__codes_environmental_equipment_manufacturers", "fields": [ "code" ] } }, { "fields": [ "nox_control_manufacturer_code" ], "reference": { "resource": "core_eia__codes_environmental_equipment_manufacturers", "fields": [ "code" ] } }, { "fields": [ "firing_type_1" ], "reference": { "resource": "core_eia__codes_firing_types", "fields": [ "code" ] } }, { "fields": [ "firing_type_2" ], "reference": { "resource": "core_eia__codes_firing_types", "fields": [ "code" ] } }, { "fields": [ "firing_type_3" ], "reference": { "resource": "core_eia__codes_firing_types", "fields": [ "code" ] } }, { "fields": [ "nox_control_existing_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_existing_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_existing_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_out_of_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_out_of_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_out_of_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_planned_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_planned_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_planned_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_nox_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "nox_control_status_code" ], "reference": { "resource": "core_eia__codes_nox_control_status", "fields": [ "code" ] } }, { "fields": [ "unit_nox" ], "reference": { "resource": "core_eia__codes_nox_units", "fields": [ "code" ] } }, { "fields": [ "mercury_control_proposed_strategy_1" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_proposed_strategy_2" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_proposed_strategy_3" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_1" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_2" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_3" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_4" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_5" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "mercury_control_existing_strategy_6" ], "reference": { "resource": "core_eia__codes_mercury_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "particulate_control_out_of_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_particulate_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "particulate_control_out_of_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_particulate_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "particulate_control_out_of_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_particulate_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "unit_particulate" ], "reference": { "resource": "core_eia__codes_particulate_units", "fields": [ "code" ] } }, { "fields": [ "regulation_nox" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "regulation_particulate" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "regulation_so2" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "regulation_mercury" ], "reference": { "resource": "core_eia__codes_regulations", "fields": [ "code" ] } }, { "fields": [ "so2_control_existing_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_existing_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_existing_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_out_of_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_out_of_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_out_of_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_planned_caaa_compliance_strategy_1" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_planned_caaa_compliance_strategy_2" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "so2_control_planned_caaa_compliance_strategy_3" ], "reference": { "resource": "core_eia__codes_so2_compliance_strategies", "fields": [ "code" ] } }, { "fields": [ "wet_dry_bottom" ], "reference": { "resource": "core_eia__codes_wet_dry_bottom", "fields": [ "code" ] } }, { "fields": [ "unit_so2" ], "reference": { "resource": "core_eia__codes_so2_units", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "boiler_fuel_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "boiler_id", "report_date" ], "reference": { "resource": "core_eia860__scd_boilers", "fields": [ "plant_id_eia", "boiler_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2981524, "hash": "sha256:39fc16ebdab18ec55d694aa249e849ef97576135c0dc116375a49465791c0947" }, { "name": "out_eia__yearly_generators", "type": "table", "description": "Annual time series of all generator attributes including calculated capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n report_date, plant_id_eia, generator_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* Due to coverage problems in other tables, some generators have heat rate estimates but not fuel cost estimates.\n\n* Not all columns are originally reported in or calculable from the input tables. Expect nulls.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes all yearly attributes\nfor all generators reported to EIA-860 and EIA-923.\n\nTo provide a complete picture of generator data, this table compiles data from many\ndifferent EIA tables, including directly reported, imputed and calculated columns.\nWe suggest using this table if you want to explore yearly attributes about generators\nand would rather use a more complete and denormalized table. If you are more interested\nin the originally reported values, we recommend searching for core_eia with the column\nyou are most interested in.\n\nThe calculations of capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh\nare based on the allocation of net generation reported on the basis of plant, prime mover\nand energy source to individual generators - which comes from this table:\n:ref:`out_eia923__yearly_generation_fuel_by_generator`.\n\nHeat rates by generator-yearly are estimated by using\nallocated estimates for per-generator net generation and fuel consumption as well as the\n:ref:`core_eia923__monthly_boiler_fuel` table, which reports fuel consumed by boiler.\nHeat rates are necessary to estimate the amount of fuel consumed by a generation unit,\nand thus the fuel cost per MWh generated.\n\nPlant specific fuel prices are taken from the\n:ref:`core_eia923__fuel_receipts_costs` table, which only has ~70% coverage,\nleading to some generators with heat rate estimates still lacking fuel cost\nestimates.\n\nThis table inherits canonicalized values for generators, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" } ], "path": "out_eia__yearly_generators.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!", "constraints": { "required": true } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "generator_operating_date", "type": "date", "description": "Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date." }, { "name": "generator_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the generator." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "planned_generator_retirement_date", "type": "date", "description": "Planned effective date of the scheduled retirement of the generator." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "fuel_cost_per_mmbtu_source", "type": "string", "description": "Indicates the source of the values in the fuel_cost_per_mmbtu column. The fuel cost either comes directly from the EIA forms (original), was filled in from the EIA's API using state-level averages (eiaapi), was filled in using a rolling average (rolling_avg) or When the records get aggregated together and contain multiple sources (mixed).", "constraints": { "enum": [ "original", "eiaapi", "rolling_avg", "mixed" ] } }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_cost_per_mwh", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "unit_heat_rate_mmbtu_per_mwh", "type": "number", "description": "Fuel content per unit of electricity generated. Coming from MCOE calculation.", "unit": "MMBTU_MWh" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "total_mmbtu", "type": "number", "description": "Total annual heat content of fuel consumed by a plant part record in the plant parts list." }, { "name": "associated_combined_heat_power", "type": "boolean", "description": "Indicates whether the generator is associated with a combined heat and power system" }, { "name": "bga_source", "type": "string", "description": "The source from where the unit_id_pudl is compiled. The unit_id_pudl comes directly from EIA 860, or string association (which looks at all the boilers and generators that are not associated with a unit and tries to find a matching string in the respective collection of boilers or generator), or from a unit connection (where the unit_id_eia is employed to find additional boiler generator connections)." }, { "name": "bypass_heat_recovery", "type": "boolean", "description": "Can this generator operate while bypassing the heat recovery steam generator?" }, { "name": "carbon_capture", "type": "boolean", "description": "Indicates whether the generator uses carbon capture technology." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "can_cofire_fuels", "type": "boolean", "description": "Whether the generator can co-fire fuels." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "current_planned_generator_operating_date", "type": "date", "description": "The most recently updated effective date on which the generator is scheduled to start operation" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "deliver_power_transgrid", "type": "boolean", "description": "Indicate whether the generator can deliver power to the transmission grid." }, { "name": "distributed_generation", "type": "boolean", "description": "Whether the generator is considered distributed generation" }, { "name": "duct_burners", "type": "boolean", "description": "Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas" }, { "name": "energy_source_1_transport_1", "type": "string", "description": "Primary mode of transport for energy source 1." }, { "name": "energy_source_1_transport_2", "type": "string", "description": "Secondary mode of transport for energy source 1." }, { "name": "energy_source_1_transport_3", "type": "string", "description": "Tertiary mode of transport for energy source 1." }, { "name": "energy_source_2_transport_1", "type": "string", "description": "Primary mode of transport for energy source 2." }, { "name": "energy_source_2_transport_2", "type": "string", "description": "Secondary mode of transport for energy source 2." }, { "name": "energy_source_2_transport_3", "type": "string", "description": "Tertiary mode of transport for energy source 2." }, { "name": "energy_source_code_2", "type": "string", "description": "The code representing the second most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_3", "type": "string", "description": "The code representing the third most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_4", "type": "string", "description": "The code representing the fourth most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_5", "type": "string", "description": "The code representing the fifth most predominant type of energy that fuels the generator" }, { "name": "energy_source_code_6", "type": "string", "description": "The code representing the sixth most predominant type of energy that fuels the generator" }, { "name": "energy_storage_capacity_mwh", "type": "number", "description": "Energy storage capacity in MWh (e.g. for batteries).", "unit": "MWh" }, { "name": "ferc_qualifying_facility", "type": "boolean", "description": "Indicates whether or not a generator is a qualifying FERC cogeneration facility." }, { "name": "fluidized_bed_tech", "type": "boolean", "description": "Indicates whether the generator uses fluidized bed technology" }, { "name": "fuel_type_count", "type": "integer", "description": "A count of how many different simple energy sources there are associated with a generator." }, { "name": "latitude", "type": "number", "description": "Latitude of the plant's location, in degrees." }, { "name": "longitude", "type": "number", "description": "Longitude of the plant's location, in degrees." }, { "name": "minimum_load_mw", "type": "number", "description": "The minimum load at which the generator can operate at continuosuly.", "unit": "MW" }, { "name": "can_burn_multiple_fuels", "type": "boolean", "description": "Whether the generator can burn multiple fuels." }, { "name": "nameplate_power_factor", "type": "number", "description": "The nameplate power factor of the generator." }, { "name": "net_capacity_mwdc", "type": "number", "description": "Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV.", "unit": "MW" }, { "name": "can_switch_when_operating", "type": "boolean", "description": "Indicates whether a fuel switching generator can switch fuels while operating." }, { "name": "operational_status_code", "type": "string", "description": "The operating status of the asset." }, { "name": "original_planned_generator_operating_date", "type": "date", "description": "The date the generator was originally scheduled to be operational" }, { "name": "other_combustion_tech", "type": "boolean", "description": "Indicates whether the generator uses other combustion technologies" }, { "name": "other_modifications_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete." }, { "name": "other_planned_modifications", "type": "boolean", "description": "Indicates whether there are there other modifications planned for the generator." }, { "name": "owned_by_non_utility", "type": "boolean", "description": "Whether any part of generator is owned by a nonutilty" }, { "name": "ownership_code", "type": "string", "description": "Identifies the ownership for each generator." }, { "name": "planned_derate_date", "type": "date", "description": "Planned effective month that the generator is scheduled to enter operation after the derate modification." }, { "name": "planned_energy_source_code_1", "type": "string", "description": "New energy source code for the planned repowered generator." }, { "name": "planned_modifications", "type": "boolean", "description": "Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years." }, { "name": "planned_net_summer_capacity_derate_mw", "type": "number", "description": "Decrease in summer capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_net_summer_capacity_uprate_mw", "type": "number", "description": "Increase in summer capacity expected to be realized from the modification to the equipment.", "unit": "MW" }, { "name": "planned_net_winter_capacity_derate_mw", "type": "number", "description": "Decrease in winter capacity expected to be realized from the derate modification to the equipment.", "unit": "MW" }, { "name": "planned_net_winter_capacity_uprate_mw", "type": "number", "description": "Increase in winter capacity expected to be realized from the uprate modification to the equipment.", "unit": "MW" }, { "name": "planned_new_capacity_mw", "type": "number", "description": "The expected new namplate capacity for the generator.", "unit": "MW" }, { "name": "planned_new_prime_mover_code", "type": "string", "description": "New prime mover for the planned repowered generator." }, { "name": "planned_repower_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the repowering is complete." }, { "name": "planned_uprate_date", "type": "date", "description": "Planned effective date that the generator is scheduled to enter operation after the uprate modification." }, { "name": "previously_canceled", "type": "boolean", "description": "Indicates whether the generator was previously reported as indefinitely postponed or canceled" }, { "name": "pulverized_coal_tech", "type": "boolean", "description": "Indicates whether the generator uses pulverized coal technology" }, { "name": "reactive_power_output_mvar", "type": "number", "description": "Reactive Power Output (MVAr)", "unit": "MVAr" }, { "name": "rto_iso_lmp_node_id", "type": "string", "description": "The designation used to identify the price node in RTO/ISO Locational Marginal Price reports" }, { "name": "rto_iso_location_wholesale_reporting_id", "type": "string", "description": "The designation used to report the specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report" }, { "name": "solid_fuel_gasification", "type": "boolean", "description": "Indicates whether the generator is part of a solid fuel gasification system" }, { "name": "startup_source_code_1", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_2", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_3", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "startup_source_code_4", "type": "string", "description": "The code representing the first, second, third or fourth start-up and flame stabilization energy source used by the combustion unit(s) associated with this generator." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "stoker_tech", "type": "boolean", "description": "Indicates whether the generator uses stoker technology" }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "subcritical_tech", "type": "boolean", "description": "Indicates whether the generator uses subcritical technology" }, { "name": "summer_capacity_estimate", "type": "boolean", "description": "Whether the summer capacity value was an estimate" }, { "name": "summer_capacity_mw", "type": "number", "description": "The net summer capacity.", "unit": "MW" }, { "name": "summer_estimated_capability_mw", "type": "number", "description": "EIA estimated summer capacity (in MWh).", "unit": "MWh" }, { "name": "supercritical_tech", "type": "boolean", "description": "Indicates whether the generator uses supercritical technology" }, { "name": "can_switch_oil_gas", "type": "boolean", "description": "Whether the generator can switch between oil and natural gas." }, { "name": "synchronized_transmission_grid", "type": "boolean", "description": "Indicates whether standby generators (SB status) can be synchronized to the grid." }, { "name": "time_cold_shutdown_full_load_code", "type": "string", "description": "The minimum amount of time required to bring the unit to full load from shutdown." }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } }, { "name": "topping_bottoming_code", "type": "string", "description": "If the generator is associated with a combined heat and power system, indicates whether the generator is part of a topping cycle or a bottoming cycle" }, { "name": "turbines_inverters_hydrokinetics", "type": "integer", "description": "Number of wind turbines, or hydrokinetic buoys." }, { "name": "turbines_num", "type": "integer", "description": "Number of wind turbines, or hydrokinetic buoys." }, { "name": "ultrasupercritical_tech", "type": "boolean", "description": "Indicates whether the generator uses ultra-supercritical technology" }, { "name": "uprate_derate_completed_date", "type": "date", "description": "The date when the uprate or derate was completed." }, { "name": "uprate_derate_during_year", "type": "boolean", "description": "Was an uprate or derate completed on this generator during the reporting year?" }, { "name": "winter_capacity_estimate", "type": "boolean", "description": "Whether the winter capacity value was an estimate" }, { "name": "winter_capacity_mw", "type": "number", "description": "The net winter capacity.", "unit": "MW" }, { "name": "winter_estimated_capability_mw", "type": "number", "description": "EIA estimated winter capacity (in MWh).", "unit": "MWh" }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } } ], "primaryKey": [ "report_date", "plant_id_eia", "generator_id" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "operational_status_code" ], "reference": { "resource": "core_eia__codes_operational_status", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_5" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_code_6" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_2" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_3" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "startup_source_code_4" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "planned_energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_1" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_2" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_1_transport_3" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_1" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_2" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "energy_source_2_transport_3" ], "reference": { "resource": "core_eia__codes_fuel_transportation_modes", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "planned_new_prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 10555973, "hash": "sha256:0227af3ec8ef9aeaa9797a7c6172f049cba5c2228ce05c26c0a476f18cfe5389" }, { "name": "out_eia__yearly_generators_by_ownership", "type": "table", "description": "Annual time series of all EIA generators with ownership integrated.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n This table has no primary key. This table would have a primary key of the following columns, except there are ~200 records without utility IDs: ['plant_id_eia', 'generator_id', 'report_date', 'utility_id_eia', 'ownership_record_type'].\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nGenerators that report to EIA can have\nmultiple utility owners. EIA reports the ownership fraction for each of the owners\nof generators (see :ref:`core_eia860__scd_ownership`). This table includes two records\nfor each generator's owner: one record represents a total ownership stake and the\nother record represents a proportional ownership stake (the ``ownership_record_type``\ncolumn labeled as \"total\" and \"owned\" respectively). All of the values reported for\nthese generator-owner records are scaled to the ownership stake (represented by\n``fraction_owned``).\n\nThis table was created to represent every possible version of ownership slices of the\nEIA generators. It is primarily used as an input to :ref:`out_eia__yearly_plant_parts`.\n\nThis table inherits canonicalized values for generators, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia__yearly_generators_by_ownership.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "generator_operating_date", "type": "date", "description": "Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date." }, { "name": "generator_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the generator." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "planned_generator_retirement_date", "type": "date", "description": "Planned effective date of the scheduled retirement of the generator." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "fuel_cost_per_mmbtu_source", "type": "string", "description": "Indicates the source of the values in the fuel_cost_per_mmbtu column. The fuel cost either comes directly from the EIA forms (original), was filled in from the EIA's API using state-level averages (eiaapi), was filled in using a rolling average (rolling_avg) or When the records get aggregated together and contain multiple sources (mixed).", "constraints": { "enum": [ "original", "eiaapi", "rolling_avg", "mixed" ] } }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_cost_per_mwh", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "unit_heat_rate_mmbtu_per_mwh", "type": "number", "description": "Fuel content per unit of electricity generated. Coming from MCOE calculation.", "unit": "MMBTU_MWh" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "total_mmbtu", "type": "number", "description": "Total annual heat content of fuel consumed by a plant part record in the plant parts list." }, { "name": "ferc_acct_name", "type": "string", "description": "Name of FERC account, derived from technology description and prime mover code.", "constraints": { "enum": [ "Hydraulic", "Nuclear", "Steam", "Other" ] } }, { "name": "generator_operating_year", "type": "integer", "description": "Year a generator went into service." }, { "name": "operational_status_pudl", "type": "string", "description": "The operating status of the asset using PUDL categories.", "constraints": { "enum": [ "operating", "retired", "proposed" ] } }, { "name": "capacity_eoy_mw", "type": "number", "description": "Total end of year installed (nameplate) capacity for a plant part, in megawatts.", "unit": "MW" }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "ownership_record_type", "type": "string", "description": "Whether each generator record is for one owner or represents a total of all ownerships.", "constraints": { "enum": [ "owned", "total" ] } } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 14039955, "hash": "sha256:e9460e46c666770fafd311d306495a9f696b4cf9bcfa94e9f916de5bf8957e50" }, { "name": "out_eia__yearly_plant_parts", "type": "table", "description": "Annual time series of all EIA plant parts, for use in matching to FERC 1.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n record_id_eia\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nPractically speaking, a plant is a collection of generator(s). There\nare many attributes of generators (i.e. prime mover, primary fuel source, technology\ntype). We can use these generator attributes to group generator records into larger\naggregate records which we call \"plant parts\". A plant part is a record which\ncorresponds to a particular collection of generators that all share an identical\nattribute and utility owner. E.g. all of the generators with unit_id=2, or all of the\ngenerators with coal as their primary fuel source.\n\nThe EIA data about power plants (from EIA 923 and 860) is reported in tables\nwith records that correspond to mostly generators and plants. Other datasets\n(cough cough FERC1) are less well organized and include plants, generators and\nother plant parts all in the same table without any clear labels. This plant part table\nis an attempt to create records corresponding to many different plant parts in order to\nconnect specific slices of EIA plants to other datasets.\n\nBecause generators are often owned by multiple utilities, another dimension of\nthis plant part table involves generating two records for each owner: one for the\nportion of the plant part they own and one for the plant part as a whole. The\nportion records are labeled in the ``ownership_record_type`` column as ``owned``\nand the total records are labeled as ``total``.\n\nThis table includes A LOT of duplicative information about EIA plants. It is primarily\nmeant for use as an input into the record linkage between FERC1 plants and EIA.\n\nThis table inherits canonicalized values for generators, plants, and utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia__yearly_plant_parts.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id_eia", "type": "string", "description": "Identifier for EIA plant parts analysis records.", "constraints": { "required": true } }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "plant_part", "type": "string", "description": "The part of the plant a record corresponds to.", "constraints": { "enum": [ "plant_ferc_acct", "plant_prime_fuel", "plant_unit", "plant_technology", "plant_prime_mover", "plant_operating_year", "plant_gen", "plant", "plant_match_ferc1" ] } }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "ferc_acct_name", "type": "string", "description": "Name of FERC account, derived from technology description and prime mover code.", "constraints": { "enum": [ "Hydraulic", "Nuclear", "Steam", "Other" ] } }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "true_gran", "type": "boolean", "description": "Indicates whether a plant part list record is associated with the highest priority plant part for all identical records." }, { "name": "appro_part_label", "type": "string", "description": "Plant part of the associated true granularity record.", "constraints": { "enum": [ "plant_ferc_acct", "plant_prime_fuel", "plant_unit", "plant_technology", "plant_prime_mover", "plant_operating_year", "plant_gen", "plant", "plant_match_ferc1" ] } }, { "name": "appro_record_id_eia", "type": "string", "description": "EIA record ID of the associated true granularity record." }, { "name": "ferc1_generator_agg_id", "type": "integer", "description": "ID dynamically assigned by PUDL to EIA records with multiple matches to a single FERC ID in the FERC-EIA manual matching process. The ID is manually assigned and has not been updated since 2020, but only affects a couple hundred records total across all years." }, { "name": "capacity_eoy_mw", "type": "number", "description": "Total end of year installed (nameplate) capacity for a plant part, in megawatts.", "unit": "MW" }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_cost_per_mwh", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "generator_retirement_date", "type": "date", "description": "Date of the scheduled or effected retirement of the generator." }, { "name": "unit_heat_rate_mmbtu_per_mwh", "type": "number", "description": "Fuel content per unit of electricity generated. Coming from MCOE calculation.", "unit": "MMBTU_MWh" }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "generator_operating_year", "type": "integer", "description": "Year a generator went into service." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "operational_status_pudl", "type": "string", "description": "The operating status of the asset using PUDL categories.", "constraints": { "enum": [ "operating", "retired", "proposed" ] } }, { "name": "ownership_record_type", "type": "string", "description": "Whether each generator record is for one owner or represents a total of all ownerships.", "constraints": { "enum": [ "owned", "total" ] } }, { "name": "ownership_dupe", "type": "boolean", "description": "Whether a plant part record has a duplicate record with different ownership status." }, { "name": "planned_generator_retirement_date", "type": "date", "description": "Planned effective date of the scheduled retirement of the generator." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "plant_name_ppe", "type": "string", "description": "Derived plant name that includes EIA plant name and other strings associated with ID and PK columns of the plant part." }, { "name": "plant_part_id_eia", "type": "string", "description": "Contains EIA plant ID, plant part, ownership, and EIA utility id" }, { "name": "record_count", "type": "integer", "description": "Number of distinct generator IDs that participated in the aggregation for a plant part list record." }, { "name": "total_fuel_cost", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "total_mmbtu", "type": "number", "description": "Total annual heat content of fuel consumed by a plant part record in the plant parts list." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "plant_id_report_year", "type": "string", "description": "PUDL plant ID and report year of the record." } ], "primaryKey": [ "record_id_eia" ], "foreignKeys": [ { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 173546474, "hash": "sha256:e4bfe719082f83cc3929d399e00921445733986133ca03481d60a52c7dbeea42" }, { "name": "out_eia__yearly_plants", "type": "table", "description": "Annual time series of all EIA plant attributes.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n plant_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table inherits canonicalized values for plants.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia__yearly_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration.", "constraints": { "required": true } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "latitude", "type": "number", "description": "Latitude of the plant's location, in degrees." }, { "name": "longitude", "type": "number", "description": "Longitude of the plant's location, in degrees." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] } }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "ash_impoundment", "type": "boolean", "description": "Is there an ash impoundment (e.g. pond, reservoir) at the plant?" }, { "name": "ash_impoundment_lined", "type": "boolean", "description": "If there is an ash impoundment at the plant, is the impoundment lined?" }, { "name": "ash_impoundment_status", "type": "string", "description": "If there is an ash impoundment at the plant, the ash impoundment status as of December 31 of the reporting year." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "datum", "type": "string", "description": "Geodetic coordinate system identifier (e.g. NAD27, NAD83, or WGS84)." }, { "name": "energy_storage", "type": "boolean", "description": "Indicates if the facility has energy storage capabilities." }, { "name": "ferc_cogen_docket_no", "type": "string", "description": "The docket number relating to the FERC cogenerator status. See FERC Form 556." }, { "name": "ferc_cogen_status", "type": "boolean", "description": "Indicates whether the plant has FERC qualifying facility cogenerator status. See FERC Form 556." }, { "name": "ferc_exempt_wholesale_generator_docket_no", "type": "string", "description": "The docket number relating to the FERC qualifying facility exempt wholesale generator status." }, { "name": "ferc_exempt_wholesale_generator", "type": "boolean", "description": "Indicates whether the plant has FERC qualifying facility exempt wholesale generator status" }, { "name": "ferc_small_power_producer_docket_no", "type": "string", "description": "The docket number relating to the FERC qualifying facility small power producer status. See FERC Form 556." }, { "name": "ferc_small_power_producer", "type": "boolean", "description": "Indicates whether the plant has FERC qualifying facility small power producer status. See FERC Form 556." }, { "name": "ferc_qualifying_facility_docket_no", "type": "string", "description": "The docket number relating to the FERC qualifying facility cogenerator status. See FERC Form 556." }, { "name": "grid_voltage_1_kv", "type": "number", "description": "Plant's grid voltage at point of interconnection to transmission or distribution facilities", "unit": "kV" }, { "name": "grid_voltage_2_kv", "type": "number", "description": "Plant's grid voltage at point of interconnection to transmission or distribution facilities", "unit": "kV" }, { "name": "grid_voltage_3_kv", "type": "number", "description": "Plant's grid voltage at point of interconnection to transmission or distribution facilities", "unit": "kV" }, { "name": "iso_rto_code", "type": "string", "description": "The code of the plant's ISO or RTO. NA if not reported in that year." }, { "name": "liquefied_natural_gas_storage", "type": "boolean", "description": "Indicates if the facility have the capability to store the natural gas in the form of liquefied natural gas." }, { "name": "natural_gas_local_distribution_company", "type": "string", "description": "Names of Local Distribution Company (LDC), connected to natural gas burning power plants." }, { "name": "natural_gas_storage", "type": "boolean", "description": "Indicates if the facility have on-site storage of natural gas." }, { "name": "natural_gas_pipeline_name_1", "type": "string", "description": "The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility." }, { "name": "natural_gas_pipeline_name_2", "type": "string", "description": "The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility." }, { "name": "natural_gas_pipeline_name_3", "type": "string", "description": "The name of the owner or operator of natural gas pipeline that connects directly to this facility or that connects to a lateral pipeline owned by this facility." }, { "name": "nerc_region", "type": "string", "description": "NERC region in which the plant is located", "constraints": { "enum": [ "BASN", "CALN", "CALS", "DSW", "ASCC", "ISONE", "ERCOT", "NORW", "NYISO", "PJM", "ROCK", "ECAR", "FRCC", "HICC", "MAAC", "MAIN", "MAPP", "MRO", "NPCC", "RFC", "SERC", "SPP", "TRE", "WECC", "WSCC", "MISO", "ECAR_MAAC", "MAPP_WECC", "RFC_SERC", "SPP_WECC", "MRO_WECC", "ERCOT_SPP", "SPP_TRE", "ERCOT_TRE", "MISO_TRE", "FRCC_SERC", "VI", "GU", "PR", "AS", "UNK" ] } }, { "name": "has_net_metering", "type": "boolean", "description": "Whether the plant has a net metering agreement in effect during the reporting year. (Only displayed for facilities that report the sun or wind as an energy source). This field was only reported up until 2015" }, { "name": "pipeline_notes", "type": "string", "description": "Additional owner or operator of natural gas pipeline." }, { "name": "primary_purpose_id_naics", "type": "integer", "description": "North American Industry Classification System (NAICS) code that best describes the primary purpose of the reporting plant" }, { "name": "regulatory_status_code", "type": "string", "description": "Indicates whether the plant is regulated or non-regulated." }, { "name": "reporting_frequency_code", "type": "string", "description": "Code that specifies what time period data has to be reported (i.e. monthly data or annual totals) and how often the power plant reports this data to EIA. See reporting_frequencies_eia for more details.", "constraints": { "enum": [ "A", "AM", "M" ] } }, { "name": "sector_id_eia", "type": "integer", "description": "EIA assigned sector ID, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "sector_name_eia", "type": "string", "description": "EIA assigned sector name, corresponding to high level NAICS sector, designated by the primary purpose, regulatory status and plant-level combined heat and power status" }, { "name": "service_area", "type": "string", "description": "Service area in which plant is located; for unregulated companies, it's the electric utility with which plant is interconnected" }, { "name": "transmission_distribution_owner_id", "type": "integer", "description": "EIA-assigned code for owner of transmission/distribution system to which the plant is interconnected." }, { "name": "transmission_distribution_owner_name", "type": "string", "description": "Name of the owner of the transmission or distribution system to which the plant is interconnected." }, { "name": "transmission_distribution_owner_state", "type": "string", "description": "State location for owner of transmission/distribution system to which the plant is interconnected." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "water_source", "type": "string", "description": "Name of water source associated with the plant." }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "balancing_authority_code_eia_consistent_rate", "type": "number", "description": "Percentage consistency of balancing authority code across entity records." } ], "primaryKey": [ "plant_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "reporting_frequency_code" ], "reference": { "resource": "core_eia__codes_reporting_frequencies", "fields": [ "code" ] } }, { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "sector_id_eia" ], "reference": { "resource": "core_eia__codes_sector_consolidated", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_plants", "fields": [ "plant_id_eia", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3300317, "hash": "sha256:37547815f2ea3b49bf0b032c05984dac0887f3466afbcddf7ca05626714df2ed" }, { "name": "out_eia__yearly_utilities", "type": "table", "description": "Annual time series of all EIA utility attributes.\n\n\nMost-recent data:\n 2026\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n EIA -- Mix of multiple EIA Forms\n\nPrimary key:\n utility_id_eia, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table inherits canonicalized values for utilities.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" } ], "path": "out_eia__yearly_utilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number.", "constraints": { "required": true } }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "street_address", "type": "string", "description": "Physical street address." }, { "name": "city", "type": "string", "description": "Name of the city." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "zip_code", "type": "string", "description": "Five digit US Zip Code.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "plants_reported_owner", "type": "boolean", "description": "Is the reporting entity an owner of power plants reported on Schedule 2 of the form?" }, { "name": "plants_reported_operator", "type": "boolean", "description": "Is the reporting entity an operator of power plants reported on Schedule 2 of the form?" }, { "name": "plants_reported_asset_manager", "type": "boolean", "description": "Is the reporting entity an asset manager of power plants reported on Schedule 2 of the form?" }, { "name": "plants_reported_other_relationship", "type": "boolean", "description": "Does the reporting entity have any other relationship to the power plants reported on Schedule 2 of the form?" }, { "name": "entity_type", "type": "string", "description": "Entity type of principal owner." }, { "name": "attention_line", "type": "string", "description": "Mail attention name of the operator/owner." }, { "name": "address_2", "type": "string", "description": "Second line of the address." }, { "name": "zip_code_4", "type": "string", "description": "Four digit US Zip Code suffix.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "contact_firstname", "type": "string", "description": "First name of utility contact 1." }, { "name": "contact_lastname", "type": "string", "description": "Last name of utility contact 1." }, { "name": "contact_title", "type": "string", "description": "Title of of utility contact 1." }, { "name": "phone_number", "type": "string", "description": "Phone number for utility contact 1." }, { "name": "phone_extension", "type": "string", "description": "Phone extension for utility contact 1" }, { "name": "contact_firstname_2", "type": "string", "description": "First name of utility contact 2." }, { "name": "contact_lastname_2", "type": "string", "description": "Last name of utility contact 2." }, { "name": "contact_title_2", "type": "string", "description": "Title of utility contact 2." }, { "name": "phone_number_2", "type": "string", "description": "Phone number for utility contact 2." }, { "name": "phone_extension_2", "type": "string", "description": "Phone extension for utility contact 2" }, { "name": "data_maturity", "type": "string", "description": "Maturity of the source data published by EIA that is reflected in this record. EIA releases data incrementally over time, including monthly updates, annual year-to-date updates, provisional early releases of annual data, and final annual release data that is not expected to change further. Records sourced from multiple upstream EIA datasets may have no well defined data maturity. Records whose values have been inferred within PUDL will also have no data maturity." } ], "primaryKey": [ "utility_id_eia", "report_date" ], "foreignKeys": [ { "fields": [ "data_maturity" ], "reference": { "resource": "core_pudl__codes_data_maturities", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2215076, "hash": "sha256:b101aeb61a29f1a1127e86d1fcc2c9c9dc594b1cea0136fe52977fb4c89b444c" }, { "name": "out_ferc1__yearly_all_plants", "type": "table", "description": "Annual time series of plants reported in the steam, small generators, hydro, and pumped storage tables.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 402, 404, 406 and 408)\n\nPrimary key:\n record_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Not all columns are originally reported in all of the input plant tables. Expect nulls.\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is a concatenation of the following plant tables:\n\n* `core_ferc1__yearly_steam_plants_sched402`\n* `core_ferc1__yearly_hydroelectric_plants_sched406`\n* `core_ferc1__yearly_small_plants_sched410`\n* `core_ferc1__yearly_pumped_storage_plants_sched408`", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_all_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_id_ferc1", "type": "integer", "description": "Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capex_annual_addition", "type": "number", "description": "Annual capital addition into `capex_total`.", "unit": "USD" }, { "name": "capex_annual_addition_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total`.", "unit": "USD" }, { "name": "capex_annual_per_kw", "type": "number", "description": "Annual capital addition into `capex_total` per kw.", "unit": "USD_per_kw" }, { "name": "capex_annual_per_mw", "type": "number", "description": "Annual capital addition into `capex_total` per MW.", "unit": "USD_per_MW" }, { "name": "capex_annual_per_mw_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total` per MW.", "unit": "USD_per_MW" }, { "name": "capex_annual_per_mwh", "type": "number", "description": "Annual capital addition into `capex_total` per MWh.", "unit": "USD_per_MWh" }, { "name": "capex_annual_per_mwh_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total` per MWh.", "unit": "USD_per_MWh" }, { "name": "capex_equipment", "type": "number", "description": "Cost of plant: equipment (USD).", "unit": "USD" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_wo_retirement_total", "type": "number", "description": "Total cost of plant (USD) without retirements.", "unit": "USD" }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "not_water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when not limited by condenser water.", "unit": "MW" }, { "name": "opex_allowances", "type": "number", "description": "Allowances.", "unit": "USD" }, { "name": "opex_boiler", "type": "number", "description": "Maintenance of boiler (or reactor) plant.", "unit": "USD" }, { "name": "opex_coolants", "type": "number", "description": "Cost of coolants and water (nuclear plants only)", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_fuel", "type": "number", "description": "Production expenses: fuel (USD).", "unit": "USD" }, { "name": "fuel_cost_per_mwh", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "opex_misc_power", "type": "number", "description": "Miscellaneous steam (or nuclear) expenses.", "unit": "USD" }, { "name": "opex_misc_steam", "type": "number", "description": "Maintenance of miscellaneous steam (or nuclear) plant.", "unit": "USD" }, { "name": "opex_nonfuel_per_mwh", "type": "number", "description": "Investments in non-fuel production expenses per Mwh.", "unit": "USD_per_Mwh" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "opex_plant", "type": "number", "description": "Production expenses: maintenance of electric plant (USD).", "unit": "USD" }, { "name": "opex_production_total", "type": "number", "description": "Total operating expenses.", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_steam", "type": "number", "description": "Steam expenses.", "unit": "USD" }, { "name": "opex_steam_other", "type": "number", "description": "Steam from other sources.", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_total_nonfuel", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_transfer", "type": "number", "description": "Steam transferred (Credit)." }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_capability_mw", "type": "number", "description": "Net plant capability in megawatts.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_type", "type": "string", "description": "Type of plant." }, { "name": "record_id", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when limited by condenser water.", "unit": "MW" }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_type", "type": "string", "description": "Type of fuel." }, { "name": "license_id_ferc1", "type": "integer", "description": "FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible." }, { "name": "opex_maintenance", "type": "number", "description": "Production expenses: Maintenance (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "capex_facilities", "type": "number", "description": "Cost of plant: reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "capex_roads", "type": "number", "description": "Cost of plant: roads, railroads, and bridges (USD).", "unit": "USD" }, { "name": "net_capacity_adverse_conditions_mw", "type": "number", "description": "Net plant capability under the least favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "net_capacity_favorable_conditions_mw", "type": "number", "description": "Net plant capability under the most favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "opex_dams", "type": "number", "description": "Production expenses: maintenance of reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "opex_generation_misc", "type": "number", "description": "Production expenses: miscellaneous power generation expenses (USD).", "unit": "USD" }, { "name": "opex_hydraulic", "type": "number", "description": "Production expenses: hydraulic expenses (USD).", "unit": "USD" }, { "name": "opex_misc_plant", "type": "number", "description": "Production expenses: maintenance of miscellaneous hydraulic plant (USD).", "unit": "USD" }, { "name": "opex_water_for_power", "type": "number", "description": "Production expenses: water for power (USD).", "unit": "USD" }, { "name": "ferc_license_id", "type": "string", "description": "The FERC license ID of a project." }, { "name": "capex_equipment_electric", "type": "number", "description": "Cost of plant: accessory electric equipment (USD).", "unit": "USD" }, { "name": "capex_equipment_misc", "type": "number", "description": "Cost of plant: miscellaneous power plant equipment (USD).", "unit": "USD" }, { "name": "capex_wheels_turbines_generators", "type": "number", "description": "Cost of plant: water wheels, turbines, and generators (USD).", "unit": "USD" }, { "name": "energy_used_for_pumping_mwh", "type": "number", "description": "Energy used for pumping, in megawatt-hours.", "unit": "MWh" }, { "name": "net_load_mwh", "type": "number", "description": "Net output for load (net generation - energy used for pumping) in megawatt-hours.", "unit": "MWh" }, { "name": "opex_production_before_pumping", "type": "number", "description": "Total production expenses before pumping (USD).", "unit": "USD" }, { "name": "opex_pumped_storage", "type": "number", "description": "Production expenses: pumped storage (USD).", "unit": "USD" }, { "name": "opex_pumping", "type": "number", "description": "Production expenses: We are here to PUMP YOU UP! (USD).", "unit": "USD" } ], "primaryKey": [ "record_id" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7356475, "hash": "sha256:ac61f5df592a9ab551205c9aa072fd885bba81cad9064a3e6aaa46868d98526a" }, { "name": "out_ferc1__yearly_balance_sheet_assets_sched110", "type": "table", "description": "Annual time series of utility assets and other debits.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110)\n\nPrimary key:\n utility_id_ferc1, report_year, asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_balance_sheet_assets_sched110.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "asset_type", "type": "string", "description": "Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.", "constraints": { "required": true } }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "asset_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4575588, "hash": "sha256:8c4f3b77e0310d400587e1f259f538bb271fa1c80a90974763e37f540e29e036" }, { "name": "out_ferc1__yearly_balance_sheet_liabilities_sched110", "type": "table", "description": "Annual time series of utility liabilities and other credits.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110)\n\nPrimary key:\n utility_id_ferc1, report_year, liability_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_balance_sheet_liabilities_sched110.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "liability_type", "type": "string", "description": "Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.", "constraints": { "required": true } }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "liability_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3908616, "hash": "sha256:25aec65ca0d35e560f32ebfd5ef8994c03809b0ce5c2f84e0b267e2ca43a9cae" }, { "name": "out_ferc1__yearly_cash_flows_sched120", "type": "table", "description": "Annual time series of utility cash flow.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 120)\n\nPrimary key:\n utility_id_ferc1, report_year, amount_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_cash_flows_sched120.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "amount_type", "type": "string", "description": "Label describing the type of amount being reported. This could be a balance or a change in value.", "constraints": { "required": true } }, { "name": "amount", "type": "number", "description": "Reported amount of dollars. This could be a balance or a change in value.", "unit": "USD" }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "amount_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2458266, "hash": "sha256:2edb5ab92e3516f8693e581f7c0defa3b38639dd82f97a9ff9efaf134c28fd2a" }, { "name": "out_ferc1__yearly_depreciation_by_function_sched219", "type": "table", "description": "Annual time series of ending balances in accumulated provision for depreciation of electric utility plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section B)\n\nPrimary key:\n utility_id_ferc1, report_year, depreciation_type, plant_function, plant_status, utility_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric utility plant refers to FERC Account 108. Section B includes the Balances at End of Year According to Functional Classification (plant_function).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_depreciation_by_function_sched219.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "depreciation_type", "type": "string", "description": "Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.", "constraints": { "required": true } }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).", "constraints": { "required": true } }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total).", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "depreciation_type", "plant_function", "plant_status", "utility_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1546470, "hash": "sha256:0bde90cb8ddc738726acf3552b56ec8038f85ca6df51867344be5c7c99ff4a94" }, { "name": "out_ferc1__yearly_depreciation_changes_sched219", "type": "table", "description": "Annual time series of changes in accumulated provision for depreciation of electric utility plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 219 - Section A)\n\nPrimary key:\n utility_id_ferc1, report_year, depreciation_type, plant_status, utility_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric utility plant refers to FERC Account 108.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_depreciation_changes_sched219.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "depreciation_type", "type": "string", "description": "Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc.", "constraints": { "required": true } }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total).", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "depreciation_type", "plant_status", "utility_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2275743, "hash": "sha256:8eb60859207608a277a526dded1c0d8a672c1c0e988e3458cd90e10bec99497e" }, { "name": "out_ferc1__yearly_depreciation_factors_sched336", "type": "table", "description": "Annual time series of factors used in estimating depreciation charges.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section C)\n\nPrimary key:\n This table has no primary key. This table is too unstructured to have a primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_depreciation_factors_sched336.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "depreciation_factors", "type": "string", "description": "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." }, { "name": "depreciable_plant_base", "type": "number", "description": "Depreciable plant balance (depreciable base) to which rates are applied.", "unit": "USD" }, { "name": "net_salvage_pct", "type": "number", "description": "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." }, { "name": "depreciation_rate", "type": "string", "description": "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." }, { "name": "mortality_curve_type", "type": "string", "description": "Description of the type of mortality curve selected in plant mortality studies prepared to assist in estimating average service lives." }, { "name": "order_num", "type": "number", "description": "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." }, { "name": "account_num", "type": "string", "description": "Account number(s) in connection with factors used in estimating depreciation charges." }, { "name": "service_life_avg", "type": "number", "description": "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." }, { "name": "remaining_life_avg", "type": "number", "description": "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." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4853770, "hash": "sha256:c31249146722dcd8b4211ce253af4e80627d185dcee9ea6c1d9d291572d93999" }, { "name": "out_ferc1__yearly_depreciation_summary_sched336", "type": "table", "description": "Annual time series of depreciation and amortization of electric plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 336 - Section A)\n\nPrimary key:\n utility_id_ferc1, report_year, plant_function, ferc_account_label\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric Plant refers to FERC Accounts 403, 404, and 405. This table only contains information from Section A: Summary of depreciation and amortization changes.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_depreciation_summary_sched336.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).", "constraints": { "required": true } }, { "name": "ferc_account_label", "type": "string", "description": "Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.", "constraints": { "required": true } }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" } ], "primaryKey": [ "utility_id_ferc1", "report_year", "plant_function", "ferc_account_label" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2077876, "hash": "sha256:e4f8f8f10b0e9a17371e47616662db05801379cd476fbeda3b0df8c9f6729774" }, { "name": "out_ferc1__yearly_detailed_balance_sheet_assets", "type": "table", "description": "Annual time series of granular, de-duplicated accounting data of utilities' balance sheet assets.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 110, 200, 204 and 219)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is derived from four FERC Form 1 accounting tables with nested calculations:\n\n* `core_ferc1__yearly_balance_sheet_assets_sched110`\n* `core_ferc1__yearly_utility_plant_summary_sched200`\n* `core_ferc1__yearly_plant_in_service_sched204`\n* `core_ferc1__yearly_depreciation_by_function_sched219`\n\nWe reconciled the nested calculations within these tables and then identified the most granular data across the tables.\nWe 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`).\nSee ``pudl.output.ferc1.Exploder`` for more details. This table was made entirely with support and direction from RMI.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_detailed_balance_sheet_assets.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "xbrl_factoid", "type": "string", "description": "The name of type of value which is a derivative of the XBRL fact name." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.)." }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total)." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "utility_type_other", "type": "string", "description": "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)." }, { "name": "in_rate_base", "type": "boolean", "description": "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." }, { "name": "rate_base_category", "type": "string", "description": "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.", "constraints": { "enum": [ "other_plant", "nuclear", "transmission", "net_nuclear_fuel", "distribution", "steam", "experimental_plant", "net_working_capital", "general_plant", "regional_transmission_and_market_operation", "other_production", "other_noncurrent_liabilities", "hydro", "net_utility_plant", "intangible_plant", "other_deferred_debits_and_credits", "net_regulatory_assets", "net_ADIT", "asset_retirement_costs", "utility_plant", "electric_plant_leased_to_others", "electric_plant_held_for_future_use", "non_utility_plant", "construction_work_in_progress", "AROs", "correction" ] } }, { "name": "table_name", "type": "string", "description": "The name of the PUDL database table where a given record originated from." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3345249, "hash": "sha256:b78de8a54620acfd0422277f900845cbc23e88511523eb7152848aa45ce69d13" }, { "name": "out_ferc1__yearly_detailed_balance_sheet_liabilities", "type": "table", "description": "Annual time series of granular, de-duplicated accounting data of utilities' balance sheet liabilities.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 110 and 118)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is derived from two FERC Form 1 accounting tables with nested calculations:\n\n* `core_ferc1__yearly_balance_sheet_liabilities_sched110`\n* `core_ferc1__yearly_retained_earnings_sched118`\n\nWe reconciled the nested calculations within these tables and then identified the most granular data across the tables.\nWe 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`).\nSee ``pudl.output.ferc1.Exploder`` for more details. This table was made entirely with support and direction from RMI.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_detailed_balance_sheet_liabilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "xbrl_factoid", "type": "string", "description": "The name of type of value which is a derivative of the XBRL fact name." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "in_rate_base", "type": "boolean", "description": "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." }, { "name": "rate_base_category", "type": "string", "description": "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.", "constraints": { "enum": [ "other_plant", "nuclear", "transmission", "net_nuclear_fuel", "distribution", "steam", "experimental_plant", "net_working_capital", "general_plant", "regional_transmission_and_market_operation", "other_production", "other_noncurrent_liabilities", "hydro", "net_utility_plant", "intangible_plant", "other_deferred_debits_and_credits", "net_regulatory_assets", "net_ADIT", "asset_retirement_costs", "utility_plant", "electric_plant_leased_to_others", "electric_plant_held_for_future_use", "non_utility_plant", "construction_work_in_progress", "AROs", "correction" ] } }, { "name": "table_name", "type": "string", "description": "The name of the PUDL database table where a given record originated from." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1407361, "hash": "sha256:7f2b4fdfb96a5c1bf0d25bbf9cfbc3eff15c7a59dc36bdd2339720675f21927f" }, { "name": "out_ferc1__yearly_detailed_income_statements", "type": "table", "description": "Annual time series of granular, de-duplicated accounting data of utilities' income statements.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 114, 300, 320 and 336)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is derived from four FERC Form 1 accounting tables with nested calculations:\n\n* :ref:`core_ferc1__yearly_income_statements_sched114`\n* :ref:`core_ferc1__yearly_depreciation_summary_sched336`\n* :ref:`core_ferc1__yearly_operating_expenses_sched320`\n* :ref:`core_ferc1__yearly_operating_revenues_sched300`\n\nWe reconciled the nested calculations within these tables and then identified the most granular data across the tables.\nWe 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`).\nSee ``pudl.output.ferc1.Exploder`` for more details. This table was made entirely with support and direction from RMI.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_detailed_income_statements.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "xbrl_factoid", "type": "string", "description": "The name of type of value which is a derivative of the XBRL fact name." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.)." }, { "name": "revenue_requirement_technology", "type": "string", "description": "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.", "constraints": { "enum": [ "administrative", "common_plant_electric", "customer_accounts", "customer_service", "distribution", "general", "hydraulic_production", "hydraulic_production_conventional", "hydraulic_production_pumped_storage", "intangible", "nuclear_production", "other", "other_electric_plant", "other_power_supply", "other_production", "purchased_power", "regional_transmission_and_market_operation", "sales", "steam_production", "transmission" ] } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "in_revenue_requirement", "type": "boolean", "description": "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." }, { "name": "revenue_requirement_category", "type": "string", "description": "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.", "constraints": { "enum": [ "depreciation_amortization_depletion", "depreciation_arc", "fuel", "investment_tax_credit", "maintenance", "non_fuel_operation", "other", "purchased_power", "regulatory_debits_credits", "taxes" ] } }, { "name": "table_name", "type": "string", "description": "The name of the PUDL database table where a given record originated from." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4733881, "hash": "sha256:729936877da4d1ab5f4ce05736177c9a4445508fa2ce71ea34a20ebe8e3812d2" }, { "name": "out_ferc1__yearly_energy_dispositions_sched401", "type": "table", "description": "Annual time series of dispositions of electric energy sold, exchanged, or stored.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)\n\nPrimary key:\n utility_id_ferc1, report_year, energy_disposition_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric Energy Account, dispositions only. Schedule 401a. Electricity utilities delivered to end users, internal losses, etc.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_energy_dispositions_sched401.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "energy_disposition_type", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "energy_mwh", "type": "number", "description": "Sources and uses of energy in MWh.", "unit": "MWh" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "energy_disposition_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 458202, "hash": "sha256:64f964ffb364393400509dab4dda7bc14fd34faa823d0a0b4c0c544393761d6d" }, { "name": "out_ferc1__yearly_energy_sources_sched401", "type": "table", "description": "Annual time series of sources of electric energy generated or purchased, exchanged and wheeled.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 401a)\n\nPrimary key:\n utility_id_ferc1, report_year, energy_source_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nElectric Energy Account, sources only. Schedule 401a. Amount of electricity the utility obtained from each of several sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_energy_sources_sched401.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "energy_source_type", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "energy_mwh", "type": "number", "description": "Sources and uses of energy in MWh.", "unit": "MWh" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "energy_source_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 603441, "hash": "sha256:022ea5de3f31db4123626af7e2345521a1b010f877f65e24136629fd0efe3778" }, { "name": "out_ferc1__yearly_hydroelectric_plants_sched406", "type": "table", "description": "Annual time series of plant statistics for large hydroelectric generating plants.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 406)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The ``plant_type`` and ``construction_type`` are standardized into categorical values from free-form strings.\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nLarge plants have an installed nameplate capacity of more than 10 MW.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_hydroelectric_plants_sched406.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "record_id", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capex_equipment", "type": "number", "description": "Cost of plant: equipment (USD).", "unit": "USD" }, { "name": "capex_facilities", "type": "number", "description": "Cost of plant: reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "capex_roads", "type": "number", "description": "Cost of plant: roads, railroads, and bridges (USD).", "unit": "USD" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "net_capacity_adverse_conditions_mw", "type": "number", "description": "Net plant capability under the least favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "net_capacity_favorable_conditions_mw", "type": "number", "description": "Net plant capability under the most favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "opex_dams", "type": "number", "description": "Production expenses: maintenance of reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_generation_misc", "type": "number", "description": "Production expenses: miscellaneous power generation expenses (USD).", "unit": "USD" }, { "name": "opex_hydraulic", "type": "number", "description": "Production expenses: hydraulic expenses (USD).", "unit": "USD" }, { "name": "opex_misc_plant", "type": "number", "description": "Production expenses: maintenance of miscellaneous hydraulic plant (USD).", "unit": "USD" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "opex_plant", "type": "number", "description": "Production expenses: maintenance of electric plant (USD).", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_total_nonfuel", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_water_for_power", "type": "number", "description": "Production expenses: water for power (USD).", "unit": "USD" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_type", "type": "string", "description": "Type of plant." }, { "name": "project_num", "type": "integer", "description": "FERC Licensed Project Number." } ], "primaryKey": [ "record_id" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 941324, "hash": "sha256:1b1bef436a993de61d7d9aa31a74a2850f7d73151bc7acc66c18729682fb694b" }, { "name": "out_ferc1__yearly_income_statements_sched114", "type": "table", "description": "Annual time series of utility income statements.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 114)\n\nPrimary key:\n utility_id_ferc1, report_year, utility_type, income_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_income_statements_sched114.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "income_type", "type": "string", "description": "Type of income reported in core_ferc1__yearly_income_statements_sched114 table.", "constraints": { "required": true } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "utility_type", "income_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 4191022, "hash": "sha256:11deec75a0b59511be5517ea8c0f7248ff6396a5e5e8b6de9d4f87259d8aa404" }, { "name": "out_ferc1__yearly_operating_expenses_sched320", "type": "table", "description": "Annual time series of operating and maintenance costs associated with producing electricity.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 320)\n\nPrimary key:\n utility_id_ferc1, report_year, expense_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_operating_expenses_sched320.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "expense_type", "type": "string", "description": "The type of expense.", "constraints": { "required": true } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "expense_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7125701, "hash": "sha256:9b71584122bf5c33e9b52622680af33c777db924f0d934f7538a04c48d38376b" }, { "name": "out_ferc1__yearly_operating_revenues_sched300", "type": "table", "description": "Annual time series of utilities' electric operating revenues.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 300)\n\nPrimary key:\n utility_id_ferc1, report_year, revenue_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_operating_revenues_sched300.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "revenue_type", "type": "string", "description": "Label describing types of revenues.", "constraints": { "required": true } }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "avg_customers_per_month", "type": "number", "description": "Average number of customers per month." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } } ], "primaryKey": [ "utility_id_ferc1", "report_year", "revenue_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1378940, "hash": "sha256:f3398aca92b47d1b907e7d4e089251fffca9577f287a956c77aae7626b424707" }, { "name": "out_ferc1__yearly_other_regulatory_assets_sched232", "type": "table", "description": "Annual time series of utilities' other regulatory assets, including rate order docket number.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 232)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_other_regulatory_assets_sched232.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." }, { "name": "additional_description", "type": "string", "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." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "debits", "type": "number", "description": "The increase (decrease) during the period in the value of other assets resulting from the ratemaking actions of regulatory agencies." }, { "name": "credits_written_off_recovered", "type": "number", "description": "Recovered amount of divestiture of other assets lacking physical substance resulting from the ratemaking actions of regulatory agencies." }, { "name": "account_detail", "type": "string", "description": "Description of the account number credited from making debit adjustment to other regulatory liabilities." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3576995, "hash": "sha256:3cd03219760eefea8408e77ace5c32d915e783a288f86e725494325ac2c84d3e" }, { "name": "out_ferc1__yearly_other_regulatory_liabilities_sched278", "type": "table", "description": "Annual time series of utilities' other regulatory liabilities, including rate order docket number.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 278)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_other_regulatory_liabilities_sched278.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "description", "type": "string", "description": "Long human-readable description of the meaning of a code/label." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "increase_in_other_regulatory_liabilities", "type": "number", "description": "The increase during the reporting period of other regulatory liabilities.", "unit": "USD" }, { "name": "account_detail", "type": "string", "description": "Description of the account number credited from making debit adjustment to other regulatory liabilities." }, { "name": "decrease_in_other_regulatory_liabilities", "type": "number", "description": "The decrease during the reporting period of other regulatory liabilities.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1473057, "hash": "sha256:e87e2cdc74d4898d415510a3682ee3864102335880836dd61835f98c2be3a16f" }, { "name": "out_ferc1__yearly_plant_in_service_sched204", "type": "table", "description": "Annual time series of utilities' balances and changes to FERC Electric Plant in Service accounts.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 204)\n\nPrimary key:\n utility_id_ferc1, report_year, ferc_account_label\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAccount 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_plant_in_service_sched204.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total)." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "adjustments", "type": "number", "description": "Cost of adjustments to the account.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "ferc_account_label", "type": "string", "description": "Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts.", "constraints": { "required": true } }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "transfers", "type": "number", "description": "Cost of transfers into (out of) the account.", "unit": "USD" } ], "primaryKey": [ "utility_id_ferc1", "report_year", "ferc_account_label" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 8212466, "hash": "sha256:1842bc9d445bccb0dd843a64903f3f28d7e45b00c9daec6c3f6c09e7380d867e" }, { "name": "out_ferc1__yearly_pumped_storage_plants_sched408", "type": "table", "description": "Annual time series of plant statistics for hydroelectric pumped storage plants with an installed nameplate capacity of 10+ MW.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 408)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAs reported in Schedule 408 of FERC Form 1.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_pumped_storage_plants_sched408.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "record_id", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capex_equipment_electric", "type": "number", "description": "Cost of plant: accessory electric equipment (USD).", "unit": "USD" }, { "name": "capex_equipment_misc", "type": "number", "description": "Cost of plant: miscellaneous power plant equipment (USD).", "unit": "USD" }, { "name": "capex_facilities", "type": "number", "description": "Cost of plant: reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "capex_roads", "type": "number", "description": "Cost of plant: roads, railroads, and bridges (USD).", "unit": "USD" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_wheels_turbines_generators", "type": "number", "description": "Cost of plant: water wheels, turbines, and generators (USD).", "unit": "USD" }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "energy_used_for_pumping_mwh", "type": "number", "description": "Energy used for pumping, in megawatt-hours.", "unit": "MWh" }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "net_load_mwh", "type": "number", "description": "Net output for load (net generation - energy used for pumping) in megawatt-hours.", "unit": "MWh" }, { "name": "opex_dams", "type": "number", "description": "Production expenses: maintenance of reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_generation_misc", "type": "number", "description": "Production expenses: miscellaneous power generation expenses (USD).", "unit": "USD" }, { "name": "opex_misc_plant", "type": "number", "description": "Production expenses: maintenance of miscellaneous hydraulic plant (USD).", "unit": "USD" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "opex_plant", "type": "number", "description": "Production expenses: maintenance of electric plant (USD).", "unit": "USD" }, { "name": "opex_production_before_pumping", "type": "number", "description": "Total production expenses before pumping (USD).", "unit": "USD" }, { "name": "opex_pumped_storage", "type": "number", "description": "Production expenses: pumped storage (USD).", "unit": "USD" }, { "name": "opex_pumping", "type": "number", "description": "Production expenses: We are here to PUMP YOU UP! (USD).", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_total_nonfuel", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_water_for_power", "type": "number", "description": "Production expenses: water for power (USD).", "unit": "USD" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_capability_mw", "type": "number", "description": "Net plant capability in megawatts.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "project_num", "type": "integer", "description": "FERC Licensed Project Number." } ], "primaryKey": [ "record_id" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 127344, "hash": "sha256:61f1b431b43f4086a2f19023af9ad7a47e0c9b1cab2348c2d2479916efbfd232" }, { "name": "out_ferc1__yearly_purchased_power_and_exchanges_sched326", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 326)\n\nPrimary key:\n This table has no primary key. The primary key for this table would be record_id,\n however a small number of these values are duplicated in 2021, 2022, and 2024.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.\n\nPurchased Power is considered FERC Account 555 according to FERC's Uniform System of Accounts. Reported on pages 326-327 of FERC Form 1.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_purchased_power_and_exchanges_sched326.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "seller_name", "type": "string", "description": "Name of the seller, or the other party in an exchange transaction." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "billing_demand_mw", "type": "number", "description": "Monthly average billing demand (for requirements purchases, and any transactions involving demand charges). In megawatts.", "unit": "MW" }, { "name": "coincident_peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "delivered_mwh", "type": "number", "description": "Gross megawatt-hours delivered in power exchanges and used as the basis for settlement.", "unit": "MWh" }, { "name": "demand_charges", "type": "number", "description": "Demand charges (USD).", "unit": "USD" }, { "name": "energy_charges", "type": "number", "description": "Energy charges (USD).", "unit": "USD" }, { "name": "non_coincident_peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "other_charges", "type": "number", "description": "Other charges, including out-of-period adjustments (USD).", "unit": "USD" }, { "name": "purchase_type_code", "type": "string", "description": "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." }, { "name": "purchased_mwh", "type": "number", "description": "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.", "unit": "MWh" }, { "name": "purchased_storage_mwh", "type": "number", "description": "Number of megawatt hours purchased during the period for energy storage.", "unit": "MWh" }, { "name": "purchased_other_than_storage_mwh", "type": "number", "description": "Number of megawatt hours purchased during the period for other than energy storage.", "unit": "MWh" }, { "name": "received_mwh", "type": "number", "description": "Gross megawatt-hours received in power exchanges and used as the basis for settlement.", "unit": "MWh" }, { "name": "tariff", "type": "string", "description": "FERC Rate Schedule Number or Tariff. (Note: may be incomplete if originally reported on multiple lines.)" }, { "name": "total_settlement", "type": "number", "description": "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.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "purchase_type_code" ], "reference": { "resource": "core_ferc1__codes_power_purchase_types", "fields": [ "code" ] } }, { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 6194329, "hash": "sha256:ee1366d99201b35ae92721946790811e1b056b28f5579e45e8765c07a9f7667f" }, { "name": "out_ferc1__yearly_rate_base", "type": "table", "description": "Annual time series of granular accounting data consisting of what utilities can typically include in their rate bases.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedules 110, 118, 200, 204 219 and 320)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis 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.\nHere are the three direct upstream inputs - the two ``detailed`` tables have several ``core_ferc1`` inputs each:\n\n* :ref:`out_ferc1__yearly_detailed_balance_sheet_assets`\n* :ref:`out_ferc1__yearly_detailed_balance_sheet_liabilities`\n* :ref:`core_ferc1__yearly_operating_expenses_sched320`\n\nWe 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`).\nSee ``pudl.output.ferc1.Exploder`` for more details. This table was made entirely with support and direction from RMI.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_rate_base.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types.", "constraints": { "enum": [ "electric", "gas", "common", "other", "other3", "other2" ] } }, { "name": "plant_function", "type": "string", "description": "Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.).", "constraints": { "enum": [ "distribution", "experimental", "general", "hydraulic_production", "intangible", "nuclear_production", "other_production", "purchased_sold", "regional_transmission_and_market_operation", "steam_production", "transmission", "unclassified" ] } }, { "name": "plant_status", "type": "string", "description": "Utility plant financial status (in service, future, leased, total)." }, { "name": "xbrl_factoid", "type": "string", "description": "The name of type of value which is a derivative of the XBRL fact name." }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "utility_type_other", "type": "string", "description": "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)." }, { "name": "rate_base_category", "type": "string", "description": "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.", "constraints": { "enum": [ "other_plant", "nuclear", "transmission", "net_nuclear_fuel", "distribution", "steam", "experimental_plant", "net_working_capital", "general_plant", "regional_transmission_and_market_operation", "other_production", "other_noncurrent_liabilities", "hydro", "net_utility_plant", "intangible_plant", "other_deferred_debits_and_credits", "net_regulatory_assets", "net_ADIT", "asset_retirement_costs", "utility_plant", "electric_plant_leased_to_others", "electric_plant_held_for_future_use", "non_utility_plant", "construction_work_in_progress", "AROs", "correction" ] } }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "is_disaggregated_utility_type", "type": "boolean", "description": "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" }, { "name": "is_disaggregated_in_rate_base", "type": "boolean", "description": "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" }, { "name": "table_name", "type": "string", "description": "The name of the PUDL database table where a given record originated from." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2785893, "hash": "sha256:b7b3982ccbd664abdac98877031ea569a409ff99d5a1cd79a3da7f73cf851355" }, { "name": "out_ferc1__yearly_retained_earnings_sched118", "type": "table", "description": "Annual time series of utilities' statements of retained earnings.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 118)\n\nPrimary key:\n utility_id_ferc1, report_year, earnings_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_retained_earnings_sched118.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "record_id", "type": "string", "description": "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." }, { "name": "earnings_type", "type": "string", "description": "Label describing types of earnings.", "constraints": { "required": true } }, { "name": "starting_balance", "type": "number", "description": "Account balance at beginning of year.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "balance", "type": "string", "description": "Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy." }, { "name": "ferc_account", "type": "string", "description": "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." }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "earnings_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1059780, "hash": "sha256:1412c4b3b62107ab161ac5081823c81f6a098b84bdc5bba90b5e76d5db51a10b" }, { "name": "out_ferc1__yearly_sales_by_rate_schedules_sched304", "type": "table", "description": "Annual time series of utilities' electric sales from all rate schedules in effect throughout the year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 304)\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Values in rate_schedule_description are free-form strings.\n\n* Data prior to 2021 does not include information in columns: rate_schedule_type and billing_status.\n\n* Units of revenue_per_kwh are suspected to include a mix of dollars and possibly cents.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe pre-2021 data in this table (extracted from FoxProDB vs. XBRL) is\nextremely unstructured. Where the post-2020 data (from XBRL) sorts the data\ninto rate schedule types: residential, industrial, commercial,\npublic_lighting, public_authorities, railroads, interdepartmental,\nprovision_for_rate_refund, commercial_and_industrial, total, and billing\nstatus: billed, unbilled, total, the pre-2021 data stuffs all of that\ninformation (if you're lucky) into the rate_schedule_description column.\nThere's no point trying to parse through the pre 2021\nrate_schedule_description column en masse because it's just too messy. The\ncontents of rate_schedule_description often contain numbers and acronyms\nthat have little to no meaning out of context. The table is structured\nsomewhat like the FERC1 small generators table with headings about rate\nstructure type also embedded into the rate_schedule_description column. To\nall who dare, beware.\n\nThis table is a combination of one pre-2021 (DBF) table and nine post-2020\n(XBRL) tables--one for each rate schedule type plus totals--hence increase\nin data clarity post-2020. The rate_schedule_type and billing_status\ncolumns are only relevant for post-2020 data as they can be reliably parsed\nfrom each of the tables and incorporated into columns. The\nrate_schedule_description is supposed to contain sub-rate_schedule_type\nnames for charges (Ex: Residential 1, Residential 2, etc.). However, the\npre-2021 data contains a little bit of everything (or nothing) and the\npost-2020 has some totals or wonky data thrown in. That's to say, even when\nworking with post-2020 data, be wary of aggregating the data. That's what\nthe \"total\" rows are for.\n\nThe values that come from from the totals table are marked with the string\n\"total\" in the rate_schedule_description column. The totals table is a\nproduct of the transition to XBRL, so these distinguishable totals are only\navailable for data post-2020 (otherwise you could try keyword searching for\n\"total\" in rate_schedule_description). The total table contains two types of\ntotals, the utility totals across all rate schedules in a given year\n(marked with rate_schedule_description = \"total\" and rate_schedule_type =\n\"total\") and each of the utility's individual rate schedule totals in a\ngiven year (marked with rate_schedule_description = \"total\" and\nrate_schedule_type = \"residential\" or any other rate schedule type).\n\nThe rate schedule based XBRL tables only report billed values whereas the\ntotal tables report billed, unbilled, and total values. (See the column\ndescription for more info on the difference between billed and unbilled).\nThis is important to consider if you're endeavoring to compare the subtotal\nvalues with the total values. We have not attempted to fix or verify any\nsubtotals or totals that don't add up.\n\nAnother important note is the possibility of unit discrepancies in certain\ncolumns. The revenue_per_kwh column does not specify reporting units, and\ncloser inspection of the data reveals two clear peaks approximate two orders\nof magnitude apart. This indicates that values may be reported in both\ndollars and cents. However, because the price of energy per kwh varies\nso much regionally, we cannot guarantee which is which and have not put\nany cleaning mechanisms in place to account for this.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_sales_by_rate_schedules_sched304.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "rate_schedule_type", "type": "string", "description": "Categorization of rate schedule type." }, { "name": "billing_status", "type": "string", "description": "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." }, { "name": "rate_schedule_description", "type": "string", "description": "Free-form description of what the rate schedule name is. Not standardized. Often a sub-category of rate_schedule_type." }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "dollar_value", "type": "number", "description": "Dollar value of reported income, expense, asset, or liability.", "unit": "USD" }, { "name": "avg_customers_per_month", "type": "number", "description": "Average number of customers per month." }, { "name": "kwh_per_customer", "type": "number", "description": "kWh per customer." }, { "name": "revenue_per_kwh", "type": "number", "description": "The amount of revenue per kWh by rate schedule acquired in the given report year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 7610919, "hash": "sha256:9ffcfa60f0973542b32f5274b09526f01ec88960f3c92e8e18646ccbec8c1d7a" }, { "name": "out_ferc1__yearly_small_plants_sched410", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 410)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nAs reported on FERC Form 1 Schedule 410 (pages 410-411)\nand extracted from the FERC Visual FoxPro and XBRL. See our\n``pudl.extract.ferc1.TABLE_NAME_MAP_FERC1`` for links to the raw tables.\n\nThe raw version of this table is more like a digitized PDF than an actual data table.\nThe rows contain lots of information in addition to what the columns might suggest.\nFor instance, a single column may contain header rows, note rows, and total rows. This\nextraneous information is useful, but it prevents proper analysis when mixed in with the\nrest of the values data in the column. We employ a couple of data transformations to\nextract these rows from the data and preserve some of the information they contain\n(fuel type, plant type, FERC license, or general notes about the plant) in separate\ncolumns.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_small_plants_sched410.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "record_id", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_type", "type": "string", "description": "Type of fuel." }, { "name": "license_id_ferc1", "type": "integer", "description": "FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "opex_fuel", "type": "number", "description": "Production expenses: fuel (USD).", "unit": "USD" }, { "name": "opex_maintenance", "type": "number", "description": "Production expenses: Maintenance (USD).", "unit": "USD" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_total_nonfuel", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_type", "type": "string", "description": "Type of plant." } ], "primaryKey": [ "record_id" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 925721, "hash": "sha256:43379c9891c8e74555bc82aaf2da09432295d9dfb8e3c86d05f2a57b1e5d7800" }, { "name": "out_ferc1__yearly_steam_plants_fuel_by_plant_sched402", "type": "table", "description": "Annual time series of FERC fuel data by plant.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)\n\nPrimary key:\n report_year, utility_id_ferc1, plant_name_ferc1\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_steam_plants_fuel_by_plant_sched402.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant.", "constraints": { "required": true } }, { "name": "coal_fraction_cost", "type": "number", "description": "Coal cost as a percentage of overall fuel cost." }, { "name": "coal_fraction_mmbtu", "type": "number", "description": "Coal heat content as a percentage of overall fuel heat content (MMBTU)." }, { "name": "fuel_cost", "type": "number", "description": "Total fuel cost for plant (in $USD).", "unit": "USD" }, { "name": "fuel_mmbtu", "type": "number", "description": "Total heat content for plant (in MMBTU).", "unit": "MMBTU" }, { "name": "gas_fraction_cost", "type": "number", "description": "Natural gas cost as a percentage of overall fuel cost." }, { "name": "gas_fraction_mmbtu", "type": "number", "description": "Natural gas heat content as a percentage of overall fuel heat content (MMBTU)." }, { "name": "nuclear_fraction_cost", "type": "number", "description": "Nuclear cost as a percentage of overall fuel cost." }, { "name": "nuclear_fraction_mmbtu", "type": "number", "description": "Nuclear heat content as a percentage of overall fuel heat content (MMBTU)." }, { "name": "oil_fraction_cost", "type": "number", "description": "Oil cost as a percentage of overall fuel cost." }, { "name": "oil_fraction_mmbtu", "type": "number", "description": "Oil heat content as a percentage of overall fuel heat content (MMBTU)." }, { "name": "primary_fuel_by_cost", "type": "string", "description": "Primary fuel for plant as a percentage of cost." }, { "name": "primary_fuel_by_mmbtu", "type": "string", "description": "Primary fuel for plant as a percentage of heat content." }, { "name": "waste_fraction_cost", "type": "number", "description": "Waste-heat cost as a percentage of overall fuel cost." }, { "name": "waste_fraction_mmbtu", "type": "number", "description": "Waste-heat heat content as a percentage of overall fuel heat content (MMBTU)." } ], "primaryKey": [ "report_year", "utility_id_ferc1", "plant_name_ferc1" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 742068, "hash": "sha256:b3507e329424b85e3ad756a591f96241af0d4360aa0d9d3da0740a39b701d744" }, { "name": "out_ferc1__yearly_steam_plants_fuel_sched402", "type": "table", "description": "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. \n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)\n\nPrimary key:\n record_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The ``fuel_type_code_pudl`` is inferred from a free-form string field.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is a subset of the steam plant table reported on page 402 of FERC Form 1.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_steam_plants_fuel_sched402.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "fuel_consumed_mmbtu", "type": "number", "description": "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.", "unit": "MMBTU" }, { "name": "fuel_consumed_total_cost", "type": "number", "description": "Total cost of consumed fuel.", "unit": "USD" }, { "name": "fuel_consumed_units", "type": "number", "description": "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." }, { "name": "fuel_cost_per_mmbtu", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_cost_per_unit_burned", "type": "number", "description": "Average cost of fuel consumed in the report year per reported fuel unit (USD).", "unit": "USD" }, { "name": "fuel_cost_per_unit_delivered", "type": "number", "description": "Average cost of fuel delivered in the report year per reported fuel unit (USD).", "unit": "USD" }, { "name": "fuel_mmbtu_per_unit", "type": "number", "description": "Heat content of the fuel in millions of Btus per physical unit.", "unit": "MMBTU_per_unit" }, { "name": "fuel_type_code_pudl", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "fuel_units", "type": "string", "description": "Reported unit of measure for fuel.", "constraints": { "enum": [ "mmbtu", "gramsU", "kg", "mwhth", "kgal", "bbl", "klbs", "mcf", "gal", "mwdth", "btu", "ton" ] } }, { "name": "record_id", "type": "string", "description": "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.", "constraints": { "required": true } } ], "primaryKey": [ "record_id" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 2034093, "hash": "sha256:7804b6243246050fc89289abc725bc55280348b45bda2e9d56200b76c401c15f" }, { "name": "out_ferc1__yearly_steam_plants_sched402", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 402)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_steam_plants_sched402.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "plant_id_ferc1", "type": "integer", "description": "Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capex_annual_addition", "type": "number", "description": "Annual capital addition into `capex_total`.", "unit": "USD" }, { "name": "capex_annual_addition_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total`.", "unit": "USD" }, { "name": "capex_annual_per_kw", "type": "number", "description": "Annual capital addition into `capex_total` per kw.", "unit": "USD_per_kw" }, { "name": "capex_annual_per_mw", "type": "number", "description": "Annual capital addition into `capex_total` per MW.", "unit": "USD_per_MW" }, { "name": "capex_annual_per_mw_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total` per MW.", "unit": "USD_per_MW" }, { "name": "capex_annual_per_mwh", "type": "number", "description": "Annual capital addition into `capex_total` per MWh.", "unit": "USD_per_MWh" }, { "name": "capex_annual_per_mwh_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total` per MWh.", "unit": "USD_per_MWh" }, { "name": "capex_equipment", "type": "number", "description": "Cost of plant: equipment (USD).", "unit": "USD" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_wo_retirement_total", "type": "number", "description": "Total cost of plant (USD) without retirements.", "unit": "USD" }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "not_water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when not limited by condenser water.", "unit": "MW" }, { "name": "opex_allowances", "type": "number", "description": "Allowances.", "unit": "USD" }, { "name": "opex_boiler", "type": "number", "description": "Maintenance of boiler (or reactor) plant.", "unit": "USD" }, { "name": "opex_coolants", "type": "number", "description": "Cost of coolants and water (nuclear plants only)", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_fuel", "type": "number", "description": "Production expenses: fuel (USD).", "unit": "USD" }, { "name": "opex_fuel_per_mwh", "type": "number", "description": "Production expenses: fuel (USD) per megawatt-hour (Mwh).", "unit": "USD_per_Mwh" }, { "name": "opex_misc_power", "type": "number", "description": "Miscellaneous steam (or nuclear) expenses.", "unit": "USD" }, { "name": "opex_misc_steam", "type": "number", "description": "Maintenance of miscellaneous steam (or nuclear) plant.", "unit": "USD" }, { "name": "opex_nonfuel_per_mwh", "type": "number", "description": "Investments in non-fuel production expenses per Mwh.", "unit": "USD_per_Mwh" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "opex_plants", "type": "number", "description": "Maintenance of electrical plant.", "unit": "USD" }, { "name": "opex_production_total", "type": "number", "description": "Total operating expenses.", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_steam", "type": "number", "description": "Steam expenses.", "unit": "USD" }, { "name": "opex_steam_other", "type": "number", "description": "Steam from other sources.", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_total_nonfuel", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_transfer", "type": "number", "description": "Steam transferred (Credit)." }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_capability_mw", "type": "number", "description": "Net plant capability in megawatts.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_type", "type": "string", "description": "Type of plant." }, { "name": "record_id", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when limited by condenser water.", "unit": "MW" } ], "primaryKey": [ "record_id" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 5458756, "hash": "sha256:0715868d6197e162fd4a55f4118843e325fb4ee653d92b8ef7700f2708bddb97" }, { "name": "out_ferc1__yearly_transmission_lines_sched422", "type": "table", "description": "Annual time series of statistics about transmission lines.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 422)\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains columns which may appear categorical, but are actually free text.\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nInformation 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_transmission_lines_sched422.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id", "type": "string", "description": "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." }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "start_point", "type": "string", "description": "The starting point of a transmission line." }, { "name": "end_point", "type": "string", "description": "The end point of a transmission line." }, { "name": "operating_voltage_kv", "type": "number", "description": "The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines.", "unit": "KV" }, { "name": "designed_voltage_kv", "type": "number", "description": "Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines", "unit": "KV" }, { "name": "supporting_structure_type", "type": "string", "description": "Supporting structure of the transmission line." }, { "name": "transmission_line_length_miles", "type": "number", "description": "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)." }, { "name": "transmission_line_and_structures_length_miles", "type": "number", "description": "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)." }, { "name": "num_transmission_circuits", "type": "integer", "description": "Number of circuits in a transmission line." }, { "name": "conductor_size_and_material", "type": "string", "description": "Size of transmission conductor and material of the transmission line." }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_other", "type": "number", "description": "Other costs associated with the plant (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_maintenance", "type": "number", "description": "Production expenses: Maintenance (USD).", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 13547459, "hash": "sha256:f5e29d8c750d66c48c104ffe89a2bf635e097d15eef84e61cf9c0617547efffd" }, { "name": "out_ferc1__yearly_utility_plant_summary_sched200", "type": "table", "description": "Annual time series of utility plant and accumulated provisions for depreciation, amortization and depletion of utility plant assets.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 1 -- Annual Report of Major Electric Utilities (Schedule 200)\n\nPrimary key:\n utility_id_ferc1, report_year, utility_type, utility_plant_asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_ferc1__yearly_utility_plant_summary_sched200.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported.", "constraints": { "required": true } }, { "name": "utility_id_ferc1", "type": "integer", "description": "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.", "constraints": { "required": true } }, { "name": "utility_id_ferc1_dbf", "type": "integer", "description": "FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_ferc1_xbrl", "type": "string", "description": "FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "utility_type", "type": "string", "description": "Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility.", "constraints": { "required": true } }, { "name": "utility_type_other", "type": "string", "description": "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)." }, { "name": "utility_plant_asset_type", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "row_type_xbrl", "type": "string", "description": "Indicates whether the value reported in the row is calculated, or uniquely reported within the table.", "constraints": { "enum": [ "calculated_value", "reported_value", "correction", "subdimension_correction" ] } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "record_id", "type": "string", "description": "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." } ], "primaryKey": [ "utility_id_ferc1", "report_year", "utility_type", "utility_plant_asset_type" ], "foreignKeys": [ { "fields": [ "utility_id_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_utilities", "fields": [ "utility_id_ferc1" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 1504063, "hash": "sha256:fdc9e7cc43f79575f68da7d3152193d5e4c61c6cbc0616e7ea9827fb6cbbe906" }, { "name": "out_ferc714__georeferenced_respondents", "type": "table", "description": "Annual summary of demand and other information about FERC-714 respondents.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report\n\nPrimary key:\n respondent_id_ferc714, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table differs from\n:ref:`out_ferc714__summarized_demand` in that it also\nincludes a geometry column describing the respondent's service territory in each year.\nThese service territories are based on the counties that the corresponding EIA-861\nrespondent reported serving in that year. There is sometimes ambiguity as to\nwhether a FERC-714 respondent should be interpreted as an individual utility or a\nbalancing authority. The ``respodent_type`` column indicates which type of entity has\nbeen assumed in determining the service territory from EIA-861 data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" }, { "name": "censusdp1tract", "title": "Census DP1 -- Profile of General Demographic Characteristics", "path": "https://www.census.gov/geographies/mapping-files/2010/geo/tiger-data.html", "description": "US Census Demographic Profile 1 (DP1) County and Tract GeoDatabase.", "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127048", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15685568", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censusdp1tract.html" }, { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "out_ferc714__georeferenced_respondents.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "geometry", "type": "string", "description": "Geospatial representation of the feature.", "geometry_format": "wkt" }, { "name": "eia_code", "type": "integer", "description": "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." }, { "name": "respondent_type", "type": "string", "description": "Whether a respondent to the FERC form 714 is a utility or a balancing authority.", "constraints": { "enum": [ "utility", "balancing_authority" ] } }, { "name": "respondent_name_ferc714", "type": "string", "description": "Name of the utility, balancing area authority, or planning authority responding to FERC Form 714." }, { "name": "balancing_authority_id_eia", "type": "integer", "description": "EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "population", "type": "number", "description": "County population, sourced from Census DP1 data." }, { "name": "area_km2", "type": "number", "description": "County area in km2.", "unit": "km2" }, { "name": "demand_annual_mwh", "type": "number", "description": "Annual electricity demand in a given report year.", "unit": "MWh" } ], "primaryKey": [ "respondent_id_ferc714", "report_date" ], "foreignKeys": [ { "fields": [ "balancing_authority_code_eia" ], "reference": { "resource": "core_eia__codes_balancing_authorities", "fields": [ "code" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "age", "annual", "balancing authority", "business model", "census", "censusdp1tract", "customer class", "demand response", "demand side management", "demographics", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "form 861", "gender", "generation", "geospatial", "gis", "government", "green pricing", "household", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "population", "power", "race", "service territory", "spatial", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 67526579, "hash": "sha256:ce78cfcc36876ae8fb9a9cb6cfb7c5eaf1f5c42f8faec3e88dbfc537260bfc9c" }, { "name": "out_ferc714__hourly_estimated_state_demand", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report\n\nPrimary key:\n state_id_fips, datetime_utc\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* Contains information from multiple raw inputs.\n\n* Large table; do not attempt to open with Excel.\n\n* Contains information from multiple raw inputs.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table uses hourly\nelectricity demand and information about service territories to estimate the total\nhourly electricity demand for each US state. Hourly demand is drawn from the FERC\n714, which reports at the balancing authority and utility level. Service territories\nfor utilities and balancing authorities are inferred from information in the EIA 861,\nincluding the counties served by each utility and the utilities that make up each\nbalancing authority.\n\nThis table uses the total electricity sales by state reported in the EIA 861 as a\nscaling factor to ensure that the magnitude of electricity sales is roughly correct, and\nobtains the shape of the demand curve from the hourly planning area demand reported in\nthe FERC 714.\n\nThis table includes the state FIPS codes - see :ref:`out_censusdp1tract__states` for\nadditional information about FIPS state codes.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" }, { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "out_ferc714__hourly_estimated_state_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "required": true, "pattern": "^\\d{2}$" } }, { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "demand_mwh", "type": "number", "description": "Electricity demand (energy) within a given timeframe.", "unit": "MWh" }, { "name": "scaled_demand_mwh", "type": "number", "description": "Estimated electricity demand scaled by the total sales within a state.", "unit": "MWh" } ], "primaryKey": [ "state_id_fips", "datetime_utc" ], "foreignKeys": [] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 163851988, "hash": "sha256:63bef35dc2f1c0e259236bc47bbff2ec653baf2a1b2b586799f94115e4e59dd4" }, { "name": "out_ferc714__hourly_planning_area_demand", "type": "table", "description": "Hourly time series of electricity demand by planning area.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report (Part III, Schedule 2a)\n\nPrimary key:\n respondent_id_ferc714, datetime_utc\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains rows where missing values were imputed.\n\n* The datetime_utc timestamps have been cleaned due to inconsistent datetime reporting. See :ref:`core_ferc714__hourly_planning_area_demand` for additional details.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table is based on :ref:`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 :ref:`core_pudl__codes_imputation_reasons` table.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "out_ferc714__hourly_planning_area_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714_csv", "type": "integer", "description": "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." }, { "name": "respondent_id_ferc714_xbrl", "type": "string", "description": "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." }, { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "timezone", "type": "string", "description": "IANA timezone name", "constraints": { "enum": [ "America/Anchorage", "America/Chicago", "America/Denver", "America/Los_Angeles", "America/New_York", "America/Phoenix", "Pacific/Honolulu" ] } }, { "name": "demand_reported_mwh", "type": "number", "description": "Originally reported electricity demand, calculated by taking the net generation within the BA and subtracting the interchange with adjacent BAs.", "unit": "MWh" }, { "name": "demand_imputed_pudl_mwh", "type": "number", "description": "Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed in PUDL.", "unit": "MWh" }, { "name": "demand_imputed_pudl_mwh_imputation_code", "type": "string", "description": "Code describing why a demand value was flagged for imputation.", "constraints": { "enum": [ "local_outlier_high", "global_outlier_neighbor", "identical_run", "anomalous_region", "global_outlier", "local_outlier_low", "single_delta", "bad_year", "missing_value", "simulated", "double_delta", "negative_or_zero" ] } } ], "primaryKey": [ "respondent_id_ferc714", "datetime_utc" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 225679780, "hash": "sha256:6f079c21c0c0320a6b6a8db57197ab91d3878a13ac4fddcd520bb14193861651" }, { "name": "out_ferc714__respondents_with_fips", "type": "table", "description": "Annual respondents with the county FIPS IDs for their service territories.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report\n\nPrimary key:\n 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.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains information from multiple raw inputs.\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" }, { "name": "censusdp1tract", "title": "Census DP1 -- Profile of General Demographic Characteristics", "path": "https://www.census.gov/geographies/mapping-files/2010/geo/tiger-data.html", "description": "US Census Demographic Profile 1 (DP1) County and Tract GeoDatabase.", "keywords": [ "age", "census", "censusdp1tract", "demographics", "gender", "geospatial", "gis", "household", "population", "race", "spatial" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127048", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15685568", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/censusdp1tract.html" }, { "name": "eia861", "title": "EIA Form 861 -- Annual Electric Power Industry Report", "path": "https://www.eia.gov/electricity/data/eia861", "email": "infoelectric@eia.gov", "description": "EIA Form 861 Annual Electric Power Industry Report, detailed data files.", "keywords": [ "MW", "MWh", "advanced metering infrastructure", "annual", "balancing authority", "business model", "customer class", "demand response", "demand side management", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "form 861", "generation", "government", "green pricing", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "power", "service territory", "transmission", "united states", "us", "usa", "utility", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127028", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17846580", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia861.html" } ], "path": "out_ferc714__respondents_with_fips.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "eia_code", "type": "integer", "description": "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." }, { "name": "respondent_type", "type": "string", "description": "Whether a respondent to the FERC form 714 is a utility or a balancing authority.", "constraints": { "enum": [ "utility", "balancing_authority" ] } }, { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources." }, { "name": "respondent_name_ferc714", "type": "string", "description": "Name of the utility, balancing area authority, or planning authority responding to FERC Form 714." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "balancing_authority_id_eia", "type": "integer", "description": "EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "state", "type": "string", "description": "Two letter US state abbreviation." }, { "name": "county", "type": "string", "description": "County name." }, { "name": "state_id_fips", "type": "string", "description": "Two digit state FIPS code.", "constraints": { "pattern": "^\\d{2}$" } }, { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "pattern": "^\\d{5}$" } } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "advanced metering infrastructure", "age", "annual", "balancing authority", "business model", "census", "censusdp1tract", "customer class", "demand response", "demand side management", "demographics", "distribution", "eia", "eia861", "electric", "electricity", "energy", "energy efficiency", "energy information administration", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "form 861", "gender", "generation", "geospatial", "gis", "government", "green pricing", "household", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "net metering", "population", "power", "race", "service territory", "spatial", "transmission", "united states", "us", "usa", "utility", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 379540, "hash": "sha256:52947d3e2c45afe7be6dcdd52d45edf78bc784b8e06bbb5dc7f1135c36ccfcca" }, { "name": "out_ferc714__summarized_demand", "type": "table", "description": "Summarized demand statistics and FERC-714 respondent attributes by respondent-year.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report\n\nPrimary key:\n respondent_id_ferc714, report_date\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "ferc714", "title": "FERC Form 714 -- Annual Electric Balancing Authority Area and Planning Area Report", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-no-714-annual-electric", "email": "form714@ferc.gov", "description": "Electric transmitting utilities operating balancing authority areas and planning areas with annual peak demand over 200MW are required to file Form 714 with the Federal Energy Regulatory Commission (FERC), reporting balancing authority area generation, actual and scheduled inter-balancing authority area power transfers, and net energy for load, summer-winter generation peaks and system lambda.", "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127100", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.16676145", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc714.html" } ], "path": "out_ferc714__summarized_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "respondent_id_ferc714", "type": "integer", "description": "PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the original CSV and XBRL data sources.", "constraints": { "required": true } }, { "name": "demand_annual_mwh", "type": "number", "description": "Annual electricity demand in a given report year.", "unit": "MWh" }, { "name": "population", "type": "number", "description": "County population, sourced from Census DP1 data." }, { "name": "area_km2", "type": "number", "description": "County area in km2.", "unit": "km2" }, { "name": "population_density_km2", "type": "number", "description": "Average population per sq. km area of a service territory." }, { "name": "demand_annual_per_capita_mwh", "type": "number", "description": "Per-capita annual demand, averaged using Census county-level population estimates.", "unit": "MWh_per_person" }, { "name": "demand_density_mwh_km2", "type": "number", "description": "Annual demand per km2 of a given service territory.", "unit": "MWh_per_km2" }, { "name": "eia_code", "type": "integer", "description": "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." }, { "name": "respondent_type", "type": "string", "description": "Whether a respondent to the FERC form 714 is a utility or a balancing authority.", "constraints": { "enum": [ "utility", "balancing_authority" ] } }, { "name": "respondent_name_ferc714", "type": "string", "description": "Name of the utility, balancing area authority, or planning authority responding to FERC Form 714." }, { "name": "balancing_authority_id_eia", "type": "integer", "description": "EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity." }, { "name": "balancing_authority_code_eia", "type": "string", "description": "EIA short code identifying a balancing authority. May include Canadian and Mexican BAs." }, { "name": "balancing_authority_name_eia", "type": "string", "description": "Name of the balancing authority." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." } ], "primaryKey": [ "respondent_id_ferc714", "report_date" ], "foreignKeys": [ { "fields": [ "respondent_id_ferc714" ], "reference": { "resource": "core_pudl__assn_ferc714_pudl_respondents", "fields": [ "respondent_id_ferc714" ] } } ] }, "keywords": [ "MW", "MWh", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc714", "form 714", "generation", "government", "kW", "kWh", "kilowatt hours", "kilowatts", "megawatt hours", "megawatts", "power", "transmission", "united states", "us", "usa", "utility" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 73652, "hash": "sha256:a9e3823b354944f053834f5b1d3d159debc00914246e2534aa5d40f6ce7ba94e" }, { "name": "out_gridpathratoolkit__hourly_available_capacity_factor", "type": "table", "description": "Hourly time series of capacity factors defining the capacity available from an aggregated group of generators.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n GridPath Resource Adequacy Toolkit Data\n\nPrimary key:\n datetime_utc, aggregation_group\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Contains estimated values.\n\n* The original data is no longer being collected or reported in this way.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table contains a mix of profiles representing whole regions and individual plants, where the individual plants are hybrid wind or solar plus electricity storage facilities. Capacity factors are stated as a fraction of the aggregate nameplate capacity of the group.\n\nFor the hybrid facilities, the capacity factor represents the available output of only the renewable generators. Estimates of the generation profiles have been extended across a longer range of dates than the original data. For wind, the years 2015-2020 are synthesized data and for solar 2020 is synthesized. See the Appendix of the GridPath Resource Adequacy Toolkit report for details.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "gridpathratoolkit", "title": "GridPath Resource Adequacy Toolkit Data", "path": "https://gridlab.org/gridpathratoolkit/", "email": "elaine@sylvan.energy", "description": "Hourly renewable generation profiles compiled for the Western United States as part of the GridPath Resource Adequacy Toolkit. Profiles are stated as a capacity factor (a fraction of nameplate capacity). There are 3 different levels of processing or aggregation provided, all at hourly resolution: Individual plant (wind) or generator (solar) output, capacity-weighted averages of wind and solar output aggregated to the level of balancing authority territories (or transmission zones for larger balancing authorities), and that same aggregated output but with some problematic individual generator profiles modified such that they match the overall production curve of the balancing authority they are within. This data also contains some daily weather data from several sites across the western US and tables describing the way in which individual wind and solar projects were aggregated up to the level of balancing authority or transmission zone.", "keywords": [ "capacity factor", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "weather", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.10844661", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Elaine Hart", "path": "https://www.sylvan.energy/", "email": "elaine@sylvan.energy", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Sylvan Energy Analytics", "name": "elaine-hart" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.10892394", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/gridpathratoolkit.html" } ], "path": "out_gridpathratoolkit__hourly_available_capacity_factor.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "aggregation_group", "type": "string", "description": "A label identifying a group of aggregated generator capacity factors.", "constraints": { "required": true } }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." } ], "primaryKey": [ "datetime_utc", "aggregation_group" ], "foreignKeys": [] }, "keywords": [ "capacity factor", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "weather", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Elaine Hart", "path": "https://www.sylvan.energy/", "email": "elaine@sylvan.energy", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Sylvan Energy Analytics", "name": "elaine-hart" } ], "bytes": 55125056, "hash": "sha256:ab3c89975e4d7d35c539ba99fe956986f9d1bc71a3fdfc3951fa7e229fa43b77" }, { "name": "out_pudl__yearly_assn_eia_ferc1_plant_parts", "type": "table", "description": "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.\n\n\nMost-recent data:\n 2024\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n The Public Utility Data Liberation (PUDL) Project\n\nPrimary key:\n record_id_ferc1\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* 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.\n\n* Contains information from multiple raw inputs.\n\n* 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.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table\nanswers the question \"What EIA data reported about plants or generators should be\nassociated with a given plant record found in the FERC Form 1?\"\n\nEach record in this table corresponds to a single FERC Form 1 record reported in one of\nseveral tables describing power plants (large steam, hydro, small, etc.). These FERC\nrecords can correspond to an entire plant, individual generators within a plant, all\ngenerators in a plant with the same prime mover type, or just the respondent's ownership\nshare of any of those categories (or other categories). Furthermore, the same utility\nmay report the same plant in different ways in different years.\n\nThe EIA data associated with each FERC plant record comes from our Plant Parts EIA\ntable, :ref:`out_eia__yearly_plant_parts`.\nThe EIA data in each record represents an aggregation of several slices of an EIA\nplant, across both physical characteristics and utility ownership.\n\nThis table inherits canonicalized values for generators and plants.\nEIA reports many attributes in many different tables across\nEIA-860 and EIA-923. In order to compile tidy, well-normalized database tables, PUDL\ncollects all instances of these values and and chooses a canonical value. By default,\nPUDL chooses the most consistently reported value of a given attribute as long as it\nis at least 70% of the given instances reported. If an attribute was reported\ninconsistently across the original EIA tables, then it will show up as a\nnull value. See :doc:`/methodology/entity_resolution` for a conceptual overview of\nthis process.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "eia860", "title": "EIA Form 860 -- Annual Electric Generator Report", "path": "https://www.eia.gov/electricity/data/eia860", "email": "infoelectric@eia.gov", "description": "US Energy Information Administration (EIA) Form 860 data for electric power plants with 1 megawatt or greater combined nameplate capacity.", "keywords": [ "MW", "MWh", "annual", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia860", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 860", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "natural gas", "nox", "nuclear", "ownership", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127026", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17091669", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia860.html" }, { "name": "eia923", "title": "EIA Form 923 -- Power Plant Operations Report", "path": "https://www.eia.gov/electricity/data/eia923", "email": "infoelectric@eia.gov", "description": "The EIA Form 923 collects detailed monthly and annual electric power data on electricity generation, fuel consumption, fossil fuel stocks, and receipts at the power plant and prime mover level.", "keywords": [ "MW", "MWh", "ash", "bituminous", "boilers", "capacity", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "distribution", "eia", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "particulate", "planned", "plant", "pm2.5", "pollution", "power", "prime mover", "proposed", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127039", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.19787342", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/eia923.html" }, { "name": "ferc1", "title": "FERC Form 1 -- Annual Report of Major Electric Utilities", "path": "https://www.ferc.gov/industries-data/electric/general-information/electric-industry-forms/form-1-electric-utility-annual", "email": "Form1@ferc.gov", "description": "The Federal Energy Regulatory Commission (FERC) Form 1 is a comprehensive financial and operating report submitted annually for electric rate regulation, market oversight analysis, and financial audits by Major electric utilities, licensees and others.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "price", "prime mover", "proposed", "receipts", "retirement", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.4127043", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.17563678", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/ferc1.html" } ], "path": "out_pudl__yearly_assn_eia_ferc1_plant_parts.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "record_id_ferc1", "type": "string", "description": "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.", "constraints": { "required": true } }, { "name": "record_id_eia", "type": "string", "description": "Identifier for EIA plant parts analysis records." }, { "name": "match_type", "type": "string", "description": "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." }, { "name": "plant_name_ppe", "type": "string", "description": "Derived plant name that includes EIA plant name and other strings associated with ID and PK columns of the plant part." }, { "name": "plant_part", "type": "string", "description": "The part of the plant a record corresponds to.", "constraints": { "enum": [ "plant_ferc_acct", "plant_prime_fuel", "plant_unit", "plant_technology", "plant_prime_mover", "plant_operating_year", "plant_gen", "plant", "plant_match_ferc1" ] } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "ownership_record_type", "type": "string", "description": "Whether each generator record is for one owner or represents a total of all ownerships.", "constraints": { "enum": [ "owned", "total" ] } }, { "name": "plant_name_eia", "type": "string", "description": "Plant name." }, { "name": "plant_id_eia", "type": "integer", "description": "The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration." }, { "name": "generator_id", "type": "string", "description": "Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string!" }, { "name": "unit_id_pudl", "type": "integer", "description": "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." }, { "name": "prime_mover_code", "type": "string", "description": "Code for the type of prime mover (e.g. CT, CG)" }, { "name": "energy_source_code_1", "type": "string", "description": "The code representing the most predominant type of energy that fuels the generator." }, { "name": "technology_description", "type": "string", "description": "High level description of the technology used by the generator to produce electricity." }, { "name": "ferc_acct_name", "type": "string", "description": "Name of FERC account, derived from technology description and prime mover code.", "constraints": { "enum": [ "Hydraulic", "Nuclear", "Steam", "Other" ] } }, { "name": "generator_operating_year", "type": "integer", "description": "Year a generator went into service." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_id_pudl", "type": "integer", "description": "A manually assigned PUDL utility ID. May not be stable over time." }, { "name": "true_gran", "type": "boolean", "description": "Indicates whether a plant part list record is associated with the highest priority plant part for all identical records." }, { "name": "appro_part_label", "type": "string", "description": "Plant part of the associated true granularity record.", "constraints": { "enum": [ "plant_ferc_acct", "plant_prime_fuel", "plant_unit", "plant_technology", "plant_prime_mover", "plant_operating_year", "plant_gen", "plant", "plant_match_ferc1" ] } }, { "name": "appro_record_id_eia", "type": "string", "description": "EIA record ID of the associated true granularity record." }, { "name": "record_count", "type": "integer", "description": "Number of distinct generator IDs that participated in the aggregation for a plant part list record." }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "ownership_dupe", "type": "boolean", "description": "Whether a plant part record has a duplicate record with different ownership status." }, { "name": "operational_status", "type": "string", "description": "The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860." }, { "name": "operational_status_pudl", "type": "string", "description": "The operating status of the asset using PUDL categories.", "constraints": { "enum": [ "operating", "retired", "proposed" ] } }, { "name": "plant_id_pudl", "type": "integer", "description": "A manually assigned PUDL plant ID. May not be constant over time." }, { "name": "total_fuel_cost_eia", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "fuel_cost_per_mmbtu_eia", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "net_generation_mwh_eia", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "capacity_mw_eia", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capacity_factor_eia", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "total_mmbtu_eia", "type": "number", "description": "Total annual heat content of fuel consumed by a plant part record in the plant parts list." }, { "name": "unit_heat_rate_mmbtu_per_mwh_eia", "type": "number", "description": "Fuel content per unit of electricity generated. Coming from MCOE calculation.", "unit": "MMBTU_MWh" }, { "name": "fuel_type_code_pudl_eia", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "installation_year_eia", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "plant_part_id_eia", "type": "string", "description": "Contains EIA plant ID, plant part, ownership, and EIA utility id" }, { "name": "utility_id_ferc1", "type": "integer", "description": "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." }, { "name": "utility_name_ferc1", "type": "string", "description": "Name of the responding utility, as it is reported in FERC Form 1. For human readability only." }, { "name": "plant_id_ferc1", "type": "integer", "description": "Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS." }, { "name": "plant_name_ferc1", "type": "string", "description": "Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant." }, { "name": "asset_retirement_cost", "type": "number", "description": "Asset retirement cost (USD).", "unit": "USD" }, { "name": "avg_num_employees", "type": "number", "description": "The average number of employees assigned to each plant." }, { "name": "capacity_factor_ferc1", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_mw_ferc1", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "capex_annual_addition", "type": "number", "description": "Annual capital addition into `capex_total`.", "unit": "USD" }, { "name": "capex_annual_addition_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total`.", "unit": "USD" }, { "name": "capex_annual_per_kw", "type": "number", "description": "Annual capital addition into `capex_total` per kw.", "unit": "USD_per_kw" }, { "name": "capex_annual_per_mw", "type": "number", "description": "Annual capital addition into `capex_total` per MW.", "unit": "USD_per_MW" }, { "name": "capex_annual_per_mw_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total` per MW.", "unit": "USD_per_MW" }, { "name": "capex_annual_per_mwh", "type": "number", "description": "Annual capital addition into `capex_total` per MWh.", "unit": "USD_per_MWh" }, { "name": "capex_annual_per_mwh_rolling", "type": "number", "description": "Year-to-date capital addition into `capex_total` per MWh.", "unit": "USD_per_MWh" }, { "name": "capex_equipment", "type": "number", "description": "Cost of plant: equipment (USD).", "unit": "USD" }, { "name": "capex_land", "type": "number", "description": "Cost of plant: land and land rights (USD).", "unit": "USD" }, { "name": "capex_per_mw", "type": "number", "description": "Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD.", "unit": "USD_per_MW" }, { "name": "capex_structures", "type": "number", "description": "Cost of plant: structures and improvements (USD).", "unit": "USD" }, { "name": "capex_total", "type": "number", "description": "Total cost of plant (USD).", "unit": "USD" }, { "name": "capex_wo_retirement_total", "type": "number", "description": "Total cost of plant (USD) without retirements.", "unit": "USD" }, { "name": "construction_type", "type": "string", "description": "Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings.", "constraints": { "enum": [ "conventional", "outdoor", "semioutdoor" ] } }, { "name": "construction_year_eia", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "construction_year_ferc1", "type": "integer", "description": "Year the plant's oldest still operational unit was built." }, { "name": "installation_year_ferc1", "type": "integer", "description": "Year the plant's most recently built unit was installed." }, { "name": "net_generation_mwh_ferc1", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "not_water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when not limited by condenser water.", "unit": "MW" }, { "name": "opex_allowances", "type": "number", "description": "Allowances.", "unit": "USD" }, { "name": "opex_boiler", "type": "number", "description": "Maintenance of boiler (or reactor) plant.", "unit": "USD" }, { "name": "opex_coolants", "type": "number", "description": "Cost of coolants and water (nuclear plants only)", "unit": "USD" }, { "name": "opex_electric", "type": "number", "description": "Production expenses: electric expenses (USD).", "unit": "USD" }, { "name": "opex_engineering", "type": "number", "description": "Production expenses: maintenance, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_fuel", "type": "number", "description": "Production expenses: fuel (USD).", "unit": "USD" }, { "name": "fuel_cost_per_mwh_eia", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "fuel_cost_per_mwh_ferc1", "type": "number", "description": "Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD.", "unit": "USD_per_MWh" }, { "name": "opex_misc_power", "type": "number", "description": "Miscellaneous steam (or nuclear) expenses.", "unit": "USD" }, { "name": "opex_misc_steam", "type": "number", "description": "Maintenance of miscellaneous steam (or nuclear) plant.", "unit": "USD" }, { "name": "opex_nonfuel_per_mwh", "type": "number", "description": "Investments in non-fuel production expenses per Mwh.", "unit": "USD_per_Mwh" }, { "name": "opex_operations", "type": "number", "description": "Production expenses: operations, supervision, and engineering (USD).", "unit": "USD" }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "opex_plant", "type": "number", "description": "Production expenses: maintenance of electric plant (USD).", "unit": "USD" }, { "name": "opex_production_total", "type": "number", "description": "Total operating expenses.", "unit": "USD" }, { "name": "opex_rents", "type": "number", "description": "Production expenses: rents (USD).", "unit": "USD" }, { "name": "opex_steam", "type": "number", "description": "Steam expenses.", "unit": "USD" }, { "name": "opex_steam_other", "type": "number", "description": "Steam from other sources.", "unit": "USD" }, { "name": "opex_structures", "type": "number", "description": "Production expenses: maintenance of structures (USD).", "unit": "USD" }, { "name": "opex_total_nonfuel", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "opex_transfer", "type": "number", "description": "Steam transferred (Credit)." }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "plant_capability_mw", "type": "number", "description": "Net plant capability in megawatts.", "unit": "MW" }, { "name": "plant_hours_connected_while_generating", "type": "number", "description": "Hours the plant was connected to load while generating in the report year.", "unit": "hr" }, { "name": "plant_type", "type": "string", "description": "Type of plant." }, { "name": "water_limited_capacity_mw", "type": "number", "description": "Plant capacity in MW when limited by condenser water.", "unit": "MW" }, { "name": "fuel_cost_per_mmbtu_ferc1", "type": "number", "description": "Average fuel cost per MMBTU of heat content in nominal USD.", "unit": "USD_per_MMBTU" }, { "name": "fuel_type", "type": "string", "description": "Type of fuel." }, { "name": "license_id_ferc1", "type": "integer", "description": "FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible." }, { "name": "opex_maintenance", "type": "number", "description": "Production expenses: Maintenance (USD).", "unit": "USD" }, { "name": "opex_total", "type": "number", "description": "Total production expenses, excluding fuel (USD).", "unit": "USD" }, { "name": "capex_facilities", "type": "number", "description": "Cost of plant: reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "capex_roads", "type": "number", "description": "Cost of plant: roads, railroads, and bridges (USD).", "unit": "USD" }, { "name": "net_capacity_adverse_conditions_mw", "type": "number", "description": "Net plant capability under the least favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "net_capacity_favorable_conditions_mw", "type": "number", "description": "Net plant capability under the most favorable operating conditions, in megawatts.", "unit": "MW" }, { "name": "opex_dams", "type": "number", "description": "Production expenses: maintenance of reservoirs, dams, and waterways (USD).", "unit": "USD" }, { "name": "opex_generation_misc", "type": "number", "description": "Production expenses: miscellaneous power generation expenses (USD).", "unit": "USD" }, { "name": "opex_hydraulic", "type": "number", "description": "Production expenses: hydraulic expenses (USD).", "unit": "USD" }, { "name": "opex_misc_plant", "type": "number", "description": "Production expenses: maintenance of miscellaneous hydraulic plant (USD).", "unit": "USD" }, { "name": "opex_water_for_power", "type": "number", "description": "Production expenses: water for power (USD).", "unit": "USD" }, { "name": "ferc_license_id", "type": "string", "description": "The FERC license ID of a project." }, { "name": "capex_equipment_electric", "type": "number", "description": "Cost of plant: accessory electric equipment (USD).", "unit": "USD" }, { "name": "capex_equipment_misc", "type": "number", "description": "Cost of plant: miscellaneous power plant equipment (USD).", "unit": "USD" }, { "name": "capex_wheels_turbines_generators", "type": "number", "description": "Cost of plant: water wheels, turbines, and generators (USD).", "unit": "USD" }, { "name": "energy_used_for_pumping_mwh", "type": "number", "description": "Energy used for pumping, in megawatt-hours.", "unit": "MWh" }, { "name": "net_load_mwh", "type": "number", "description": "Net output for load (net generation - energy used for pumping) in megawatt-hours.", "unit": "MWh" }, { "name": "opex_production_before_pumping", "type": "number", "description": "Total production expenses before pumping (USD).", "unit": "USD" }, { "name": "opex_pumped_storage", "type": "number", "description": "Production expenses: pumped storage (USD).", "unit": "USD" }, { "name": "opex_pumping", "type": "number", "description": "Production expenses: We are here to PUMP YOU UP! (USD).", "unit": "USD" }, { "name": "total_fuel_cost_ferc1", "type": "number", "description": "Total annual reported fuel costs for the plant part. Includes costs from all fuels." }, { "name": "total_mmbtu_ferc1", "type": "number", "description": "Total annual heat content of fuel consumed by a plant part record in the plant parts list." }, { "name": "fuel_type_code_pudl_ferc1", "type": "string", "description": "Simplified fuel type code used in PUDL", "constraints": { "enum": [ "coal", "gas", "hydro", "nuclear", "oil", "other", "solar", "waste", "wind" ] } }, { "name": "unit_heat_rate_mmbtu_per_mwh_ferc1", "type": "number", "description": "Fuel content per unit of electricity generated. Calculated from FERC reported fuel consumption and net generation.", "unit": "MMBTU_MWh" } ], "primaryKey": [ "record_id_ferc1" ], "foreignKeys": [ { "fields": [ "energy_source_code_1" ], "reference": { "resource": "core_eia__codes_energy_sources", "fields": [ "code" ] } }, { "fields": [ "prime_mover_code" ], "reference": { "resource": "core_eia__codes_prime_movers", "fields": [ "code" ] } }, { "fields": [ "plant_id_eia", "generator_id", "report_date" ], "reference": { "resource": "core_eia860__scd_generators", "fields": [ "plant_id_eia", "generator_id", "report_date" ] } }, { "fields": [ "utility_id_eia", "report_date" ], "reference": { "resource": "core_eia860__scd_utilities", "fields": [ "utility_id_eia", "report_date" ] } }, { "fields": [ "utility_id_ferc1", "plant_name_ferc1" ], "reference": { "resource": "core_pudl__assn_ferc1_pudl_plants", "fields": [ "utility_id_ferc1", "plant_name_ferc1" ] } }, { "fields": [ "plant_id_pudl" ], "reference": { "resource": "core_pudl__entity_plants_pudl", "fields": [ "plant_id_pudl" ] } }, { "fields": [ "utility_id_pudl" ], "reference": { "resource": "core_pudl__entity_utilities_pudl", "fields": [ "utility_id_pudl" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "annual", "ash", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "carbon dioxide", "chlorine", "co2", "coal", "combined_cycle", "combustion", "contract", "cost", "debt", "depreciation", "distribution", "eia", "eia860", "eia923", "electric", "electricity", "emissions", "energy", "energy information administration", "federal", "federal energy regulatory commission", "ferc", "ferc1", "finance", "form 1", "form 860", "form 923", "fuel", "fuel cost", "fuel price", "generation", "generators", "ghg", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mercury", "mmbtu", "monthly", "natural gas", "nox", "nuclear", "operating expenses", "opex", "ownership", "particulate", "planned", "plant", "plant in service", "pm2.5", "pollution", "power", "price", "prime mover", "proposed", "receipts", "retirement", "so2", "solar", "sox", "steam", "subbituminous", "sulfur", "transmission", "turbine", "united states", "us", "usa", "utility", "wind", "yearly" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 10043428, "hash": "sha256:b5dfc4e5801ddbbb2e152f1f09f46d63d5ea303110062ea225ff85f34f109f94" }, { "name": "out_rus12__monthly_demand_and_energy_at_delivery_points", "type": "table", "description": "Monthly time series of demand and energy delivered to distribution utilities.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section E)\n\nPrimary key:\n report_date, borrower_id_rus, delivery_recipient\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__monthly_demand_and_energy_at_delivery_points.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "delivery_recipient", "type": "string", "description": "The recipient of the delivered energy or demand.", "constraints": { "required": true } }, { "name": "delivered_demand_mw", "type": "number", "description": "The amount of demand delivered in MW.", "unit": "MW" }, { "name": "delivered_energy_mwh", "type": "number", "description": "The amount of energy delivered in MWh.", "unit": "MWh" } ], "primaryKey": [ "report_date", "borrower_id_rus", "delivery_recipient" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 180636, "hash": "sha256:bdd979fead0aa38eb631620ea85dc976682e806d2d87e8f66802355a8920e944" }, { "name": "out_rus12__monthly_demand_and_energy_at_power_sources", "type": "table", "description": "Monthly time series of demand and energy at point of generation.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section D)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThere are some peak demand dates that have an hour component and others that don't. This is because there is inconsistent reporting of peak_demand_hour in the raw data. If there is no hour reported, we record the hour as 0 and only the date will show in the data.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__monthly_demand_and_energy_at_power_sources.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "energy_output_mwh", "type": "number", "description": "The amount of energy output in MWh.", "unit": "MWh" }, { "name": "peak_demand_mw", "type": "number", "description": "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.", "unit": "MW" }, { "name": "peak_demand_date", "type": "datetime", "description": "The date of the peak demand." }, { "name": "is_peak_coincident", "type": "boolean", "description": "Whether or not the peak_mw is coincident or non-coincident peak." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 115906, "hash": "sha256:67817b63bed8f3749e3368fdf895b96fa341f7aca48e972e69cf3af2cfb7a9da" }, { "name": "out_rus12__yearly_balance_sheet_assets", "type": "table", "description": "Annual time series of assets and other debts from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part A - Section B)\n\nPrimary key:\n report_date, borrower_id_rus, asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_balance_sheet_assets.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "asset_type", "type": "string", "description": "Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "asset_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 122195, "hash": "sha256:175406cdcd9ebcd799ccf7e6f18b96ec3afe3233f276efc212680789256b5a9d" }, { "name": "out_rus12__yearly_balance_sheet_liabilities", "type": "table", "description": "Annual time series of liabilities and other credits from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part A - Section B)\n\nPrimary key:\n report_date, borrower_id_rus, liability_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_balance_sheet_liabilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "liability_type", "type": "string", "description": "Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "liability_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 118570, "hash": "sha256:771561a6d53a2546e4d509463b80b4a5c84d25c552c0aa9a42ede2ae23930629" }, { "name": "out_rus12__yearly_depreciation_changes", "type": "table", "description": "Annual time series of changes in accumulated depreciation.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section B)\n\nPrimary key:\n report_date, borrower_id_rus, depreciation_and_amortization_group, depreciation_and_amortization_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_depreciation_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "depreciation_and_amortization_group", "type": "string", "description": "High-level category of depreciation and amortization items.", "constraints": { "required": true, "enum": [ "electric_plant_in_service", "provision_for_depreciation_and_amortization" ] } }, { "name": "depreciation_and_amortization_item", "type": "string", "description": "Category of depreciation and amortization items.", "constraints": { "required": true } }, { "name": "composite_depreciation_rate", "type": "number", "description": "The composite depreciation rate within a given category. This is typically expressed as a number between 0 and 100." }, { "name": "accruals", "type": "number", "description": "Value of additions into an asset class a.k.a accruals.", "unit": "USD" }, { "name": "retirements_less_net_salvage", "type": "number", "description": "Cost of retirements minus any net salvage value.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "depreciation_and_amortization_group", "depreciation_and_amortization_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 105407, "hash": "sha256:6108f00924fd9764d88b22686e15c097a4257c8a86b22a33f9be0f4bc35a40f8" }, { "name": "out_rus12__yearly_depreciation_misc", "type": "table", "description": "Annual time series of accumulated depreciation.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - 2nd part of Section B)\n\nPrimary key:\n report_date, borrower_id_rus, depreciation_and_amortization_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis is the second half of the depreciation table. It includes ending balances of six depreciation and amortization values.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_depreciation_misc.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "depreciation_and_amortization_item", "type": "string", "description": "Category of depreciation and amortization items.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "depreciation_and_amortization_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 27990, "hash": "sha256:4830ce35f0207f518be1e7b691b10ba37d8a49655716f134a5dc85dcc064abd8" }, { "name": "out_rus12__yearly_external_financial_risk_ratio", "type": "table", "description": "Annual time series of ratio of investments and loan guarantee balances to total utility plant assets.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section F - Subsection III)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_external_financial_risk_ratio.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "external_financial_risk_ratio", "type": "number", "description": "total investments + loan guarantee balances / total utility plant assets. This ratio shows how much a utility is financially exposed to outside entities relative to its own assets." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 13410, "hash": "sha256:e51806ae3262f0095c8cae49f30cc7597a5c3a61440a7599f580fc3ce9c0d388" }, { "name": "out_rus12__yearly_investments", "type": "table", "description": "Annual time series of investments, loan guarantees and loans.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section F, Sub-section I)\n\nPrimary key:\n This table has no primary key. This is a list of all investments or loans in each year and borrowers can have multiple records with the same ``investment_description``.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReporting of investments is required by 7 CFR 1717, Subpart N. Investment categories reported on this Part correspond to Balance Sheet items in Part A Section B in table :ref:`core_rus12__yearly_balance_sheet_assets`.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_investments.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "investment_description", "type": "string", "description": "Description of investment. This is a free-form text field and thus contains a wide variety of values." }, { "name": "investment_type_code", "type": "integer", "description": "Investment type code.", "constraints": { "minimum": 1, "maximum": 11 } }, { "name": "included_investments", "type": "number", "description": "Included investment." }, { "name": "excluded_investments", "type": "number", "description": "Excluded investment." }, { "name": "income_or_loss", "type": "number", "description": "Income or loss from investment." }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "investment_type_code" ], "reference": { "resource": "core_rus__codes_investment_types", "fields": [ "code" ] } }, { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 264782, "hash": "sha256:2ba2acf7d6e1a95cab964d7bbf0d328400a45ca22338e5c5a34d4c6d8a45f66c" }, { "name": "out_rus12__yearly_lines_stations_labor_materials_cost", "type": "table", "description": "Annual time series of labor and material cost for lines and stations operated by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part I - Section C)\n\nPrimary key:\n report_date, borrower_id_rus, labor_or_material, operation_or_maintenance, lines_or_stations\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_lines_stations_labor_materials_cost.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "labor_or_material", "type": "string", "description": "Indicates whether the cost reported is for labor or material.", "constraints": { "required": true, "enum": [ "labor", "material" ] } }, { "name": "operation_or_maintenance", "type": "string", "description": "Indicates whether the expenditure is for operation or maintenance.", "constraints": { "required": true, "enum": [ "operation", "maintenance" ] } }, { "name": "lines_or_stations", "type": "string", "description": "Indicates whether the cost reported pertains to lines or stations.", "constraints": { "required": true, "enum": [ "lines", "stations" ] } }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "labor_or_material", "operation_or_maintenance", "lines_or_stations" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 33020, "hash": "sha256:4a81d68b461d6f25fb9a55a61839b03383dcfb0e7f816e3b381d1dbf880b1b16" }, { "name": "out_rus12__yearly_loans", "type": "table", "description": "Annual time series of loans provided by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section F - Subsections II & IV)\n\nPrimary key:\n This table has no primary key. This table has no primary key because some borrowers report multiple loan values from the same entity in a given year.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table also includes loan guarantees where the RUS borrower backs a loan from another entity and is therefore liable to pay any remaining balance should the original borrower default.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_loans.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "loan_recipient", "type": "string", "description": "The organization that received a loan." }, { "name": "loan_maturity_date", "type": "date", "description": "The date on which a loan is scheduled to be fully paid." }, { "name": "loan_original_amount", "type": "number", "description": "The original amount of a loan.", "unit": "USD" }, { "name": "loan_balance", "type": "number", "description": "The amount of money still owned on a loan at the end of the reporting year." }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." }, { "name": "is_loan_guarantee", "type": "boolean", "description": "Indicates a third-party loan that the reporting utility (referred as a borrower) has co-signed, taking on responsibility for repayment if the primary borrower defaults." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 24803, "hash": "sha256:5fc3ee267fbdd68492ee098b8a6bc93f9e582c7eb376d2b67ed6e76e77e4b12c" }, { "name": "out_rus12__yearly_long_term_debt", "type": "table", "description": "Annual time series of long-term debt and debt service requirements for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section H)\n\nPrimary key:\n This table has no primary key. This table has no primary key because some borrowers report multiple debt values from the same entity in a given year.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_long_term_debt.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "debt_description", "type": "string", "description": "Description of debt or loan. On the original form, there are nine provided descriptions and a section to add other free-form descriptions." }, { "name": "debt_ending_balance", "type": "number", "description": "The amount of principal still owned on the debt at the end of the report year.", "unit": "USD" }, { "name": "debt_interest", "type": "number", "description": "The interest expense on the debt for the report year.", "unit": "USD" }, { "name": "debt_principal", "type": "number", "description": "The principal paid on the debt during the report year.", "unit": "USD" }, { "name": "debt_total", "type": "number", "description": "The total amount of debt.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 105862, "hash": "sha256:de0e86dcb6a13a0410a6de14795e13bb1ce920e75dcd13173f358756d2b88003" }, { "name": "out_rus12__yearly_meeting_and_board", "type": "table", "description": "Annual time series of annual meeting and board information for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section I)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_meeting_and_board.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "last_annual_meeting_date", "type": "datetime", "description": "The date of the last annual meeting." }, { "name": "members_num", "type": "integer", "description": "The total number of members." }, { "name": "members_present_at_meeting_num", "type": "integer", "description": "The number of members present at the last annual meeting." }, { "name": "was_quorum_present", "type": "boolean", "description": "Whether or not quorum was met." }, { "name": "members_voting_by_proxy_or_mail_num", "type": "integer", "description": "The number of members voting by mail or by proxy." }, { "name": "board_members_num", "type": "integer", "description": "The total number of board members." }, { "name": "fees_and_expenses_for_board_members", "type": "integer", "description": "The total amount of fees and expenses for board members.", "unit": "USD" }, { "name": "does_manager_have_written_contract", "type": "boolean", "description": "Whether or not the RUS borrower's manager has a written contract." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 26341, "hash": "sha256:f8bc6f7624ba1112772988fb1885138631bd04cebdf8bf1578ff3be9c7276ebd" }, { "name": "out_rus12__yearly_non_utility_plant_changes", "type": "table", "description": "Annual time series of changes in non-utility plant.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section C)\n\nPrimary key:\n report_date, borrower_id_rus, non_utility_plant_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_non_utility_plant_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "non_utility_plant_item", "type": "string", "description": "Category describing non-utility plant asset items.", "constraints": { "required": true, "enum": [ "property", "provision_for_depreciation_and_amortization" ] } }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "non_utility_plant_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 15286, "hash": "sha256:b709d1f40dcbdd8b8fa4c1552c9bad88c6e24b2c05731870669b4daadc2dc93c" }, { "name": "out_rus12__yearly_plant_costs", "type": "table", "description": "Annual time series of costs of net energy generated by plant.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part F - Section D)\n\nPrimary key:\n This table has no primary key. This table has no primary key because there is one plant (Walter Scott) that has duplicate records every year. Based on other RUS-12 tables, it is likely that these duplicate records are the borrowers' ownership portion of the plant as well as the total plant but there is no clear indication in this table.\n\nThe primary key of this table otherwise would be: ['report_date', 'borrower_id_rus', 'plant_name_rus', 'cost_group', 'cost_type'].\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe cost column in this table is expected to be largely non-null, the cost_per_mwh and cost_per_mmbtu columns only apply to some cost_type's and even plant_type's and thus are expected to contain many nulls.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_plant_costs.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "cost_group", "type": "string", "description": "High-level category of cost type.", "constraints": { "enum": [ "opex", "total", "capex" ] } }, { "name": "cost_type", "type": "string", "description": "Detailed category of cost type.", "constraints": { "enum": [ "allowances", "coal_fuel", "coolants_and_water", "depreciation", "electric", "energy_for_compressed_air", "energy_for_pumped_storage", "fuel", "gas_fuel", "generation", "hydraulic", "interest", "less_fuel_acquisition_adjustment", "maintenance_boiler_plant", "maintenance_electric_plant", "maintenance_generating_and_electric_plant", "maintenance_miscellaneous_plant", "maintenance_other_plant", "maintenance_reactor_plant_equipment", "maintenance_reservoirs_dams_waterways", "maintenance_structures", "maintenance_supervision_and_engineering", "maintenance_total", "miscellaneous_power_generation", "net_fuel", "non_fuels_subtotal", "oil_fuel", "operations_total", "other_fuel", "other_generation", "other_nuclear_power", "plant_acquisition_adjustment", "power", "reactor_credits", "rents", "steam", "steam_other_sources", "steam_power", "supervision_and_engineering", "total", "total_fixed", "total_fuel", "water_for_power" ] } }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" }, { "name": "cost_per_mwh", "type": "number", "description": "Unit cost of energy production in cost per MWh", "unit": "USD_per_MWh" }, { "name": "cost_per_mmbtu", "type": "number", "description": "Unit cost of energy production in cost per MMBTU", "unit": "USD_per_MMBTU" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 393383, "hash": "sha256:bf8bcc6d78eeec61514744648aa9ba683fbd865714bbd3c9289e0d1f9ed27a5a" }, { "name": "out_rus12__yearly_plant_factors_and_maximum_demand", "type": "table", "description": "Annual time series of plant factors and maximum demand for plants owned by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Parts D, E, F IC, F CC, G - Section C)\n\nPrimary key:\n This table has no primary key. The primary key for this table would be report_date, borrower_id_rus, plant_name_rus, and plant_type but the plant_type column is not reported before 2009 causing lots of duplicate records. Because none of the other fields are static year-over-year, there is no reliable way to backfill the plant_type column in instances where there are different plant_types reported for the same plant in later years.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe plant_type field was only included in the data starting in 2009. We backfill records with only one reported plant_type per borrower/plant name/year. Records with multiple plant_types per borrower/plant name/year are left with null plant_type because there is no reliable way to determine which plant_type is associated with which record back in time. Plants who's names are reported differently pre and post 2009 will also miss being backfilled.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_plant_factors_and_maximum_demand.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "capacity_factor_running", "type": "number", "description": "Fraction of potential generation over the time period a plant was in operation. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "load_factor", "type": "number", "description": "Fraction of consumption vs demand reported for a plant over a given timeframe. Energy consumed over time period / peak demand * time period (hours/years/etc.)." }, { "name": "peak_gross_demand_mw", "type": "number", "description": "The highest average power output recorded over any single 15 minute interval during the reporting period.", "unit": "MW" }, { "name": "peak_gross_demand_nameplate_mw", "type": "number", "description": "The theoretical or nameplate peak the plant could produce under the best operating conditions during the reporting period.", "unit": "MW" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 66637, "hash": "sha256:9d3a9af55fb76ec0deafdd58458fa3a5345d4355bdea82e23f4ea8e5e09924bd" }, { "name": "out_rus12__yearly_plant_labor", "type": "table", "description": "Annual time series of labor and payroll information for plants owned by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Parts D, E, F, G - Section B)\n\nPrimary key:\n This table has no primary key. The primary key should be report_date, borrower_id_rus, plant_name_rus, and plant_type, but this table did not report plant_type before 2009 and there are respondents who report multiple rows per plant pre-2009. The data cannot be backfilled because there is no way to distinguish between duplicate rows pre-2009.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nNote the lack of plant_type pre-2009 leading to a lack of reliable primary keys.\n\nPlant-level data from :ref:`core_rus12__yearly_plant_operations_by_plant` can be matched to data from this table, but you must also join this data usingthe ``borrower_id_rus`` column as well as the ``report_date`` and ``plant_name``. This is because the :ref:`core_rus12__yearly_plant_operations_by_plant` table includes records from each plant owner. The RUS instructions note that:\n\nyou should use caution when using total plant data since there are cases where more than one Borrower shares units at the same plant which means that you will be getting duplicate plant total records (and there is no guarantee that the total plant records entered by two borrowers for the same plant will be identical).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_plant_labor.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "employees_full_time_num", "type": "integer", "description": "Number of employees hired full-time for normal operations of the system." }, { "name": "employees_part_time_num", "type": "integer", "description": "Number employees regularly employed on a part-time basis. Exclude employees hired for short periods of time to complete special jobs." }, { "name": "employee_hours_worked_total", "type": "number", "description": "Total number of hours worked by employees." }, { "name": "payroll_maintenance", "type": "number", "description": "The amount of payroll spent on plant maintenance.", "unit": "USD" }, { "name": "payroll_operations", "type": "number", "description": "The amount of payroll spent on plant operations.", "unit": "USD" }, { "name": "payroll_other_accounts", "type": "number", "description": "The amount of plant payroll spent on accounts other than maintenance and operations.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 68290, "hash": "sha256:0d2996010f5b71524fdc9068c994921c64af5b1801ec6d3e3a3125625dfd2b5d" }, { "name": "out_rus12__yearly_plant_operations_by_borrower", "type": "table", "description": "Annual time series of borrower portion of plant operational data including fuel consumption and operational hours.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part D, E, F (CC), F (IC) & G - Section A)\n\nPrimary key:\n This table has no primary key. This table has no primary key because there are a handful of plants that have duplicate records. The primary key of this table otherwise would be: [`report_date`, `borrower_id_rus`, `plant_name_rus`, `plant_name_rus`, `unit_id_rus`, `plant_type`, `is_full_ownership_portion`, `is_partly_owned_by_borrower`].\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe data in this table comes from five different portions of RUS 12 corresponding to different plant types (steam, hydroelectric, combined_cycle, internal_combustion and nuclear).\nThe original form includes plant operations data for each plant type reported in multiple ways: with records corresponding to the portion of plants that borrowers own as well as the whole plant. We split these records into two tables, :ref:`core_rus12__yearly_plant_operations_by_borrower`, which contains records reported at the borrower level, and :ref:`core_rus12__yearly_plant_operations_by_plant`, which contains records reported at the plant level.Records that are wholly owned by one borrower show up in both :ref:`core_rus12__yearly_plant_operations_by_borrower` and :ref:`core_rus12__yearly_plant_operations_by_plant`.\n\nThere are two boolean columns used to delineate which records are associated with the borrowers' share vs the whole plant - which is documented in ``_OR_PowerSupply Plant File Documentation.rtf`` in the newer years in the RUS 12 archive. One of these two fields - ``is_partly_owned_by_borrower`` - was not reported before 2009. For the pre-2009 years, we assume that all records that report TRUE for is_full_ownership_portion should end up in the by-plant table while all records should end up in the by-borrower portion of the table.Like the post-2009 records, this involves records from the original tables ending up in both of these PUDL tables.\n\nAlso there are two cleaning steps that we performed that alter the original data slightly:\n\n* **One dropped with unexpected ownership label and duplicate data**: There is a Wisdom steam plant record that is labeled to be both fully owned by borrower and partly owned for one year, which is an unexpected combo based on the `_OR_PowerSupply Plant File Documentation.rst` documentation file in the rus12 archive. Luckily this plant has exactly the same records as the other Wisdom steam plant that year with more expected ownership labels.* **Replaced two string values for unit_id_rus**: There are two instances from 2018 of unit_id_rus's that have string values in them - ``WSL GT 12`` and ``WSL ST 10``. Based on pre-cleaned data, we were able to clearly identify that we can use just the numeric values in these bad strings - 12 and 10 respectively. This enables us to have an integer type for this unit_id_rus column.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_plant_operations_by_borrower.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "unit_id_rus", "type": "integer", "description": "RUS-assigned unit identification code." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "ownership_pct", "type": "number", "description": "Percentage of the plant owned by the respondent." }, { "name": "is_full_ownership_portion", "type": "boolean", "description": "Whether or not the plant record represents the full plant - regardless of whether its fully owned by the borrower." }, { "name": "is_partly_owned_by_borrower", "type": "boolean", "description": "Whether or not the plant record is partially owned by the borrower. This column was not reported before 2009." }, { "name": "fuel_consumption_coal_lbs", "type": "number", "description": "Annual pounds of coal consumed for fuel.This field is only reported for plant_type steam.", "unit": "lb" }, { "name": "fuel_consumption_gas_cubic_feet", "type": "number", "description": "Annual cubic feet of natural gas consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "cf" }, { "name": "fuel_consumption_oil_gallons", "type": "number", "description": "Annual gallons of oil consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "gal" }, { "name": "fuel_consumption_other", "type": "number", "description": "Annual other fuel consumed. Neither units nor type of fuel are documented.This field is only reported for plant_type's combined_cycle, combined_cycle and steam." }, { "name": "operating_hours_in_service", "type": "number", "description": "Number of operating hours in service.", "unit": "hours" }, { "name": "operating_hours_on_standby", "type": "number", "description": "Number of operating hours on standby.", "unit": "hours" }, { "name": "operating_hours_out_of_service_scheduled", "type": "number", "description": "Number of operating hours out of service which were scheduled.", "unit": "hours" }, { "name": "operating_hours_out_of_service_unscheduled", "type": "number", "description": "Number of operating hours out of service which were unscheduled.", "unit": "hours" }, { "name": "times_started", "type": "number", "description": "Number of times the plant was started. This field is only reported for plant_type's steam and nuclear." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 200460, "hash": "sha256:56154fe4a024697ea0e9d4a39c06b254cb505510f51fdcc4916499fdf6504210" }, { "name": "out_rus12__yearly_plant_operations_by_plant", "type": "table", "description": "Annual time series of whole plant operational data including fuel consumption and operational hours.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part D, E, F (CC), F (IC) & G - Section A)\n\nPrimary key:\n This table has no primary key. This table has no primary key because there are a handful of plants that have duplicate records. The primary key of this table otherwise would be: [`report_date`, `borrower_id_rus`, `plant_name_rus`, `plant_name_rus`, `unit_id_rus`, `plant_type`, `is_full_ownership_portion`, `is_partly_owned_by_borrower`].\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe data in this table comes from five different portions of RUS 12 corresponding to different plant types (steam, hydroelectric, combined_cycle, internal_combustion and nuclear).\nThe original form includes plant operations data for each plant type reported in multiple ways: with records corresponding to the portion of plants that borrowers own as well as the whole plant. We split these records into two tables, :ref:`core_rus12__yearly_plant_operations_by_borrower`, which contains records reported at the borrower level, and :ref:`core_rus12__yearly_plant_operations_by_plant`, which contains records reported at the plant level.Records that are wholly owned by one borrower show up in both :ref:`core_rus12__yearly_plant_operations_by_borrower` and :ref:`core_rus12__yearly_plant_operations_by_plant`.\n\nThere are two boolean columns used to delineate which records are associated with the borrowers' share vs the whole plant - which is documented in ``_OR_PowerSupply Plant File Documentation.rtf`` in the newer years in the RUS 12 archive. One of these two fields - ``is_partly_owned_by_borrower`` - was not reported before 2009. For the pre-2009 years, we assume that all records that report TRUE for is_full_ownership_portion should end up in the by-plant table while all records should end up in the by-borrower portion of the table.Like the post-2009 records, this involves records from the original tables ending up in both of these PUDL tables.\n\nAlso there are two cleaning steps that we performed that alter the original data slightly:\n\n* **One dropped with unexpected ownership label and duplicate data**: There is a Wisdom steam plant record that is labeled to be both fully owned by borrower and partly owned for one year, which is an unexpected combo based on the `_OR_PowerSupply Plant File Documentation.rst` documentation file in the rus12 archive. Luckily this plant has exactly the same records as the other Wisdom steam plant that year with more expected ownership labels.* **Replaced two string values for unit_id_rus**: There are two instances from 2018 of unit_id_rus's that have string values in them - ``WSL GT 12`` and ``WSL ST 10``. Based on pre-cleaned data, we were able to clearly identify that we can use just the numeric values in these bad strings - 12 and 10 respectively. This enables us to have an integer type for this unit_id_rus column..\n\nPlant-level data can be matched to the :ref:core_rus12__yearly_plant_labor` and forthcoming core_rus12__yearly_plant_factors_and_maximum_demand, which report Section B and C data for all plants. The RUS instructions note that:\n\nyou should use caution when using total plant data since there are cases where more than one Borrower shares units at the same plant which means that you will be getting duplicate plant total records (and there is no guarantee that the total plant records entered by two borrowers for the same plant will be identical).", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_plant_operations_by_plant.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS." }, { "name": "unit_id_rus", "type": "integer", "description": "RUS-assigned unit identification code." }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "gross_generation_mwh", "type": "number", "description": "Gross electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "ownership_pct", "type": "number", "description": "Percentage of the plant owned by the respondent." }, { "name": "is_partly_owned_by_borrower", "type": "boolean", "description": "Whether or not the plant record is partially owned by the borrower. This column was not reported before 2009." }, { "name": "fuel_consumption_coal_lbs", "type": "number", "description": "Annual pounds of coal consumed for fuel.This field is only reported for plant_type steam.", "unit": "lb" }, { "name": "fuel_consumption_gas_cubic_feet", "type": "number", "description": "Annual cubic feet of natural gas consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "cf" }, { "name": "fuel_consumption_oil_gallons", "type": "number", "description": "Annual gallons of oil consumed for fuel.This field is only reported for plant_type's combined_cycle, combined_cycle and steam.", "unit": "gal" }, { "name": "fuel_consumption_other", "type": "number", "description": "Annual other fuel consumed. Neither units nor type of fuel are documented.This field is only reported for plant_type's combined_cycle, combined_cycle and steam." }, { "name": "operating_hours_in_service", "type": "number", "description": "Number of operating hours in service.", "unit": "hours" }, { "name": "operating_hours_on_standby", "type": "number", "description": "Number of operating hours on standby.", "unit": "hours" }, { "name": "operating_hours_out_of_service_scheduled", "type": "number", "description": "Number of operating hours out of service which were scheduled.", "unit": "hours" }, { "name": "operating_hours_out_of_service_unscheduled", "type": "number", "description": "Number of operating hours out of service which were unscheduled.", "unit": "hours" }, { "name": "times_started", "type": "number", "description": "Number of times the plant was started. This field is only reported for plant_type's steam and nuclear." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 175099, "hash": "sha256:d4f159653555944e18e418999780344ae9ef1687b0a59ba6eb9f317c2493a4b8" }, { "name": "out_rus12__yearly_renewable_plants", "type": "table", "description": "Annual time series of renewable energy plant generation information for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part C RE)\n\nPrimary key:\n report_date, borrower_id_rus, plant_name_rus, prime_mover_id\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_renewable_plants.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_name_rus", "type": "string", "description": "Name of the plant as reported to RUS.", "constraints": { "required": true } }, { "name": "prime_mover_id", "type": "integer", "description": "Unique numeric identifier for each prime mover type used by RUS borrowers.", "constraints": { "required": true } }, { "name": "prime_mover_type", "type": "string", "description": "Type of prime mover (e.g. Hydro, Internal Combustion).", "constraints": { "enum": [ "Hydro", "Internal Combustion", "Large Wind", "Steam", "Photovoltaic" ] } }, { "name": "primary_renewable_fuel_type_id", "type": "integer", "description": "Unique numeric identifier for each renewable fuel type.", "constraints": { "minimum": 1, "maximum": 15 } }, { "name": "primary_renewable_fuel_type", "type": "string", "description": "Primary renewable fuel type used by the plant.", "constraints": { "enum": [ "Hydro", "Methane - landfill gas", "Wind", "Biomass - wood", "Methane - waste", "Hybrid", "Solar - photovoltaic", "Solar - thermal generation", "Other" ] } }, { "name": "renewable_fuel_pct", "type": "number", "description": "Percentage of renewable fuel used." }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "net_generation_mwh", "type": "number", "description": "Net electricity generation for the specified period in megawatt-hours (MWh).", "unit": "MWh" }, { "name": "capacity_factor", "type": "number", "description": "Fraction of potential generation that was actually reported for a plant part. Energy generated over time period / nameplate capacity * time period (hours/years/etc.)." }, { "name": "employees_num", "type": "integer", "description": "Number of employees." }, { "name": "opex_per_mwh", "type": "number", "description": "Total production expenses (USD per MWh generated).", "unit": "USD per MWh" }, { "name": "power_cost_per_mwh", "type": "number", "description": "The cost of power per mwh.", "unit": "USD_per_MWh" }, { "name": "invested", "type": "number", "description": "The amount of money invested.", "unit": "USD" }, { "name": "ownership_pct", "type": "number", "description": "Percentage of the plant owned by the respondent." }, { "name": "rus_funding", "type": "number", "description": "Amount of funding received from the Rural Utilities Service (RUS).", "unit": "USD" }, { "name": "comments", "type": "string", "description": "General comments field." } ], "primaryKey": [ "report_date", "borrower_id_rus", "plant_name_rus", "prime_mover_id" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 37740, "hash": "sha256:a097f503c9a24fddcc81555c2366ced96a368523b1893a9251aa3a4da385465e" }, { "name": "out_rus12__yearly_sources_and_distribution", "type": "table", "description": "Annual time series of MWh and cost of energy sources and distribution by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, source_of_energy\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nSee the ``sources_and_distribution_by_plant_type`` table for a breakdown of plant-type-specific cost, capacity, plant_num, and net_energy_received values. Also note that there are several ``source_of_energy`` values that don't have a corresponding cost value.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_sources_and_distribution.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "source_of_energy", "type": "string", "description": "The source of energy (not plant type).", "constraints": { "required": true, "enum": [ "energy_available_for_sale", "energy_used_by_borrower", "purchased_power", "total_energy_accounted", "total_energy_losses", "total_plant", "total_sales", "delivered_out_of_system_gross", "net_interchange", "received_into_system_gross", "delivered_out_of_system_wheeling", "net_energy_wheeled", "received_into_system_wheeling", "energy_furnished_without_charge" ] } }, { "name": "net_energy_received_mwh", "type": "number", "description": "The net amount of energy received into the system.", "unit": "MWh" }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "source_of_energy" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 48124, "hash": "sha256:ec42565d4c56a13d49885c8ae3f00da01c1c0e1ced287934d4c0da5baf466fa4" }, { "name": "out_rus12__yearly_sources_and_distribution_by_plant_type", "type": "table", "description": "Annual time series of capacity, plant num, MWh, and cost of energy by plant type for RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, plant_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_sources_and_distribution_by_plant_type.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "plant_type", "type": "string", "description": "Type of plant.", "constraints": { "required": true, "enum": [ "combined_cycle", "hydro", "internal_combustion", "nuclear", "other", "steam" ] } }, { "name": "capacity_mw", "type": "number", "description": "Total installed (nameplate) capacity, in megawatts.", "unit": "MW" }, { "name": "plant_num", "type": "integer", "description": "Number of plants." }, { "name": "cost", "type": "number", "description": "Cost value.", "unit": "USD" }, { "name": "net_energy_received_mwh", "type": "number", "description": "The net amount of energy received into the system.", "unit": "MWh" } ], "primaryKey": [ "report_date", "borrower_id_rus", "plant_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 32241, "hash": "sha256:2d6c2455520fdb2849151d8f945712e615ad3402b67de6510d8ffbd22fdac72b" }, { "name": "out_rus12__yearly_statement_of_operations", "type": "table", "description": "Annual time series of opex and cost of electric service for RUS borrowers by time period.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part A - Section A)\n\nPrimary key:\n report_date, borrower_id_rus, opex_group, opex_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_statement_of_operations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "opex_group", "type": "string", "description": "High level section from the statement of operations table. Most of these types have subcomponents broken out in the ``opex_type`` column.", "constraints": { "required": true } }, { "name": "opex_type", "type": "string", "description": "Type of item from the statement of operations.", "constraints": { "required": true } }, { "name": "opex_report_month", "type": "number", "description": "Amount of operational expense, cost or income during the report month.", "unit": "USD" }, { "name": "opex_ytd", "type": "number", "description": "The year-to-date amount of operational expense, cost or income.", "unit": "USD" }, { "name": "opex_ytd_budget", "type": "number", "description": "The year-to-date budget for amount of operational expense, cost or income.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "opex_group", "opex_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 311174, "hash": "sha256:93a00473ec02dc5b2caf2c01b286631292f9fff4f4479d3126496c1a09d5a759" }, { "name": "out_rus12__yearly_utility_plant_changes", "type": "table", "description": "Annual time series of changes in utility plant\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply (Part H - Section A)\n\nPrimary key:\n report_date, borrower_id_rus, utility_plant_group, utility_plant_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThere are a few layers of nesting in this table, which can be distinguished by the categories in the `utility_plant_group` column:\n\n * intangible_plant: only has one total utility_plant_item\n * production_plant: has several sub-component utility_plant_item and a standard total\n * transmission_plant: has several sub-component utility_plant_item and a standard total\n * distribution_plant: has several sub-component utility_plant_item and a standard total\n * electric_plant_in_service: has two sub-components and a total which includes those sub-components and the totals of the above categories\n * utility_plant_in_service: has several sub-components and the total is the sum of those sub-components as well as the total of electric_plant_in_service\n * total_utility_plant: has one sub-component and the total is the sum of the sub-component and utility_plant_in_service", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus12", "title": "USDA RUS Form 12 -- Financial and Operating Report: Electric Power Supply", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Power Supply (formerly known as Form 12) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for power supply (generation). This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.18315222", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18315223", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus12.html" } ], "path": "out_rus12__yearly_utility_plant_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "utility_plant_group", "type": "string", "description": "High-level category of utility plant asset type.", "constraints": { "required": true } }, { "name": "utility_plant_item", "type": "string", "description": "Sub-category of utility_plant_group describing utility plant asset item.", "constraints": { "required": true } }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "utility_plant_group", "utility_plant_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus12__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "MW", "MWh", "accounting", "bituminous", "boilers", "capacity", "capex", "capital", "capital expenses", "coal", "combined_cycle", "combustion", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "electric", "electricity", "energy", "federal", "finance", "form 12", "fuel", "fuel cost", "fuel price", "generation", "generators", "government", "heat content", "heat rate", "hydro", "kW", "kWh", "kilowatt hours", "kilowatts", "lignite", "megawatt hours", "megawatts", "mmbtu", "natural gas", "nuclear", "operating expenses", "opex", "ownership", "planned", "plant", "plant in service", "power", "power supply", "price", "prime mover", "proposed", "receipts", "retirement", "rural", "rural utilities service", "rural utility", "rus", "solar", "steam", "subbituminous", "transmission", "turbine", "united states", "us", "usa", "usda", "utility", "wind" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 182535, "hash": "sha256:5f5c998a88b4363cf6ce5279bf6d7af004bd4b956de1aed5599ce6fdc2334068" }, { "name": "out_rus7__yearly_balance_sheet_assets", "type": "table", "description": "Annual time series of assets and other debts from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, asset_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_balance_sheet_assets.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "asset_type", "type": "string", "description": "Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "asset_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 1289873, "hash": "sha256:ef54b7dac2f0a2c60e8a23c540c3c4ccd118ba19121cf4145ff71f3e34f59a60" }, { "name": "out_rus7__yearly_balance_sheet_liabilities", "type": "table", "description": "Annual time series of liabilities and other credits from the balance sheet.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part C)\n\nPrimary key:\n report_date, borrower_id_rus, liability_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_balance_sheet_liabilities.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "liability_type", "type": "string", "description": "Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table.", "constraints": { "required": true } }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "liability_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 1229482, "hash": "sha256:b3e4f3eba0c1c02b1d42fef69fd965841b528fa86cbbc43358e08d98c071e7bc" }, { "name": "out_rus7__yearly_customer_energy_efficiency_and_conservation_loans", "type": "table", "description": "Annual time series of the repayment status of loans made by a borrower to customers for investments in energy efficiency and conservation initiatives.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part J)\n\nPrimary key:\n report_date, borrower_id_rus, loan_status\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nEnergy Resources Conservation (ERC) loans are defined by the RUS as loans made by an RUS borrower to its consumers for the cost of labor and materials for the following energy conservation measures: caulking, weather-stripping, ceiling insulation, wall insulation, floor insulation, duct insulation, pipe insulation, water heater insulation storm windows, thermal windows, storm or thermal doors, clock thermostats and attic ventilation fans.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_customer_energy_efficiency_and_conservation_loans.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "loan_status", "type": "string", "description": "The repayment status of a loan.", "constraints": { "required": true, "enum": [ "loan_default", "loan_delinquency" ] } }, { "name": "actual_pct", "type": "number", "description": "Observed percentage." }, { "name": "anticipated_pct", "type": "number", "description": "Expected percentage." }, { "name": "ytd_dollars", "type": "number", "description": "Balance this current year, in U.S. dollars.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "loan_status" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 16789, "hash": "sha256:a6564620867727d082510c44525b441c1514925ee5cac13669a84decc9182e76" }, { "name": "out_rus7__yearly_distribution_services", "type": "table", "description": "Annual time series of distribution services.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part B)\n\nPrimary key:\n report_date, borrower_id_rus, service_status\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_distribution_services.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "service_status", "type": "string", "description": "Status of services (e.g., idle, retired) in report period. Idle services exclude seasonals.", "constraints": { "required": true, "enum": [ "connected", "idle", "retired", "total" ] } }, { "name": "services", "type": "number", "description": "Number of services in system at end of year." }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "service_status" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 220404, "hash": "sha256:376139728a48509e3329faa8cc8366d32ec61b52711b67ba524cd73b67dc44be" }, { "name": "out_rus7__yearly_employee_statistics", "type": "table", "description": "Annual time series of statistics about employment and payroll.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part H)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_employee_statistics.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "employees_fte_num", "type": "integer", "description": "The number of full time employees." }, { "name": "employee_hours_worked_regular_time", "type": "integer", "description": "The number of regular (non-overtime) hours worked by employees." }, { "name": "employee_hours_worked_over_time", "type": "integer", "description": "The number of overtime hours worked by employees." }, { "name": "payroll_expensed", "type": "integer", "description": "The amount of payroll spent that was expensed." }, { "name": "payroll_capitalized", "type": "integer", "description": "The amount of payroll spent that was capitalized." }, { "name": "payroll_other", "type": "integer", "description": "The amount of payroll spent that was funded by other means - not capitalized or expensed." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 275277, "hash": "sha256:252ffb234d7ee5623fefbfac52a44c7fa7d110d91990f8f288ba99e680f01681" }, { "name": "out_rus7__yearly_energy_efficiency", "type": "table", "description": "Annual time series of investments in and impacts of energy efficiency programs.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part P)\n\nPrimary key:\n report_date, borrower_id_rus, customer_class, observation_period\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The savings_mmbtu likely contains values with incorrect units.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_energy_efficiency.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type.", "constraints": { "required": true, "enum": [ "residential_excluding_seasonal", "other_electric", "public_street_lighting", "sales_for_resale_rus_borrowers", "transmission", "irrigation", "public_other", "total", "sales_for_resale_other", "commercial_and_industrial_large", "commercial_and_industrial_small", "residential_seasonal" ] } }, { "name": "observation_period", "type": "string", "description": "The date range that any given record pertains to. Ex: 'december' implies that this record covers the month of December only, while 'avg' implies this record pertains to the average of the reporting period.", "constraints": { "required": true, "enum": [ "ytd", "new_in_report_year", "avg", "report_month", "report_year", "december", "cumulative", "ytd_budget" ] } }, { "name": "customers_num", "type": "number", "description": "Number of customers." }, { "name": "invested", "type": "number", "description": "The amount of money invested.", "unit": "USD" }, { "name": "savings_mmbtu", "type": "number", "description": "The estimated amount of energy savings from energy efficiency programs. Warning: We found values much larger than expected that we have not yet cleaned - this is likely a reporting unit error.", "unit": "MMBTU" } ], "primaryKey": [ "report_date", "borrower_id_rus", "customer_class", "observation_period" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 317128, "hash": "sha256:9c54f424857aeac1d5f3c571c5d29cd3e5830a166f93e6b3e8fa7a4f9d7dad31" }, { "name": "out_rus7__yearly_energy_purchased", "type": "table", "description": "Annual time series of energy purchased by RUS borrowers.\n\n\nMost-recent data:\n 2020\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part K)\n\nPrimary key:\n This table has no primary key. The primary key would probably be report_date, borrower_id_rus, fuel_type_code, supplier_code_rus, renewable_energy_program if not for certain EIA utilities represented as Miscellaneous (supplier code 700000).\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nA number of records report purchases from an unspecified entity. These fields all have reported utility names beginning with an \\*, including \\*Miscellaneous, \\*Adjustments, and \\*Residential Renewable Supplier.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_energy_purchased.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "purchased_mwh", "type": "number", "description": "The total electricity purchased.", "unit": "MWh" }, { "name": "purchased_energy_cost_total", "type": "number", "description": "The total cost of purchased energy. Includes fuel cost adjustment and wheeling and other charges.", "unit": "USD" }, { "name": "average_energy_cost_dollars_per_mwh", "type": "number", "description": "The average cost of energy per MWh.", "unit": "dollars_per_MWh" }, { "name": "wheeling_and_other_charges", "type": "number", "description": "The cost of wheeling and other charges or credits related to fuel. Included in the total cost." }, { "name": "fuel_cost_adjustment", "type": "number", "description": "The variable fuel surcharge component of a distribution cooperative's wholesale purchased power bill, reflecting pass-through of actual fuel cost fluctuations from the supplying utility, reported separately from base power charges and wheeling costs. Included in the total cost." }, { "name": "fuel_type_code_rus", "type": "integer", "description": "Unique numeric identifier for RUS fuel types.", "constraints": { "minimum": 1, "maximum": 17 } }, { "name": "is_supplier_eia_respondent", "type": "boolean", "description": "Whether the utility supplying energy to a RUS borrower is an EIA respondent." }, { "name": "supplier_code_rus", "type": "string", "description": "Unique numeric identifier for the utility supplying energy to a RUS borrower." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "comments", "type": "string", "description": "General comments field." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 361553, "hash": "sha256:3ed5847541e1175d013d92e7e766bea435a374fb5ea7195a8c10883c19c5fb31" }, { "name": "out_rus7__yearly_external_financial_risk_ratio", "type": "table", "description": "Annual time series of ratio of investments and loan guarantee balances to total utility plant assets.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part Q - Section III)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_external_financial_risk_ratio.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "external_financial_risk_ratio", "type": "number", "description": "total investments + loan guarantee balances / total utility plant assets. This ratio shows how much a utility is financially exposed to outside entities relative to its own assets." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 51277, "hash": "sha256:4331a88a81e0ca4aa8dcf89c7ec8ce7d171577528eba6315644895e1c1777077" }, { "name": "out_rus7__yearly_investments", "type": "table", "description": "Annual time series of investments, loan guarantees and loans.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part P - Section I)\n\nPrimary key:\n This table has no primary key. This is a list of all investments or loans in each year and borrowers can have multiple records with the same ``investment_description``.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nReporting of investments is required by 7 CFR 1717, Subpart N. Investment categories reported on this Part correspond to Balance Sheet items in Part C.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_investments.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "investment_description", "type": "string", "description": "Description of investment. This is a free-form text field and thus contains a wide variety of values." }, { "name": "investment_type_code", "type": "integer", "description": "Investment type code.", "constraints": { "minimum": 1, "maximum": 11 } }, { "name": "included_investments", "type": "number", "description": "Included investment." }, { "name": "excluded_investments", "type": "number", "description": "Excluded investment." }, { "name": "income_or_loss", "type": "number", "description": "Income or loss from investment." }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "investment_type_code" ], "reference": { "resource": "core_rus__codes_investment_types", "fields": [ "code" ] } }, { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 3089342, "hash": "sha256:cd0f122c4d3fcea228f64de742b538f6252521a16eab0b7ebc469895b3e3cbba" }, { "name": "out_rus7__yearly_loans", "type": "table", "description": "Annual time series of loans provided by RUS borrowers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part Q - Sections II & IV)\n\nPrimary key:\n This table has no primary key. Borrowers may receive multiple loans from ``lending_organizations`` in a given year.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table also includes loan guarantees where the RUS borrower backs a loan from another entity and is therefore liable to pay any remaining balance should the original borrower default. \n\nIn 2006, the loan maturity date for borrower ND0051's loan from ERC - Paulson, David was reported as 2/8/2820. There is no clear way to determine the correct maturity date given that 2006 is the first year of data we have and the same loan does not appear in future years. For this reason we've nulled the date.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_loans.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "loan_recipient", "type": "string", "description": "The organization that received a loan." }, { "name": "loan_balance", "type": "number", "description": "The amount of money still owned on a loan at the end of the reporting year." }, { "name": "loan_maturity_date", "type": "date", "description": "The date on which a loan is scheduled to be fully paid." }, { "name": "loan_original_amount", "type": "number", "description": "The original amount of a loan.", "unit": "USD" }, { "name": "for_rural_development", "type": "boolean", "description": "Whether or not the investment or loan is for rural development. This includes investments in any/all types of projects or products that were made to improve the economy and/or quality of life in the specified area." }, { "name": "is_loan_guarantee", "type": "boolean", "description": "Indicates a third-party loan that the reporting utility (referred as a borrower) has co-signed, taking on responsibility for repayment if the primary borrower defaults." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 217499, "hash": "sha256:aa1c6026f4b0c1f59804461bfb97fd4ad6c5fff4a0db57f00f4e0d9e7f1e25a0" }, { "name": "out_rus7__yearly_long_term_debt", "type": "table", "description": "Annual time series of long term debt and debt service requirements.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part N)\n\nPrimary key:\n This table has no primary key. This table has no native primary key. It is a list of all debts in each year and borrowers can have multiple records with the same ``investment_description``.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_long_term_debt.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "debt_description", "type": "string", "description": "Description of debt or loan. On the original form, there are nine provided descriptions and a section to add other free-form descriptions." }, { "name": "debt_ending_balance", "type": "number", "description": "The amount of principal still owned on the debt at the end of the report year.", "unit": "USD" }, { "name": "debt_interest", "type": "number", "description": "The interest expense on the debt for the report year.", "unit": "USD" }, { "name": "debt_principal", "type": "number", "description": "The principal paid on the debt during the report year.", "unit": "USD" }, { "name": "debt_total", "type": "number", "description": "The total amount of debt.", "unit": "USD" } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 897247, "hash": "sha256:c169022bf1707925778fab7a470863418d370d9490aaa3ef10f0691c2d779308" }, { "name": "out_rus7__yearly_long_term_leases", "type": "table", "description": "Annual time series of long term leases by property type.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part L)\n\nPrimary key:\n This table has no primary key. Borrowers may receive multiple leases from ``lending_organizations`` in a given year.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_long_term_leases.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "lending_organization", "type": "string", "description": "The organization that provided a lease or loan." }, { "name": "property_type", "type": "string", "description": "The type of property leased." }, { "name": "rental_cost_ytd", "type": "number", "description": "Year-to-date rental cost for leased property." } ], "primaryKey": [], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 47861, "hash": "sha256:47c0998537dea7fce8620a2c387439b0901013f9a06d01e4c698b68badb6e73d" }, { "name": "out_rus7__yearly_materials_and_supplies", "type": "table", "description": "Annual time series of cost of electric vs. other materials that were purchased, salvaged, used, or sold.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part F)\n\nPrimary key:\n report_date, borrower_id_rus, electric_or_other_materials\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_materials_and_supplies.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "electric_or_other_materials", "type": "string", "description": "Whether the cost is for electric materials or other materials", "constraints": { "required": true, "enum": [ "electric_materials", "other_materials" ] } }, { "name": "materials_adjustment", "type": "number", "description": "An adjustment value for the cost of materials and supplies.", "unit": "USD" }, { "name": "materials_ending_balance", "type": "number", "description": "The balance at the end of the report year for materials and supplies.", "unit": "USD" }, { "name": "materials_purchased", "type": "number", "description": "The cost of materials and supplies purchased.", "unit": "USD" }, { "name": "materials_salvaged", "type": "number", "description": "The cost of materials and supplies salvaged.", "unit": "USD" }, { "name": "materials_sold", "type": "number", "description": "The cost of materials and supplies sold.", "unit": "USD" }, { "name": "materials_used", "type": "number", "description": "The cost of materials and supplies used.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "electric_or_other_materials" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 457178, "hash": "sha256:71c78bed484b7d3a4ac06343840092eb7d83875f73d70eb24f74a731c9c2813a" }, { "name": "out_rus7__yearly_meeting_and_board", "type": "table", "description": "Annual time series of governance information about RUS borrowers' annual member meetings as well as information about their board.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part M)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_meeting_and_board.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "last_annual_meeting_date", "type": "datetime", "description": "The date of the last annual meeting." }, { "name": "members_num", "type": "integer", "description": "The total number of members." }, { "name": "members_present_at_meeting_num", "type": "integer", "description": "The number of members present at the last annual meeting." }, { "name": "was_quorum_present", "type": "boolean", "description": "Whether or not quorum was met." }, { "name": "members_voting_by_proxy_or_mail_num", "type": "integer", "description": "The number of members voting by mail or by proxy." }, { "name": "board_members_num", "type": "integer", "description": "The total number of board members." }, { "name": "fees_and_expenses_for_board_members", "type": "integer", "description": "The total amount of fees and expenses for board members.", "unit": "USD" }, { "name": "does_manager_have_written_contract", "type": "boolean", "description": "Whether or not the RUS borrower's manager has a written contract." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 197809, "hash": "sha256:c90d16fed2769b3e634b5b298b43f7d232fa4d6c05d47080a36d1ce5495a6461" }, { "name": "out_rus7__yearly_owed_by_customers", "type": "table", "description": "Annual time series of debt owed by customers.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part J)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_owed_by_customers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "amount_due_over_60_days", "type": "number", "description": "Reported amount of dollars due over 60 days from consumers for electric service. Includes both connected and disconnected customers.", "unit": "USD" }, { "name": "amount_written_off_ytd", "type": "number", "description": "Total charges due from consumers for electric service written off during the current year to Account 144.1, representing the write-off of uncollectible accounts.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 121789, "hash": "sha256:5f0c519d7580ddd5525f82b67ead329fd20c23ff97c6d90d6947f45ae6af64a0" }, { "name": "out_rus7__yearly_patronage_capital", "type": "table", "description": "Annual time series of patronage capital distributed and received.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part I)\n\nPrimary key:\n report_date, borrower_id_rus, patronage_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_patronage_capital.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "patronage_type", "type": "string", "description": "Type of patronage capital distributed or received.", "constraints": { "required": true, "enum": [ "total_received", "total_distributions_retirements", "received_lenders_of_electric_power", "distributions_special_retirements", "distributions_general_retirements", "received_supplier_of_electric_power" ] } }, { "name": "patronage_report_year", "type": "number", "description": "Amount of patronage distributed or received within report year.", "unit": "USD" }, { "name": "patronage_cumulative", "type": "number", "description": "Amount of patronage distributed or received cumulatively. Received patronage capital is not reported cumulatively and thus will be null.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "patronage_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 373065, "hash": "sha256:42df2d371b71e516a39a45c132eb23efa1e8933a4051f08f7605682a3b95a070" }, { "name": "out_rus7__yearly_power_requirements", "type": "table", "description": "Annual time series of power requirements - revenue and generation summary.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part O)\n\nPrimary key:\n report_date, borrower_id_rus\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThis table includes totals of electric sales and revenue which also appear in :ref:`core_rus7__yearly_power_requirements_electric_sales` with a ``customer_class`` of ``total``. This table includes all other power requirements - not broken out by customer class, so we include these electric requirements in this table as well.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_power_requirements.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "electric_sales_revenue", "type": "integer", "description": "Total Revenue Received From Sales of Electric Energy. Total of lines 1c thru 9c on the original form.", "unit": "USD" }, { "name": "transmission_revenue", "type": "integer", "description": "Transmission revenue.", "unit": "USD" }, { "name": "other_electric_revenue", "type": "integer", "description": "Electric revenue other than electric_sales_revenue.", "unit": "USD" }, { "name": "purchases_and_generation_cost", "type": "integer", "description": "The cost of purchases and generation of electricity.", "unit": "UDS" }, { "name": "electric_sales_mwh", "type": "number", "description": "Total MWh Sold to electric sales. Total of lines 1b thru 9b on the original form.", "unit": "MWh" }, { "name": "own_use_mwh", "type": "number", "description": "The electricity in MWh used for the borrower's own internal use.", "unit": "MWh" }, { "name": "purchased_mwh", "type": "number", "description": "The total electricity purchased.", "unit": "MWh" }, { "name": "generated_mwh", "type": "number", "description": "The total electricity generated.", "unit": "MWh" }, { "name": "interchange_mwh", "type": "number", "description": "The net interchange of electricity. The net amount of electricity exchanged in purchases and sales.", "unit": "MWh" }, { "name": "peak_mw", "type": "number", "description": "The peak system MWh - the sum of all MW.", "unit": "MW" }, { "name": "is_peak_coincident", "type": "boolean", "description": "Whether or not the peak_mw is coincident or non-coincident peak." } ], "primaryKey": [ "report_date", "borrower_id_rus" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 383363, "hash": "sha256:1375630f3a241056d4b648c54d777890d86dbad6a1ab5728239f5906c756be1d" }, { "name": "out_rus7__yearly_power_requirements_electric_customers", "type": "table", "description": "Annual time series of power requirements - number of customers served by customer type.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part O)\n\nPrimary key:\n report_date, borrower_id_rus, customer_class, observation_period\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_power_requirements_electric_customers.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type.", "constraints": { "required": true, "enum": [ "residential_excluding_seasonal", "other_electric", "public_street_lighting", "sales_for_resale_rus_borrowers", "transmission", "irrigation", "public_other", "total", "sales_for_resale_other", "commercial_and_industrial_large", "commercial_and_industrial_small", "residential_seasonal" ] } }, { "name": "observation_period", "type": "string", "description": "The date range that any given record pertains to. Ex: 'december' implies that this record covers the month of December only, while 'avg' implies this record pertains to the average of the reporting period.", "constraints": { "required": true, "enum": [ "ytd", "new_in_report_year", "avg", "report_month", "report_year", "december", "cumulative", "ytd_budget" ] } }, { "name": "customers_num", "type": "number", "description": "Number of customers." } ], "primaryKey": [ "report_date", "borrower_id_rus", "customer_class", "observation_period" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 378165, "hash": "sha256:8c4e40a9a98c74406f31fb633b19b8316164773db742662950206b4d854233f9" }, { "name": "out_rus7__yearly_power_requirements_electric_sales", "type": "table", "description": "Annual time series of power requirements - revenue and energy sold by customer type.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part O)\n\nPrimary key:\n report_date, borrower_id_rus, customer_class\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_power_requirements_electric_sales.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "customer_class", "type": "string", "description": "High level categorization of customer type.", "constraints": { "required": true, "enum": [ "residential_excluding_seasonal", "other_electric", "public_street_lighting", "sales_for_resale_rus_borrowers", "transmission", "irrigation", "public_other", "total", "sales_for_resale_other", "commercial_and_industrial_large", "commercial_and_industrial_small", "residential_seasonal" ] } }, { "name": "sales_mwh", "type": "number", "description": "Quantity of electricity sold in MWh.", "unit": "MWh" }, { "name": "revenue", "type": "number", "description": "Amount of revenue.", "unit": "USD" } ], "primaryKey": [ "report_date", "borrower_id_rus", "customer_class" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 778893, "hash": "sha256:ca2266059553a6c875dc7f805fe4973e4e392a2d3b6c4c3ca222fde1e9ab6eee" }, { "name": "out_rus7__yearly_service_interruptions", "type": "table", "description": "Annual time series of service interruptions by cause.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part G)\n\nPrimary key:\n report_date, borrower_id_rus, service_interruption_cause, observation_period\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_service_interruptions.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "service_interruption_cause", "type": "string", "description": "Source of service interruption.", "constraints": { "required": true, "enum": [ "major_event", "other", "planned", "power_supplier", "total" ] } }, { "name": "observation_period", "type": "string", "description": "The date range that any given record pertains to. Ex: 'december' implies that this record covers the month of December only, while 'avg' implies this record pertains to the average of the reporting period.", "constraints": { "required": true, "enum": [ "five_year_average", "annual" ] } }, { "name": "saidi_minutes", "type": "number", "description": "Cumulative duration (minutes) of interruption for the average customer during the report year.", "unit": "min" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "service_interruption_cause", "observation_period" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 362925, "hash": "sha256:58acb00a2fa251a02fa53f19422b072ade75d0b069fcac65ac2bb881ae9c5a15" }, { "name": "out_rus7__yearly_statement_of_operations", "type": "table", "description": "Annual time series of opex and cost of electric service for RUS borrowers by time period.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part A)\n\nPrimary key:\n report_date, borrower_id_rus, opex_group, opex_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_statement_of_operations.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "opex_group", "type": "string", "description": "High level section from the statement of operations table. Most of these types have subcomponents broken out in the ``opex_type`` column.", "constraints": { "required": true } }, { "name": "opex_type", "type": "string", "description": "Type of item from the statement of operations.", "constraints": { "required": true } }, { "name": "opex_report_month", "type": "number", "description": "Amount of operational expense, cost or income during the report month.", "unit": "USD" }, { "name": "opex_ytd", "type": "number", "description": "The year-to-date amount of operational expense, cost or income.", "unit": "USD" }, { "name": "opex_ytd_budget", "type": "number", "description": "The year-to-date budget for amount of operational expense, cost or income.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "opex_group", "opex_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 2963170, "hash": "sha256:2aad858b7ddf77cb4c4d06538452546efd61b44a8ccb317bb16049699cc083ad" }, { "name": "out_rus7__yearly_transmission_and_distribution_mileage", "type": "table", "description": "Annual time series of miles of transmission and distribution infrastructure.\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part B)\n\nPrimary key:\n report_date, borrower_id_rus, line_type\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nNote that according to RUS, 'underbuild in overhead lines or joint runs in underground installations do not increase the number of line miles except for distribution underbuild on transmission poles. In such cases, distribution pole line miles would be increased by the number of underbuild miles involved.'", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_transmission_and_distribution_mileage.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "line_type", "type": "string", "description": "The type of line mileage reported (e.g., transmission, overhead distribution).", "constraints": { "required": true, "enum": [ "distribution_overhead", "distribution_underground", "transmission_line", "total" ] } }, { "name": "miles", "type": "number", "description": "Line length at the end of the reported period, in miles.", "unit": "miles" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "line_type" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 260958, "hash": "sha256:0c89b198ee6dad3de7ea75f951bb41ab15aaa78f9ef99ca5095a7d0abbd9714b" }, { "name": "out_rus7__yearly_utility_plant_changes", "type": "table", "description": "Annual time series of changes in utility plant\n\n\nMost-recent data:\n 2021\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution (Part E)\n\nPrimary key:\n report_date, borrower_id_rus, utility_plant_group, utility_plant_item\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* Some columns contain subtotals; use caution when choosing columns to aggregate.\n\n* Borrower name data has been drawn from reported values over multiple years and tables of data which are not always consistent with each other. PUDL chooses the most consistent borrower name to facilitate cross-referencing even if that means some values will differ from the raw sources.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "rus7", "title": "USDA RUS Form 7 -- Financial and Operating Report: Electric Distribution", "path": "https://www.rd.usda.gov/resources/forms/rus-forms", "description": "The United States Department of Agriculture (USDA) Financial and Operating Report for Electric Distribution (formerly known as Form 7) is an annual report submitted by rural electric utilities that receive funding from the USDA Rural Utilities Service (RUS) for distribution services. This data was obtained through multiple Freedom of Information Access (FOIA) requests.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "concept_doi": "https://doi.org/10.5281/zenodo.18248545", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "doi": "https://doi.org/10.5281/zenodo.18793102", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/rus7.html" } ], "path": "out_rus7__yearly_utility_plant_changes.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "report_date", "type": "date", "description": "Date reported.", "constraints": { "required": true } }, { "name": "borrower_id_rus", "type": "string", "description": "Unique identifier of RUS (Rural Utilities Service) borrower. These ID's are structured as: two character state acronyms followed by four digits.", "constraints": { "required": true, "pattern": "^[A-Z]{2}\\d{4}$" } }, { "name": "borrower_name_rus", "type": "string", "description": "The name of the RUS (Rural Utilities Service) borrower." }, { "name": "state", "type": "string", "description": "Two letter US state or territory abbreviation, or ISO 3166-1 alpha-two code for Micronesia and the Marshall Islands.", "constraints": { "enum": [ "IA", "WA", "ND", "SD", "GU", "CO", "MT", "NB", "NC", "AL", "MB", "VT", "LA", "WY", "NU", "AB", "TN", "GA", "DC", "WV", "OH", "MA", "TX", "SK", "FM", "YT", "UT", "CA", "KS", "NM", "CT", "PE", "MS", "IN", "NT", "KY", "ID", "MH", "NS", "SC", "VI", "HI", "DE", "ON", "AS", "VA", "AR", "BC", "NH", "NJ", "OR", "NY", "IL", "RI", "FL", "ME", "MI", "MO", "PR", "NV", "MN", "NL", "PA", "WI", "AK", "AZ", "QC", "MD", "MP", "OK", "NE" ] } }, { "name": "utility_plant_group", "type": "string", "description": "High-level category of utility plant asset type.", "constraints": { "required": true } }, { "name": "utility_plant_item", "type": "string", "description": "Sub-category of utility_plant_group describing utility plant asset item.", "constraints": { "required": true } }, { "name": "retirements", "type": "number", "description": "Cost of disposal of items classified within the account.", "unit": "USD" }, { "name": "additions", "type": "number", "description": "Cost of acquisition of items classified within the account.", "unit": "USD" }, { "name": "adjustments_and_transfers", "type": "number", "description": "Amount of adjustments and transfers within a class of assets.", "unit": "USD" }, { "name": "ending_balance", "type": "number", "description": "Account balance at end of year.", "unit": "USD" }, { "name": "is_total", "type": "boolean", "description": "Whether or not this record represents a total." } ], "primaryKey": [ "report_date", "borrower_id_rus", "utility_plant_group", "utility_plant_item" ], "foreignKeys": [ { "fields": [ "borrower_id_rus" ], "reference": { "resource": "core_rus7__entity_borrowers", "fields": [ "borrower_id_rus" ] } } ] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "coop", "cooperative", "cost", "debt", "department of agriculture", "depreciation", "distribution", "federal", "finance", "form 7", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "rural", "rural utilities service", "rural utility", "rus", "united states", "us", "usa", "usda" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" }, { "title": "Matthew Grimley", "path": "https://www.hhh.umn.edu/directory/matthew-grimley", "email": "griml011@umn.edu", "roles": [ "contributor" ], "zenodo_role": "data collector", "organization": "University of Minnesota", "orcid": "0000-0003-3969-505X", "name": "matthew-grimley" } ], "bytes": 986230, "hash": "sha256:44b665d9faf5750eb1f41588cf0557b303eb9994ea523f01c86e323d9059b152" }, { "name": "out_sec10k__changelog_company_name", "type": "table", "description": "Changelog table tracking changes in the names each SEC 10-K filer has used.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n This table has no primary key.\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nWe use the company name reported in association with each name change block in the\ncompany information table to fill in the most recent value of ``company_name_new``.\nRoughly 1,000 reported \"name changes\" in which the old and new names were identical\nhave been dropped.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "out_sec10k__changelog_company_name.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database.", "constraints": { "required": true } }, { "name": "name_change_date", "type": "date", "description": "Date of last name change of the company.", "constraints": { "required": true } }, { "name": "company_name_old", "type": "string", "description": "Name of company prior to name change." }, { "name": "company_name_new", "type": "string", "description": "Name of company after name change." } ], "primaryKey": [], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 702691, "hash": "sha256:3d86c902070e79e9c951560ab856dd2c51e979446b49ed4220505b6ff48e1d6e" }, { "name": "out_sec10k__parents_and_subsidiaries", "type": "table", "description": "A denormalized table containing information about parent companies that file SEC Form 10-K and their subsidiaries, which may or may not file Form 10-K.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n filename_sec10k, subsidiary_company_id_sec10k\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* This data has been extracted probabilistically using a machine learning model and contains some incompletions and errors. It should not be treated as ground truth data.\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nCompany ownership fractions are extracted from SEC 10-K Exhibit 21. Information about\nthe companies is extracted primarily from the headers of the SEC 10-K filing.\nSubsidiaries that file Form 10-K will have much more information available than those\nthat only appear as subsidiaries in Exhibit 21.\n\nSEC 10-K filers and EIA utilities are matched using probabilistic record linkage.\nExhibit 21 subsidiaries that don't file a Form 10-K are matched to EIA utilities using\nthe company name.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "out_sec10k__parents_and_subsidiaries.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "filename_sec10k", "type": "string", "description": "Unique portion of the filename associated with the SEC 10-K filing in the EDGAR database. The full source URL can be reconstructed by prepending https://www.sec.gov/Archives/edgar/data/ and adding the .txt file type extension.", "constraints": { "required": true } }, { "name": "subsidiary_company_name", "type": "string", "description": "Name of subsidiary company." }, { "name": "subsidiary_company_location", "type": "string", "description": "Location of subsidiary company. This is the full US state name or country name and occasionally a two digit code that was not mapped to a full name during cleaning." }, { "name": "subsidiary_company_id_sec10k", "type": "string", "description": "PUDL-assigned ID for subsidiaries found in SEC 10-K Exhibit 21. The ID is created by concatenating the CIK of the company whose filing the subsidiary was found in, the subsidiary company's name, and location of incorporation. It is not guaranteed to be stable across different releases of PUDL and so should never be hard-coded in analyses.", "constraints": { "required": true } }, { "name": "fraction_owned", "type": "number", "description": "Proportion of generator ownership attributable to this utility." }, { "name": "parent_company_central_index_key", "type": "string", "description": "Central index key (CIK) of the parent company." }, { "name": "parent_company_name", "type": "string", "description": "Name of the parent company." }, { "name": "filing_date", "type": "date", "description": "Date on which the filing was submitted." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "parent_company_phone_number", "type": "string", "description": "Phone number of the parent company." }, { "name": "parent_company_business_city", "type": "string", "description": "City where the parent company's place of business is located." }, { "name": "parent_company_business_state", "type": "string", "description": "State where the parent company's place of business is located." }, { "name": "parent_company_business_street_address", "type": "string", "description": "Street address of the parent company's place of business." }, { "name": "parent_company_business_street_address_2", "type": "string", "description": "Second line of the street address of the parent company's place of business." }, { "name": "parent_company_business_zip_code", "type": "string", "description": "Zip code of the parent company's place of business.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "parent_company_business_zip_code_4", "type": "string", "description": "Zip code suffix of the company's place of business.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "parent_company_mail_city", "type": "string", "description": "City of the parent company's mailing address." }, { "name": "parent_company_mail_state", "type": "string", "description": "State of the parent company's mailing address." }, { "name": "parent_company_mail_street_address", "type": "string", "description": "Street portion of the parent company's mailing address." }, { "name": "parent_company_mail_street_address_2", "type": "string", "description": "Second line of the street portion of the parent company's mailing address." }, { "name": "parent_company_mail_zip_code", "type": "string", "description": "Zip code of the parent company's mailing address.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "parent_company_mail_zip_code_4", "type": "string", "description": "Zip code suffix of the parent company's mailing address.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "parent_company_incorporation_state", "type": "string", "description": "Two letter state code where parent company is incorporated." }, { "name": "parent_company_utility_id_eia", "type": "integer", "description": "The EIA utility ID of the parent company." }, { "name": "parent_company_utility_name_eia", "type": "string", "description": "The EIA reported utility name of the parent company." }, { "name": "parent_company_industry_name_sic", "type": "string", "description": "Text description of the parent company's Standard Industrial Classification (SIC)" }, { "name": "parent_company_industry_id_sic", "type": "string", "description": "Four-digit Standard Industrial Classification (SIC) code identifying the parent company's primary industry. SIC codes have been replaced by NAICS codes in many applications, but are still used by the SEC. See e.g. https://www.osha.gov/data/sic-manual for code definitions." }, { "name": "parent_company_taxpayer_id_irs", "type": "string", "description": "Taxpayer ID of the parent company with the IRS.", "constraints": { "pattern": "^\\d{2}-\\d{7}$" } }, { "name": "subsidiary_company_central_index_key", "type": "string", "description": "Central index key (CIK) of the subsidiary company." }, { "name": "subsidiary_company_phone_number", "type": "string", "description": "Phone number of the subsidiary company." }, { "name": "subsidiary_company_business_city", "type": "string", "description": "City where the subsidiary company's place of business is located." }, { "name": "subsidiary_company_business_state", "type": "string", "description": "State where the subsidiary company's place of business is located." }, { "name": "subsidiary_company_business_street_address", "type": "string", "description": "Street address of the subsidiary company's place of business." }, { "name": "subsidiary_company_business_street_address_2", "type": "string", "description": "Second line of the street address of the subsidiary company's place of business." }, { "name": "subsidiary_company_business_zip_code", "type": "string", "description": "Zip code of the subsidiary company's place of business.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "subsidiary_company_business_zip_code_4", "type": "string", "description": "Zip code suffix of the subsidiary company's place of business.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "subsidiary_company_mail_city", "type": "string", "description": "City of the subsidiary company's mailing address." }, { "name": "subsidiary_company_mail_state", "type": "string", "description": "State of the parent company's mailing address." }, { "name": "subsidiary_company_mail_street_address", "type": "string", "description": "Street portion of the subsidiary company's mailing address." }, { "name": "subsidiary_company_mail_street_address_2", "type": "string", "description": "Second line of the street portion of the subsidiary company's mailing address." }, { "name": "subsidiary_company_mail_zip_code", "type": "string", "description": "Zip code of the subsidiary company's mailing address.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "subsidiary_company_mail_zip_code_4", "type": "string", "description": "Zip code suffix of the subsidiary company's mailing address.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "subsidiary_company_incorporation_state", "type": "string", "description": "Two letter state code where subisidary company is incorporated." }, { "name": "subsidiary_company_utility_id_eia", "type": "integer", "description": "The EIA utility ID of the subsidiary company." }, { "name": "subsidiary_company_utility_name_eia", "type": "string", "description": "The EIA reported utility name of the subsidiary company." }, { "name": "subsidiary_company_industry_name_sic", "type": "string", "description": "Text description of the subsidiary company's Standard Industrial Classification (SIC)" }, { "name": "subsidiary_company_industry_id_sic", "type": "string", "description": "Four-digit Standard Industrial Classification (SIC) code identifying the subsidiary company's primary industry. SIC codes have been replaced by NAICS codes in many applications, but are still used by the SEC. See e.g. https://www.osha.gov/data/sic-manual for code definitions." }, { "name": "subsidiary_company_taxpayer_id_irs", "type": "string", "description": "Taxpayer ID of the subsidiary company with the IRS.", "constraints": { "pattern": "^\\d{2}-\\d{7}$" } } ], "primaryKey": [ "filename_sec10k", "subsidiary_company_id_sec10k" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 82583789, "hash": "sha256:64aaabd28f9fa18d654d86f636267df0d4286344f74e13519bb6e0a748168ed4" }, { "name": "out_sec10k__quarterly_company_information", "type": "table", "description": "Quarterly time series of company and filing data extracted from SEC 10-K filings.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n filename_sec10k, central_index_key\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nIn addition to the information provided by the :ref:`core_sec10k__quarterly_company_information` table, this output table merges in the associated ``utility_id_eia`` (and utility name) if it is available, as well as the report and filing dates associated with the filing each record was extracted from, as well as providing a link to the source URL for the filing.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "out_sec10k__quarterly_company_information.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "filename_sec10k", "type": "string", "description": "Unique portion of the filename associated with the SEC 10-K filing in the EDGAR database. The full source URL can be reconstructed by prepending https://www.sec.gov/Archives/edgar/data/ and adding the .txt file type extension.", "constraints": { "required": true } }, { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database.", "constraints": { "required": true } }, { "name": "filer_count", "type": "integer", "description": "A counter indicating which observation of company data within an SEC 10-K filing header the record pertains to." }, { "name": "utility_id_eia", "type": "integer", "description": "The EIA Utility Identification number." }, { "name": "utility_name_eia", "type": "string", "description": "The name of the utility." }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "filing_date", "type": "date", "description": "Date on which the filing was submitted." }, { "name": "company_name", "type": "string", "description": "Name of the reporting company." }, { "name": "fiscal_year_end", "type": "string", "description": "The end date of an SEC filing company's fiscal year, in MMDD format.", "constraints": { "pattern": "^(?:(?:0[1-9]|1[0-2])(?:0[1-9]|1\\d|2\\d|3[01])|(?:0[13-9]|1[0-2])(?:29|30)|(?:0[13578]|1[02])31)$" } }, { "name": "taxpayer_id_irs", "type": "string", "description": "Taxpayer ID of the company with the IRS.", "constraints": { "pattern": "^\\d{2}-\\d{7}$" } }, { "name": "incorporation_state", "type": "string", "description": "Two letter state code where company is incorporated." }, { "name": "industry_name_sic", "type": "string", "description": "Text description of Standard Industrial Classification (SIC)" }, { "name": "industry_group_sic", "type": "string", "description": "A higher level industry category defined within the Standard Industrial Classification (SIC) system." }, { "name": "industry_id_sic", "type": "string", "description": "Four-digit Standard Industrial Classification (SIC) code identifying the company's primary industry. SIC codes have been replaced by NAICS codes in many applications, but are still used by the SEC. See e.g. https://www.osha.gov/data/sic-manual for code definitions.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "film_number", "type": "string", "description": "Document control number used in the SEC EDGAR database. The first four digits can be used to access scans of the document in the SEC's Virtual Private Reference Room." }, { "name": "sec10k_type", "type": "string", "description": "Specific version of SEC 10-K that was filed. 10-k: the standard annual report. 10-k/a: an amended version of the annual report. 10-k405: filed to report insider trading that was not reported in a timely fashion. 10-k405/a: an amended version of the 10-k405. 10-kt: submitted in lieu of or in addition to a standard 10-K annual report when a company changes the end of its fiscal year (e.g. due to a merger) leaving the company with a longer or shorter reporting period. 10-kt/a: an amended version of the 10-kt. 10-ksb: the annual report for small businesses, also known as penny stocks. 10-ksb/a: an amended version of the 10-ksb.", "constraints": { "enum": [ "10-k", "10-k/a", "10-k405", "10-k405/a", "10-kt", "10-kt/a", "10-ksb", "10-ksb/a" ] } }, { "name": "sec_act", "type": "string", "description": "SEC Act through which the form was enacted, e.g. 1934 act.", "constraints": { "enum": [ "1934 act" ] } }, { "name": "filing_number_sec", "type": "string", "description": "Filing number used internally by the SEC commission to track filing." }, { "name": "phone_number", "type": "string", "description": "Phone number for utility contact 1." }, { "name": "business_street_address", "type": "string", "description": "Street address of the company's place of business." }, { "name": "business_street_address_2", "type": "string", "description": "Second line of the street address of the company's place of business." }, { "name": "business_city", "type": "string", "description": "City where the company's place of business is located." }, { "name": "business_state", "type": "string", "description": "State where the company's place of business is located." }, { "name": "business_zip_code", "type": "string", "description": "Zip code of the company's place of business.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "business_zip_code_4", "type": "string", "description": "Zip code suffix of the company's place of business.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "business_postal_code", "type": "string", "description": "Non-US postal code of the company's place of business." }, { "name": "mail_street_address", "type": "string", "description": "Street portion of the company's mailing address." }, { "name": "mail_street_address_2", "type": "string", "description": "Second line of the street portion of the company's mailing address." }, { "name": "mail_city", "type": "string", "description": "City of the company's mailing address." }, { "name": "mail_state", "type": "string", "description": "State of the company's mailing address." }, { "name": "mail_zip_code", "type": "string", "description": "Zip code of the company's mailing address.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "mail_zip_code_4", "type": "string", "description": "Zip code suffix of the company's mailing address.", "constraints": { "pattern": "^\\d{4}$" } }, { "name": "mail_postal_code", "type": "string", "description": "Non-US postal code of the company's mailing address." }, { "name": "source_url", "type": "string", "description": "URL pointing to the original source of the data in the record.", "constraints": { "pattern": "^https?://.+" } } ], "primaryKey": [ "filename_sec10k", "central_index_key" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 18491842, "hash": "sha256:edba13b5adc270486e10b758784c62336ed2e4eb9b651b5157e0e7d71cb005c0" }, { "name": "out_sec10k__quarterly_filings", "type": "table", "description": "Quarterly time series of metadata describing SEC 10-K filings.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data has been expanded into a wide/denormalized format, with IDs and codes accompanied by human-readable names and descriptions.\n\nSource:\n U.S. Securities and Exchange Commission (SEC) Form 10-K\n\nPrimary key:\n filename_sec10k\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* PUDL does not currently update its copy of this data.\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\n\nEach SEC 10-K filing is submitted by a single company, but may contain information about\nnumerous other companies. This table indicates the company submitting the filing, as\nwell as some information about the overall filing. Each filing is guaranteed to have a\nunique filename, but ~1% of all filings are one company submitting the same form\nmultiple times on the same day, so the filename is the only available natural primary\nkey. This output table adds a link to the source URL for the filing, which is\nconstructed from the filename.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "sec10k", "title": "U.S. Securities and Exchange Commission (SEC) Form 10-K", "path": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "description": "The SEC Form 10-K is an annual report required by the U.S. Securities and Exchange Commission (SEC), that gives a comprehensive summary of a company's financial performance.", "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "concept_doi": "https://doi.org/10.5281/zenodo.15161693", "license_raw": { "name": "other-pd", "title": "U.S. Government Works", "path": "https://www.usa.gov/publicdomain/label/1.0/" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15161694", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/sec10k.html" } ], "path": "out_sec10k__quarterly_filings.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "filename_sec10k", "type": "string", "description": "Unique portion of the filename associated with the SEC 10-K filing in the EDGAR database. The full source URL can be reconstructed by prepending https://www.sec.gov/Archives/edgar/data/ and adding the .txt file type extension.", "constraints": { "required": true } }, { "name": "central_index_key", "type": "string", "description": "Identifier of the company in SEC database." }, { "name": "company_name", "type": "string", "description": "Name of the reporting company." }, { "name": "sec10k_type", "type": "string", "description": "Specific version of SEC 10-K that was filed. 10-k: the standard annual report. 10-k/a: an amended version of the annual report. 10-k405: filed to report insider trading that was not reported in a timely fashion. 10-k405/a: an amended version of the 10-k405. 10-kt: submitted in lieu of or in addition to a standard 10-K annual report when a company changes the end of its fiscal year (e.g. due to a merger) leaving the company with a longer or shorter reporting period. 10-kt/a: an amended version of the 10-kt. 10-ksb: the annual report for small businesses, also known as penny stocks. 10-ksb/a: an amended version of the 10-ksb.", "constraints": { "enum": [ "10-k", "10-k/a", "10-k405", "10-k405/a", "10-kt", "10-kt/a", "10-ksb", "10-ksb/a" ] } }, { "name": "filing_date", "type": "date", "description": "Date on which the filing was submitted." }, { "name": "exhibit_21_version", "type": "string", "description": "Version of exhibit 21 submitted (if applicable).", "constraints": { "pattern": "^21\\.*\\d*$" } }, { "name": "report_date", "type": "date", "description": "Date reported." }, { "name": "source_url", "type": "string", "description": "URL pointing to the original source of the data in the record.", "constraints": { "pattern": "^https?://.+" } } ], "primaryKey": [ "filename_sec10k" ], "foreignKeys": [] }, "keywords": [ "accounting", "capex", "capital", "capital expenses", "contract", "cost", "debt", "depreciation", "federal", "finance", "government", "operating expenses", "opex", "ownership", "plant in service", "price", "receipts", "sec", "securities and exchange commission", "united states", "us", "usa" ], "contributors": [ { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 12861652, "hash": "sha256:3201e767244f9929bb146dd68d1f86976606354729fe88e3c887100155fd72c1" }, { "name": "out_vcerare__hourly_available_capacity_factor", "type": "table", "description": "Hourly time series of estimated county-averaged capacity factors for wind and solar generating facilities across the contiguous United States (US), to be used as a tool and input for resource adequacy modeling and planning.\n\n\nMost-recent data:\n 2023\n\n\nProcessing:\n Data is ready for use in analyses, but for practical reasons has not been denormalized and remains in narrow format.\n\nSource:\n Vibrant Clean Energy Resource Adequacy Renewable Energy (RARE) Power Dataset\n\nPrimary key:\n state, place_name, datetime_utc\n\n\nUsage Warnings\n^^^^^^^^^^^^^^\n\n\n* The hourly capacity factors are normalized to unity for maximal power output. To convert to units of power, the user must multiply by the installed capacity within the county.\n\n* Hourly capacity factors are spatially averaged across each county over the contiguous USA. There are a handful of counties that are too small to pick up representation on the HRRR operational forecast grid. As such, these counties will have no wind or solar power production curves.\n\n* Due to power production performance being correlated with panel temperatures, during cold sunny periods, some solar capacity factor values are greater than 1 (but less that 1.1).\n\n\n\n\n\nAdditional Details\n^^^^^^^^^^^^^^^^^^\n\nThe data in this table were produced by Vibrant Clean Energy, and are licensed to the public under the Creative Commons Attribution 4.0 International license (CC-BY-4.0).\n\nThe technologies provided are:\n\n1) Onshore wind assuming a 100m hub height and 120m rotor diameter;\n\n2) Offshore wind assuming a 140m hub height and 120m rotor diameter;\n\n3) Utility solar assuming a fixed axis panel tilted at latitude.\n\nThe foundation of the capacity factors provided here is the NOAA HRRR operational numerical weather prediction model. The HRRR covers the entire contiguous US at a horizontal resolution of 3 km. Forecasts are initialized each hour of the year. Forecast hour two (2) is used as the input data for the power algorithms. This forecast hour is chosen to trade-off the impact of the measurement and data assimilation procedure of the HRRR with the physics of the model to derive the most complete picture of the atmosphere at the forecast time horizon. \n\nFor wind capacity factors: vertical slices of the atmosphere are considered across the defined rotor swept area. Bringing together wind speed, density, temperature and icing information, a power capacity is estimated using a representative power coefficient (Cp) curve to determine the power from a given wind speed, atmospheric density and temperature. There is no wake modeling included in the dataset.\n\nFor solar capacity factors: pertinent surface weather variables are pulled such as incoming short wave radiation, direct normal irradiance (calculated in the HRRR 2016 forward), surface temperature and other parameters. These are used in a non-linear I-V curve translation to power capacity factors.", "licenses": [ { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" } ], "sources": [ { "name": "vcerare", "title": "Vibrant Clean Energy Resource Adequacy Renewable Energy (RARE) Power Dataset", "path": "https://vibrantcleanenergy.com/products/datasets/", "description": "This dataset was produced by Vibrant Clean Energy and is licensed to the public under the Creative Commons Attribution 4.0 International license (CC-BY-4.0). The data consists of hourly, county-level renewable generation profiles in the continental United States and was compiled based on outputs from the NOAA HRRR weather model. Profiles are stated as a capacity factor (a percentage of nameplate capacity) and exist for onshore wind, offshore wind, and fixed-tilt solar generation types.", "keywords": [ "capacity factor", "county", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "vibrant clean energy", "weather", "wind" ], "concept_doi": "https://doi.org/10.5281/zenodo.13937522", "license_raw": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "license_pudl": { "name": "CC-BY-4.0", "title": "Creative Commons Attribution 4.0", "path": "https://creativecommons.org/licenses/by/4.0" }, "contributors": [ { "title": "Vibrant Clean Energy", "path": "https://vibrantcleanenergy.com/", "email": "info@vibrantcleanenergy.com", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Vibrant Clean Energy", "name": "vibrant-clean-energy" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "doi": "https://doi.org/10.5281/zenodo.15166129", "documentation": "https://docs.catalyst.coop/pudl/en/nightly/data_sources/vcerare.html" } ], "path": "out_vcerare__hourly_available_capacity_factor.parquet", "scheme": "file", "format": "parquet", "mediatype": "application/parquet", "schema": { "fields": [ { "name": "state", "type": "string", "description": "Two letter US state abbreviation.", "constraints": { "required": true } }, { "name": "place_name", "type": "string", "description": "County or lake name, sourced from the latest Census PEP vintage based on county FIPS ID. Lake names originate from VCE RARE directly, and may also appear several times--once for each state it touches. FIPS ID values for lakes have been nulled.", "constraints": { "required": true } }, { "name": "datetime_utc", "type": "datetime", "description": "Date and time converted to Coordinated Universal Time (UTC).", "constraints": { "required": true } }, { "name": "report_year", "type": "integer", "description": "Four-digit year in which the data was reported." }, { "name": "hour_of_year", "type": "integer", "description": "Integer between 1 and 8670 representing the hour in a given year." }, { "name": "county_id_fips", "type": "string", "description": "County ID from the Federal Information Processing Standard Publication 6-4.", "constraints": { "pattern": "^\\d{5}$" } }, { "name": "latitude", "type": "number", "description": "Latitude of the place centroid (e.g., county centroid)." }, { "name": "longitude", "type": "number", "description": "Longitude of the place centroid (e.g., county centroid)." }, { "name": "capacity_factor_solar_pv", "type": "number", "description": "Estimated capacity factor (0-1) calculated for solar PV assuming a fixed axis panel tilted at latitude and DC power outputs. Due to power production performance being correlated with panel temperatures, during cold sunny periods, some solar capacity factor values are greater than 1 (but less that 1.1).All values are based on outputs from the NOAA HRRR operational numerical weather prediction model. Capacity factors are normalized to unity for maximal power output. Pertinent surface weather variables are pulled such as incoming short wave radiation, direct normal irradiance (calculated in the HRRR 2016 forward), surface temperature and other parameters. These are used in a non-linear I-V curve translation to power capacity factors." }, { "name": "capacity_factor_onshore_wind", "type": "number", "description": "Estimated capacity factor (0-1) calculated for onshore wind assuming a 100m hub height and 120m rotor diameter.Based on outputs from the NOAA HRRR operational numerical weather prediction model. Capacity factors are normalized to unity for maximal power output. Vertical slices of the atmosphere are considered across the defined rotor swept area. Bringing together wind speed, density, temperature and icing information, a power capacity is estimated using a representative power coefficient (Cp) curve to determine the power from a given wind speed, atmospheric density and temperature. There is no wake modeling included in the dataset." }, { "name": "capacity_factor_offshore_wind", "type": "number", "description": "Estimated capacity factor (0-1) calculated for offshore wind assuming a 140m hub height and 120m rotor diameter.Based on outputs from the NOAA HRRR operational numerical weather prediction model. Capacity factors are normalized to unity for maximal power output. Vertical slices of the atmosphere are considered across the defined rotor swept area. Bringing together wind speed, density, temperature and icing information, a power capacity is estimated using a representative power coefficient (Cp) curve to determine the power from a given wind speed, atmospheric density and temperature. There is no wake modeling included in the dataset." } ], "primaryKey": [ "state", "place_name", "datetime_utc" ], "foreignKeys": [] }, "keywords": [ "capacity factor", "county", "electricity", "energy", "generation", "gridpath", "hourly", "resource adequacy", "solar", "time series", "united states", "usa", "vibrant clean energy", "weather", "wind" ], "contributors": [ { "title": "Vibrant Clean Energy", "path": "https://vibrantcleanenergy.com/", "email": "info@vibrantcleanenergy.com", "roles": [ "author" ], "zenodo_role": "producer", "organization": "Vibrant Clean Energy", "name": "vibrant-clean-energy" }, { "title": "Catalyst Cooperative", "path": "https://catalyst.coop/", "email": "pudl@catalyst.coop", "roles": [ "publisher" ], "zenodo_role": "distributor", "organization": "Catalyst Cooperative", "name": "catalyst-cooperative" } ], "bytes": 3565889932, "hash": "sha256:fd0dbe72ce5b1f28a7830a25abccd28f561aec74abf538c1a32d630001f8a5ac" } ], "$schema": "https://datapackage.org/profiles/2.0/datapackage.json", "created": "2026-06-01T11:49:59.034079+00:00", "id": "99aadbad-4692-4e6a-ba28-bd0174564302", "git_sha": "6b4309b5b4e656de79ff48141e9efa6202d70a51", "git_tags": [ "nightly-2026-06-01" ] }