=============================================================================== PUDL Data Dictionary =============================================================================== The following data tables have been cleaned and transformed by our ETL process. .. _out_eia860__yearly_emissions_control_equipment: ------------------------------------------------------------------------------- out_eia860__yearly_emissions_control_equipment ------------------------------------------------------------------------------- The cost, type, operating status, retirement date, and install year of emissions control equipment reported to EIA. Includes control ids for sulfur dioxide (SO2), particulate matter, mercury, nitrogen oxide (NOX), and acid (HCl) gas monitoring. The denormalized version contains plant name, utility id, pudl id, and utility name columns. **The table has the following primary key columns:** * report_year * plant_id_eia * emission_control_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - acid_gas_control - boolean - Indicates whether the emissions control equipment controls acid (HCl) gas. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - emission_control_equipment_cost - number - The total cost to install a piece of emission control equipment. * - emission_control_equipment_type_code - string - Short code indicating the type of emission control equipment installed. * - emission_control_id_pudl - number - 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. * - emission_control_operating_date - date - The date a piece of emissions control equipment began operating. Derived from month and year columns in the raw data. * - emission_control_retirement_date - date - The expected or actual retirement date for a piece of emissions control equipment. Derived from month and year columns in the raw data. * - mercury_control_id_eia - string - Mercury control identification number. This ID is not a unique identifier. * - nox_control_id_eia - string - Nitrogen oxide control identification number. This ID is not a unique identifier. * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_code - string - The operating status of the asset. * - particulate_control_id_eia - string - Particulate matter control identification number. This ID is not a unique identifier. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_year - integer - Four-digit year in which the data was reported. * - so2_control_id_eia - string - Sulfur dioxide control identification number. This ID is not a unique identifier. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia860__yearly_ownership: ------------------------------------------------------------------------------- out_eia860__yearly_ownership ------------------------------------------------------------------------------- Generator Ownership, reported in EIA-860 Schedule 4. Includes only jointly or third-party owned generators. Denormalized to include plant and utility names and other associated IDs. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id * owner_utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - fraction_owned - number - Proportion of generator ownership attributable to this utility. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - owner_city - string - City of owner. * - owner_country - string - Three letter ISO-3166 country code. * - owner_state - string - Two letter ISO-3166 political subdivision code. * - owner_street_address - string - Steet address of owner. * - owner_utility_id_eia - integer - 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. * - owner_utility_name_eia - string - The name of the EIA owner utility. * - owner_zip_code - string - Zip code of owner. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. .. _out_eia861__yearly_balancing_authority_service_territory: ------------------------------------------------------------------------------- out_eia861__yearly_balancing_authority_service_territory ------------------------------------------------------------------------------- County-level data about EIA-861 balancing authority service territories. **The table has the following primary key columns:** * balancing_authority_id_eia * report_date * county_id_fips * county `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - area_km2 - number - County area in km2. * - balancing_authority_id_eia - integer - EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity. * - county - string - County name. * - county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. * - county_name_census - string - County name as specified in Census DP1 Data. * - population - number - County population, sourced from Census DP1 data. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - state_id_fips - string - Two digit state FIPS code. .. _out_eia861__yearly_utility_service_territory: ------------------------------------------------------------------------------- out_eia861__yearly_utility_service_territory ------------------------------------------------------------------------------- County-level data about EIA-861 utility service territories. **The table has the following primary key columns:** * utility_id_eia * report_date * county_id_fips `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - area_km2 - number - County area in km2. * - county - string - County name. * - county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. * - county_name_census - string - County name as specified in Census DP1 Data. * - population - number - County population, sourced from Census DP1 data. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - state_id_fips - string - Two digit state FIPS code. * - utility_id_eia - integer - The EIA Utility Identification number. .. _out_eia923__boiler_fuel: ------------------------------------------------------------------------------- out_eia923__boiler_fuel ------------------------------------------------------------------------------- EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3. Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units. This table provides better coverage of the entire fleet of generators than the ``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex. Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * boiler_id * energy_source_code * prime_mover_code * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - boiler_id - string - Alphanumeric boiler ID. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__fuel_receipts_costs: ------------------------------------------------------------------------------- out_eia923__fuel_receipts_costs ------------------------------------------------------------------------------- Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A. 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. There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units. Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices. Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - bulk_agg_fuel_cost_per_mmbtu - number - 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. * - chlorine_content_ppm - number - 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. * - coalmine_county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. This is the county where the coal mine is located. * - contract_expiration_date - date - Date contract expires.Format: MMYY. * - contract_type_code - string - Purchase type under which receipts occurred in the reporting month. C: Contract, NC: New Contract, S: Spot Purchase, T: Tolling Agreement. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_group_code - string - Fuel groups used in the Electric Power Monthly * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_received_units - number - Quanity of fuel received in tons, barrel, or Mcf. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - mercury_content_ppm - number - Mercury content in parts per million (ppm) to the nearest 0.001 ppm. * - mine_id_msha - integer - MSHA issued mine identifier. * - mine_name - string - Coal mine name. * - mine_state - string - State where the coal mine is located. Two letter abbreviation. * - mine_type_code - string - Type of coal mine. * - moisture_content_pct - number - For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent. * - natural_gas_delivery_contract_type_code - string - Contract type for natrual gas delivery service: * - natural_gas_transport_code - string - Contract type for natural gas transportation service. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - primary_transportation_mode_code - string - Transportation mode for the longest distance transported. * - report_date - date - Date reported. * - secondary_transportation_mode_code - string - Transportation mode for the second longest distance transported. * - state - string - Two letter US state abbreviation. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - supplier_name - string - Company that sold the fuel to the plant or, in the case of Natural Gas, pipline owner. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__generation: ------------------------------------------------------------------------------- out_eia923__generation ------------------------------------------------------------------------------- EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3. Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the ``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting requirements imposed on different types and sizes of generators. Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations. Note that a small number of respondents only report annual net generation, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__generation_fuel_combined: ------------------------------------------------------------------------------- out_eia923__generation_fuel_combined ------------------------------------------------------------------------------- EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3. Denormalized, combined data from the ``core_eia923__monthly_generation_fuel`` and ``core_eia923__monthly_generation_fuel_nuclear`` with nuclear generation aggregated from the nuclear generation unit level up to the plant prime mover level, so as to be compatible with fossil fuel generation data. **The table has the following primary key columns:** * plant_id_eia * report_date * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_for_electricity_units - number - Consumption for electric generation of the fuel type in physical unit. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_agg - string - 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. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__monthly_boiler_fuel: ------------------------------------------------------------------------------- out_eia923__monthly_boiler_fuel ------------------------------------------------------------------------------- EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3. Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units. This table provides better coverage of the entire fleet of generators than the ``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex. Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * boiler_id * energy_source_code * prime_mover_code * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - boiler_id - string - Alphanumeric boiler ID. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__monthly_fuel_receipts_costs: ------------------------------------------------------------------------------- out_eia923__monthly_fuel_receipts_costs ------------------------------------------------------------------------------- Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A. 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. There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units. Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices. Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - chlorine_content_ppm - number - 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. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_received_units - number - Quanity of fuel received in tons, barrel, or Mcf. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - mercury_content_ppm - number - Mercury content in parts per million (ppm) to the nearest 0.001 ppm. * - moisture_content_pct - number - For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__monthly_generation: ------------------------------------------------------------------------------- out_eia923__monthly_generation ------------------------------------------------------------------------------- EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3. Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the ``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting requirements imposed on different types and sizes of generators. Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations. Note that a small number of respondents only report annual net generation, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__monthly_generation_fuel_by_generator: ------------------------------------------------------------------------------- out_eia923__monthly_generation_fuel_by_generator ------------------------------------------------------------------------------- Monthly estimated net generation and fuel consumption by generator. Based on allocating net electricity generation and fuel consumption reported in the EIA-923 generation and generation_fuel tables to individual generators. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_mmbtu - number - 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. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__monthly_generation_fuel_by_generator_energy_source: ------------------------------------------------------------------------------- out_eia923__monthly_generation_fuel_by_generator_energy_source ------------------------------------------------------------------------------- Monthly estimated net generation and fuel consumption associated with each combination of generator, energy source, and prime mover. First, the net electricity generation and fuel consumption reported in the EIA-923 generation fuel are allocated to individual generators. Then, these allocations are aggregated to unique generator, prime mover, and energy source code combinations. 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. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - energy_source_code_num - string - Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_mmbtu - number - 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. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. .. _out_eia923__monthly_generation_fuel_combined: ------------------------------------------------------------------------------- out_eia923__monthly_generation_fuel_combined ------------------------------------------------------------------------------- EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3. Denormalized, combined data from the ``core_eia923__monthly_generation_fuel`` and ``core_eia923__monthly_generation_fuel_nuclear`` with nuclear generation aggregated from the nuclear generation unit level up to the plant prime mover level, so as to be compatible with fossil fuel generation data. **The table has the following primary key columns:** * plant_id_eia * report_date * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_for_electricity_units - number - Consumption for electric generation of the fuel type in physical unit. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__yearly_boiler_fuel: ------------------------------------------------------------------------------- out_eia923__yearly_boiler_fuel ------------------------------------------------------------------------------- EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3. Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units. This table provides better coverage of the entire fleet of generators than the ``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex. Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * boiler_id * energy_source_code * prime_mover_code * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - boiler_id - string - Alphanumeric boiler ID. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__yearly_fuel_receipts_costs: ------------------------------------------------------------------------------- out_eia923__yearly_fuel_receipts_costs ------------------------------------------------------------------------------- Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A. 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. There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units. Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices. Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - chlorine_content_ppm - number - 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. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_received_units - number - Quanity of fuel received in tons, barrel, or Mcf. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - mercury_content_ppm - number - Mercury content in parts per million (ppm) to the nearest 0.001 ppm. * - moisture_content_pct - number - For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__yearly_generation: ------------------------------------------------------------------------------- out_eia923__yearly_generation ------------------------------------------------------------------------------- EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3. Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the ``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting requirements imposed on different types and sizes of generators. Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations. Note that a small number of respondents only report annual net generation, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__yearly_generation_fuel_by_generator: ------------------------------------------------------------------------------- out_eia923__yearly_generation_fuel_by_generator ------------------------------------------------------------------------------- Yearly estimated net generation and fuel consumption by generator. Based on allocating net electricity generation and fuel consumption reported in the EIA-923 generation and generation_fuel tables to individual generators. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_mmbtu - number - 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. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia923__yearly_generation_fuel_by_generator_energy_source: ------------------------------------------------------------------------------- out_eia923__yearly_generation_fuel_by_generator_energy_source ------------------------------------------------------------------------------- Yearly estimated net generation and fuel consumption associated with each combination of generator, energy source, and prime mover. First, the net electricity generation and fuel consumption reported in the EIA-923 generation fuel are allocated to individual generators. Then, these allocations are aggregated to unique generator, prime mover, and energy source code combinations. 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. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - energy_source_code_num - string - Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_mmbtu - number - 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. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. .. _out_eia923__yearly_generation_fuel_by_generator_energy_source_owner: ------------------------------------------------------------------------------- out_eia923__yearly_generation_fuel_by_generator_energy_source_owner ------------------------------------------------------------------------------- Yearly estimated net generation and fuel consumption for each generator, associated with each combination of generator, energy source, prime mover, and owner. First, the net electricity generation and fuel consumption reported in the EIA-923 generation fuel are allocated to individual generators. Then, these allocations are aggregated to unique generator, prime mover, energy source code, and owner combinations. Note that the utility_id_eia in this table refers to the OWNER of the generator, not the operator. 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. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id * prime_mover_code * energy_source_code * utility_id_eia * ownership_record_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - energy_source_code_num - string - Name of the energy_source_code_N column that this energy source code was reported in for the generator referenced in the same record. * - fraction_owned - number - Proportion of generator ownership attributable to this utility. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_mmbtu - number - 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. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - ownership_record_type - string - Whether each generator record is for one owner or represents a total of all ownerships. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - utility_id_eia - integer - The EIA Utility Identification number. .. _out_eia923__yearly_generation_fuel_combined: ------------------------------------------------------------------------------- out_eia923__yearly_generation_fuel_combined ------------------------------------------------------------------------------- EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3. Denormalized, combined data from the ``core_eia923__monthly_generation_fuel`` and ``core_eia923__monthly_generation_fuel_nuclear`` with nuclear generation aggregated from the nuclear generation unit level up to the plant prime mover level, so as to be compatible with fossil fuel generation data. **The table has the following primary key columns:** * plant_id_eia * report_date * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_for_electricity_units - number - Consumption for electric generation of the fuel type in physical unit. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia__monthly_generators: ------------------------------------------------------------------------------- out_eia__monthly_generators ------------------------------------------------------------------------------- Monthly all generator attributes including calculated capacity factor, heat rate, fuel cost per MMBTU and fuel cost. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - associated_combined_heat_power - boolean - Indicates whether the generator is associated with a combined heat and power system * - bga_source - string - 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). * - bypass_heat_recovery - boolean - Can this generator operate while bypassing the heat recovery steam generator? * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - carbon_capture - boolean - Indicates whether the generator uses carbon capture technology. * - city - string - Name of the city. * - cofire_fuels - boolean - Can the generator co-fire fuels?. * - county - string - County name. * - current_planned_generator_operating_date - date - The most recently updated effective date on which the generator is scheduled to start operation * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - deliver_power_transgrid - boolean - Indicate whether the generator can deliver power to the transmission grid. * - distributed_generation - boolean - Whether the generator is considered distributed generation * - duct_burners - boolean - Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas * - energy_source_1_transport_1 - string - Primary mode of transport for energy source 1. * - energy_source_1_transport_2 - string - Secondary mode of transport for energy source 1. * - energy_source_1_transport_3 - string - Tertiary mode of transport for energy source 1. * - energy_source_2_transport_1 - string - Primary mode of transport for energy source 2. * - energy_source_2_transport_2 - string - Secondary mode of transport for energy source 2. * - energy_source_2_transport_3 - string - Tertiary mode of transport for energy source 2. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - energy_source_code_2 - string - The code representing the second most predominant type of energy that fuels the generator * - energy_source_code_3 - string - The code representing the third most predominant type of energy that fuels the generator * - energy_source_code_4 - string - The code representing the fourth most predominant type of energy that fuels the generator * - energy_source_code_5 - string - The code representing the fifth most predominant type of energy that fuels the generator * - energy_source_code_6 - string - The code representing the sixth most predominant type of energy that fuels the generator * - energy_storage_capacity_mwh - number - Energy storage capacity in MWh (e.g. for batteries). * - ferc_qualifying_facility - boolean - Indicates whether or not a generator is a qualifying FERC cogeneration facility. * - fluidized_bed_tech - boolean - Indicates whether the generator uses fluidized bed technology * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_date - date - Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date. * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - latitude - number - Latitude of the plant's location, in degrees. * - longitude - number - Longitude of the plant's location, in degrees. * - minimum_load_mw - number - The minimum load at which the generator can operate at continuosuly. * - multiple_fuels - boolean - Can the generator burn multiple fuels? * - nameplate_power_factor - number - The nameplate power factor of the generator. * - net_capacity_mwdc - number - Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - operating_switch - string - Indicates whether the fuel switching generator can switch when operating * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_code - string - The operating status of the asset. * - original_planned_generator_operating_date - date - The date the generator was originally scheduled to be operational * - other_combustion_tech - boolean - Indicates whether the generator uses other combustion technologies * - other_modifications_date - date - Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete. * - other_planned_modifications - boolean - Indicates whether there are there other modifications planned for the generator. * - owned_by_non_utility - boolean - Whether any part of generator is owned by a nonutilty * - ownership_code - string - Identifies the ownership for each generator. * - planned_derate_date - date - Planned effective month that the generator is scheduled to enter operation after the derate modification. * - planned_energy_source_code_1 - string - New energy source code for the planned repowered generator. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - planned_modifications - boolean - Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years. * - planned_net_summer_capacity_derate_mw - number - Decrease in summer capacity expected to be realized from the derate modification to the equipment. * - planned_net_summer_capacity_uprate_mw - number - Increase in summer capacity expected to be realized from the modification to the equipment. * - planned_net_winter_capacity_derate_mw - number - Decrease in winter capacity expected to be realized from the derate modification to the equipment. * - planned_net_winter_capacity_uprate_mw - number - Increase in winter capacity expected to be realized from the uprate modification to the equipment. * - planned_new_capacity_mw - number - The expected new namplate capacity for the generator. * - planned_new_prime_mover_code - string - New prime mover for the planned repowered generator. * - planned_repower_date - date - Planned effective date that the generator is scheduled to enter operation after the repowering is complete. * - planned_uprate_date - date - Planned effective date that the generator is scheduled to enter operation after the uprate modification. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - previously_canceled - boolean - Indicates whether the generator was previously reported as indefinitely postponed or canceled * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - pulverized_coal_tech - boolean - Indicates whether the generator uses pulverized coal technology * - reactive_power_output_mvar - number - Reactive Power Output (MVAr) * - report_date - date - Date reported. * - rto_iso_lmp_node_id - string - The designation used to identify the price node in RTO/ISO Locational Marginal Price reports * - rto_iso_location_wholesale_reporting_id - string - The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report * - solid_fuel_gasification - boolean - Indicates whether the generator is part of a solid fuel gasification system * - startup_source_code_1 - string - 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. * - startup_source_code_2 - string - 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. * - startup_source_code_3 - string - 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. * - startup_source_code_4 - string - 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. * - state - string - Two letter US state abbreviation. * - stoker_tech - boolean - Indicates whether the generator uses stoker technology * - street_address - string - Physical street address. * - subcritical_tech - boolean - Indicates whether the generator uses subcritical technology * - summer_capacity_estimate - boolean - Whether the summer capacity value was an estimate * - summer_capacity_mw - number - The net summer capacity. * - summer_estimated_capability_mw - number - EIA estimated summer capacity (in MWh). * - supercritical_tech - boolean - Indicates whether the generator uses supercritical technology * - switch_oil_gas - boolean - Indicates whether the generator switch between oil and natural gas. * - syncronized_transmission_grid - boolean - Indicates whether standby generators (SB status) can be synchronized to the grid. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - time_cold_shutdown_full_load_code - string - The minimum amount of time required to bring the unit to full load from shutdown. * - timezone - string - IANA timezone name * - topping_bottoming_code - string - 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 * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - turbines_inverters_hydrokinetics - integer - Number of wind turbines, or hydrokinetic buoys. * - turbines_num - integer - Number of wind turbines, or hydrokinetic buoys. * - ultrasupercritical_tech - boolean - Indicates whether the generator uses ultra-supercritical technology * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. * - uprate_derate_completed_date - date - The date when the uprate or derate was completed. * - uprate_derate_during_year - boolean - Was an uprate or derate completed on this generator during the reporting year? * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. * - winter_capacity_estimate - boolean - Whether the winter capacity value was an estimate * - winter_capacity_mw - number - The net winter capacity. * - winter_estimated_capability_mw - number - EIA estimated winter capacity (in MWh). * - zip_code - string - Five digit US Zip Code. .. _out_eia__yearly_assn_plant_parts_plant_gen: ------------------------------------------------------------------------------- out_eia__yearly_assn_plant_parts_plant_gen ------------------------------------------------------------------------------- In order to easily determine what generator records are associated with every plant part record, we made this association table. This table associates every plant part record (identified as ``record_id_eia``) from the ``out_eia__yearly_plant_parts`` table to the associated 'plant_gen' records (identified as ``record_id_eia_plant_gen``) from the same table. The plant part records have a one to many relationship to the associated 'plant_gen' records. The 'plant_gen' records are also included in the plant part records, so for these records there is a one to one relationship and the ``record_id_eia`` and the ``record_id_eia_plant_gen`` are the same. All of the columns in this table that have a suffix of '_plant_gen' are attributes of the ``record_id_eia_plant_gen`` record. **The table has the following primary key columns:** * record_id_eia * record_id_eia_plant_gen `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_source_code_1_plant_gen - string - Code representing the most predominant type of energy that fuels the record_id_eia_plant_gen's generator. * - ferc1_generator_agg_id_plant_gen - integer - 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. * - ferc_acct_name_plant_gen - string - Name of FERC account, derived from technology description and prime mover code. This name is associated with the record_id_eia_plant_gen record. * - generator_id_plant_gen - string - 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! * - generator_operating_year_plant_gen - integer - The year an associated plant_gen's generator went into service. * - generators_number - integer - The number of generators associated with each ``record_id_eia``. * - operational_status_pudl_plant_gen - string - The operating status of the asset using PUDL categories of the record_id_eia_plant_gen record . * - ownership_record_type - string - Whether each generator record is for one owner or represents a total of all ownerships. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code_plant_gen - string - Code for the type of prime mover (e.g. CT, CG) associated with the record_id_eia_plant_gen. * - record_id_eia - string - Identifier for EIA plant parts analysis records. * - record_id_eia_plant_gen - string - Identifier for EIA plant parts analysis records which is at the plant_part level of plant_gen - meaning each record pertains to one generator. * - report_date - date - Date reported. * - technology_description_plant_gen - string - High level description of the technology used by the record_id_eia_plant_gen's generator to produce electricity. * - unit_id_pudl_plant_gen - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. .. _out_eia__yearly_boilers: ------------------------------------------------------------------------------- out_eia__yearly_boilers ------------------------------------------------------------------------------- Denormalized table containing all EIA boiler attributes. **The table has the following primary key columns:** * plant_id_eia * boiler_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - air_flow_100pct_load_cubic_feet_per_minute - number - Total air flow including excess air at 100 percent load, reported at standard temperature and pressure (i.e. 68 F and one atmosphere pressure). * - boiler_fuel_code_1 - string - The code representing the most predominant type of energy that fuels the boiler. * - boiler_fuel_code_2 - string - The code representing the second most predominant type of energy that fuels the boiler. * - boiler_fuel_code_3 - string - The code representing the third most predominant type of energy that fuels the boiler. * - boiler_fuel_code_4 - string - The code representing the fourth most predominant type of energy that fuels the boiler. * - boiler_id - string - Alphanumeric boiler ID. * - boiler_manufacturer - string - Name of boiler manufacturer. * - boiler_manufacturer_code - string - EIA short code for boiler manufacturer. * - boiler_operating_date - date - Date the boiler began or is planned to begin commercial operation. * - boiler_retirement_date - date - Date of the scheduled or effected retirement of the boiler. * - boiler_status - string - EIA short code identifying boiler operational status. * - boiler_type - string - EIA short code indicating the standards under which the boiler is operating as described in the U.S. EPA regulation under 40 CFR. * - city - string - Name of the city. * - compliance_year_mercury - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for mercury emissions. * - compliance_year_nox - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for nitrogen oxide emissions. * - compliance_year_particulate - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for particulate matter emissions. * - compliance_year_so2 - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for sulfur dioxide emissions. * - county - string - County name. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - efficiency_100pct_load - number - Boiler efficiency percentage when burning at 100 percent load to the nearest 0.1 percent. * - efficiency_50pct_load - number - Boiler efficiency percentage when burning at 50 percent load to the nearest 0.1 percent. * - firing_rate_using_coal_tons_per_hour - number - Design firing rate at maximum continuous steam flow for coal to the nearest 0.1 ton per hour. * - firing_rate_using_gas_mcf_per_hour - number - Design firing rate at maximum continuous steam flow for gas to the nearest 0.1 cubic feet per hour. * - firing_rate_using_oil_bbls_per_hour - number - Design firing rate at maximum continuous steam flow for pet coke to the nearest 0.1 barrels per hour. * - firing_rate_using_other_fuels - number - Design firing rate at maximum continuous steam flow for energy sources other than coal, petroleum, or natural gas. * - firing_type_1 - string - EIA short code indicating the type of firing used by this boiler. * - firing_type_2 - string - EIA short code indicating the type of firing used by this boiler. * - firing_type_3 - string - EIA short code indicating the type of firing used by this boiler. * - fly_ash_reinjection - boolean - Indicates whether the boiler is capable of re-injecting fly ash. * - hrsg - boolean - indicates if the boiler is a heat recovery steam generator (HRSG). * - latitude - number - Latitude of the plant's location, in degrees. * - longitude - number - Longitude of the plant's location, in degrees. * - max_steam_flow_1000_lbs_per_hour - number - Maximum continuous steam flow at 100 percent load. * - mercury_control_existing_strategy_1 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_2 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_3 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_4 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_5 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_6 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_proposed_strategy_1 - string - Proposed strategy to comply with the most stringent mercury regulation. * - mercury_control_proposed_strategy_2 - string - Proposed strategy to comply with the most stringent mercury regulation. * - mercury_control_proposed_strategy_3 - string - Proposed strategy to comply with the most stringent mercury regulation. * - new_source_review - boolean - Indicates whether the boiler is subject to New Source Review requirements. * - new_source_review_date - date - Month of issued New Source Review permit. * - new_source_review_permit - string - New Source Review permit number. * - nox_control_existing_caaa_compliance_strategy_1 - string - Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_existing_caaa_compliance_strategy_2 - string - Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_existing_caaa_compliance_strategy_3 - string - Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_existing_strategy_1 - string - Existing strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_existing_strategy_2 - string - Existing strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_existing_strategy_3 - string - Existing strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_manufacturer - string - Name of nitrogen oxide control manufacturer. * - nox_control_manufacturer_code - string - Code indicating the nitrogen oxide control burner manufacturer. * - nox_control_out_of_compliance_strategy_1 - string - If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance. * - nox_control_out_of_compliance_strategy_2 - string - If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance. * - nox_control_out_of_compliance_strategy_3 - string - If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance. * - nox_control_planned_caaa_compliance_strategy_1 - string - Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_planned_caaa_compliance_strategy_2 - string - Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_planned_caaa_compliance_strategy_3 - string - Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_proposed_strategy_1 - string - Proposed strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_proposed_strategy_2 - string - Proposed strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_proposed_strategy_3 - string - Proposed strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_status_code - string - Nitrogen oxide control status code. * - particulate_control_out_of_compliance_strategy_1 - string - If boiler is not in compliance with particulate matter regulations, strategy for compliance. * - particulate_control_out_of_compliance_strategy_2 - string - If boiler is not in compliance with particulate matter regulations, strategy for compliance. * - particulate_control_out_of_compliance_strategy_3 - string - If boiler is not in compliance with particulate matter regulations, strategy for compliance. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - regulation_mercury - string - Most stringent type of statute or regulation code under which the boiler is operating for mercury control standards. * - regulation_nox - string - EIA short code for most stringent type of statute or regulation code under which the boiler is operating for nitrogen oxide control standards. * - regulation_particulate - string - EIA short code for most stringent type of statute or regulation code under which the boiler is operating for particulate matter control standards. * - regulation_so2 - string - EIA short code for most stringent type of statute or regulation code under which the boiler is operating for sulfur dioxide control standards. * - report_date - date - Date reported. * - so2_control_existing_caaa_compliance_strategy_1 - string - Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_existing_caaa_compliance_strategy_2 - string - Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_existing_caaa_compliance_strategy_3 - string - Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_existing_strategy_1 - string - Existing strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_existing_strategy_2 - string - Existing strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_existing_strategy_3 - string - Existing strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_out_of_compliance_strategy_1 - string - If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance. * - so2_control_out_of_compliance_strategy_2 - string - If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance. * - so2_control_out_of_compliance_strategy_3 - string - If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance. * - so2_control_planned_caaa_compliance_strategy_1 - string - Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_planned_caaa_compliance_strategy_2 - string - Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_planned_caaa_compliance_strategy_3 - string - Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_proposed_strategy_1 - string - Proposed strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_proposed_strategy_2 - string - Proposed strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_proposed_strategy_3 - string - Proposed strategy to comply with the most stringent sulfur dioxide regulation. * - standard_nox_rate - number - Numeric value for the unit of measurement specified for nitrogen oxide. * - standard_particulate_rate - number - Numeric value for the unit of measurement specified for particulate matter. * - standard_so2_percent_scrubbed - number - The percent of sulfur dioxide to be scrubbed specified by the most stringent sulfur dioxide regulation. * - standard_so2_rate - number - Numeric value for the unit of measurement specified for sulfur dioxide. * - state - string - Two letter US state abbreviation. * - street_address - string - Physical street address. * - timezone - string - IANA timezone name * - turndown_ratio - number - The turndown ratio for the boiler. * - unit_id_pudl - integer - 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. * - unit_nox - string - Numeric value for the unit of measurement specified for nitrogen oxide. * - unit_particulate - string - Numeric value for the unit of measurement specified for particulate matter. * - unit_so2 - string - Numeric value for the unit of measurement specified for sulfur dioxide. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. * - waste_heat_input_mmbtu_per_hour - number - 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). * - wet_dry_bottom - string - 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. * - zip_code - string - Five digit US Zip Code. .. _out_eia__yearly_generators: ------------------------------------------------------------------------------- out_eia__yearly_generators ------------------------------------------------------------------------------- Yearly all generator attributes including calculated capacity factor, heat rate, fuel cost per MMBTU and fuel cost. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - associated_combined_heat_power - boolean - Indicates whether the generator is associated with a combined heat and power system * - bga_source - string - 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). * - bypass_heat_recovery - boolean - Can this generator operate while bypassing the heat recovery steam generator? * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - carbon_capture - boolean - Indicates whether the generator uses carbon capture technology. * - city - string - Name of the city. * - cofire_fuels - boolean - Can the generator co-fire fuels?. * - county - string - County name. * - current_planned_generator_operating_date - date - The most recently updated effective date on which the generator is scheduled to start operation * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - deliver_power_transgrid - boolean - Indicate whether the generator can deliver power to the transmission grid. * - distributed_generation - boolean - Whether the generator is considered distributed generation * - duct_burners - boolean - Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas * - energy_source_1_transport_1 - string - Primary mode of transport for energy source 1. * - energy_source_1_transport_2 - string - Secondary mode of transport for energy source 1. * - energy_source_1_transport_3 - string - Tertiary mode of transport for energy source 1. * - energy_source_2_transport_1 - string - Primary mode of transport for energy source 2. * - energy_source_2_transport_2 - string - Secondary mode of transport for energy source 2. * - energy_source_2_transport_3 - string - Tertiary mode of transport for energy source 2. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - energy_source_code_2 - string - The code representing the second most predominant type of energy that fuels the generator * - energy_source_code_3 - string - The code representing the third most predominant type of energy that fuels the generator * - energy_source_code_4 - string - The code representing the fourth most predominant type of energy that fuels the generator * - energy_source_code_5 - string - The code representing the fifth most predominant type of energy that fuels the generator * - energy_source_code_6 - string - The code representing the sixth most predominant type of energy that fuels the generator * - energy_storage_capacity_mwh - number - Energy storage capacity in MWh (e.g. for batteries). * - ferc_qualifying_facility - boolean - Indicates whether or not a generator is a qualifying FERC cogeneration facility. * - fluidized_bed_tech - boolean - Indicates whether the generator uses fluidized bed technology * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_date - date - Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date. * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - latitude - number - Latitude of the plant's location, in degrees. * - longitude - number - Longitude of the plant's location, in degrees. * - minimum_load_mw - number - The minimum load at which the generator can operate at continuosuly. * - multiple_fuels - boolean - Can the generator burn multiple fuels? * - nameplate_power_factor - number - The nameplate power factor of the generator. * - net_capacity_mwdc - number - Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - operating_switch - string - Indicates whether the fuel switching generator can switch when operating * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_code - string - The operating status of the asset. * - original_planned_generator_operating_date - date - The date the generator was originally scheduled to be operational * - other_combustion_tech - boolean - Indicates whether the generator uses other combustion technologies * - other_modifications_date - date - Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete. * - other_planned_modifications - boolean - Indicates whether there are there other modifications planned for the generator. * - owned_by_non_utility - boolean - Whether any part of generator is owned by a nonutilty * - ownership_code - string - Identifies the ownership for each generator. * - planned_derate_date - date - Planned effective month that the generator is scheduled to enter operation after the derate modification. * - planned_energy_source_code_1 - string - New energy source code for the planned repowered generator. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - planned_modifications - boolean - Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years. * - planned_net_summer_capacity_derate_mw - number - Decrease in summer capacity expected to be realized from the derate modification to the equipment. * - planned_net_summer_capacity_uprate_mw - number - Increase in summer capacity expected to be realized from the modification to the equipment. * - planned_net_winter_capacity_derate_mw - number - Decrease in winter capacity expected to be realized from the derate modification to the equipment. * - planned_net_winter_capacity_uprate_mw - number - Increase in winter capacity expected to be realized from the uprate modification to the equipment. * - planned_new_capacity_mw - number - The expected new namplate capacity for the generator. * - planned_new_prime_mover_code - string - New prime mover for the planned repowered generator. * - planned_repower_date - date - Planned effective date that the generator is scheduled to enter operation after the repowering is complete. * - planned_uprate_date - date - Planned effective date that the generator is scheduled to enter operation after the uprate modification. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - previously_canceled - boolean - Indicates whether the generator was previously reported as indefinitely postponed or canceled * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - pulverized_coal_tech - boolean - Indicates whether the generator uses pulverized coal technology * - reactive_power_output_mvar - number - Reactive Power Output (MVAr) * - report_date - date - Date reported. * - rto_iso_lmp_node_id - string - The designation used to identify the price node in RTO/ISO Locational Marginal Price reports * - rto_iso_location_wholesale_reporting_id - string - The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report * - solid_fuel_gasification - boolean - Indicates whether the generator is part of a solid fuel gasification system * - startup_source_code_1 - string - 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. * - startup_source_code_2 - string - 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. * - startup_source_code_3 - string - 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. * - startup_source_code_4 - string - 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. * - state - string - Two letter US state abbreviation. * - stoker_tech - boolean - Indicates whether the generator uses stoker technology * - street_address - string - Physical street address. * - subcritical_tech - boolean - Indicates whether the generator uses subcritical technology * - summer_capacity_estimate - boolean - Whether the summer capacity value was an estimate * - summer_capacity_mw - number - The net summer capacity. * - summer_estimated_capability_mw - number - EIA estimated summer capacity (in MWh). * - supercritical_tech - boolean - Indicates whether the generator uses supercritical technology * - switch_oil_gas - boolean - Indicates whether the generator switch between oil and natural gas. * - syncronized_transmission_grid - boolean - Indicates whether standby generators (SB status) can be synchronized to the grid. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - time_cold_shutdown_full_load_code - string - The minimum amount of time required to bring the unit to full load from shutdown. * - timezone - string - IANA timezone name * - topping_bottoming_code - string - 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 * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - turbines_inverters_hydrokinetics - integer - Number of wind turbines, or hydrokinetic buoys. * - turbines_num - integer - Number of wind turbines, or hydrokinetic buoys. * - ultrasupercritical_tech - boolean - Indicates whether the generator uses ultra-supercritical technology * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. * - uprate_derate_completed_date - date - The date when the uprate or derate was completed. * - uprate_derate_during_year - boolean - Was an uprate or derate completed on this generator during the reporting year? * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. * - winter_capacity_estimate - boolean - Whether the winter capacity value was an estimate * - winter_capacity_mw - number - The net winter capacity. * - winter_estimated_capability_mw - number - EIA estimated winter capacity (in MWh). * - zip_code - string - Five digit US Zip Code. .. _out_eia__yearly_generators_by_ownership: ------------------------------------------------------------------------------- out_eia__yearly_generators_by_ownership ------------------------------------------------------------------------------- A mega table of all EIA generators with ownership integrated. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_eoy_mw - number - Total end of year installed (nameplate) capacity for a plant part, in megawatts. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - ferc_acct_name - string - Name of FERC account, derived from technology description and prime mover code. * - fraction_owned - number - Proportion of generator ownership attributable to this utility. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_date - date - Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date. * - generator_operating_year - integer - Year a generator went into service. * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_pudl - string - The operating status of the asset using PUDL categories. * - ownership_record_type - string - Whether each generator record is for one owner or represents a total of all ownerships. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia__yearly_plant_parts: ------------------------------------------------------------------------------- out_eia__yearly_plant_parts ------------------------------------------------------------------------------- Output table with the aggregation of all EIA plant parts. For use with matching to FERC 1. Practically speaking, a plant is a collection of generator(s). There are many attributes of generators (i.e. prime mover, primary fuel source, technology type). We can use these generator attributes to group generator records into larger aggregate records which we call "plant parts". A plant part is a record which corresponds to a particular collection of generators that all share an identical attribute and utility owner. E.g. all of the generators with unit_id=2, or all of the generators with coal as their primary fuel source. The EIA data about power plants (from EIA 923 and 860) is reported in tables with records that correspond to mostly generators and plants. Other datasets (cough cough FERC1) are less well organized and include plants, generators and other plant parts all in the same table without any clear labels. This plant part table is an attempt to create records corresponding to many different plant parts in order to connect specific slices of EIA plants to other datasets. Because generators are often owned by multiple utilities, another dimension of this plant part table involves generating two records for each owner: one for the portion of the plant part they own and one for the plant part as a whole. The portion records are labeled in the ``ownership_record_type`` column as ``owned`` and the total records are labeled as ``total``. This table includes A LOT of duplicative information about EIA plants. It is primarily meant for use as an input into the record linkage between FERC1 plants and EIA. **The table has the following primary key columns:** * record_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - appro_part_label - string - Plant part of the associated true granularity record. * - appro_record_id_eia - string - EIA record ID of the associated true granularity record. * - capacity_eoy_mw - number - Total end of year installed (nameplate) capacity for a plant part, in megawatts. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - ferc1_generator_agg_id - integer - ID dynamically assigned by PUDL to EIA records with multiple matches to a single FERC ID in the FERC-EIA manual matching process. * - ferc_acct_name - string - Name of FERC account, derived from technology description and prime mover code. * - fraction_owned - number - Proportion of generator ownership attributable to this utility. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_year - integer - Year a generator went into service. * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_pudl - string - The operating status of the asset using PUDL categories. * - ownership_dupe - boolean - Whether a plant part record has a duplicate record with different ownership status. * - ownership_record_type - string - Whether each generator record is for one owner or represents a total of all ownerships. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_id_report_year - string - PUDL plant ID and report year of the record. * - plant_name_eia - string - Plant name. * - plant_name_ppe - string - Derived plant name that includes EIA plant name and other strings associated with ID and PK columns of the plant part. * - plant_part - string - The part of the plant a record corresponds to. * - plant_part_id_eia - string - Contains EIA plant ID, plant part, ownership, and EIA utility id * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - record_count - integer - Number of distinct generator IDs that partcipated in the aggregation for a plant part list record. * - record_id_eia - string - Identifier for EIA plant parts analysis records. * - report_date - date - Date reported. * - report_year - integer - Four-digit year in which the data was reported. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - true_gran - boolean - Indicates whether a plant part list record is associated with the highest priority plant part for all identical records. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _out_eia__yearly_plants: ------------------------------------------------------------------------------- out_eia__yearly_plants ------------------------------------------------------------------------------- Denormalized table containing all EIA plant attributes. **The table has the following primary key columns:** * plant_id_eia * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_impoundment - boolean - Is there an ash impoundment (e.g. pond, reservoir) at the plant? * - ash_impoundment_lined - boolean - If there is an ash impoundment at the plant, is the impoundment lined? * - ash_impoundment_status - string - If there is an ash impoundment at the plant, the ash impoundment status as of December 31 of the reporting year. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_code_eia_consistent_rate - number - Percentage consistency of balancing authority code across entity records. * - balancing_authority_name_eia - string - Name of the balancing authority. * - city - string - Name of the city. * - county - string - County name. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - datum - string - Geodetic coordinate system identifier (e.g. NAD27, NAD83, or WGS84). * - energy_storage - boolean - Indicates if the facility has energy storage capabilities. * - ferc_cogen_docket_no - string - The docket number relating to the FERC cogenerator status. See FERC Form 556. * - ferc_cogen_status - boolean - Indicates whether the plant has FERC qualifying facility cogenerator status. See FERC Form 556. * - ferc_exempt_wholesale_generator - boolean - Indicates whether the plant has FERC qualifying facility exempt wholesale generator status * - ferc_exempt_wholesale_generator_docket_no - string - The docket number relating to the FERC qualifying facility exempt wholesale generator status. * - ferc_qualifying_facility_docket_no - string - The docket number relating to the FERC qualifying facility cogenerator status. See FERC Form 556. * - ferc_small_power_producer - boolean - Indicates whether the plant has FERC qualifying facility small power producer status. See FERC Form 556. * - ferc_small_power_producer_docket_no - string - The docket number relating to the FERC qualifying facility small power producer status. See FERC Form 556. * - grid_voltage_1_kv - number - Plant's grid voltage at point of interconnection to transmission or distibution facilities * - grid_voltage_2_kv - number - Plant's grid voltage at point of interconnection to transmission or distibution facilities * - grid_voltage_3_kv - number - Plant's grid voltage at point of interconnection to transmission or distibution facilities * - has_net_metering - boolean - 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 * - iso_rto_code - string - The code of the plant's ISO or RTO. NA if not reported in that year. * - latitude - number - Latitude of the plant's location, in degrees. * - liquefied_natural_gas_storage - boolean - Indicates if the facility have the capability to store the natural gas in the form of liquefied natural gas. * - longitude - number - Longitude of the plant's location, in degrees. * - natural_gas_local_distribution_company - string - Names of Local Distribution Company (LDC), connected to natural gas burning power plants. * - natural_gas_pipeline_name_1 - string - 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. * - natural_gas_pipeline_name_2 - string - 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. * - natural_gas_pipeline_name_3 - string - 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. * - natural_gas_storage - boolean - Indicates if the facility have on-site storage of natural gas. * - nerc_region - string - NERC region in which the plant is located * - pipeline_notes - string - Additional owner or operator of natural gas pipeline. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - primary_purpose_id_naics - integer - North American Industry Classification System (NAICS) code that best describes the primary purpose of the reporting plant * - regulatory_status_code - string - Indicates whether the plant is regulated or non-regulated. * - report_date - date - Date reported. * - reporting_frequency_code - string - 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. * - sector_id_eia - integer - 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 * - sector_name_eia - string - 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 * - service_area - string - Service area in which plant is located; for unregulated companies, it's the electric utility with which plant is interconnected * - state - string - Two letter US state abbreviation. * - street_address - string - Physical street address. * - timezone - string - IANA timezone name * - transmission_distribution_owner_id - integer - EIA-assigned code for owner of transmission/distribution system to which the plant is interconnected. * - transmission_distribution_owner_name - string - Name of the owner of the transmission or distribution system to which the plant is interconnected. * - transmission_distribution_owner_state - string - State location for owner of transmission/distribution system to which the plant is interconnected. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. * - water_source - string - Name of water source associated with the plant. * - zip_code - string - Five digit US Zip Code. .. _out_eia__yearly_utilities: ------------------------------------------------------------------------------- out_eia__yearly_utilities ------------------------------------------------------------------------------- Denormalized table containing all EIA utility attributes. **The table has the following primary key columns:** * utility_id_eia * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - address_2 - string - Second line of the address. * - attention_line - string - Mail attention name of the operator/owner. * - city - string - Name of the city. * - contact_firstname - string - First name of utility contact 1. * - contact_firstname_2 - string - First name of utility contact 2. * - contact_lastname - string - Last name of utility contact 1. * - contact_lastname_2 - string - Last name of utility contact 2. * - contact_title - string - Title of of utility contact 1. * - contact_title_2 - string - Title of utility contact 2. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - entity_type - string - Entity type of principal owner. * - phone_extension - string - Phone extension for utility contact 1 * - phone_extension_2 - string - Phone extension for utility contact 2 * - phone_number - string - Phone number for utility contact 1. * - phone_number_2 - string - Phone number for utility contact 2. * - plants_reported_asset_manager - boolean - Is the reporting entity an asset manager of power plants reported on Schedule 2 of the form? * - plants_reported_operator - boolean - Is the reporting entity an operator of power plants reported on Schedule 2 of the form? * - plants_reported_other_relationship - boolean - Does the reporting entity have any other relationship to the power plants reported on Schedule 2 of the form? * - plants_reported_owner - boolean - Is the reporting entity an owner of power plants reported on Schedule 2 of the form? * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - street_address - string - Physical street address. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. * - zip_code - string - Five digit US Zip Code. * - zip_code_4 - string - Four digit US Zip Code suffix. .. _out_ferc1__yearly_all_plants: ------------------------------------------------------------------------------- out_ferc1__yearly_all_plants ------------------------------------------------------------------------------- Denormalized table combining the steam, small generators, hydro, and pumped storage tables from FERC Form 1. **The table has the following primary key columns:** * record_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_annual_addition - number - Annual capital addition into `capex_total`. * - capex_annual_addition_rolling - number - Year-to-date capital addition into `capex_total`. * - capex_annual_per_kw - number - Annual capital addition into `capex_total` per kw. * - capex_annual_per_mw - number - Annual capital addition into `capex_total` per MW. * - capex_annual_per_mw_rolling - number - Year-to-date capital addition into `capex_total` per MW. * - capex_annual_per_mwh - number - Annual capital addition into `capex_total` per MWh. * - capex_annual_per_mwh_rolling - number - Year-to-date capital addition into `capex_total` per MWh. * - capex_equipment - number - Cost of plant: equipment (USD). * - capex_equipment_electric - number - Cost of plant: accessory electric equipment (USD). * - capex_equipment_misc - number - Cost of plant: miscellaneous power plant equipment (USD). * - capex_facilities - number - Cost of plant: reservoirs, dams, and waterways (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_roads - number - Cost of plant: roads, railroads, and bridges (USD). * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - capex_wheels_turbines_generators - number - Cost of plant: water wheels, turbines, and generators (USD). * - capex_wo_retirement_total - number - Total cost of plant (USD) without retirements. * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - energy_used_for_pumping_mwh - number - Energy used for pumping, in megawatt-hours. * - ferc_license_id - string - The FERC license ID of a project. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type - string - Type of fuel. * - installation_year - integer - Year the plant's most recently built unit was installed. * - license_id_ferc1 - integer - FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible. * - net_capacity_adverse_conditions_mw - number - Net plant capability under the least favorable operating conditions, in megawatts. * - net_capacity_favorable_conditions_mw - number - Net plant capability under the most favorable operating conditions, in megawatts. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - net_load_mwh - number - Net output for load (net generation - energy used for pumping) in megawatt-hours. * - not_water_limited_capacity_mw - number - Plant capacity in MW when not limited by condenser water. * - opex_allowances - number - Allowances. * - opex_boiler - number - Maintenance of boiler (or reactor) plant. * - opex_coolants - number - Cost of coolants and water (nuclear plants only) * - opex_dams - number - Production expenses: maintenance of reservoirs, dams, and waterways (USD). * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_fuel - number - Production expenses: fuel (USD). * - opex_generation_misc - number - Production expenses: miscellaneous power generation expenses (USD). * - opex_hydraulic - number - Production expenses: hydraulic expenses (USD). * - opex_maintenance - number - Production expenses: Maintenance (USD). * - opex_misc_plant - number - Production expenses: maintenance of miscellaneous hydraulic plant (USD). * - opex_misc_power - number - Miscellaneous steam (or nuclear) expenses. * - opex_misc_steam - number - Maintenance of miscellaneous steam (or nuclear) plant. * - opex_nonfuel_per_mwh - number - Investments in non-fuel production expenses per Mwh. * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plant - number - Production expenses: maintenance of electric plant (USD). * - opex_production_before_pumping - number - Total production expenses before pumping (USD). * - opex_production_total - number - Total operating expenses. * - opex_pumped_storage - number - Production expenses: pumped storage (USD). * - opex_pumping - number - Production expenses: We are here to PUMP YOU UP! (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_steam - number - Steam expenses. * - opex_steam_other - number - Steam from other sources. * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_total_nonfuel - number - Total production expenses, excluding fuel (USD). * - opex_transfer - number - Steam transferred (Credit). * - opex_water_for_power - number - Production expenses: water for power (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_capability_mw - number - Net plant capability in megawatts. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_id_ferc1 - integer - Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - water_limited_capacity_mw - number - Plant capacity in MW when limited by condenser water. .. _out_ferc1__yearly_balance_sheet_assets_sched110: ------------------------------------------------------------------------------- out_ferc1__yearly_balance_sheet_assets_sched110 ------------------------------------------------------------------------------- Denormalized table that contains FERC balance sheet asset information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * asset_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_type - string - Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table. * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_balance_sheet_liabilities_sched110: ------------------------------------------------------------------------------- out_ferc1__yearly_balance_sheet_liabilities_sched110 ------------------------------------------------------------------------------- Denormalized table that contains FERC balance sheet liability information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * liability_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - liability_type - string - Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_cash_flows_sched120: ------------------------------------------------------------------------------- out_ferc1__yearly_cash_flows_sched120 ------------------------------------------------------------------------------- Denormalized table that contains FERC cash flow information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * amount_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - amount - number - Reported amount of dollars. This could be a balance or a change in value. * - amount_type - string - Label describing the type of amount being reported. This could be a balance or a change in value. * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_depreciation_by_function_sched219: ------------------------------------------------------------------------------- out_ferc1__yearly_depreciation_by_function_sched219 ------------------------------------------------------------------------------- Denormalized accumulated provision for depreciation of electric utility plant (Account 108). Schedule 219 Section B: Functional plant classifications. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * depreciation_type * plant_function * plant_status * utility_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - depreciation_type - string - Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc. * - ending_balance - number - Account balance at end of year. * - plant_function - string - Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.). * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_depreciation_changes_sched219: ------------------------------------------------------------------------------- out_ferc1__yearly_depreciation_changes_sched219 ------------------------------------------------------------------------------- Denormalized table that contains FERC electric plant depreciation changes information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * depreciation_type * plant_status * utility_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - depreciation_type - string - Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - 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. * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_depreciation_summary_sched336: ------------------------------------------------------------------------------- out_ferc1__yearly_depreciation_summary_sched336 ------------------------------------------------------------------------------- Denormalized table that contains FERC depreciation amortization information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * plant_function * ferc_account_label `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting. * - ferc_account_label - string - Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts. * - plant_function - string - Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_energy_dispositions_sched401: ------------------------------------------------------------------------------- out_ferc1__yearly_energy_dispositions_sched401 ------------------------------------------------------------------------------- Denormalized table that contains FERC electric energy dispositions information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * energy_disposition_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_disposition_type - string - 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. * - energy_mwh - number - Sources and uses of energy in MWh. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_energy_sources_sched401: ------------------------------------------------------------------------------- out_ferc1__yearly_energy_sources_sched401 ------------------------------------------------------------------------------- Denormalized table that contains FERC electric energy sources information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * energy_source_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_mwh - number - Sources and uses of energy in MWh. * - energy_source_type - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_hydroelectric_plants_sched406: ------------------------------------------------------------------------------- out_ferc1__yearly_hydroelectric_plants_sched406 ------------------------------------------------------------------------------- Denormalized table that contains small plant information from FERC Form 1. **The table has the following primary key columns:** * record_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_equipment - number - Cost of plant: equipment (USD). * - capex_facilities - number - Cost of plant: reservoirs, dams, and waterways (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_roads - number - Cost of plant: roads, railroads, and bridges (USD). * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_capacity_adverse_conditions_mw - number - Net plant capability under the least favorable operating conditions, in megawatts. * - net_capacity_favorable_conditions_mw - number - Net plant capability under the most favorable operating conditions, in megawatts. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - opex_dams - number - Production expenses: maintenance of reservoirs, dams, and waterways (USD). * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_generation_misc - number - Production expenses: miscellaneous power generation expenses (USD). * - opex_hydraulic - number - Production expenses: hydraulic expenses (USD). * - opex_misc_plant - number - Production expenses: maintenance of miscellaneous hydraulic plant (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plant - number - Production expenses: maintenance of electric plant (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_total_nonfuel - number - Total production expenses, excluding fuel (USD). * - opex_water_for_power - number - Production expenses: water for power (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - project_num - integer - FERC Licensed Project Number. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_income_statements_sched114: ------------------------------------------------------------------------------- out_ferc1__yearly_income_statements_sched114 ------------------------------------------------------------------------------- Denormalized table that contains FERC income statement information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * utility_type * income_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - 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. * - income_type - string - Type of income reported in core_ferc1__yearly_income_statements_sched114 table. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_operating_expenses_sched320: ------------------------------------------------------------------------------- out_ferc1__yearly_operating_expenses_sched320 ------------------------------------------------------------------------------- Denormalized table that contains FERC electric operating expense information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * expense_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - expense_type - string - The type of expense. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_operating_revenues_sched300: ------------------------------------------------------------------------------- out_ferc1__yearly_operating_revenues_sched300 ------------------------------------------------------------------------------- Denormalized table that contains FERC electric operating revenue information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * revenue_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - avg_customers_per_month - number - Average number of customers per month. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - revenue_type - string - Label describing types of revenues. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - sales_mwh - number - Quantity of electricity sold in MWh. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_other_regulatory_liabilities_sched278: ------------------------------------------------------------------------------- out_ferc1__yearly_other_regulatory_liabilities_sched278 ------------------------------------------------------------------------------- Denormalized table that contains FERC other regulatory liabilities information. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - account_detail - string - Description of the account number credited from making debit adjustment to other regulatory liabilities. * - decrease_in_other_regulatory_liabilities - number - The decrease during the reporting period of other regulatory liabilities. * - description - string - Long human-readable description of the meaning of a code/label. * - ending_balance - number - Account balance at end of year. * - increase_in_other_regulatory_liabilities - number - The increase during the reporting period of other regulatory liabilities. * - report_year - integer - Four-digit year in which the data was reported. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_plant_in_service_sched204: ------------------------------------------------------------------------------- out_ferc1__yearly_plant_in_service_sched204 ------------------------------------------------------------------------------- Denormalized table of FERC Form 1 Electric Plant in Service data. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * ferc_account_label `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - additions - number - Cost of acquisition of items classified within the account. * - adjustments - number - Cost of adjustments to the account. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting. * - ferc_account_label - string - Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts. * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - retirements - number - Cost of disposal of items classified within the account. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - transfers - number - Cost of transfers into (out of) the account. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_pumped_storage_plants_sched408: ------------------------------------------------------------------------------- out_ferc1__yearly_pumped_storage_plants_sched408 ------------------------------------------------------------------------------- Denormalized table that contains pumped storage plant information from FERC Form 1. **The table has the following primary key columns:** * record_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_equipment_electric - number - Cost of plant: accessory electric equipment (USD). * - capex_equipment_misc - number - Cost of plant: miscellaneous power plant equipment (USD). * - capex_facilities - number - Cost of plant: reservoirs, dams, and waterways (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_roads - number - Cost of plant: roads, railroads, and bridges (USD). * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - capex_wheels_turbines_generators - number - Cost of plant: water wheels, turbines, and generators (USD). * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - energy_used_for_pumping_mwh - number - Energy used for pumping, in megawatt-hours. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - net_load_mwh - number - Net output for load (net generation - energy used for pumping) in megawatt-hours. * - opex_dams - number - Production expenses: maintenance of reservoirs, dams, and waterways (USD). * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_generation_misc - number - Production expenses: miscellaneous power generation expenses (USD). * - opex_misc_plant - number - Production expenses: maintenance of miscellaneous hydraulic plant (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plant - number - Production expenses: maintenance of electric plant (USD). * - opex_production_before_pumping - number - Total production expenses before pumping (USD). * - opex_pumped_storage - number - Production expenses: pumped storage (USD). * - opex_pumping - number - Production expenses: We are here to PUMP YOU UP! (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_total_nonfuel - number - Total production expenses, excluding fuel (USD). * - opex_water_for_power - number - Production expenses: water for power (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_capability_mw - number - Net plant capability in megawatts. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - project_num - integer - FERC Licensed Project Number. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_purchased_power_and_exchanges_sched326: ------------------------------------------------------------------------------- out_ferc1__yearly_purchased_power_and_exchanges_sched326 ------------------------------------------------------------------------------- Denormalized table of FERC Form 1 Purchased Power data. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - billing_demand_mw - number - Monthly average billing demand (for requirements purchases, and any transactions involving demand charges). In megawatts. * - coincident_peak_demand_mw - number - Average monthly coincident peak (CP) demand (for requirements purchases, and any transactions involving demand charges). Monthly CP demand is the metered demand during the hour (60-minute integration) in which the supplier's system reaches its monthly peak. In megawatts. * - delivered_mwh - number - Gross megawatt-hours delivered in power exchanges and used as the basis for settlement. * - demand_charges - number - Demand charges (USD). * - energy_charges - number - Energy charges (USD). * - non_coincident_peak_demand_mw - number - Average monthly non-coincident peak (NCP) demand (for requirements purhcases, and any transactions involving demand charges). Monthly NCP demand is the maximum metered hourly (60-minute integration) demand in a month. In megawatts. * - other_charges - number - Other charges, including out-of-period adjustments (USD). * - purchase_type_code - string - Categorization based on the original contractual terms and conditions of the service. Must be one of 'requirements', 'long_firm', 'intermediate_firm', 'short_firm', 'long_unit', 'intermediate_unit', 'electricity_exchange', 'other_service', or 'adjustment'. Requirements service is ongoing high reliability service, with load integrated into system resource planning. 'Long term' means 5+ years. 'Intermediate term' is 1-5 years. 'Short term' is less than 1 year. 'Firm' means not interruptible for economic reasons. 'unit' indicates service from a particular designated generating unit. 'exchange' is an in-kind transaction. * - purchased_mwh - number - Megawatt-hours shown on bills rendered to the respondent. Includes both electricity purchased for storage and non-storage purposes, which were lumped together prior to 2021. * - purchased_other_than_storage_mwh - number - Number of megawatt hours purchased during the period for other than energy storage. * - purchased_storage_mwh - number - Number of megawatt hours purchased during the period for energy storage. * - received_mwh - number - Gross megawatt-hours received in power exchanges and used as the basis for settlement. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - seller_name - string - Name of the seller, or the other party in an exchange transaction. * - tariff - string - FERC Rate Schedule Number or Tariff. (Note: may be incomplete if originally reported on multiple lines.) * - total_settlement - number - 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. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_rate_base: ------------------------------------------------------------------------------- out_ferc1__yearly_rate_base ------------------------------------------------------------------------------- This table contains granular data accounting consisting of what utilities can typically include in their rate bases. This table is derived from seven FERC Form 1 accounting tables with nested calculations. We reconciled these nested calculations and then identified the most granular data across the tables. We applied slight modifications to three columns (utility_type, plant_function & plant_status) as compared to the originally reported values in our core tables. The modifications were applied to either provide more specificity (i.e. we convertedsome `total` utility_type's into `electric`) or to condense similar categories for easier analysis (i.e. creating a `hydraulic_production` plant_function by combining `hydraulic_production_conventional` and `hydraulic_production_pumped_storage` See ``pudl.output.ferc1.Exploder`` for more details. This table was made entirely from support and direction of RMI. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - is_disaggregated_in_rate_base - boolean - 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 * - is_disaggregated_utility_type - boolean - 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 * - plant_function - string - Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.). * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - rate_base_category - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - table_name - string - The name of the PUDL database table where a given record originated from. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. * - utility_type_other - string - 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). * - xbrl_factoid - string - The name of type of value which is a derivative of the XBRL fact name. .. _out_ferc1__yearly_retained_earnings_sched118: ------------------------------------------------------------------------------- out_ferc1__yearly_retained_earnings_sched118 ------------------------------------------------------------------------------- Denormalized table that contains FERC retained earnings information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * earnings_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - earnings_type - string - Label describing types of earnings. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _out_ferc1__yearly_sales_by_rate_schedules_sched304: ------------------------------------------------------------------------------- out_ferc1__yearly_sales_by_rate_schedules_sched304 ------------------------------------------------------------------------------- Denormalized table that contains FERC electricity sales by rate schedule information. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - avg_customers_per_month - number - Average number of customers per month. * - billing_status - string - 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. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - kwh_per_customer - number - kWh per customer. * - rate_schedule_description - string - Free-form description of what the rate schedule name is. Not standardized. Often a sub-category of rate_schedule_type. * - rate_schedule_type - string - Categorization of rate schedule type. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - revenue_per_kwh - number - The amount of revenue per kWh by rate schedule aquired in the given report year. * - sales_mwh - number - Quantity of electricity sold in MWh. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_small_plants_sched410: ------------------------------------------------------------------------------- out_ferc1__yearly_small_plants_sched410 ------------------------------------------------------------------------------- Denormalized table that contains small plant information from FERC Form 1. **The table has the following primary key columns:** * record_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_total - number - Total cost of plant (USD). * - construction_year - integer - Year the plant's oldest still operational unit was built. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_type - string - Type of fuel. * - license_id_ferc1 - integer - FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - opex_fuel - number - Production expenses: fuel (USD). * - opex_maintenance - number - Production expenses: Maintenance (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_total_nonfuel - number - Total production expenses, excluding fuel (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_steam_plants_fuel_by_plant_sched402: ------------------------------------------------------------------------------- out_ferc1__yearly_steam_plants_fuel_by_plant_sched402 ------------------------------------------------------------------------------- A table summarizing FERC fuel data by plant, using FERC Form 1 data. **The table has the following primary key columns:** * report_year * utility_id_ferc1 * plant_name_ferc1 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - coal_fraction_cost - number - Coal cost as a percentage of overall fuel cost. * - coal_fraction_mmbtu - number - Coal heat content as a percentage of overall fuel heat content (mmBTU). * - fuel_cost - number - Total fuel cost for plant (in $USD). * - fuel_mmbtu - number - Total heat content for plant (in MMBtu). * - gas_fraction_cost - number - Natural gas cost as a percentage of overall fuel cost. * - gas_fraction_mmbtu - number - Natural gas heat content as a percentage of overall fuel heat content (MMBtu). * - nuclear_fraction_cost - number - Nuclear cost as a percentage of overall fuel cost. * - nuclear_fraction_mmbtu - number - Nuclear heat content as a percentage of overall fuel heat content (MMBtu). * - oil_fraction_cost - number - Oil cost as a percentage of overall fuel cost. * - oil_fraction_mmbtu - number - Oil heat content as a percentage of overall fuel heat content (MMBtu). * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - primary_fuel_by_cost - string - Primary fuel for plant as a percentage of cost. * - primary_fuel_by_mmbtu - string - Primary fuel for plant as a percentage of heat content. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - waste_fraction_cost - number - Waste-heat cost as a percentage of overall fuel cost. * - waste_fraction_mmbtu - number - Waste-heat heat content as a percentage of overall fuel heat content (MMBtu). .. _out_ferc1__yearly_steam_plants_fuel_sched402: ------------------------------------------------------------------------------- out_ferc1__yearly_steam_plants_fuel_sched402 ------------------------------------------------------------------------------- Denormalized table that contains fuel information from FERC Form 1. **The table has the following primary key columns:** * record_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_total_cost - number - Total cost of consumed fuel. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_unit_burned - number - Average cost of fuel consumed in the report year per reported fuel unit (USD). * - fuel_cost_per_unit_delivered - number - Average cost of fuel delivered in the report year per reported fuel unit (USD). * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_units - string - Reported unit of measure for fuel. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_steam_plants_sched402: ------------------------------------------------------------------------------- out_ferc1__yearly_steam_plants_sched402 ------------------------------------------------------------------------------- Denormalized table that contains steam plant information from FERC Form 1. **The table has the following primary key columns:** * record_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_annual_addition - number - Annual capital addition into `capex_total`. * - capex_annual_addition_rolling - number - Year-to-date capital addition into `capex_total`. * - capex_annual_per_kw - number - Annual capital addition into `capex_total` per kw. * - capex_annual_per_mw - number - Annual capital addition into `capex_total` per MW. * - capex_annual_per_mw_rolling - number - Year-to-date capital addition into `capex_total` per MW. * - capex_annual_per_mwh - number - Annual capital addition into `capex_total` per MWh. * - capex_annual_per_mwh_rolling - number - Year-to-date capital addition into `capex_total` per MWh. * - capex_equipment - number - Cost of plant: equipment (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - capex_wo_retirement_total - number - Total cost of plant (USD) without retirements. * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - not_water_limited_capacity_mw - number - Plant capacity in MW when not limited by condenser water. * - opex_allowances - number - Allowances. * - opex_boiler - number - Maintenance of boiler (or reactor) plant. * - opex_coolants - number - Cost of coolants and water (nuclear plants only) * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_fuel - number - Production expenses: fuel (USD). * - opex_fuel_per_mwh - number - Production expenses: fuel (USD) per megawatt-hour (Mwh). * - opex_misc_power - number - Miscellaneous steam (or nuclear) expenses. * - opex_misc_steam - number - Maintenance of miscellaneous steam (or nuclear) plant. * - opex_nonfuel_per_mwh - number - Investments in non-fuel production expenses per Mwh. * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plants - number - Maintenance of electrical plant. * - opex_production_total - number - Total operating expenses. * - opex_rents - number - Production expenses: rents (USD). * - opex_steam - number - Steam expenses. * - opex_steam_other - number - Steam from other sources. * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total_nonfuel - number - Total production expenses, excluding fuel (USD). * - opex_transfer - number - Steam transferred (Credit). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_capability_mw - number - Net plant capability in megawatts. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_id_ferc1 - integer - Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - water_limited_capacity_mw - number - Plant capacity in MW when limited by condenser water. .. _out_ferc1__yearly_transmission_lines_sched422: ------------------------------------------------------------------------------- out_ferc1__yearly_transmission_lines_sched422 ------------------------------------------------------------------------------- Denormalized table that contains FERC transmission statistics information. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_other - number - Other costs associated with the plant (USD). * - capex_total - number - Total cost of plant (USD). * - conductor_size_and_material - string - Size of transmission conductor and material of the transmission line. * - designed_voltage_kv - number - Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines * - end_point - string - The end point of a transmission line. * - num_transmission_circuits - integer - Number of circuits in a transmission line. * - operating_voltage_kv - number - The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines. * - opex_maintenance - number - Production expenses: Maintenance (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - start_point - string - The starting point of a transmission line. * - supporting_structure_type - string - Supporting structure of the transmission line. * - transmission_line_and_structures_length_miles - number - 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). * - transmission_line_length_miles - number - 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). * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _out_ferc1__yearly_utility_plant_summary_sched200: ------------------------------------------------------------------------------- out_ferc1__yearly_utility_plant_summary_sched200 ------------------------------------------------------------------------------- Denormalized table that contains FERC utility plant summary information. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * utility_type * utility_plant_asset_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ending_balance - number - Account balance at end of year. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - utility_plant_asset_type - string - 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. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. * - utility_type_other - string - 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). .. _out_ferc714__hourly_estimated_state_demand: ------------------------------------------------------------------------------- out_ferc714__hourly_estimated_state_demand ------------------------------------------------------------------------------- Estimated hourly electricity demand for each state, scaled such that it matches the total electricity sales by state reported in EIA 861. **The table has the following primary key columns:** * state_id_fips * datetime_utc This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - datetime_utc - datetime - Date and time converted to Coordinated Universal Time (UTC). * - demand_mwh - number - Electricity demand (energy) within a given timeframe. * - scaled_demand_mwh - number - Estimated electricity demand scaled by the total sales within a state. * - state_id_fips - string - Two digit state FIPS code. .. _out_ferc714__hourly_planning_area_demand: ------------------------------------------------------------------------------- out_ferc714__hourly_planning_area_demand ------------------------------------------------------------------------------- Hourly electricity demand by planning area. FERC Form 714, Part III, Schedule 2a. This table includes data from the pre-2021 CSV raw source as well as the newer 2021 through present XBRL raw source. An 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. The 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. This 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. **The table has the following primary key columns:** * respondent_id_ferc714 * datetime_utc This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - datetime_utc - datetime - Date and time converted to Coordinated Universal Time (UTC). * - demand_mwh - number - Electricity demand (energy) within a given timeframe. * - report_date - date - Date reported. * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - respondent_id_ferc714_csv - integer - FERC Form 714 respondent ID from CSV reported data - published from years: 2006-2020. This ID is linked to the newer years of reported XBRL data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as respondent_id. Note that this ID does not correspond to FERC respondent IDs from other forms. * - respondent_id_ferc714_xbrl - string - 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. * - timezone - string - IANA timezone name .. _out_ferc714__respondents_with_fips: ------------------------------------------------------------------------------- out_ferc714__respondents_with_fips ------------------------------------------------------------------------------- Annual respondents with the county FIPS IDs for their service territories. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_id_eia - integer - EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity. * - balancing_authority_name_eia - string - Name of the balancing authority. * - county - string - County name. * - county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. * - eia_code - integer - 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. * - report_date - date - Date reported. * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - respondent_name_ferc714 - string - Name of the utility, balancing area authority, or planning authority responding to FERC Form 714. * - respondent_type - string - Whether a respondent to the FERC form 714 is a utility or a balancing authority. * - state - string - Two letter US state abbreviation. * - state_id_fips - string - Two digit state FIPS code. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _out_ferc714__summarized_demand: ------------------------------------------------------------------------------- out_ferc714__summarized_demand ------------------------------------------------------------------------------- Compile FERC 714 annualized, categorized respondents and summarize values. **The table has the following primary key columns:** * respondent_id_ferc714 * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - area_km2 - number - County area in km2. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_id_eia - integer - EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity. * - balancing_authority_name_eia - string - Name of the balancing authority. * - demand_annual_mwh - number - Annual electricity demand in a given report year. * - demand_annual_per_capita_mwh - number - Per-capita annual demand, averaged using Census county-level population estimates. * - demand_density_mwh_km2 - number - Annual demand per km2 of a given service territory. * - eia_code - integer - 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. * - population - number - County population, sourced from Census DP1 data. * - population_density_km2 - number - Average population per sq. km area of a service territory. * - report_date - date - Date reported. * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - respondent_name_ferc714 - string - Name of the utility, balancing area authority, or planning authority responding to FERC Form 714. * - respondent_type - string - Whether a respondent to the FERC form 714 is a utility or a balancing authority. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _out_gridpathratoolkit__hourly_available_capacity_factor: ------------------------------------------------------------------------------- out_gridpathratoolkit__hourly_available_capacity_factor ------------------------------------------------------------------------------- Hourly capacity factors defining the capacity available from an aggregated group of generators, stated as a fraction of the aggregate nameplate capacity of the group. This 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. For 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. **The table has the following primary key columns:** * datetime_utc * aggregation_group This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - aggregation_group - string - A label identifying a group of aggregated generator capacity factors. * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - datetime_utc - datetime - Date and time converted to Coordinated Universal Time (UTC). .. _out_pudl__yearly_assn_eia_ferc1_plant_parts: ------------------------------------------------------------------------------- out_pudl__yearly_assn_eia_ferc1_plant_parts ------------------------------------------------------------------------------- This table links power plant data reported in FERC Form 1 to related EIA data. It answers the question "What EIA data reported about plants or generators should be associated with a given plant record found in the FERC Form 1." Each record in this table corresponds to a single FERC Form 1 record reported in one of several tables describing power plants (large steam, hydro, small, etc.). These FERC records can correspond to an entire plant, individual generators within a plant, all generators in a plant with the same prime mover type, or just the respondent's ownership share of any of those categories (or other categories). Furthermore, the same utility may report the same plant in different ways in different years. The EIA data associated with each FERC plant record comes from our Plant Parts EIA table. The EIA data in each record represents an aggregation of several slices of an EIA plant, across both physical characteristics and utility ownership. **The table has the following primary key columns:** * record_id_ferc1 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - appro_part_label - string - Plant part of the associated true granularity record. * - appro_record_id_eia - string - EIA record ID of the associated true granularity record. * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_factor_eia - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_factor_ferc1 - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw_eia - number - Total installed (nameplate) capacity, in megawatts. * - capacity_mw_ferc1 - number - Total installed (nameplate) capacity, in megawatts. * - capex_annual_addition - number - Annual capital addition into `capex_total`. * - capex_annual_addition_rolling - number - Year-to-date capital addition into `capex_total`. * - capex_annual_per_kw - number - Annual capital addition into `capex_total` per kw. * - capex_annual_per_mw - number - Annual capital addition into `capex_total` per MW. * - capex_annual_per_mw_rolling - number - Year-to-date capital addition into `capex_total` per MW. * - capex_annual_per_mwh - number - Annual capital addition into `capex_total` per MWh. * - capex_annual_per_mwh_rolling - number - Year-to-date capital addition into `capex_total` per MWh. * - capex_equipment - number - Cost of plant: equipment (USD). * - capex_equipment_electric - number - Cost of plant: accessory electric equipment (USD). * - capex_equipment_misc - number - Cost of plant: miscellaneous power plant equipment (USD). * - capex_facilities - number - Cost of plant: reservoirs, dams, and waterways (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_roads - number - Cost of plant: roads, railroads, and bridges (USD). * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - capex_wheels_turbines_generators - number - Cost of plant: water wheels, turbines, and generators (USD). * - capex_wo_retirement_total - number - Total cost of plant (USD) without retirements. * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year_eia - integer - Year the plant's oldest still operational unit was built. * - construction_year_ferc1 - integer - Year the plant's oldest still operational unit was built. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - energy_used_for_pumping_mwh - number - Energy used for pumping, in megawatt-hours. * - ferc_acct_name - string - Name of FERC account, derived from technology description and prime mover code. * - ferc_license_id - string - The FERC license ID of a project. * - fraction_owned - number - Proportion of generator ownership attributable to this utility. * - fuel_cost_per_mmbtu_eia - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_ferc1 - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mwh_eia - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_cost_per_mwh_ferc1 - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type - string - Type of fuel. * - fuel_type_code_pudl_eia - string - Simplified fuel type code used in PUDL * - fuel_type_code_pudl_ferc1 - string - Simplified fuel type code used in PUDL * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_year - integer - Year a generator went into service. * - installation_year_eia - integer - Year the plant's most recently built unit was installed. * - installation_year_ferc1 - integer - Year the plant's most recently built unit was installed. * - license_id_ferc1 - integer - FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible. * - match_type - string - 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. * - net_capacity_adverse_conditions_mw - number - Net plant capability under the least favorable operating conditions, in megawatts. * - net_capacity_favorable_conditions_mw - number - Net plant capability under the most favorable operating conditions, in megawatts. * - net_generation_mwh_eia - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - net_generation_mwh_ferc1 - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - net_load_mwh - number - Net output for load (net generation - energy used for pumping) in megawatt-hours. * - not_water_limited_capacity_mw - number - Plant capacity in MW when not limited by condenser water. * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_pudl - string - The operating status of the asset using PUDL categories. * - opex_allowances - number - Allowances. * - opex_boiler - number - Maintenance of boiler (or reactor) plant. * - opex_coolants - number - Cost of coolants and water (nuclear plants only) * - opex_dams - number - Production expenses: maintenance of reservoirs, dams, and waterways (USD). * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_fuel - number - Production expenses: fuel (USD). * - opex_generation_misc - number - Production expenses: miscellaneous power generation expenses (USD). * - opex_hydraulic - number - Production expenses: hydraulic expenses (USD). * - opex_maintenance - number - Production expenses: Maintenance (USD). * - opex_misc_plant - number - Production expenses: maintenance of miscellaneous hydraulic plant (USD). * - opex_misc_power - number - Miscellaneous steam (or nuclear) expenses. * - opex_misc_steam - number - Maintenance of miscellaneous steam (or nuclear) plant. * - opex_nonfuel_per_mwh - number - Investments in non-fuel production expenses per Mwh. * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plant - number - Production expenses: maintenance of electric plant (USD). * - opex_production_before_pumping - number - Total production expenses before pumping (USD). * - opex_production_total - number - Total operating expenses. * - opex_pumped_storage - number - Production expenses: pumped storage (USD). * - opex_pumping - number - Production expenses: We are here to PUMP YOU UP! (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_steam - number - Steam expenses. * - opex_steam_other - number - Steam from other sources. * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_total_nonfuel - number - Total production expenses, excluding fuel (USD). * - opex_transfer - number - Steam transferred (Credit). * - opex_water_for_power - number - Production expenses: water for power (USD). * - ownership_dupe - boolean - Whether a plant part record has a duplicate record with different ownership status. * - ownership_record_type - string - Whether each generator record is for one owner or represents a total of all ownerships. * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_capability_mw - number - Net plant capability in megawatts. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_ferc1 - integer - Algorithmically assigned PUDL FERC Plant ID. WARNING: NOT STABLE BETWEEN PUDL DB INITIALIZATIONS. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_name_ppe - string - Derived plant name that includes EIA plant name and other strings associated with ID and PK columns of the plant part. * - plant_part - string - The part of the plant a record corresponds to. * - plant_part_id_eia - string - Contains EIA plant ID, plant part, ownership, and EIA utility id * - plant_type - string - Type of plant. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - record_count - integer - Number of distinct generator IDs that partcipated in the aggregation for a plant part list record. * - record_id_eia - string - Identifier for EIA plant parts analysis records. * - record_id_ferc1 - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_date - date - Date reported. * - report_year - integer - Four-digit year in which the data was reported. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - total_fuel_cost_eia - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_fuel_cost_ferc1 - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu_eia - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - total_mmbtu_ferc1 - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - true_gran - boolean - Indicates whether a plant part list record is associated with the highest priority plant part for all identical records. * - unit_heat_rate_mmbtu_per_mwh_eia - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_heat_rate_mmbtu_per_mwh_ferc1 - number - Fuel content per unit of electricity generated. Calculated from FERC reported fuel consumption and net generation. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. * - water_limited_capacity_mw - number - Plant capacity in MW when limited by condenser water. .. _core_eia860__assn_boiler_cooling: ------------------------------------------------------------------------------- core_eia860__assn_boiler_cooling ------------------------------------------------------------------------------- A table that links EIA boiler IDs to EIA cooling system IDs. **The table has the following primary key columns:** * report_date * plant_id_eia * boiler_id * cooling_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - boiler_id - string - Alphanumeric boiler ID. * - cooling_id_eia - string - 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) * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. .. _core_eia860__assn_boiler_generator: ------------------------------------------------------------------------------- core_eia860__assn_boiler_generator ------------------------------------------------------------------------------- Associations between boilers and generators as reported in EIA-860 Schedule 6, Part A. Augmented with various heuristics within PUDL. **The table has the following primary key columns:** * plant_id_eia * report_date * generator_id * boiler_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - bga_source - string - 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). * - boiler_generator_assn_type_code - string - Indicates whether boiler associations with generator during the year were actual or theoretical. Only available before 2013. * - boiler_id - string - Alphanumeric boiler ID. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - steam_plant_type_code - integer - Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details. * - unit_id_eia - string - EIA-assigned unit identification code. * - unit_id_pudl - integer - 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. .. _core_eia860__assn_boiler_stack_flue: ------------------------------------------------------------------------------- core_eia860__assn_boiler_stack_flue ------------------------------------------------------------------------------- A table that links EIA boiler IDs to EIA stack and/or flue system IDs. **The table has the following primary key columns:** * report_date * plant_id_eia * boiler_id * stack_flue_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - boiler_id - string - Alphanumeric boiler ID. * - flue_id_eia - string - 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. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - stack_flue_id_eia - string - The stack or flue identification value reported to EIA. This denotes the place where emissions from the combusion process are released into the atmosphere. Prior to 2013, this was reported as `stack_id_eia` and `flue_id_eia`. * - stack_flue_id_pudl - string - 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 seperated by an underscore or just the stack_flue_eia in cases where flue_id_eia is NA. * - stack_id_eia - string - 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. .. _core_eia860__assn_yearly_boiler_emissions_control_equipment: ------------------------------------------------------------------------------- core_eia860__assn_yearly_boiler_emissions_control_equipment ------------------------------------------------------------------------------- A table that links EIA boiler IDs to emissions control IDs for NOx, SO2, mercury, and particulate monitoring. The relationship between the IDs is sometimes many to many. **The table has the following primary key columns:** * report_date * plant_id_eia * boiler_id * emission_control_id_type * emission_control_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - boiler_id - string - Alphanumeric boiler ID. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - emission_control_id_eia - string - 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. * - emission_control_id_type - string - The type of emissions control id: SO2, NOx, particulate, or mercury. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. .. _core_eia860__scd_boilers: ------------------------------------------------------------------------------- core_eia860__scd_boilers ------------------------------------------------------------------------------- Annually varying boiler attributes, compiled from across all EIA-860 data. **The table has the following primary key columns:** * plant_id_eia * boiler_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - air_flow_100pct_load_cubic_feet_per_minute - number - Total air flow including excess air at 100 percent load, reported at standard temperature and pressure (i.e. 68 F and one atmosphere pressure). * - boiler_fuel_code_1 - string - The code representing the most predominant type of energy that fuels the boiler. * - boiler_fuel_code_2 - string - The code representing the second most predominant type of energy that fuels the boiler. * - boiler_fuel_code_3 - string - The code representing the third most predominant type of energy that fuels the boiler. * - boiler_fuel_code_4 - string - The code representing the fourth most predominant type of energy that fuels the boiler. * - boiler_id - string - Alphanumeric boiler ID. * - boiler_operating_date - date - Date the boiler began or is planned to begin commercial operation. * - boiler_retirement_date - date - Date of the scheduled or effected retirement of the boiler. * - boiler_status - string - EIA short code identifying boiler operational status. * - boiler_type - string - EIA short code indicating the standards under which the boiler is operating as described in the U.S. EPA regulation under 40 CFR. * - compliance_year_mercury - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for mercury emissions. * - compliance_year_nox - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for nitrogen oxide emissions. * - compliance_year_particulate - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for particulate matter emissions. * - compliance_year_so2 - integer - Year boiler was or is expected to be in compliance with federal, state and/or local regulations for sulfur dioxide emissions. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - efficiency_100pct_load - number - Boiler efficiency percentage when burning at 100 percent load to the nearest 0.1 percent. * - efficiency_50pct_load - number - Boiler efficiency percentage when burning at 50 percent load to the nearest 0.1 percent. * - firing_rate_using_coal_tons_per_hour - number - Design firing rate at maximum continuous steam flow for coal to the nearest 0.1 ton per hour. * - firing_rate_using_gas_mcf_per_hour - number - Design firing rate at maximum continuous steam flow for gas to the nearest 0.1 cubic feet per hour. * - firing_rate_using_oil_bbls_per_hour - number - Design firing rate at maximum continuous steam flow for pet coke to the nearest 0.1 barrels per hour. * - firing_rate_using_other_fuels - number - Design firing rate at maximum continuous steam flow for energy sources other than coal, petroleum, or natural gas. * - firing_type_1 - string - EIA short code indicating the type of firing used by this boiler. * - firing_type_2 - string - EIA short code indicating the type of firing used by this boiler. * - firing_type_3 - string - EIA short code indicating the type of firing used by this boiler. * - fly_ash_reinjection - boolean - Indicates whether the boiler is capable of re-injecting fly ash. * - hrsg - boolean - indicates if the boiler is a heat recovery steam generator (HRSG). * - max_steam_flow_1000_lbs_per_hour - number - Maximum continuous steam flow at 100 percent load. * - mercury_control_existing_strategy_1 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_2 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_3 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_4 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_5 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_existing_strategy_6 - string - Existing strategy to comply with the most stringent mercury regulation. * - mercury_control_proposed_strategy_1 - string - Proposed strategy to comply with the most stringent mercury regulation. * - mercury_control_proposed_strategy_2 - string - Proposed strategy to comply with the most stringent mercury regulation. * - mercury_control_proposed_strategy_3 - string - Proposed strategy to comply with the most stringent mercury regulation. * - new_source_review - boolean - Indicates whether the boiler is subject to New Source Review requirements. * - new_source_review_date - date - Month of issued New Source Review permit. * - new_source_review_permit - string - New Source Review permit number. * - nox_control_existing_caaa_compliance_strategy_1 - string - Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_existing_caaa_compliance_strategy_2 - string - Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_existing_caaa_compliance_strategy_3 - string - Existing strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_existing_strategy_1 - string - Existing strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_existing_strategy_2 - string - Existing strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_existing_strategy_3 - string - Existing strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_manufacturer - string - Name of nitrogen oxide control manufacturer. * - nox_control_manufacturer_code - string - Code indicating the nitrogen oxide control burner manufacturer. * - nox_control_out_of_compliance_strategy_1 - string - If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance. * - nox_control_out_of_compliance_strategy_2 - string - If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance. * - nox_control_out_of_compliance_strategy_3 - string - If boiler is not in compliance with nitrogen oxide regulations, strategy for compliance. * - nox_control_planned_caaa_compliance_strategy_1 - string - Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_planned_caaa_compliance_strategy_2 - string - Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_planned_caaa_compliance_strategy_3 - string - Planned strategies to meet the nitrogen oxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - nox_control_proposed_strategy_1 - string - Proposed strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_proposed_strategy_2 - string - Proposed strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_proposed_strategy_3 - string - Proposed strategy to comply with the most stringent nitrogen oxide regulation. * - nox_control_status_code - string - Nitrogen oxide control status code. * - particulate_control_out_of_compliance_strategy_1 - string - If boiler is not in compliance with particulate matter regulations, strategy for compliance. * - particulate_control_out_of_compliance_strategy_2 - string - If boiler is not in compliance with particulate matter regulations, strategy for compliance. * - particulate_control_out_of_compliance_strategy_3 - string - If boiler is not in compliance with particulate matter regulations, strategy for compliance. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - regulation_mercury - string - Most stringent type of statute or regulation code under which the boiler is operating for mercury control standards. * - regulation_nox - string - EIA short code for most stringent type of statute or regulation code under which the boiler is operating for nitrogen oxide control standards. * - regulation_particulate - string - EIA short code for most stringent type of statute or regulation code under which the boiler is operating for particulate matter control standards. * - regulation_so2 - string - EIA short code for most stringent type of statute or regulation code under which the boiler is operating for sulfur dioxide control standards. * - report_date - date - Date reported. * - so2_control_existing_caaa_compliance_strategy_1 - string - Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_existing_caaa_compliance_strategy_2 - string - Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_existing_caaa_compliance_strategy_3 - string - Existing strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_existing_strategy_1 - string - Existing strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_existing_strategy_2 - string - Existing strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_existing_strategy_3 - string - Existing strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_out_of_compliance_strategy_1 - string - If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance. * - so2_control_out_of_compliance_strategy_2 - string - If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance. * - so2_control_out_of_compliance_strategy_3 - string - If boiler is not in compliance with sulfur dioxide regulations, strategy for compliance. * - so2_control_planned_caaa_compliance_strategy_1 - string - Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_planned_caaa_compliance_strategy_2 - string - Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_planned_caaa_compliance_strategy_3 - string - Planned strategies to meet the sulfur dioxide requirements of Title IV of the Clean Air Act Amendment of 1990. * - so2_control_proposed_strategy_1 - string - Proposed strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_proposed_strategy_2 - string - Proposed strategy to comply with the most stringent sulfur dioxide regulation. * - so2_control_proposed_strategy_3 - string - Proposed strategy to comply with the most stringent sulfur dioxide regulation. * - standard_nox_rate - number - Numeric value for the unit of measurement specified for nitrogen oxide. * - standard_particulate_rate - number - Numeric value for the unit of measurement specified for particulate matter. * - standard_so2_percent_scrubbed - number - The percent of sulfur dioxide to be scrubbed specified by the most stringent sulfur dioxide regulation. * - standard_so2_rate - number - Numeric value for the unit of measurement specified for sulfur dioxide. * - turndown_ratio - number - The turndown ratio for the boiler. * - unit_nox - string - Numeric value for the unit of measurement specified for nitrogen oxide. * - unit_particulate - string - Numeric value for the unit of measurement specified for particulate matter. * - unit_so2 - string - Numeric value for the unit of measurement specified for sulfur dioxide. * - waste_heat_input_mmbtu_per_hour - number - 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). * - wet_dry_bottom - string - 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. .. _core_eia860__scd_emissions_control_equipment: ------------------------------------------------------------------------------- core_eia860__scd_emissions_control_equipment ------------------------------------------------------------------------------- The cost, type, operating status, retirement date, and install year of emissions control equipment reported to EIA. Includes control ids for sulfur dioxide (SO2), particulate matter, mercury, nitrogen oxide (NOX), and acid (HCl) gas monitoring. **The table has the following primary key columns:** * report_year * plant_id_eia * emission_control_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - acid_gas_control - boolean - Indicates whether the emissions control equipment controls acid (HCl) gas. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - emission_control_equipment_cost - number - The total cost to install a piece of emission control equipment. * - emission_control_equipment_type_code - string - Short code indicating the type of emission control equipment installed. * - emission_control_id_pudl - number - 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. * - emission_control_operating_date - date - The date a piece of emissions control equipment began operating. Derived from month and year columns in the raw data. * - emission_control_retirement_date - date - The expected or actual retirement date for a piece of emissions control equipment. Derived from month and year columns in the raw data. * - mercury_control_id_eia - string - Mercury control identification number. This ID is not a unique identifier. * - nox_control_id_eia - string - Nitrogen oxide control identification number. This ID is not a unique identifier. * - operational_status_code - string - The operating status of the asset. * - particulate_control_id_eia - string - Particulate matter control identification number. This ID is not a unique identifier. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_year - integer - Four-digit year in which the data was reported. * - so2_control_id_eia - string - Sulfur dioxide control identification number. This ID is not a unique identifier. .. _core_eia860__scd_generators: ------------------------------------------------------------------------------- core_eia860__scd_generators ------------------------------------------------------------------------------- Annually varying generator attributes compiled from across EIA-860 and EIA-923 data. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - carbon_capture - boolean - Indicates whether the generator uses carbon capture technology. * - cofire_fuels - boolean - Can the generator co-fire fuels?. * - current_planned_generator_operating_date - date - The most recently updated effective date on which the generator is scheduled to start operation * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - deliver_power_transgrid - boolean - Indicate whether the generator can deliver power to the transmission grid. * - distributed_generation - boolean - Whether the generator is considered distributed generation * - energy_source_1_transport_1 - string - Primary mode of transport for energy source 1. * - energy_source_1_transport_2 - string - Secondary mode of transport for energy source 1. * - energy_source_1_transport_3 - string - Tertiary mode of transport for energy source 1. * - energy_source_2_transport_1 - string - Primary mode of transport for energy source 2. * - energy_source_2_transport_2 - string - Secondary mode of transport for energy source 2. * - energy_source_2_transport_3 - string - Tertiary mode of transport for energy source 2. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - energy_source_code_2 - string - The code representing the second most predominant type of energy that fuels the generator * - energy_source_code_3 - string - The code representing the third most predominant type of energy that fuels the generator * - energy_source_code_4 - string - The code representing the fourth most predominant type of energy that fuels the generator * - energy_source_code_5 - string - The code representing the fifth most predominant type of energy that fuels the generator * - energy_source_code_6 - string - The code representing the sixth most predominant type of energy that fuels the generator * - energy_storage_capacity_mwh - number - Energy storage capacity in MWh (e.g. for batteries). * - ferc_qualifying_facility - boolean - Indicates whether or not a generator is a qualifying FERC cogeneration facility. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - minimum_load_mw - number - The minimum load at which the generator can operate at continuosuly. * - multiple_fuels - boolean - Can the generator burn multiple fuels? * - nameplate_power_factor - number - The nameplate power factor of the generator. * - net_capacity_mwdc - number - Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV. * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_code - string - The operating status of the asset. * - other_modifications_date - date - Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete. * - other_planned_modifications - boolean - Indicates whether there are there other modifications planned for the generator. * - owned_by_non_utility - boolean - Whether any part of generator is owned by a nonutilty * - ownership_code - string - Identifies the ownership for each generator. * - planned_derate_date - date - Planned effective month that the generator is scheduled to enter operation after the derate modification. * - planned_energy_source_code_1 - string - New energy source code for the planned repowered generator. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - planned_modifications - boolean - Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years. * - planned_net_summer_capacity_derate_mw - number - Decrease in summer capacity expected to be realized from the derate modification to the equipment. * - planned_net_summer_capacity_uprate_mw - number - Increase in summer capacity expected to be realized from the modification to the equipment. * - planned_net_winter_capacity_derate_mw - number - Decrease in winter capacity expected to be realized from the derate modification to the equipment. * - planned_net_winter_capacity_uprate_mw - number - Increase in winter capacity expected to be realized from the uprate modification to the equipment. * - planned_new_capacity_mw - number - The expected new namplate capacity for the generator. * - planned_new_prime_mover_code - string - New prime mover for the planned repowered generator. * - planned_repower_date - date - Planned effective date that the generator is scheduled to enter operation after the repowering is complete. * - planned_uprate_date - date - Planned effective date that the generator is scheduled to enter operation after the uprate modification. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - reactive_power_output_mvar - number - Reactive Power Output (MVAr) * - report_date - date - Date reported. * - startup_source_code_1 - string - 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. * - startup_source_code_2 - string - 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. * - startup_source_code_3 - string - 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. * - startup_source_code_4 - string - 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. * - summer_capacity_estimate - boolean - Whether the summer capacity value was an estimate * - summer_capacity_mw - number - The net summer capacity. * - summer_estimated_capability_mw - number - EIA estimated summer capacity (in MWh). * - switch_oil_gas - boolean - Indicates whether the generator switch between oil and natural gas. * - syncronized_transmission_grid - boolean - Indicates whether standby generators (SB status) can be synchronized to the grid. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - time_cold_shutdown_full_load_code - string - The minimum amount of time required to bring the unit to full load from shutdown. * - turbines_inverters_hydrokinetics - integer - Number of wind turbines, or hydrokinetic buoys. * - turbines_num - integer - Number of wind turbines, or hydrokinetic buoys. * - uprate_derate_completed_date - date - The date when the uprate or derate was completed. * - uprate_derate_during_year - boolean - Was an uprate or derate completed on this generator during the reporting year? * - utility_id_eia - integer - The EIA Utility Identification number. * - winter_capacity_estimate - boolean - Whether the winter capacity value was an estimate * - winter_capacity_mw - number - The net winter capacity. * - winter_estimated_capability_mw - number - EIA estimated winter capacity (in MWh). .. _core_eia860__scd_generators_energy_storage: ------------------------------------------------------------------------------- core_eia860__scd_generators_energy_storage ------------------------------------------------------------------------------- Annually reported information about energy storage from EIA-860 Schedule 3. This 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 core_eia860__scd_generators and core_eia__entity_generators. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_id_direct_support_1 - string - The EIA Generator ID of the primary unit whose generation this energy storage device is intended to firm or store. * - generator_id_direct_support_2 - string - The EIA Generator ID of the secondary unit whose generation this energy storage device is intended to firm or store. * - generator_id_direct_support_3 - string - The EIA Generator ID of the tertiary unit whose generation this energy storage device is intended to firm or store. * - id_dc_coupled_tightly - boolean - 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). * - is_ac_coupled - boolean - 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). * - is_dc_coupled - boolean - 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). * - is_direct_support - boolean - Indicates if this energy storage device is intended for dedicated generator firming or storing excess generation of other units. * - is_independent - boolean - Indicates if this energy storage device is independent (not coupled with another generators) * - is_transmission_and_distribution_asset_support - boolean - Indicate if the energy storage system is intended to support a specific substation, transmission or distribution asset. * - max_charge_rate_mw - number - Maximum charge rate in MW. * - max_discharge_rate_mw - number - Maximum discharge rate in MW. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_eia_direct_support_1 - integer - The EIA Plant ID of the primary unit whose generation this energy storage device is intended to firm or store. * - plant_id_eia_direct_support_2 - integer - The EIA Plant ID of the secondary unit whose generation this energy storage device is intended to firm or store. * - plant_id_eia_direct_support_3 - integer - The EIA Plant ID of the tertiary unit whose generation this energy storage device is intended to firm or store. * - report_date - date - Date reported. * - served_arbitrage - boolean - Whether the energy storage device served arbitrage applications during the reporting year * - served_backup_power - boolean - Whether the energy storage device served backup power applications during the reporting year. * - served_co_located_renewable_firming - boolean - Whether the energy storage device served renewable firming applications during the reporting year. * - served_frequency_regulation - boolean - Whether the energy storage device served frequency regulation applications during the reporting year. * - served_load_following - boolean - Whether the energy storage device served load following applications during the reporting year. * - served_load_management - boolean - Whether the energy storage device served load management applications during the reporting year. * - served_ramping_spinning_reserve - boolean - Whether the this energy storage device served ramping / spinning reserve applications during the reporting year. * - served_system_peak_shaving - boolean - Whether the energy storage device served system peak shaving applications during the reporting year. * - served_transmission_and_distribution_deferral - boolean - Whether the energy storage device served renewable firming applications during the reporting year. * - served_voltage_or_reactive_power_support - boolean - Whether the energy storage device served voltage or reactive power support applications during the reporting year. * - storage_enclosure_code - string - A code representing the enclosure type that best describes where the generator is located. * - storage_technology_code_1 - string - The electro-chemical storage technology used for this battery applications. * - storage_technology_code_2 - string - The electro-chemical storage technology used for this battery applications. * - storage_technology_code_3 - string - The electro-chemical storage technology used for this battery applications. * - storage_technology_code_4 - string - The electro-chemical storage technology used for this battery applications. * - stored_excess_wind_and_solar_generation - boolean - Whether the energy storage device was used to store excess wind/solar generation during the reporting year. .. _core_eia860__scd_generators_solar: ------------------------------------------------------------------------------- core_eia860__scd_generators_solar ------------------------------------------------------------------------------- Annually reported information about solar generators from EIA-860 Schedule 3.3. This 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 core_eia860__scd_generators and core_eia__entity_generators. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - azimuth_angle_deg - number - Indicates the azimuth angle of the unit for fixed tilt or single-axis technologies. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_metering_capacity_mwdc - number - The DC megawatt capacity that is part of a net metering agreement. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - standard_testing_conditions_capacity_mwdc - number - 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. * - tilt_angle_deg - number - Indicates the tilt angle of the unit for fixed tilt or single-axis technologies. * - uses_bifacial_panels - boolean - Indicates whether bifacial solar panels are used at this solar generating unit. * - uses_material_crystalline_silicon - boolean - Indicates whether any solar photovoltaic panels at this generator are made of crystalline silicon. * - uses_material_other - boolean - Indicates whether any solar photovoltaic panels at this generator are made of other materials. * - uses_material_thin_film_a_si - boolean - Indicates whether any solar photovoltaic panels at this generator are made of thin-film amorphous silicon (A-Si). * - uses_material_thin_film_cdte - boolean - Indicates whether any solar photovoltaic panels at this generator are made of thin-film cadmium telluride (CdTe). * - uses_material_thin_film_cigs - boolean - Indicates whether any solar photovoltaic panels at this generator are made of thin-film copper indium gallium diselenide (CIGS). * - uses_material_thin_film_other - boolean - Indicates whether any solar photovoltaic panels at this generator are made of other thin-film material. * - uses_net_metering_agreement - boolean - Indicates if the output from this generator is part of a net metering agreement. * - uses_technology_dish_engine - boolean - Indicates whether dish engines are used at this solar generating unit. * - uses_technology_dual_axis_tracking - boolean - Indicates whether dual-axis tracking technologies are used at this solar generating unit. * - uses_technology_east_west_fixed_tilt - boolean - Indicates whether east west fixed tilt technologies are used at this solar generating unit. * - uses_technology_fixed_tilt - boolean - Indicates whether fixed tilt technologies are used at this solar generating unit. * - uses_technology_lenses_mirrors - boolean - Indicates whether lenses or mirrors are used at this solar generating unit. * - uses_technology_linear_fresnel - boolean - Indicates whether linear fresnel technologies are used at this solar generating unit. * - uses_technology_other - boolean - Indicates whether other solar technologies are used at this solar generating unit. * - uses_technology_parabolic_trough - boolean - Indicates whether parabolic trough technologies s are used at this solar generating unit. * - uses_technology_power_tower - boolean - Indicates whether power towers are used at this solar generating unit. * - uses_technology_single_axis_tracking - boolean - Indicates whether single-axis tracking technologies are used at this solar generating unit. * - uses_virtual_net_metering_agreement - boolean - Indicates if the output from this generator is part of a virtual net metering agreement. * - virtual_net_metering_capacity_mwdc - number - The DC capacity in MW that is part of a virtual net metering agreement. .. _core_eia860__scd_generators_wind: ------------------------------------------------------------------------------- core_eia860__scd_generators_wind ------------------------------------------------------------------------------- Annually reported information about wind generators from EIA-860 Schedule 3.2. This 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 core_eia860__scd_generators and core_eia__entity_generators. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - design_wind_speed_mph - number - Average annual wind speed that turbines at this wind site were designed for. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - obstacle_id_faa - string - 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. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - predominant_turbine_manufacturer - string - Name of predominant manufacturer of turbines at this generator. * - predominant_turbine_model - string - Predominant model number of turbines at this generator. * - report_date - date - Date reported. * - turbine_hub_height_feet - number - The hub height of turbines at this generator. If more than one value exists, the one that best represents the turbines. * - wind_quality_class - integer - The wind quality class for turbines at this generator. See table core_eia__codes_wind_quality_class for specifications about each class. .. _core_eia860__scd_ownership: ------------------------------------------------------------------------------- core_eia860__scd_ownership ------------------------------------------------------------------------------- Generator Ownership, reported in EIA-860 Schedule 4. Includes only jointly or third-party owned generators. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id * owner_utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - fraction_owned - number - Proportion of generator ownership attributable to this utility. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - owner_city - string - City of owner. * - owner_country - string - Three letter ISO-3166 country code. * - owner_state - string - Two letter ISO-3166 political subdivision code. * - owner_street_address - string - Steet address of owner. * - owner_utility_id_eia - integer - 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. * - owner_utility_name_eia - string - The name of the EIA owner utility. * - owner_zip_code - string - Zip code of owner. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. .. _core_eia860__scd_plants: ------------------------------------------------------------------------------- core_eia860__scd_plants ------------------------------------------------------------------------------- Annually varying plant attributes, compiled from across all EIA-860 and EIA-923 data. **The table has the following primary key columns:** * plant_id_eia * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_impoundment - boolean - Is there an ash impoundment (e.g. pond, reservoir) at the plant? * - ash_impoundment_lined - boolean - If there is an ash impoundment at the plant, is the impoundment lined? * - ash_impoundment_status - string - If there is an ash impoundment at the plant, the ash impoundment status as of December 31 of the reporting year. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_name_eia - string - Name of the balancing authority. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - datum - string - Geodetic coordinate system identifier (e.g. NAD27, NAD83, or WGS84). * - energy_storage - boolean - Indicates if the facility has energy storage capabilities. * - ferc_cogen_docket_no - string - The docket number relating to the FERC cogenerator status. See FERC Form 556. * - ferc_cogen_status - boolean - Indicates whether the plant has FERC qualifying facility cogenerator status. See FERC Form 556. * - ferc_exempt_wholesale_generator - boolean - Indicates whether the plant has FERC qualifying facility exempt wholesale generator status * - ferc_exempt_wholesale_generator_docket_no - string - The docket number relating to the FERC qualifying facility exempt wholesale generator status. * - ferc_qualifying_facility_docket_no - string - The docket number relating to the FERC qualifying facility cogenerator status. See FERC Form 556. * - ferc_small_power_producer - boolean - Indicates whether the plant has FERC qualifying facility small power producer status. See FERC Form 556. * - ferc_small_power_producer_docket_no - string - The docket number relating to the FERC qualifying facility small power producer status. See FERC Form 556. * - grid_voltage_1_kv - number - Plant's grid voltage at point of interconnection to transmission or distibution facilities * - grid_voltage_2_kv - number - Plant's grid voltage at point of interconnection to transmission or distibution facilities * - grid_voltage_3_kv - number - Plant's grid voltage at point of interconnection to transmission or distibution facilities * - has_net_metering - boolean - 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 * - iso_rto_code - string - The code of the plant's ISO or RTO. NA if not reported in that year. * - liquefied_natural_gas_storage - boolean - Indicates if the facility have the capability to store the natural gas in the form of liquefied natural gas. * - natural_gas_local_distribution_company - string - Names of Local Distribution Company (LDC), connected to natural gas burning power plants. * - natural_gas_pipeline_name_1 - string - 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. * - natural_gas_pipeline_name_2 - string - 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. * - natural_gas_pipeline_name_3 - string - 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. * - natural_gas_storage - boolean - Indicates if the facility have on-site storage of natural gas. * - nerc_region - string - NERC region in which the plant is located * - pipeline_notes - string - Additional owner or operator of natural gas pipeline. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - primary_purpose_id_naics - integer - North American Industry Classification System (NAICS) code that best describes the primary purpose of the reporting plant * - regulatory_status_code - string - Indicates whether the plant is regulated or non-regulated. * - report_date - date - Date reported. * - reporting_frequency_code - string - 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. * - sector_id_eia - integer - 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 * - sector_name_eia - string - 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 * - service_area - string - Service area in which plant is located; for unregulated companies, it's the electric utility with which plant is interconnected * - transmission_distribution_owner_id - integer - EIA-assigned code for owner of transmission/distribution system to which the plant is interconnected. * - transmission_distribution_owner_name - string - Name of the owner of the transmission or distribution system to which the plant is interconnected. * - transmission_distribution_owner_state - string - State location for owner of transmission/distribution system to which the plant is interconnected. * - utility_id_eia - integer - The EIA Utility Identification number. * - water_source - string - Name of water source associated with the plant. .. _core_eia860__scd_utilities: ------------------------------------------------------------------------------- core_eia860__scd_utilities ------------------------------------------------------------------------------- Annually varying utility attributes, compiled from all EIA data. **The table has the following primary key columns:** * utility_id_eia * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - address_2 - string - Second line of the address. * - attention_line - string - Mail attention name of the operator/owner. * - city - string - Name of the city. * - contact_firstname - string - First name of utility contact 1. * - contact_firstname_2 - string - First name of utility contact 2. * - contact_lastname - string - Last name of utility contact 1. * - contact_lastname_2 - string - Last name of utility contact 2. * - contact_title - string - Title of of utility contact 1. * - contact_title_2 - string - Title of utility contact 2. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - entity_type - string - Entity type of principal owner. * - phone_extension - string - Phone extension for utility contact 1 * - phone_extension_2 - string - Phone extension for utility contact 2 * - phone_number - string - Phone number for utility contact 1. * - phone_number_2 - string - Phone number for utility contact 2. * - plants_reported_asset_manager - boolean - Is the reporting entity an asset manager of power plants reported on Schedule 2 of the form? * - plants_reported_operator - boolean - Is the reporting entity an operator of power plants reported on Schedule 2 of the form? * - plants_reported_other_relationship - boolean - Does the reporting entity have any other relationship to the power plants reported on Schedule 2 of the form? * - plants_reported_owner - boolean - Is the reporting entity an owner of power plants reported on Schedule 2 of the form? * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - street_address - string - Physical street address. * - utility_id_eia - integer - The EIA Utility Identification number. * - zip_code - string - Five digit US Zip Code. * - zip_code_4 - string - Four digit US Zip Code suffix. .. _core_eia860m__changelog_generators: ------------------------------------------------------------------------------- core_eia860m__changelog_generators ------------------------------------------------------------------------------- This table is a changelog of the monthly reported EIA-860M data. EIA-860M includes generator tables with the most up-to-date catalog of EIA generators and their operational status and other generator characteristics. EIA-860M is reported monthly, although for the vast majority of the generators nothing changes month-to- month. This table is a changelog of that monthly reported generator data. There is a record corresponding to the first instance of a generator and associated characteristics with a report_date column and a valid_until_date column. Whenever any of the reported EIA-860M data was changed for a record, there will be a new changelog record with a new report_date. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - county - string - County name. * - current_planned_generator_operating_date - date - The most recently updated effective date on which the generator is scheduled to start operation * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - energy_storage_capacity_mwh - number - Energy storage capacity in MWh (e.g. for batteries). * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_date - date - Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date. * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - latitude - number - Latitude of the plant's location, in degrees. * - longitude - number - Longitude of the plant's location, in degrees. * - net_capacity_mwdc - number - Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV. * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_code - string - The operating status of the asset. * - planned_derate_date - date - Planned effective month that the generator is scheduled to enter operation after the derate modification. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - planned_net_summer_capacity_derate_mw - number - Decrease in summer capacity expected to be realized from the derate modification to the equipment. * - planned_net_summer_capacity_uprate_mw - number - Increase in summer capacity expected to be realized from the modification to the equipment. * - planned_uprate_date - date - Planned effective date that the generator is scheduled to enter operation after the uprate modification. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_name_eia - string - Plant name. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - sector_id_eia - integer - 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 * - state - string - Two letter US state abbreviation. * - summer_capacity_mw - number - The net summer capacity. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - valid_until_date - date - 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. * - winter_capacity_mw - number - The net winter capacity. .. _core_eia861__assn_balancing_authority: ------------------------------------------------------------------------------- core_eia861__assn_balancing_authority ------------------------------------------------------------------------------- Association table showing which combinations of state, balancing authority, and utilities were observed in the data each year. **The table has the following primary key columns:** * report_date * balancing_authority_id_eia * utility_id_eia * state `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_id_eia - integer - EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__assn_utility: ------------------------------------------------------------------------------- core_eia861__assn_utility ------------------------------------------------------------------------------- Association table indicating which states each utility reported data for by year. **The table has the following primary key columns:** * report_date * utility_id_eia * state `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_advanced_metering_infrastructure: ------------------------------------------------------------------------------- core_eia861__yearly_advanced_metering_infrastructure ------------------------------------------------------------------------------- The data contain number of meters from automated meter readings (AMR) and advanced metering infrastructure (AMI) by state, sector, and balancing authority. The energy served (in megawatthours) for AMI systems is provided. Form EIA-861 respondents also report the number of standard meters (non AMR/AMI) in their system. Historical Changes: We started collecting the number of standard meters in 2013. The monthly survey collected these data from January 2011 to January 2017. **The table has the following primary key columns:** * balancing_authority_code_eia * customer_class * report_date * state * utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - advanced_metering_infrastructure - integer - 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. * - automated_meter_reading - integer - Number of meters that collect data for billing purposes only and transmit this data one way, usually from the customer to the distribution utility. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - daily_digital_access_customers - integer - Number of customers able to access daily energy usage through a webportal or other electronic means. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - direct_load_control_customers - integer - Number of customers with direct load control: a A demand response activity by which the program sponsor remotely shuts down or cycles a customer’s electrical equipment (e.g. air conditioner, water heater) on short notice. * - energy_served_ami_mwh - number - Amount of energy served through AMI meters. AMI meters can transmit data in both directions, between the delivery entity and the customer. * - entity_type - string - Entity type of principal owner. * - home_area_network - integer - Number of AMI meters with home area network (HAN) gateway enabled. * - non_amr_ami - integer - 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. * - report_date - date - Date reported. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_balancing_authority: ------------------------------------------------------------------------------- core_eia861__yearly_balancing_authority ------------------------------------------------------------------------------- Annual entity table for balancing authorities. **The table has the following primary key columns:** * report_date * balancing_authority_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_id_eia - integer - EIA balancing authority ID. This is often (but not always!) the same as the utility ID associated with the same legal entity. * - balancing_authority_name_eia - string - Name of the balancing authority. * - report_date - date - Date reported. .. _core_eia861__yearly_demand_response: ------------------------------------------------------------------------------- core_eia861__yearly_demand_response ------------------------------------------------------------------------------- Energy demand response programs by state, sector, and balancing authority. We collect data for the number of customers enrolled, energy savings, potential and actual peak savings, and associated costs. The EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. **The table has the following primary key columns:** * balancing_authority_code_eia * customer_class * report_date * state * utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - actual_peak_demand_savings_mw - number - Demand reduction actually achieved by demand response activities. Measured at the time of the company's annual system peak hour. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - customer_incentives_cost - number - 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. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_savings_mwh - number - The energy savings incurred in a given reporting year by participation in demand response programs. * - other_costs - number - Additional costs. * - potential_peak_demand_savings_mw - number - The total demand savings that could occur at the time of the system peak hour assuming all demand response is called. * - report_date - date - Date reported. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_demand_response_water_heater: ------------------------------------------------------------------------------- core_eia861__yearly_demand_response_water_heater ------------------------------------------------------------------------------- The number of grid connected water heaters enrolled in demand response programs. **The table has the following primary key columns:** * balancing_authority_code_eia * report_date * state * utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - num_water_heaters - integer - 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’s Office of Energy Efficiency and Renewable Energy). * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_demand_side_management_ee_dr: ------------------------------------------------------------------------------- core_eia861__yearly_demand_side_management_ee_dr ------------------------------------------------------------------------------- The impact of energy efficiency and load management programs on total energy sold (MWh) and peak demand (MW) by customer class. Includes incremental effects (from new programs and new participants) as well as total annual effects (all programs and participants in a given year) and potential effects (anticipated peak reduction for load management programs). Also includes the cost of DSM programs and the number of customers enrolled in price-responsive and time-responsive programs. The raw EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - annual_indirect_program_cost - number - Costs that have not been included in any program category, but could be meaningfully identified with operating the company’s DSM programs (e.g., Administrative, Marketing, Monitoring & Evaluation, Company-Earned Incentives, Other). * - annual_total_cost - number - The sum of direct program costs, indirect program costs, and incentive payments associated with utility demand side management programs. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_efficiency_annual_actual_peak_reduction_mw - number - The peak reduction incurred in a given reporting year by all participants in efficiency programs. * - energy_efficiency_annual_cost - number - The sum of actual direct costs, incentive payments, and indirect costs incurred in a given reporting year from energy efficiency programs. * - energy_efficiency_annual_effects_mwh - number - The change in energy use incurred in a given reporting year by all participants in energy efficiency programs. * - energy_efficiency_annual_incentive_payment - number - 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. * - energy_efficiency_incremental_actual_peak_reduction_mw - number - 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. * - energy_efficiency_incremental_effects_mwh - number - 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. * - load_management_annual_actual_peak_reduction_mw - number - The peak reduction incurred in a given reporting year by all participants in load management programs. * - load_management_annual_cost - number - The sum of actual direct costs, incentive payments, and indirect costs incurred in a given reporting year from load management programs. * - load_management_annual_effects_mwh - number - The change in energy use incurred in a given reporting year by all participants in load management programs. * - load_management_annual_incentive_payment - number - 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. * - load_management_annual_potential_peak_reduction_mw - number - The potential amount of peak reduction that could be incurred in a given reporting year by all participants in load management programs. * - load_management_incremental_actual_peak_reduction_mw - number - 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. * - load_management_incremental_effects_mwh - number - 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 managment programs. * - load_management_incremental_potential_peak_reduction_mw - number - 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. * - nerc_region - string - NERC region in which the plant is located * - price_responsiveness_customers - integer - The number of customers participating in the respondent's incentive-based demand response programs. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - time_responsiveness_customers - integer - The number of cusomters participating in the respondent's time-based rate programs. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_demand_side_management_misc: ------------------------------------------------------------------------------- core_eia861__yearly_demand_side_management_misc ------------------------------------------------------------------------------- Miscellaneous information from the EIA861 DSM table. Includes boolean fields about whether the energy savings estimates/calculations were independently verified and whether the utility runs time and or price responsive programs. Also contains information on whether any of the respondent's DSM activities are reported under another company, and if so which one. The raw EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_savings_estimates_independently_verified - boolean - Whether savings estimates are based on a forecast or the report of one or more independent evaluators. * - energy_savings_independently_verified - boolean - Whether reported energy savings were verified through an independent evaluation. * - entity_type - string - Entity type of principal owner. * - has_time_responsive_programs - boolean - 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). * - major_program_changes - boolean - 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. * - nerc_region - string - NERC region in which the plant is located * - price_responsive_programs - boolean - 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). * - report_date - date - Date reported. * - reported_as_another_company - string - The name of the company if a respondent's demand-side management activities are reported on Schedule 6 of another company’s form. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_demand_side_management_sales: ------------------------------------------------------------------------------- core_eia861__yearly_demand_side_management_sales ------------------------------------------------------------------------------- Electricity sales for resale and to ultimate customer. The raw EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - nerc_region - string - NERC region in which the plant is located * - report_date - date - Date reported. * - sales_for_resale_mwh - number - 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. * - sales_to_ultimate_consumers_mwh - number - The amount of electricity sold to customers purchasing electricity for their own use and not for resale. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_distributed_generation_fuel: ------------------------------------------------------------------------------- core_eia861__yearly_distributed_generation_fuel ------------------------------------------------------------------------------- Information on the energy sources used for utility or customer-owned distributed generation capacity. The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - estimated_or_actual_fuel_data - string - Whether the reported fuel data is estimated or actual. * - fuel_class - string - Fuel types specific to EIA 861 distributed generation table: ['gas', 'oil', 'other', 'renewable', 'water', 'wind', 'wood'] * - fuel_pct - number - Percent of fuel * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_distributed_generation_misc: ------------------------------------------------------------------------------- core_eia861__yearly_distributed_generation_misc ------------------------------------------------------------------------------- Information on the capacity of utility or customer-owned distributed generation. Includes the number of generators, whether the capacity is esimated or actual, the amount of backup capacity, and how much capacity is from generators with less than 1 MW of nameplate capacity. The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - backup_capacity_mw - number - The total nameplate capacity of generators that are used only for emergency backup service. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - distributed_generation_owned_capacity_mw - number - Amount of distributed generation capacity owned by the respondent. * - estimated_or_actual_capacity_data - string - Whether the reported capacity data is estimated or actual. * - generators_num_less_1_mw - integer - Total number of generators less than 1 MW. * - generators_number - integer - Total number of generators * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - total_capacity_less_1_mw - number - The total amount of capacity from generators with less than 1 MW of nameplate capacity. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_distributed_generation_tech: ------------------------------------------------------------------------------- core_eia861__yearly_distributed_generation_tech ------------------------------------------------------------------------------- Information on the technology used for utility or customer-owned distributed generation. The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - estimated_or_actual_tech_data - string - Whether the reported technology data is estimated or actual. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - tech_class - string - 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', 'all_storage', 'total', 'virtual_pv', 'wind']. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_distribution_systems: ------------------------------------------------------------------------------- core_eia861__yearly_distribution_systems ------------------------------------------------------------------------------- The number of distribution circuits and circuits with voltage optimization by state. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - circuits_with_voltage_optimization - integer - Number of distribution circuits that employ voltage/VAR optimization (VVO). * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - distribution_circuits - integer - Total number of distribution circuits. * - report_date - date - Date reported. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_dynamic_pricing: ------------------------------------------------------------------------------- core_eia861__yearly_dynamic_pricing ------------------------------------------------------------------------------- The number of customers enrolled in dynamic pricing programs by state, sector, and balancing authority. Respondents check if one or more customers are enrolled in time-of-use pricing, real time pricing, variable peak pricing, critical peak pricing, and critical peak rebates. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - critical_peak_pricing - boolean - 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. * - critical_peak_rebate - boolean - 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. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - real_time_pricing - boolean - 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. * - report_date - date - Date reported. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - time_of_use_pricing - boolean - 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 “standard” rate. Price schedule is fixed and predefined, based on season, day of week, and time of day. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - variable_peak_pricing - boolean - 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. .. _core_eia861__yearly_energy_efficiency: ------------------------------------------------------------------------------- core_eia861__yearly_energy_efficiency ------------------------------------------------------------------------------- Incremental energy savings, peak demand savings, weighted average life cycle, and associated costs for the reporting year and life cycle of energy efficiency programs. The EIA861 demand-side management (DSM) table (split into three normalized tables in PUDL) contain data through 2012. The form changed in 2013 and split the contents of the DSM table into energy efficiency and demand response tables. Though similar, the information collected before and after 2012 are not comprable enough to combine into a singular, continous table. We were discouraged from doing so after contacting a representative from EIA. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - customer_incentives_incremental_cost - number - 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. * - customer_incentives_incremental_life_cycle_cost - number - 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. * - customer_other_costs_incremental_life_cycle_cost - number - All anticipated costs other than customer incentives. Includes reporting year incremental costs and all future costs. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - incremental_energy_savings_mwh - number - energy savings in the given report year resulting from new participants in existing demand response programs and all participants in new demand response programs. * - incremental_life_cycle_energy_savings_mwh - number - 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. * - incremental_life_cycle_peak_reduction_mw - number - 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. * - incremental_peak_reduction_mw - number - 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. * - other_costs_incremental_cost - number - 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. * - report_date - date - Date reported. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - weighted_average_life_years - number - The weighted average life of the respondent's portfolio of energy efficiency programs. .. _core_eia861__yearly_green_pricing: ------------------------------------------------------------------------------- core_eia861__yearly_green_pricing ------------------------------------------------------------------------------- Green pricing program revenue, sales, and customer count by sector and state. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - green_pricing_revenue - number - The money derived from premium green pricing rate of the respondent'sprogram. * - rec_revenue - number - Amount of revenue collected from Renewable Energy Certificates (RECs). * - rec_sales_mwh - number - Amount of sales collected from Renewable Energy Certificates (RECs). * - report_date - date - Date reported. * - sales_mwh - number - Quantity of electricity sold in MWh. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_mergers: ------------------------------------------------------------------------------- core_eia861__yearly_mergers ------------------------------------------------------------------------------- Information about utility mergers and acquisitions. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - entity_type - string - Entity type of principal owner. * - merge_address - string - Address of new parent company. * - merge_city - string - City of new parent company. * - merge_company - string - Name of the company merged with or acquired. * - merge_date - date - Date of merger or acquisition. * - merge_state - string - Two letter US state abbreviations and three letter ISO-3166-1 country codes for international mines. * - new_parent - string - Name of the new parent company post merger. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - zip_code - string - Five digit US Zip Code. * - zip_code_4 - string - Four digit US Zip Code suffix. .. _core_eia861__yearly_net_metering_customer_fuel_class: ------------------------------------------------------------------------------- core_eia861__yearly_net_metering_customer_fuel_class ------------------------------------------------------------------------------- The amount of energy sold to back to the grid. From 2007 - 2009 the data are reported as a lump sum of total energy dispatched by sector. After 2009, the data are broken down by sector and technology type. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - report_date - date - Date reported. * - short_form - boolean - 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. * - sold_to_utility_mwh - number - The amount of electric energy sold back to the utility through the net metering application. * - state - string - Two letter US state abbreviation. * - tech_class - string - 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', 'all_storage', 'total', 'virtual_pv', 'wind']. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_net_metering_misc: ------------------------------------------------------------------------------- core_eia861__yearly_net_metering_misc ------------------------------------------------------------------------------- The PV current flow type for net metered capacity. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - pv_current_flow_type - string - Current flow type for photovoltaics: AC or DC * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_non_net_metering_customer_fuel_class: ------------------------------------------------------------------------------- core_eia861__yearly_non_net_metering_customer_fuel_class ------------------------------------------------------------------------------- The amount of non-net metered distributed generation by sector and technology type. The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - tech_class - string - 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', 'all_storage', 'total', 'virtual_pv', 'wind']. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_non_net_metering_misc: ------------------------------------------------------------------------------- core_eia861__yearly_non_net_metering_misc ------------------------------------------------------------------------------- Information on the capacity of utility or customer-owned distributed generation. Includes the number of generators, pv current flow type, backup capacity and utility owned capacity. The raw EIA861 distributed generation (DG) table (split into three normalized tables in PUDL) was renamed in 2016 to Non-Net Metering to prevent double counting. The data in the Non-Net Metering table (2016+) are split by sector, contain fuel cell information, and convert capacity reported in DC units to AC units. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - backup_capacity_mw - number - The total nameplate capacity of generators that are used only for emergency backup service. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - generators_number - integer - Total number of generators * - pv_current_flow_type - string - Current flow type for photovoltaics: AC or DC * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_owned_capacity_mw - number - Total non-net-metered capacity owned by the respondent. .. _core_eia861__yearly_operational_data_misc: ------------------------------------------------------------------------------- core_eia861__yearly_operational_data_misc ------------------------------------------------------------------------------- The annual megawatt hours (MWH) for all a utility's sources of electricity and disposition of electricity listed. Sources include: net generation purchases from electricity suppliers, exchanges received, exchanges delivered, exchanges net, wheeled recieved, wheeled delivered, wheeled net, transmission by others, and losses. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - consumed_by_facility_mwh - number - The amount of electricity used by the facility. * - consumed_by_respondent_without_charge_mwh - number - The amount of electricity used by the electric utility in its electric and other departments without charge. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - data_observed - boolean - Is the value observed (True) or imputed (False). * - entity_type - string - Entity type of principal owner. * - exchange_energy_delivered_mwh - number - The amount of exchange energy delivered. Does not include power delivered as part of a tolling arrangement. * - exchange_energy_received_mwh - number - The amount of exchange energy received. Does not include power received through tolling arrangements. * - furnished_without_charge_mwh - number - 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. * - nerc_region - string - NERC region in which the plant is located * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - net_power_exchanged_mwh - number - 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. * - net_wheeled_power_mwh - number - 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 delievered). Wheeled net represents the energy losses on the respondent's system associated with the wheeling of energy for other systems. * - report_date - date - Date reported. * - retail_sales_mwh - number - 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. * - sales_for_resale_mwh - number - 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. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - summer_peak_demand_mw - number - 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. * - total_disposition_mwh - number - 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. * - total_energy_losses_mwh - number - The total amount of electricity lost from transmission, distribution, and/or unaccounted for. Should be expressed as a positive number. * - total_sources_mwh - number - 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. * - transmission_by_other_losses_mwh - number - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - wheeled_power_delivered_mwh - number - 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. * - wheeled_power_received_mwh - number - 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. * - wholesale_power_purchases_mwh - number - Purchases from electricity suppliers. * - winter_peak_demand_mw - number - 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. .. _core_eia861__yearly_operational_data_revenue: ------------------------------------------------------------------------------- core_eia861__yearly_operational_data_revenue ------------------------------------------------------------------------------- A utility's revenue by type of electric operating revenue. Includes electric operating revenue From sales to ultimate customers, revenue from unbundled (delivery) customers, revenue from sales for resale, electric credits/other adjustments, revenue from transmission, other electric operating revenue, and total electric operating revenue. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - nerc_region - string - NERC region in which the plant is located * - report_date - date - Date reported. * - revenue - number - Amount of revenue. * - revenue_class - string - Source of revenue: ['credits_or_adjustments', 'delivery_customers', 'other', 'retail_sales', 'sales_for_resale', 'total', 'transmission', 'unbundled'] * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_reliability: ------------------------------------------------------------------------------- core_eia861__yearly_reliability ------------------------------------------------------------------------------- Standardized metrics of electricity system reliability and outage impacts. Includes the system average interruption duration index (SAIDI), system average interruption frequency index (SAIFI), and customer average interruption duration index (CAIDI) aka SAIDI/SAIFI with and without major event days and loss of service. Includes the standard (IEEE/other) and other relevant information. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - caidi_w_major_event_days_minus_loss_of_service_minutes - number - Average number of minutes per interruption (SAIDI/SAIFI) including major event days and excluding reliability events caused by a loss of supply. * - caidi_w_major_event_days_minutes - number - Average number of minutes per interruption (SAIDI/SAIFI) including major event days. * - caidi_wo_major_event_days_minutes - number - Average number of minutes per interruption (SAIDI/SAIFI) excluding major event days. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - entity_type - string - Entity type of principal owner. * - highest_distribution_voltage_kv - number - The highest voltage that's part of the distribution system. * - inactive_accounts_included - boolean - Whether the respondent includes inactive accounts in its definition of customers used to determine SAIDI and SAIFI. * - momentary_interruption_definition - string - How the respondent defines momentary service interruptions: less than 1 min, equal to or less than 5 min, or some other way. * - outages_recorded_automatically - boolean - Whether the information about customer outages is recorded automatically. * - report_date - date - Date reported. * - saidi_w_major_event_days_minus_loss_of_service_minutes - number - 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. * - saidi_w_major_event_days_minutes - number - Cumulative duration (minutes) of interruption for the average customer during the report year including major event days. * - saidi_wo_major_event_days_minutes - number - Cumulative duration (minutes) of interruption for the average customer during the report year excluding major event days. * - saifi_w_major_event_days_customers - number - Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year including major event days. * - saifi_w_major_event_days_minus_loss_of_service_customers - number - 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. * - saifi_wo_major_event_days_customers - number - Average number of times a customer experienced a sustained interruption (over 5 minutes) during the report year excluding major event days. * - short_form - boolean - 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. * - standard - string - Whether the respondent calculates SAIDI/SAIFI, and major event days according to the IEEE or an Other standard. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_sales: ------------------------------------------------------------------------------- core_eia861__yearly_sales ------------------------------------------------------------------------------- Annual electricity sales to ultimate customers broken down by utility, balancing authority, state, and customer class. **The table has the following primary key columns:** * utility_id_eia * state * report_date * balancing_authority_code_eia * customer_class * business_model * service_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - business_model - string - Business model. * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - data_observed - boolean - Is the value observed (True) or imputed (False). * - entity_type - string - Entity type of principal owner. * - report_date - date - Date reported. * - sales_mwh - number - Quantity of electricity sold in MWh. * - sales_revenue - number - Revenue from electricity sold. * - service_type - string - 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. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_service_territory: ------------------------------------------------------------------------------- core_eia861__yearly_service_territory ------------------------------------------------------------------------------- County FIPS codes for counties composing utility service territories. **The table has the following primary key columns:** * report_date * utility_id_eia * county_id_fips `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - county - string - County name. * - county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - report_date - date - Date reported. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - state_id_fips - string - Two digit state FIPS code. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_short_form: ------------------------------------------------------------------------------- core_eia861__yearly_short_form ------------------------------------------------------------------------------- This is data extracted from Form EIA-861S, a shorter version of Form EIA-861. The data started being reported in 2012. However, the 2019 data is not available. They are expected to submit the completed Form EIA-861S to EIA by April 30th, following the end of the prior calendar year. Utilities report on Form EIA-861S if they: - Report less than 200,000 megawatthours on the last previous Form EIA-861. - Provide only bundled service (generation and distribution). - Are not needed to ensure acceptable quality of statistical estimates. - Are not part of the aggregate TVA or WPPI. - Do not report on Form EIA-861M. **The table has the following primary key columns:** * utility_id_eia * state * report_date * balancing_authority_code_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - customers - number - Number of customers. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - entity_type - string - Entity type of principal owner. * - has_demand_side_management - boolean - Whether there were strategies or measures used to control electricity demand by customers * - has_green_pricing - boolean - Whether a green pricing program was associated with this utility during the reporting year. * - has_net_metering - boolean - 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 * - has_time_responsive_programs - boolean - 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). * - report_date - date - Date reported. * - sales_mwh - number - Quantity of electricity sold in MWh. * - sales_revenue - number - Revenue from electricity sold. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia861__yearly_utility_data_misc: ------------------------------------------------------------------------------- core_eia861__yearly_utility_data_misc ------------------------------------------------------------------------------- A table of boolean values indicating what kind of business activities each utility engages in This includes whether they operate alternative fuel vehicles, whether they provide transmission, distribution, or generation services (bundled or unbundled), and whether they engage in wholesale and/or retail markets. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - alternative_fuel_vehicle_2_activity - boolean - Whether the utility plants to operate alternative-fueled vehicles this coming year. * - alternative_fuel_vehicle_activity - boolean - Whether the utility operates alternative-fueled vehicles during the year. * - bundled_activity - boolean - 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. * - buying_distribution_activity - boolean - Whether a utility bought any distribution on other electrical systems during the year. * - buying_transmission_activity - boolean - Whether a utility bought any transmission services on other electrical systems during the year. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - distribution_activity - boolean - Whether a utility engaged in any distribution using owned/leased electrical wires during the year. * - entity_type - string - Entity type of principal owner. * - generation_activity - boolean - Whether a utility utilized generation from company owned plant during the year. * - nerc_region - string - NERC region in which the plant is located * - operates_generating_plant - boolean - Whether the respondent operated at least one generating plant during the reporting period. * - report_date - date - Date reported. * - retail_marketing_activity - boolean - Whether a utility engaged in retail power marketing during the year. * - short_form - boolean - 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. * - state - string - Two letter US state abbreviation. * - transmission_activity - boolean - Whether a utility engaged in any transmission activities during the year. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - wholesale_marketing_activity - boolean - Whether a utility engages in wholesale power marketing during the year. .. _core_eia861__yearly_utility_data_nerc: ------------------------------------------------------------------------------- core_eia861__yearly_utility_data_nerc ------------------------------------------------------------------------------- The NERC regions that a utiltiy operates in. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - nerc_region - string - NERC region in which the plant is located * - nerc_regions_of_operation - string - All the regional entities within the North American Electric Reliability Corporation (NERC) in which the respodent conducts operations. * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia861__yearly_utility_data_rto: ------------------------------------------------------------------------------- core_eia861__yearly_utility_data_rto ------------------------------------------------------------------------------- The RTOs that a utility operates in. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - nerc_region - string - NERC region in which the plant is located * - report_date - date - Date reported. * - rtos_of_operation - string - The ISOs/RTOs, in which the respondent conducts operations. * - state - string - Two letter US state abbreviation. * - utility_id_eia - integer - The EIA Utility Identification number. .. _core_eia923__entity_coalmine: ------------------------------------------------------------------------------- core_eia923__entity_coalmine ------------------------------------------------------------------------------- Attributes of coal mines reporting deliveries in the Fuel Receipts and Costs table, via EIA-923 Schedule 2, Part C. This table is produced during the transformation of fuel delivery data, in order to produce a better normalized database. The same coalmines report many individual deliveries, and repeating their attributes many times in the fuel receipts and costs table is duplicative. Unfortunately the coalmine attributes do not generally use a controlled vocabulary or well defined IDs and so in practice there are many distinct records in this table that correspond to the same mines in reality. We have not yet taken the time to rigorously clean this data, but it could be linked with both Mining Safety and Health Administration (MSHA) and USGS data to provide more insight into where coal is coming from, and what the employment and geological context is for those supplies. **The table has the following primary key columns:** * mine_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - mine_id_msha - integer - MSHA issued mine identifier. * - mine_id_pudl - integer - Dynamically assigned PUDL mine identifier. * - mine_name - string - Coal mine name. * - mine_type_code - string - Type of coal mine. * - state - string - Two letter US state abbreviation. .. _core_eia923__monthly_boiler_fuel: ------------------------------------------------------------------------------- core_eia923__monthly_boiler_fuel ------------------------------------------------------------------------------- EIA-923 Monthly Boiler Fuel Consumption and Emissions, from EIA-923 Schedule 3. Reports the quantity of each type of fuel consumed by each boiler on a monthly basis, as well as the sulfur and ash content of those fuels. Fuel quantity is reported in standard EIA fuel units (tons, barrels, Mcf). Heat content per unit of fuel is also reported, making this table useful for calculating the thermal efficiency (heat rate) of various generation units. This table provides better coverage of the entire fleet of generators than the ``core_eia923__monthly_generation_fuel`` table, but the fuel consumption reported here is not directly associated with a generator. This complicates the heat rate calculation, since the associations between individual boilers and generators are incomplete and can be complex. Note that a small number of respondents only report annual fuel consumption, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * boiler_id * energy_source_code * prime_mover_code * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - boiler_id - string - Alphanumeric boiler ID. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. .. _core_eia923__monthly_energy_storage: ------------------------------------------------------------------------------- core_eia923__monthly_energy_storage ------------------------------------------------------------------------------- EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3. Monthly quantities of energy consumed and discharged ("generated") by energy storage units. The total MWh discharged from the energy storage unit during the reporting period is the gross generation and the difference between gross generation and consumption is the net generation. **The table has the following primary key columns:** * plant_id_eia * report_date * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_for_electricity_units - number - Consumption for electric generation of the fuel type in physical unit. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_units - string - Reported unit of measure for fuel. * - gross_generation_mwh - number - Gross electricity generation for the specified period in megawatt-hours (MWh). * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. .. _core_eia923__monthly_fuel_receipts_costs: ------------------------------------------------------------------------------- core_eia923__monthly_fuel_receipts_costs ------------------------------------------------------------------------------- Data describing fuel deliveries to power plants, reported in EIA-923 Schedule 2, Part A. 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. There can be a significant delay between the receipt of fuel and its consumption, so using this table to infer monthly attributes associated with power generation may not be entirely accurate. However, this is the most granular data we have describing fuel costs, and we use it in calculating the marginal cost of electricity for individual generation units. Under some circumstances utilities are allowed to treat the price of fuel as proprietary business data, meaning it is redacted from the publicly available spreadsheets. It's still reported to EIA and influences the aggregated (state, region, annual, etc.) fuel prices they publish. From 2009-2021 about 1/3 of all prices are redacted. The missing data is not randomly distributed. Deregulated markets dominated by merchant generators (independent power producers) redact much more data, and natural gas is by far the most likely fuel to have its price redacted. This means, for instance, that the entire Northeastern US reports essentially no fine-grained data about its natural gas prices. Additional data which we haven't yet integrated is available in a similar format from 2002-2008 via the EIA-423, and going back as far as 1972 from the FERC-423. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ash_content_pct - number - Ash content percentage by weight to the nearest 0.1 percent. * - chlorine_content_ppm - number - 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. * - contract_expiration_date - date - Date contract expires.Format: MMYY. * - contract_type_code - string - Purchase type under which receipts occurred in the reporting month. C: Contract, NC: New Contract, S: Spot Purchase, T: Tolling Agreement. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_group_code - string - Fuel groups used in the Electric Power Monthly * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_received_units - number - Quanity of fuel received in tons, barrel, or Mcf. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - mercury_content_ppm - number - Mercury content in parts per million (ppm) to the nearest 0.001 ppm. * - mine_id_pudl - integer - Dynamically assigned PUDL mine identifier. * - moisture_content_pct - number - For coal only: the moisture content of the fuel in terms of moisture percentage by weight. Reported to the nearest 0.01 percent. * - natural_gas_delivery_contract_type_code - string - Contract type for natrual gas delivery service: * - natural_gas_transport_code - string - Contract type for natural gas transportation service. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - primary_transportation_mode_code - string - Transportation mode for the longest distance transported. * - report_date - date - Date reported. * - secondary_transportation_mode_code - string - Transportation mode for the second longest distance transported. * - sulfur_content_pct - number - Sulfur content percentage by weight to the nearest 0.01 percent. * - supplier_name - string - Company that sold the fuel to the plant or, in the case of Natural Gas, pipline owner. .. _core_eia923__monthly_generation: ------------------------------------------------------------------------------- core_eia923__monthly_generation ------------------------------------------------------------------------------- EIA-923 Monthly Generating Unit Net Generation. From EIA-923 Schedule 3. Reports the net electricity generated by each reporting generator on a monthly basis. This is the most granular information we have about how much electricity individual generators are producing, but only about half of all the generation reported in the ``core_eia923__monthly_generation_fuel`` appears in this table due to the different reporting requirements imposed on different types and sizes of generators. Whenever possible, we use this generator-level net generation to estimate the heat rates of generation units and the marginal cost of electricity on a per-generator basis, but those calculations depend on plant-level fuel costs and sometimes uncertain or incomplete boiler-generator associations. Note that a small number of respondents only report annual net generation, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. .. _core_eia923__monthly_generation_fuel: ------------------------------------------------------------------------------- core_eia923__monthly_generation_fuel ------------------------------------------------------------------------------- EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3. Monthly electricity generation and fuel consumption reported for each combination of fuel and prime mover within a plant. This data can't be easily linked to individual boilers, generators, and generation units, but it is provides the most complete coverage of fuel consumption and electricity generation for the entire generation fleet. We use the primary fuels and prime movers reported for each generator along with their capacities to attribute fuel consumption and generation when it isn't directly reported in the ``core_eia923__monthly_generation`` and ``core_eia923__monthly_boiler_fuel`` tables in order to calculate capacity factors, heat rates, and the marginal cost of electricity. The table makes a distinction between all fuel consumed and fuel consumed for electricity generation because some units are also combined heat and power (CHP) units, and also provide high temperature process heat at the expense of net electricity generation. Note that a small number of respondents only report annual fuel consumption and net generation, and all of it is reported in December. **The table has the following primary key columns:** * plant_id_eia * report_date * prime_mover_code * energy_source_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_for_electricity_units - number - Consumption for electric generation of the fuel type in physical unit. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_agg - string - 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. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. .. _core_eia923__monthly_generation_fuel_nuclear: ------------------------------------------------------------------------------- core_eia923__monthly_generation_fuel_nuclear ------------------------------------------------------------------------------- EIA-923 Monthly Generation and Fuel Consumption Time Series. From EIA-923 Schedule 3. Monthly electricity generation and fuel consumption reported for each combination of fuel and prime mover within a nuclear generation unit. This data is originally reported alongside similar information for fossil fuel plants, but the nuclear data is reported by (nuclear) generation unit rather than fuel type and prime mover, and so has a different primary key. **The table has the following primary key columns:** * plant_id_eia * report_date * nuclear_unit_id * energy_source_code * prime_mover_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - energy_source_code - string - A 2-3 letter code indicating the energy source (e.g. fuel type) associated with the record. * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - fuel_consumed_for_electricity_units - number - Consumption for electric generation of the fuel type in physical unit. * - fuel_consumed_mmbtu - number - Total consumption of fuel in physical unit, year to date. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_agg - string - 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. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - nuclear_unit_id - string - 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. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. .. _core_eia930__hourly_interchange: ------------------------------------------------------------------------------- core_eia930__hourly_interchange ------------------------------------------------------------------------------- Hourly balancing authority interchange. Interchange is the net metered tie line flow from one BA to another directly interconnected BA. Total net interchange is the net sum of all interchange occurring between a BA and its directly interconnected neighboring BAs. Negative interchange values indicate net inflows, and positive interchange values indicate net outflows. **The table has the following primary key columns:** * datetime_utc * balancing_authority_code_eia * balancing_authority_code_adjacent_eia This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_adjacent_eia - string - EIA short code for the other adjacent balancing authority, with which interchange is occuring. Includes Canadian and Mexican BAs. * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - datetime_utc - datetime - Timestamp at the end of the hour for which the data is reported. * - interchange_reported_mwh - number - Original reported energy interchange between adjacent balancing authorities. .. _core_eia930__hourly_net_generation_by_energy_source: ------------------------------------------------------------------------------- core_eia930__hourly_net_generation_by_energy_source ------------------------------------------------------------------------------- EIA-930 hourly balancing authority net generation by energy source. BAs report generation from dual-fuel (switching from one fuel to another) and multiple-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. To maintain generator confidentiality, generation may sometimes be reported in the Other category if too few generators are reported for a particular energy source category. In 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, there are many cases in which these values diverge significantly, which require further investigation. **The table has the following primary key columns:** * datetime_utc * balancing_authority_code_eia * generation_energy_source This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - datetime_utc - datetime - Timestamp at the end of the hour for which the data is reported. * - generation_energy_source - string - High level energy source used to produce electricity. * - net_generation_adjusted_mwh - number - Reported net generation adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling. * - net_generation_imputed_mwh - number - Reported net generation with outlying values removed and missing values imputed by EIA. * - net_generation_reported_mwh - number - Unaltered originally reported net generation for the specified period. .. _core_eia930__hourly_operations: ------------------------------------------------------------------------------- core_eia930__hourly_operations ------------------------------------------------------------------------------- Hourly balancing authority net generation, interchange, and demand. Net 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. Generators on the distribution system—both large-scale resources and small- scale distributed resources, such as rooftop solar photovoltaic (PV) systems—are typically not included. In some electricity publications, EIA reports generation from all utility- scale generating 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. Interchange is the net metered tie line flow from one BA to another directly interconnected BA. This table includes the net sum of all interchange occurring between a BA all of its directly interconnected neighboring BAs. For a detailed breakdown of interchange between each pair of adjacent BAs see :ref:`core_eia930__hourly_interchange`. Negative interchange values indicate net inflows, and positive interchange values indicate net outflows. Demand 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. Each 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. **The table has the following primary key columns:** * datetime_utc * balancing_authority_code_eia This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - datetime_utc - datetime - Timestamp at the end of the hour for which the data is reported. * - demand_adjusted_mwh - number - Electricity demand adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling. * - demand_forecast_mwh - number - Day ahead demand forecast. * - demand_imputed_mwh - number - Electricity demand calculated by subtracting BA interchange from net generation, with outliers and missing values imputed by EIA. * - demand_reported_mwh - number - Originally reported electricity demand, calculated by taking the net generation within the BA and subtracting the interchange with adjacent BAs. * - interchange_adjusted_mwh - number - Energy interchange between adjacent balancing authorities, adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling. * - interchange_imputed_mwh - number - Energy interchange between adjacent balancing authorities, with outliers and missing values imputed by EIA. * - interchange_reported_mwh - number - Original reported energy interchange between adjacent balancing authorities. * - net_generation_adjusted_mwh - number - Reported net generation adjusted by EIA to reflect non-physical commercial transfers through pseudo-ties and dynamic scheduling. * - net_generation_imputed_mwh - number - Reported net generation with outlying values removed and missing values imputed by EIA. * - net_generation_reported_mwh - number - Unaltered originally reported net generation for the specified period. .. _core_eia930__hourly_subregion_demand: ------------------------------------------------------------------------------- core_eia930__hourly_subregion_demand ------------------------------------------------------------------------------- EIA-930 hourly balancing authority subregion demand. For select BAs, demand by subregion data provide demand at a further level of geographic disaggregation (for example, load zones, weather zones, operating company areas, local BAs, etc.) within a BA's electric system. A BA's reporting demand by subregion section below provides more information on subregions. **The table has the following primary key columns:** * datetime_utc * balancing_authority_code_eia * balancing_authority_subregion_code_eia This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_subregion_code_eia - string - Code identifying subregions of larger balancing authorities. * - datetime_utc - datetime - Timestamp at the end of the hour for which the data is reported. * - demand_reported_mwh - number - Originally reported electricity demand for the balancing area subregion. Note that different BAs have different methods of calculating and allocating subregion demand. .. _core_eia__codes_averaging_periods: ------------------------------------------------------------------------------- core_eia__codes_averaging_periods ------------------------------------------------------------------------------- A coding table describing the averaging period specified by emissions statutes and regulation for in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_balancing_authorities: ------------------------------------------------------------------------------- core_eia__codes_balancing_authorities ------------------------------------------------------------------------------- A coding table describing balancing authorities in EIA-860, EIA-923, and EIA-930 **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_region_code_eia - string - EIA balancing authority region code. * - balancing_authority_region_name_eia - string - Human-readable name of the EIA balancing region. * - balancing_authority_retirement_date - date - Date on which the balancing authority ceased independent operation. * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - is_generation_only - boolean - 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. * - label - string - Longer human-readable code using snake_case * - report_timezone - string - Timezone used by the reporting entity. For use in localizing UTC times. .. _core_eia__codes_balancing_authority_subregions: ------------------------------------------------------------------------------- core_eia__codes_balancing_authority_subregions ------------------------------------------------------------------------------- Details about the balancing authority subregions in EIA-930. **The table has the following primary key columns:** * balancing_authority_code_eia * balancing_authority_subregion_code_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balancing_authority_code_eia - string - EIA short code identifying a balancing authority. May include Canadian and Mexican BAs. * - balancing_authority_subregion_code_eia - string - Code identifying subregions of larger balancing authorities. * - balancing_authority_subregion_name_eia - string - Name of the balancing authority subregion. .. _core_eia__codes_boiler_generator_assn_types: ------------------------------------------------------------------------------- core_eia__codes_boiler_generator_assn_types ------------------------------------------------------------------------------- A coding table describing different types of boiler-generator associations in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_boiler_status: ------------------------------------------------------------------------------- core_eia__codes_boiler_status ------------------------------------------------------------------------------- A coding table describing different types of boiler status in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_boiler_types: ------------------------------------------------------------------------------- core_eia__codes_boiler_types ------------------------------------------------------------------------------- A coding table describing different types of boiler regulatory types in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_coalmine_types: ------------------------------------------------------------------------------- core_eia__codes_coalmine_types ------------------------------------------------------------------------------- A coding table describing different types of coalmines reported as fuel sources in the EIA-923. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_contract_types: ------------------------------------------------------------------------------- core_eia__codes_contract_types ------------------------------------------------------------------------------- A coding table describing the various types of fuel supply contracts reported in EIA-923. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_cooling_system_types: ------------------------------------------------------------------------------- core_eia__codes_cooling_system_types ------------------------------------------------------------------------------- A coding table for cooling system types. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_cooling_tower_types: ------------------------------------------------------------------------------- core_eia__codes_cooling_tower_types ------------------------------------------------------------------------------- A coding table for cooling tower types. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_cooling_water_sources: ------------------------------------------------------------------------------- core_eia__codes_cooling_water_sources ------------------------------------------------------------------------------- A coding table describing different types of cooling water sources in EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_cooling_water_types: ------------------------------------------------------------------------------- core_eia__codes_cooling_water_types ------------------------------------------------------------------------------- A coding table for cooling water types. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_emission_control_equipment_types: ------------------------------------------------------------------------------- core_eia__codes_emission_control_equipment_types ------------------------------------------------------------------------------- A coding table describing the type of emissions control equipment installed on a boiler. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_energy_sources: ------------------------------------------------------------------------------- core_eia__codes_energy_sources ------------------------------------------------------------------------------- Codes and metadata pertaining to energy sources reported to EIA. Compiled from EIA-860 instructions and EIA-923 file layout spreadsheets. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - fuel_derived_from - string - Original fuel from which this refined fuel was derived. * - fuel_group_eia - string - High level fuel group defined in the 2021-2023 EIA Form 860 instructions, Table 28. * - fuel_phase - string - Physical phase of matter of the fuel. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_units - string - Reported unit of measure for fuel. * - label - string - Longer human-readable code using snake_case * - max_fuel_mmbtu_per_unit - number - Maximum heat content per physical unit of fuel in MMBtu. * - min_fuel_mmbtu_per_unit - number - Minimum heat content per physical unit of fuel in MMBtu. .. _core_eia__codes_environmental_equipment_manufacturers: ------------------------------------------------------------------------------- core_eia__codes_environmental_equipment_manufacturers ------------------------------------------------------------------------------- A coding table describing manufacturers of boilers and environmental control equipment in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_firing_types: ------------------------------------------------------------------------------- core_eia__codes_firing_types ------------------------------------------------------------------------------- A coding table describing different boiler firing types in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_fuel_transportation_modes: ------------------------------------------------------------------------------- core_eia__codes_fuel_transportation_modes ------------------------------------------------------------------------------- Long descriptions of the fuel transportation modes reported in the EIA-860 and EIA-923. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_fuel_types_agg: ------------------------------------------------------------------------------- core_eia__codes_fuel_types_agg ------------------------------------------------------------------------------- Descriptive labels for aggregated fuel types used in the Annual Energy Review or Monthly Energy Review. See EIA-923 Fuel Code table for additional information. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. .. _core_eia__codes_mercury_compliance_strategies: ------------------------------------------------------------------------------- core_eia__codes_mercury_compliance_strategies ------------------------------------------------------------------------------- A coding table describing different compliance strategies used to control mercury in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_momentary_interruptions: ------------------------------------------------------------------------------- core_eia__codes_momentary_interruptions ------------------------------------------------------------------------------- A coding table for utility definitions of momentary service interruptions. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_nox_compliance_strategies: ------------------------------------------------------------------------------- core_eia__codes_nox_compliance_strategies ------------------------------------------------------------------------------- A coding table describing different compliance strategies used to control nitrogen oxide in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_nox_control_status: ------------------------------------------------------------------------------- core_eia__codes_nox_control_status ------------------------------------------------------------------------------- A coding table describing the operational status of nitrogen oxide control units associated with boilers in the EIA-860 data. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_nox_units: ------------------------------------------------------------------------------- core_eia__codes_nox_units ------------------------------------------------------------------------------- A coding table describing different units of measurement for nitrogen oxide in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_operational_status: ------------------------------------------------------------------------------- core_eia__codes_operational_status ------------------------------------------------------------------------------- Codes and metadata pertaining to operational status reported to EIA. Compiled from EIA-860 instructions and EIA-923 file layout spreadsheets. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. .. _core_eia__codes_particulate_compliance_strategies: ------------------------------------------------------------------------------- core_eia__codes_particulate_compliance_strategies ------------------------------------------------------------------------------- A coding table describing different compliance strategies used to control particulate matter in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_particulate_units: ------------------------------------------------------------------------------- core_eia__codes_particulate_units ------------------------------------------------------------------------------- A coding table describing different units of measurement for particulate matter in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_prime_movers: ------------------------------------------------------------------------------- core_eia__codes_prime_movers ------------------------------------------------------------------------------- Long descriptions explaining the short prime mover codes reported in the EIA-860 and EIA-923. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_regulations: ------------------------------------------------------------------------------- core_eia__codes_regulations ------------------------------------------------------------------------------- A coding table describing the different levels of statutes and codes under which boilers operate in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_reporting_frequencies: ------------------------------------------------------------------------------- core_eia__codes_reporting_frequencies ------------------------------------------------------------------------------- A coding table describing different types of reporting frequencies in plants in the EIA-923. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_sector_consolidated: ------------------------------------------------------------------------------- core_eia__codes_sector_consolidated ------------------------------------------------------------------------------- Long descriptions for the EIA consolidated NAICS sector codes. Codes and descriptions taken from the EIA-923 File Layout spreadsheet. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_so2_compliance_strategies: ------------------------------------------------------------------------------- core_eia__codes_so2_compliance_strategies ------------------------------------------------------------------------------- A coding table describing different compliance strategies used to control sulfur dioxide in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_so2_units: ------------------------------------------------------------------------------- core_eia__codes_so2_units ------------------------------------------------------------------------------- A coding table describing different units of measurement for sulfur dioxide in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_sorbent_types: ------------------------------------------------------------------------------- core_eia__codes_sorbent_types ------------------------------------------------------------------------------- A coding table describing different flue gas desulfurization sorbent types used in EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_steam_plant_types: ------------------------------------------------------------------------------- core_eia__codes_steam_plant_types ------------------------------------------------------------------------------- A coding table describing different types of steam plants in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_storage_enclosure_types: ------------------------------------------------------------------------------- core_eia__codes_storage_enclosure_types ------------------------------------------------------------------------------- A coding table for energy storage enclosure types. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_storage_technology_types: ------------------------------------------------------------------------------- core_eia__codes_storage_technology_types ------------------------------------------------------------------------------- A coding table for energy storage technology types. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_wet_dry_bottom: ------------------------------------------------------------------------------- core_eia__codes_wet_dry_bottom ------------------------------------------------------------------------------- A coding table describing whether boiler has a wet or dry bottom in the EIA-860. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_eia__codes_wind_quality_class: ------------------------------------------------------------------------------- core_eia__codes_wind_quality_class ------------------------------------------------------------------------------- A coding table for wind quality classes. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - extreme_fifty_year_gust_ms - number - The extreme 50-year wind gusts at this generator in meters per hour. * - label - string - Longer human-readable code using snake_case * - turbulence_intensity_a - number - The upper bounds of the turbulence intensity at the wind site (ratio of standard deviation of fluctuating wind velocity to the mean wind speed). * - turbulence_intensity_b - number - The lower bounds of the turbulence intensity at the wind site (ratio of standard deviation of fluctuating wind velocity to the mean wind speed). * - wind_speed_avg_ms - number - Average wind speed in meters per second. .. _core_eia__entity_boilers: ------------------------------------------------------------------------------- core_eia__entity_boilers ------------------------------------------------------------------------------- Static boiler attributes compiled from the EIA-860 and EIA-923 data. **The table has the following primary key columns:** * plant_id_eia * boiler_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - boiler_id - string - Alphanumeric boiler ID. * - boiler_manufacturer - string - Name of boiler manufacturer. * - boiler_manufacturer_code - string - EIA short code for boiler manufacturer. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. .. _core_eia__entity_generators: ------------------------------------------------------------------------------- core_eia__entity_generators ------------------------------------------------------------------------------- Static generator attributes compiled from across the EIA-860 and EIA-923 data. **The table has the following primary key columns:** * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - associated_combined_heat_power - boolean - Indicates whether the generator is associated with a combined heat and power system * - bypass_heat_recovery - boolean - Can this generator operate while bypassing the heat recovery steam generator? * - duct_burners - boolean - Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas * - fluidized_bed_tech - boolean - Indicates whether the generator uses fluidized bed technology * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_date - date - Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date. * - operating_switch - string - Indicates whether the fuel switching generator can switch when operating * - original_planned_generator_operating_date - date - The date the generator was originally scheduled to be operational * - other_combustion_tech - boolean - Indicates whether the generator uses other combustion technologies * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - previously_canceled - boolean - Indicates whether the generator was previously reported as indefinitely postponed or canceled * - pulverized_coal_tech - boolean - Indicates whether the generator uses pulverized coal technology * - rto_iso_lmp_node_id - string - The designation used to identify the price node in RTO/ISO Locational Marginal Price reports * - rto_iso_location_wholesale_reporting_id - string - The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report * - solid_fuel_gasification - boolean - Indicates whether the generator is part of a solid fuel gasification system * - stoker_tech - boolean - Indicates whether the generator uses stoker technology * - subcritical_tech - boolean - Indicates whether the generator uses subcritical technology * - supercritical_tech - boolean - Indicates whether the generator uses supercritical technology * - topping_bottoming_code - string - 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 * - ultrasupercritical_tech - boolean - Indicates whether the generator uses ultra-supercritical technology .. _core_eia__entity_plants: ------------------------------------------------------------------------------- core_eia__entity_plants ------------------------------------------------------------------------------- Static plant attributes, compiled from across all EIA-860 and EIA-923 data. **The table has the following primary key columns:** * plant_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - city - string - Name of the city. * - county - string - County name. * - latitude - number - Latitude of the plant's location, in degrees. * - longitude - number - Longitude of the plant's location, in degrees. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_name_eia - string - Plant name. * - state - string - Two letter US state abbreviation. * - street_address - string - Physical street address. * - timezone - string - IANA timezone name * - zip_code - string - Five digit US Zip Code. .. _core_eia__entity_utilities: ------------------------------------------------------------------------------- core_eia__entity_utilities ------------------------------------------------------------------------------- Static attributes of utilities, compiled from all EIA data. **The table has the following primary key columns:** * utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. .. _core_eia__yearly_fuel_receipts_costs_aggs: ------------------------------------------------------------------------------- core_eia__yearly_fuel_receipts_costs_aggs ------------------------------------------------------------------------------- Aggregated fuel receipts and costs from the EIA bulk electricty data. **The table has the following primary key columns:** * fuel_agg * geo_agg * sector_agg * temporal_agg * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_agg - string - Category of fuel aggregation in EIA bulk electricity data. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_received_mmbtu - number - Aggregated fuel receipts, in MMBtu, in EIA bulk electricity data. * - geo_agg - string - Category of geographic aggregation in EIA bulk electricity data. * - report_date - date - Date reported. * - sector_agg - string - Category of sectoral aggregation in EIA bulk electricity data. * - temporal_agg - string - Category of temporal aggregation in EIA bulk electricity data. .. _core_eiaaeo__yearly_projected_electric_sales: ------------------------------------------------------------------------------- core_eiaaeo__yearly_projected_electric_sales ------------------------------------------------------------------------------- Projected electricity sales by region and customer class. **The table has the following primary key columns:** * report_year * electricity_market_module_region_eiaaeo * model_case_eiaaeo * projection_year * customer_class `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - customer_class - string - High level categorization of customer type: ['commercial', 'industrial', 'direct_connection', 'other', 'residential', 'total', 'transportation', 'commercial_other']. * - electricity_market_module_region_eiaaeo - string - AEO projection region. * - model_case_eiaaeo - string - Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details. * - projection_year - integer - The year of the projected value. * - report_year - integer - Four-digit year in which the data was reported. * - sales_mwh - number - Quantity of electricity sold in MWh. .. _core_eiaaeo__yearly_projected_fuel_cost_in_electric_sector_by_type: ------------------------------------------------------------------------------- core_eiaaeo__yearly_projected_fuel_cost_in_electric_sector_by_type ------------------------------------------------------------------------------- Projected fuel prices for the electric power sector, including electricity- only and combined-heat-and-power plants that have a regulatory status. **The table has the following primary key columns:** * report_year * electricity_market_module_region_eiaaeo * model_case_eiaaeo * projection_year * fuel_type_eiaaeo `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - electricity_market_module_region_eiaaeo - string - AEO projection region. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_real_per_mmbtu_eiaaeo - number - 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``. * - fuel_type_eiaaeo - string - Fuel type reported for AEO end-use sector generation data. * - model_case_eiaaeo - string - Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details. * - projection_year - integer - The year of the projected value. * - real_cost_basis_year - integer - Four-digit year which is the basis for any 'real cost' monetary values (as opposed to nominal values). * - report_year - integer - Four-digit year in which the data was reported. .. _core_eiaaeo__yearly_projected_generation_in_electric_sector_by_technology: ------------------------------------------------------------------------------- core_eiaaeo__yearly_projected_generation_in_electric_sector_by_technology ------------------------------------------------------------------------------- Projected generation capacity & total generation in the electric sector, broken out by technology. **The table has the following primary key columns:** * report_year * electricity_market_module_region_eiaaeo * model_case_eiaaeo * projection_year * technology_description_eiaaeo `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - electricity_market_module_region_eiaaeo - string - AEO projection region. * - gross_generation_mwh - number - Gross electricity generation for the specified period in megawatt-hours (MWh). * - model_case_eiaaeo - string - Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details. * - projection_year - integer - The year of the projected value. * - report_year - integer - Four-digit year in which the data was reported. * - summer_capacity_mw - number - The net summer capacity. * - summer_capacity_planned_additions_mw - number - The total planned additions to net summer generating capacity. * - summer_capacity_retirements_mw - number - The total retirements from net summer generating capacity. * - summer_capacity_unplanned_additions_mw - number - The total unplanned additions to net summer generating capacity. * - technology_description_eiaaeo - string - Generation technology reported for AEO. .. _core_eiaaeo__yearly_projected_generation_in_end_use_sectors_by_fuel_type: ------------------------------------------------------------------------------- core_eiaaeo__yearly_projected_generation_in_end_use_sectors_by_fuel_type ------------------------------------------------------------------------------- Projected generation capacity and total generation in the end-use sector, broken out by fuel type. Includes combined-heat-and-power plants and electricity-only plants in the commercial and industrial sectors; and small on-site generating systems in the residential, commercial, and industrial sectors used primarily for own-use generation, but which may also sell some power to the grid. Solar photovoltaic capacity portion of Renewable Sources in megawatts direct current; other technologies in megawatts alternating current. **The table has the following primary key columns:** * report_year * electricity_market_module_region_eiaaeo * model_case_eiaaeo * projection_year * fuel_type_eiaaeo `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - electricity_market_module_region_eiaaeo - string - AEO projection region. * - fuel_type_eiaaeo - string - Fuel type reported for AEO end-use sector generation data. * - gross_generation_mwh - number - Gross electricity generation for the specified period in megawatt-hours (MWh). * - model_case_eiaaeo - string - Factors such as economic growth, future oil prices, the ultimate size of domestic energy resources, and technological change are often uncertain. To illustrate some of these uncertainties, EIA runs side cases to show how the model responds to changes in key input variables compared with the Reference case. See https://www.eia.gov/outlooks/aeo/assumptions/case_descriptions.php for more details. * - projection_year - integer - The year of the projected value. * - report_year - integer - Four-digit year in which the data was reported. * - summer_capacity_mw - number - The net summer capacity. .. _core_epa__assn_eia_epacamd: ------------------------------------------------------------------------------- core_epa__assn_eia_epacamd ------------------------------------------------------------------------------- This crosswalk table comes from the EPA's Github repo camd-eia-crosswalk: https://github.com/USEPA/camd-eia-crosswalk. It's purpose is to connect EPA units with EIA plants, boilers, and generators. The camd-eia-crosswalk README and our Data Source documentation page on :doc:`../data_sources/epacems` depict the complicated relationship between EIA and EPA data, specifically the nature of EPA vs. EIA "units" and the level of granularity that one can connect the two sources. The crosswalk table is generated using EIA data from 2018 meaning that any plants that have shifted before or since then aren't accurately reflected in the data. We're hoping to create a temporal version of the crosswalk at some point. Our version of the crosswalk clarifies some of the column names and removes unmatched rows. The :func:`pudl.etl.glue_assets.core_epa__assn_eia_epacamd` function doc strings explain what changes are made from the EPA's version. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - boiler_id - string - Alphanumeric boiler ID. * - emissions_unit_id_epa - string - Emissions (smokestack) unit monitored by EPA CEMS. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_id_epa - string - Generator ID used by the EPA. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_epa - integer - The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia. * - report_year - integer - Four-digit year in which the data was reported. .. _core_epa__assn_eia_epacamd_subplant_ids: ------------------------------------------------------------------------------- core_epa__assn_eia_epacamd_subplant_ids ------------------------------------------------------------------------------- This table is an augmented version of the core_epa__assn_eia_epacamd crosswalk table which initally comes from the EPA's Github repo camd-eia- crosswalk: https://github.com/USEPA/camd-eia-crosswalk. It's purpose is to connect EPA units with EIA units, and generators. This table identifies subplants within plant_ids, which are the smallest coherent units for aggregation. plant_id refers to a legal entity that often contains multiple distinct power plants, even of different technology or fuel types. EPA CEMS data combines information from several parts of a power plant: * emissions from smokestacks * fuel use from combustors * electricty production from generators But smokestacks, combustors, and generators can be connected in complex, many- to-many relationships. This complexity makes attribution difficult for, as an example, allocating pollution to energy producers. Furthermore, heterogeneity within plant_ids make aggregation to the parent entity difficult or inappropriate. This table inherits from the EPA's crosswalk, the ID's from EPA CAMD core_epacems__hourly_emissions table itself, the core_eia860__assn_boiler_generator table and the core_eia860__scd_generators table. While the core_epa__assn_eia_epacamd table is the core backbone of the table, EPA CAMD id's ensure there is complete coverage of EPA CAMD reporting units. The EIA 860 table addition ensures there is also complete coverage of those units as well. For more information about the how this subplant_id is made, see the documentation for pudl.etl.glue_assets.make_subplant_ids and pudl.etl.glue_assets.update_subplant_ids from: https://catalystcoop-pudl.readthedocs.io/en/nightly/autoapi/index.html But by analyzing the relationships between combustors and generators, as provided in the core_epa__assn_eia_epacamd crosswalk, we can identify distinct power plants. These are the smallest coherent units of aggregation. This table does not have primary keys because 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 because ~2 percent of all EPA CAMD records are not successfully mapped to EIA generators. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - emissions_unit_id_epa - string - Emissions (smokestack) unit monitored by EPA CEMS. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_epa - integer - The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia. * - subplant_id - integer - Sub-plant ID links EPA CEMS emissions units to EIA units. * - unit_id_pudl - integer - 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. .. _core_epacems__hourly_emissions: ------------------------------------------------------------------------------- core_epacems__hourly_emissions ------------------------------------------------------------------------------- Hourly emissions and plant operational data reported via Continuous Emissions Monitoring Systems as required by 40 CFR Part 75. **The table has the following primary key columns:** * plant_id_epa * emissions_unit_id_epa * operating_datetime_utc This table is not published to Datasette. .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - co2_mass_measurement_code - string - Identifies whether the reported value of emissions was measured, calculated, or measured and substitute. * - co2_mass_tons - number - Carbon dioxide emissions in short tons. * - emissions_unit_id_epa - string - Emissions (smokestack) unit monitored by EPA CEMS. * - gross_load_mw - number - Average power in megawatts delivered during time interval measured. * - heat_content_mmbtu - number - The energy contained in fuel burned, measured in million BTU. * - nox_mass_lbs - number - NOx emissions in pounds. * - nox_mass_measurement_code - string - Identifies whether the reported value of emissions was measured, calculated, or measured and substitute. * - operating_datetime_utc - datetime - Date and time measurement began (UTC). * - operating_time_hours - number - Length of time interval measured. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_epa - integer - The ORISPL ID used by EPA to refer to the plant. Usually but not always the same as plant_id_eia. * - so2_mass_lbs - number - Sulfur dioxide emissions in pounds. * - so2_mass_measurement_code - string - Identifies whether the reported value of emissions was measured, calculated, or measured and substitute. * - state - string - Two letter US state abbreviation. * - steam_load_1000_lbs - number - Total steam pressure produced by a unit during the reported hour. * - year - integer - Year the data was reported in, used for partitioning EPA CEMS. .. _core_ferc1__codes_power_purchase_types: ------------------------------------------------------------------------------- core_ferc1__codes_power_purchase_types ------------------------------------------------------------------------------- Coding table defining different types of electricity power purchases. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. * - label - string - Longer human-readable code using snake_case .. _core_ferc1__yearly_balance_sheet_assets_sched110: ------------------------------------------------------------------------------- core_ferc1__yearly_balance_sheet_assets_sched110 ------------------------------------------------------------------------------- Comparative Balance Sheet (Assets and Other Debits). Schedule 110. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * asset_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_type - string - Type of asset being reported to the core_ferc1__yearly_balance_sheet_assets_sched110 table. * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_balance_sheet_liabilities_sched110: ------------------------------------------------------------------------------- core_ferc1__yearly_balance_sheet_liabilities_sched110 ------------------------------------------------------------------------------- Comparative balance sheet (liabilities and other credits) **The table has the following primary key columns:** * utility_id_ferc1 * report_year * liability_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - liability_type - string - Type of liability being reported to the core_ferc1__yearly_balance_sheet_liabilities_sched110 table. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_cash_flows_sched120: ------------------------------------------------------------------------------- core_ferc1__yearly_cash_flows_sched120 ------------------------------------------------------------------------------- The structured portion of the FERC1 cash flow table - Schedule 120. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * amount_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - amount - number - Reported amount of dollars. This could be a balance or a change in value. * - amount_type - string - Label describing the type of amount being reported. This could be a balance or a change in value. * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_depreciation_by_function_sched219: ------------------------------------------------------------------------------- core_ferc1__yearly_depreciation_by_function_sched219 ------------------------------------------------------------------------------- Accumulated provision for depreciation of electric utility plant (Account 108). Schedule 219 Section B: Functional plant classifications. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * depreciation_type * plant_function * plant_status * utility_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - depreciation_type - string - Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc. * - ending_balance - number - Account balance at end of year. * - plant_function - string - Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.). * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_depreciation_changes_sched219: ------------------------------------------------------------------------------- core_ferc1__yearly_depreciation_changes_sched219 ------------------------------------------------------------------------------- Accumulated provision for depreciation of electric utility plant (Account 108). Schedule 219 Section A: balances and changes during year. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * depreciation_type * plant_status * utility_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - depreciation_type - string - Type of depreciation provision within FERC Account 108, including cost ofremoval, depreciation expenses, salvage, cost of retired plant, etc. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - 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. * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_depreciation_summary_sched336: ------------------------------------------------------------------------------- core_ferc1__yearly_depreciation_summary_sched336 ------------------------------------------------------------------------------- Depreciation and Amortization of Electric Plant (Account 403, 404, 405) Section A: Summary of depreciation and amortization changes. Schedule 336a of FERC Form 1. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * plant_function * ferc_account_label `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting. * - ferc_account_label - string - Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts. * - plant_function - string - Functional role played by utility plant (steam production, nuclear production, distribution, transmission, etc.). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_energy_dispositions_sched401: ------------------------------------------------------------------------------- core_ferc1__yearly_energy_dispositions_sched401 ------------------------------------------------------------------------------- Electric Energy Account, dispositions only. Schedule 401a. Electricity utilities delived to end users, internal losses, etc. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * energy_disposition_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_disposition_type - string - 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. * - energy_mwh - number - Sources and uses of energy in MWh. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_energy_sources_sched401: ------------------------------------------------------------------------------- core_ferc1__yearly_energy_sources_sched401 ------------------------------------------------------------------------------- Electric Energy Account, sources only. Schedule 401a. Amount of electricity the utility obtained from each of several sources, by year. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * energy_source_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - energy_mwh - number - Sources and uses of energy in MWh. * - energy_source_type - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_hydroelectric_plants_sched406: ------------------------------------------------------------------------------- core_ferc1__yearly_hydroelectric_plants_sched406 ------------------------------------------------------------------------------- Hydroelectric generating plant statistics for large plants. Large plants have an installed nameplate capacity of more than 10 MW. As reported on FERC Form 1, Schedule 406 (pages 406-407), and extracted from the f1_hydro table in FERC's FoxPro database. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_equipment - number - Cost of plant: equipment (USD). * - capex_facilities - number - Cost of plant: reservoirs, dams, and waterways (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_roads - number - Cost of plant: roads, railroads, and bridges (USD). * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_capacity_adverse_conditions_mw - number - Net plant capability under the least favorable operating conditions, in megawatts. * - net_capacity_favorable_conditions_mw - number - Net plant capability under the most favorable operating conditions, in megawatts. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - opex_dams - number - Production expenses: maintenance of reservoirs, dams, and waterways (USD). * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_generation_misc - number - Production expenses: miscellaneous power generation expenses (USD). * - opex_hydraulic - number - Production expenses: hydraulic expenses (USD). * - opex_misc_plant - number - Production expenses: maintenance of miscellaneous hydraulic plant (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plant - number - Production expenses: maintenance of electric plant (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_water_for_power - number - Production expenses: water for power (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - project_num - integer - FERC Licensed Project Number. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_income_statements_sched114: ------------------------------------------------------------------------------- core_ferc1__yearly_income_statements_sched114 ------------------------------------------------------------------------------- Statement of Income. Schedule 114. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * utility_type * income_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - 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. * - income_type - string - Type of income reported in core_ferc1__yearly_income_statements_sched114 table. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_operating_expenses_sched320: ------------------------------------------------------------------------------- core_ferc1__yearly_operating_expenses_sched320 ------------------------------------------------------------------------------- Operating and maintenance costs associated with producing electricty, reported in Schedule 320 of FERC Form 1. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * expense_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - expense_type - string - The type of expense. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_operating_revenues_sched300: ------------------------------------------------------------------------------- core_ferc1__yearly_operating_revenues_sched300 ------------------------------------------------------------------------------- Electric operating revenues - The structed 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. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * revenue_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - avg_customers_per_month - number - Average number of customers per month. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - revenue_type - string - Label describing types of revenues. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - sales_mwh - number - Quantity of electricity sold in MWh. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_other_regulatory_liabilities_sched278: ------------------------------------------------------------------------------- core_ferc1__yearly_other_regulatory_liabilities_sched278 ------------------------------------------------------------------------------- Other regulatory liabilities, including rate order docket number. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - account_detail - string - Description of the account number credited from making debit adjustment to other regulatory liabilities. * - decrease_in_other_regulatory_liabilities - number - The decrease during the reporting period of other regulatory liabilities. * - description - string - Long human-readable description of the meaning of a code/label. * - ending_balance - number - Account balance at end of year. * - increase_in_other_regulatory_liabilities - number - The increase during the reporting period of other regulatory liabilities. * - report_year - integer - Four-digit year in which the data was reported. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_plant_in_service_sched204: ------------------------------------------------------------------------------- core_ferc1__yearly_plant_in_service_sched204 ------------------------------------------------------------------------------- Balances and changes to FERC Electric Plant in Service accounts, as reported on FERC Form 1, Schedule 204. Data originally from the f1_plant_in_srvce table in FERC's FoxPro database. Account numbers correspond to the FERC Uniform System of Accounts for Electric Plant, which is defined in Code of Federal Regulations (CFR) Title 18, Chapter I, Subchapter C, Part 101. (See e.g. https://www.law.cornell.edu/cfr/text/18/part-101). Each FERC respondent reports starting and ending balances for each account annually. Balances are organization wide, and are not broken down on a per-plant basis. End of year balance should equal beginning year balance plus the sum of additions, retirements, adjustments, and transfers. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * ferc_account_label `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - additions - number - Cost of acquisition of items classified within the account. * - adjustments - number - Cost of adjustments to the account. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - Actual FERC Account number (e.g. '359.1') if available, or a PUDL assigned ID when FERC accounts have been split or combined in reporting. * - ferc_account_label - string - Long FERC account identifier derived from values reported in the XBRL taxonomies. May also refer to aggregations of individual FERC accounts. * - plant_status - string - Utility plant financial status (in service, future, leased, total). * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - retirements - number - Cost of disposal of items classified within the account. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - transfers - number - Cost of transfers into (out of) the account. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_pumped_storage_plants_sched408: ------------------------------------------------------------------------------- core_ferc1__yearly_pumped_storage_plants_sched408 ------------------------------------------------------------------------------- Generating plant statistics for hydroelectric pumped storage plants with an installed nameplate capacity of 10+ MW. As reported in Scheudle 408 of FERC Form 1 and extracted from the f1_pumped_storage table in FERC's Visual FoxPro Database. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_equipment_electric - number - Cost of plant: accessory electric equipment (USD). * - capex_equipment_misc - number - Cost of plant: miscellaneous power plant equipment (USD). * - capex_facilities - number - Cost of plant: reservoirs, dams, and waterways (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_roads - number - Cost of plant: roads, railroads, and bridges (USD). * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - capex_wheels_turbines_generators - number - Cost of plant: water wheels, turbines, and generators (USD). * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - energy_used_for_pumping_mwh - number - Energy used for pumping, in megawatt-hours. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - net_load_mwh - number - Net output for load (net generation - energy used for pumping) in megawatt-hours. * - opex_dams - number - Production expenses: maintenance of reservoirs, dams, and waterways (USD). * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_generation_misc - number - Production expenses: miscellaneous power generation expenses (USD). * - opex_misc_plant - number - Production expenses: maintenance of miscellaneous hydraulic plant (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plant - number - Production expenses: maintenance of electric plant (USD). * - opex_production_before_pumping - number - Total production expenses before pumping (USD). * - opex_pumped_storage - number - Production expenses: pumped storage (USD). * - opex_pumping - number - Production expenses: We are here to PUMP YOU UP! (USD). * - opex_rents - number - Production expenses: rents (USD). * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_total - number - Total production expenses, excluding fuel (USD). * - opex_water_for_power - number - Production expenses: water for power (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_capability_mw - number - Net plant capability in megawatts. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - project_num - integer - FERC Licensed Project Number. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_purchased_power_and_exchanges_sched326: ------------------------------------------------------------------------------- core_ferc1__yearly_purchased_power_and_exchanges_sched326 ------------------------------------------------------------------------------- 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. Reported on pages 326-327 of FERC Form 1. Extracted from the f1_purchased_pwr table in FERC's Visual FoxPro database. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - billing_demand_mw - number - Monthly average billing demand (for requirements purchases, and any transactions involving demand charges). In megawatts. * - coincident_peak_demand_mw - number - Average monthly coincident peak (CP) demand (for requirements purchases, and any transactions involving demand charges). Monthly CP demand is the metered demand during the hour (60-minute integration) in which the supplier's system reaches its monthly peak. In megawatts. * - delivered_mwh - number - Gross megawatt-hours delivered in power exchanges and used as the basis for settlement. * - demand_charges - number - Demand charges (USD). * - energy_charges - number - Energy charges (USD). * - non_coincident_peak_demand_mw - number - Average monthly non-coincident peak (NCP) demand (for requirements purhcases, and any transactions involving demand charges). Monthly NCP demand is the maximum metered hourly (60-minute integration) demand in a month. In megawatts. * - other_charges - number - Other charges, including out-of-period adjustments (USD). * - purchase_type_code - string - Categorization based on the original contractual terms and conditions of the service. Must be one of 'requirements', 'long_firm', 'intermediate_firm', 'short_firm', 'long_unit', 'intermediate_unit', 'electricity_exchange', 'other_service', or 'adjustment'. Requirements service is ongoing high reliability service, with load integrated into system resource planning. 'Long term' means 5+ years. 'Intermediate term' is 1-5 years. 'Short term' is less than 1 year. 'Firm' means not interruptible for economic reasons. 'unit' indicates service from a particular designated generating unit. 'exchange' is an in-kind transaction. * - purchased_mwh - number - Megawatt-hours shown on bills rendered to the respondent. Includes both electricity purchased for storage and non-storage purposes, which were lumped together prior to 2021. * - purchased_other_than_storage_mwh - number - Number of megawatt hours purchased during the period for other than energy storage. * - purchased_storage_mwh - number - Number of megawatt hours purchased during the period for energy storage. * - received_mwh - number - Gross megawatt-hours received in power exchanges and used as the basis for settlement. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - seller_name - string - Name of the seller, or the other party in an exchange transaction. * - tariff - string - FERC Rate Schedule Number or Tariff. (Note: may be incomplete if originally reported on multiple lines.) * - total_settlement - number - 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. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_retained_earnings_sched118: ------------------------------------------------------------------------------- core_ferc1__yearly_retained_earnings_sched118 ------------------------------------------------------------------------------- Retained Earnings - The structed part of schedule 118. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * earnings_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - balance - string - Indication of whether a column is a credit or debit, as reported in the XBRL taxonomy. * - earnings_type - string - Label describing types of earnings. * - ending_balance - number - Account balance at end of year. * - ferc_account - string - 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. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - starting_balance - number - Account balance at beginning of year. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. .. _core_ferc1__yearly_sales_by_rate_schedules_sched304: ------------------------------------------------------------------------------- core_ferc1__yearly_sales_by_rate_schedules_sched304 ------------------------------------------------------------------------------- The pre-2021 data in this table (extracted from FoxProDB vs. XBRL) is extremely unstructured. Where the post-2020 data (from XBRL) sorts the data into rate schedule types: residential, industrial, commercial, public_lighting, public_authorities, railroads, interdepartmental, provision_for_rate_refund, commercial_and_industrial, total, and billing status: billed, unbilled, total, the pre-2021 data stuffs all of that information (if you're lucky) into the rate_schedule_description column. There's no point trying to parse through the pre 2021 rate_schedule_description column en masse because it's just too messy. The contents of rate_schedule_description often contain numbers and acronyms that have little to no meaning out of context. The table is structured somewhat like the FERC1 small generators table with headings about rate structure type also embedded into the rate_schedule_description column. To all who dare, beware. This table is a combination of one pre-2021 (DBF) table and nine post-2020 (XBRL) tables--one for each rate schedule type plus totals--hence increase in data clarity post-2020. The rate_schedule_type and billing_status columns are only relevant for post-2020 data as they can be reliably parsed from each of the tables and incorporated into columns. The rate_schedule_description is supposed to contain sub-rate_schedule_type names for charges (Ex: Residential 1, Residential 2, etc.). However, the pre-2021 data contains a little bit of everything (or nothing) and the post-2020 has some totals or wonky data thrown in. That's to say, even when working with post-2020 data, be wary of aggregating the data. That's what the "total" rows are for. The values that come from from the totals table are marked with the string "total" in the rate_schedule_description column. The totals table is a product of the transition to XBRL, so these distinguishable totals are only available for data post-2020 (otherwise you could try keyword searching for "total" in rate_schedule_description). The total table contains two types of totals, the utility totals accross all rate schedules in a given year (marked with rate_schedule_description = "total" and rate_schedule_type = "total") and each of the utility's individual rate schedule totals in a given year (marked with rate_schedule_description = "total" and rate_schdedule_type = "residential" or any other rate schdedule type). The rate schedule based XBRL tables only report billed values whereas the total tables report billed, unbilled, and total values. (See the column description for more info on the difference between billed and unbilled). This is important to consider if you're endeavoring to compare the subtotal values with the total values. We have not attempted to fix or verify any subtotals or totals that don't add up. Another important note is the possability of unit discrepancies in certain columns. The revenue_per_kwh column does not specify reporting units, and closer inspection of the data reveals two clear peaks approximate two orders of magnitude appart. This indicates that values may be reported in both dollars and cents. However, because the price of energy per kwh varies so much regionally, we cannot guarantee which is which and have not put any cleaning mechanisms in place to account for this. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - avg_customers_per_month - number - Average number of customers per month. * - billing_status - string - 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. * - dollar_value - number - Dollar value of reported income, expense, asset, or liability. * - kwh_per_customer - number - kWh per customer. * - rate_schedule_description - string - Free-form description of what the rate schedule name is. Not standardized. Often a sub-category of rate_schedule_type. * - rate_schedule_type - string - Categorization of rate schedule type. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - revenue_per_kwh - number - The amount of revenue per kWh by rate schedule aquired in the given report year. * - sales_mwh - number - Quantity of electricity sold in MWh. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_small_plants_sched410: ------------------------------------------------------------------------------- core_ferc1__yearly_small_plants_sched410 ------------------------------------------------------------------------------- The generating 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. As reported on FERC Form 1 Schedule 410 (pages 410-411) and extracted from the FERC Visual FoxPro and XBRL. See our ``pudl.extract.ferc1.TABLE_NAME_MAP_FERC1`` for links to the raw tables. The raw version of this table is more like a digitized PDF than an actual data table. The rows contain lots of information in addition to what the columns might suggest. For instance, a single column may contain header rows, note rows, and total rows. This extraneous information is useful, but it prevents proper analysis when mixed in with the rest of the values data in the column. We employ a couple of data transformations to extract these rows from the data and preserve some of the information they contain (fuel type, plant type, FERC license, or general notes about the plant) in separate columns. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_total - number - Total cost of plant (USD). * - construction_year - integer - Year the plant's oldest still operational unit was built. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_type - string - Type of fuel. * - license_id_ferc1 - integer - FERC issued operating license ID for the facility, if available. This value is extracted from the original plant name where possible. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - opex_fuel - number - Production expenses: fuel (USD). * - opex_maintenance - number - Production expenses: Maintenance (USD). * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_steam_plants_fuel_sched402: ------------------------------------------------------------------------------- core_ferc1__yearly_steam_plants_fuel_sched402 ------------------------------------------------------------------------------- Annual 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. As reported on page 402 of FERC Form 1 and extracted from the f1_fuel table in FERC's FoxPro Database. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_consumed_units - number - Consumption of the fuel type in physical unit. Note: this is the total quantity consumed for both electricity and, in the case of combined heat and power plants, process steam production. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_unit_burned - number - Average cost of fuel consumed in the report year per reported fuel unit (USD). * - fuel_cost_per_unit_delivered - number - Average cost of fuel delivered in the report year per reported fuel unit (USD). * - fuel_mmbtu_per_unit - number - Heat content of the fuel in millions of Btus per physical unit. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_units - string - Reported unit of measure for fuel. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_steam_plants_sched402: ------------------------------------------------------------------------------- core_ferc1__yearly_steam_plants_sched402 ------------------------------------------------------------------------------- Generating plant statistics for steam plants with a capacity of 25+ MW, internal combustion and gas-turbine plants of 10+ MW, and all nuclear plants. As reported in Schedule 402 of FERC Form 1 and extracted from the f1_gnrt_plant table in FERC's Visual FoxPro Database. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - asset_retirement_cost - number - Asset retirement cost (USD). * - avg_num_employees - number - The average number of employees assigned to each plant. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - capex_equipment - number - Cost of plant: equipment (USD). * - capex_land - number - Cost of plant: land and land rights (USD). * - capex_per_mw - number - Cost of plant per megawatt of installed (nameplate) capacity. Nominal USD. * - capex_structures - number - Cost of plant: structures and improvements (USD). * - capex_total - number - Total cost of plant (USD). * - construction_type - string - Type of plant construction ('outdoor', 'semioutdoor', or 'conventional'). Categorized by PUDL based on our best guess of intended value in FERC1 freeform strings. * - construction_year - integer - Year the plant's oldest still operational unit was built. * - installation_year - integer - Year the plant's most recently built unit was installed. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - not_water_limited_capacity_mw - number - Plant capacity in MW when not limited by condenser water. * - opex_allowances - number - Allowances. * - opex_boiler - number - Maintenance of boiler (or reactor) plant. * - opex_coolants - number - Cost of coolants and water (nuclear plants only) * - opex_electric - number - Production expenses: electric expenses (USD). * - opex_engineering - number - Production expenses: maintenance, supervision, and engineering (USD). * - opex_fuel - number - Production expenses: fuel (USD). * - opex_misc_power - number - Miscellaneous steam (or nuclear) expenses. * - opex_misc_steam - number - Maintenance of miscellaneous steam (or nuclear) plant. * - opex_operations - number - Production expenses: operations, supervision, and engineering (USD). * - opex_per_mwh - number - Total production expenses (USD per MWh generated). * - opex_plants - number - Maintenance of electrical plant. * - opex_production_total - number - Total operating expenses. * - opex_rents - number - Production expenses: rents (USD). * - opex_steam - number - Steam expenses. * - opex_steam_other - number - Steam from other sources. * - opex_structures - number - Production expenses: maintenance of structures (USD). * - opex_transfer - number - Steam transferred (Credit). * - peak_demand_mw - number - Net peak demand for 60 minutes. Note: in some cases peak demand for other time periods may have been reported instead, if hourly peak demand was unavailable. * - plant_capability_mw - number - Net plant capability in megawatts. * - plant_hours_connected_while_generating - number - Hours the plant was connected to load while generating in the report year. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - plant_type - string - Type of plant. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - utility_id_ferc1 - integer - 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. * - water_limited_capacity_mw - number - Plant capacity in MW when limited by condenser water. .. _core_ferc1__yearly_transmission_lines_sched422: ------------------------------------------------------------------------------- core_ferc1__yearly_transmission_lines_sched422 ------------------------------------------------------------------------------- Transmission Line Statistics. Schedule 422 of FERC Form 1. Information describing transmission lines, the cost of lines, annual operating and capital expenses, etc. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capex_land - number - Cost of Land and land rights for the transmission line. * - capex_other - number - Construction and other costs for the transmission line. * - capex_total - number - Total costs for the transmission line. * - conductor_size_and_material - string - Size of transmission conductor and material of the transmission line. * - designed_voltage_kv - number - Manufactured (Designed) voltage, expressed in kilo-volts, for three-phase 60 cycle alternative current transmission lines * - end_point - string - The end point of a transmission line. * - num_transmission_circuits - integer - Number of circuits in a transmission line. * - operating_voltage_kv - number - The operating voltage, expressed kilo-volts, for three-phase 60 cycle alternative current transmission lines. * - opex_maintenance - number - Maintenance expenses for the transmission line. * - opex_operations - number - Operating expenses for the transmission line. * - opex_rents - number - Rent expenses for the transmission line. * - opex_total - number - Overall expenses for the transmission line. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - start_point - string - The starting point of a transmission line. * - supporting_structure_type - string - Supporting structure of the transmission line. * - transmission_line_and_structures_length_miles - number - 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). * - transmission_line_length_miles - number - 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). * - utility_id_ferc1 - integer - 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. .. _core_ferc1__yearly_utility_plant_summary_sched200: ------------------------------------------------------------------------------- core_ferc1__yearly_utility_plant_summary_sched200 ------------------------------------------------------------------------------- Summary of utility plant and accumulated provisions for depreciation, amortization and depletion of utilty plant assets reported annually at the end of the report year. Schedule 200 of FERC Form 1. **The table has the following primary key columns:** * utility_id_ferc1 * report_year * utility_type * utility_plant_asset_type `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ending_balance - number - Account balance at end of year. * - record_id - string - Identifier indicating original FERC Form 1 source record. format: {table_name}_{report_year}_{report_prd}_{respondent_id}_{spplmnt_num}_{row_number}. Unique within FERC Form 1 DB tables which are not row-mapped. * - report_year - integer - Four-digit year in which the data was reported. * - row_type_xbrl - string - Indicates whether the value reported in the row is calculated, or uniquely reported within the table. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_plant_asset_type - string - 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. * - utility_type - string - Listing of utility plant types. Examples include Electric Utility, Gas Utility, and Other Utility. * - utility_type_other - string - 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). .. _core_ferc714__respondent_id: ------------------------------------------------------------------------------- core_ferc714__respondent_id ------------------------------------------------------------------------------- Respondent identification. FERC Form 714, Part I, Schedule 1. **The table has the following primary key columns:** * respondent_id_ferc714 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - eia_code - integer - EIA utility or balancing area authority ID associated with this FERC Form 714 respondent. Note that many utilities are also balancing authorities and in many cases EIA uses the same integer ID to identify a utility in its role as a balancing authority AND as a utility, but there is no requirement that these IDs be the same, and in a number of cases they are different. * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - respondent_id_ferc714_csv - integer - FERC Form 714 respondent ID from CSV reported data - published from years: 2006-2020. This ID is linked to the newer years of reported XBRL data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as respondent_id. Note that this ID does not correspond to FERC respondent IDs from other forms. * - respondent_id_ferc714_xbrl - string - FERC Form 714 respondent ID from XBRL reported data - published from years: 2021-present. This ID is linked to the older years of reported CSV data through the PUDL-assigned respondent_id_ferc714 ID. This ID was originally reported as entity_id. Note that this ID does not correspond to FERC respondent IDs from other forms. * - respondent_name_ferc714 - string - Name of the utility, balancing area authority, or planning authority responding to FERC Form 714. .. _core_ferc714__yearly_planning_area_demand_forecast: ------------------------------------------------------------------------------- core_ferc714__yearly_planning_area_demand_forecast ------------------------------------------------------------------------------- 10-year forecasted summer and winter peak demand and annual net energy per planning area. FERC Form 714, Part III, Schedule 2b. 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 core_ferc714_respondent_id table for links to the original source IDs. This table contains forecasted net demand (MWh) as well as summer and winter peak demand (MW) for the next ten years after after the report_date. 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). **The table has the following primary key columns:** * respondent_id_ferc714 * report_year * forecast_year `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - forecast_year - integer - Four-digit year that applies to a particular forecasted value. * - net_demand_forecast_mwh - number - Net forecasted electricity demand for the specific period in megawatt-hours (MWh). * - report_year - integer - Four-digit year in which the data was reported. * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - summer_peak_demand_forecast_mw - number - The maximum forecasted hourly sumemr load (for the months of June through September). * - winter_peak_demand_forecast_mw - number - The maximum forecasted hourly winter load (for the months of January through March). .. _core_ferc__codes_accounts: ------------------------------------------------------------------------------- core_ferc__codes_accounts ------------------------------------------------------------------------------- Account numbers from 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). **The table has the following primary key columns:** * ferc_account_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - ferc_account_description - string - Description of the FERC account. * - ferc_account_id - string - Account identifier from FERC's Uniform System of Accounts for Electric Plant. Includes higher level labeled categories. .. _core_gridpathratoolkit__assn_generator_aggregation_group: ------------------------------------------------------------------------------- core_gridpathratoolkit__assn_generator_aggregation_group ------------------------------------------------------------------------------- This 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`. **The table has the following primary key columns:** * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - aggregation_group - string - A label identifying a group of aggregated generator capacity factors. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - include_generator - boolean - 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. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. .. _core_nrelatb__yearly_projected_cost_performance: ------------------------------------------------------------------------------- core_nrelatb__yearly_projected_cost_performance ------------------------------------------------------------------------------- Projections of costs and performance for various technologies. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capex_construction_finance_factor - number - 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. * - capex_grid_connection_per_kw - number - 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. * - capex_overnight_additional_per_kw - number - 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. * - capex_overnight_per_kw - number - 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. * - capex_per_kw - number - Capital cost (USD). Expenditures required to achieve commercial operation of the generation plant. * - cost_recovery_period_years - integer - The period over which the initial capital investment to build a plant is recovered. * - fuel_cost_per_mwh - number - Fuel costs in USD$/MWh. NREL-derived values using heat rates. * - heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. * - heat_rate_penalty - number - 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 * - levelized_cost_of_energy_per_mwh - number - 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. * - model_case_nrelatb - string - NREL's financial assumption cases. There are two cases which effect project finanical 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 * - model_tax_credit_case_nrelatb - string - 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 * - net_output_penalty - number - 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 * - opex_fixed_per_kw - number - Fixed operation and maintenance expenses. Annual expenditures to operate and maintain equipment that are not incurred on a per-unit-energy basis. * - opex_variable_per_mwh - number - Operation and maintenance costs incurred on a per-unit-energy basis. * - projection_year - integer - The year of the projected value. * - report_year - integer - Four-digit year in which the data was reported. * - scenario_atb - string - Technology innovation scenarios. https://atb.nrel.gov/electricity/2023/definitions#scenarios * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - technology_description_detail_1 - string - Technology details indicate resource levels and specific technology subcategories. * - technology_description_detail_2 - string - Technology details indicate resource levels and specific technology subcategories. .. _core_nrelatb__yearly_projected_financial_cases: ------------------------------------------------------------------------------- core_nrelatb__yearly_projected_financial_cases ------------------------------------------------------------------------------- Financial assumptions for each model case (model_case_nrelatb), and sub-type of technology (technology_description). **The table has the following primary key columns:** * report_year * model_case_nrelatb * projection_year * technology_description `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - inflation_rate - number - 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. * - interest_rate_calculated_real - number - Calculated real interest rate. * - interest_rate_during_construction_nominal - number - 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. * - interest_rate_nominal - number - Nominal interest rate. * - model_case_nrelatb - string - NREL's financial assumption cases. There are two cases which effect project finanical 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 * - projection_year - integer - The year of the projected value. * - rate_of_return_on_equity_calculated_real - number - Calculated real rate of return on equity. * - rate_of_return_on_equity_nominal - number - Nomial rate of return on equity. * - report_year - integer - Four-digit year in which the data was reported. * - tax_rate_federal_state - number - 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. * - technology_description - string - High level description of the technology used by the generator to produce electricity. .. _core_nrelatb__yearly_projected_financial_cases_by_scenario: ------------------------------------------------------------------------------- core_nrelatb__yearly_projected_financial_cases_by_scenario ------------------------------------------------------------------------------- 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). There are a small number of records which have nulls inthe 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'] **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capital_recovery_factor - number - Ratio of a constant annuity to the present value of receiving that annuity for a given length of time. * - cost_recovery_period_years - integer - The period over which the initial capital investment to build a plant is recovered. * - debt_fraction - number - Fraction of capital financed with debt; Debt fraction is assumed financed with equity; also referred to as the leverage ratio. * - fixed_charge_rate - number - Amount of revenue per dollar of investment required that must be collected annually from customers to pay the carrying charges on that investment. * - model_case_nrelatb - string - NREL's financial assumption cases. There are two cases which effect project finanical 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 * - model_tax_credit_case_nrelatb - string - 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 * - projection_year - integer - The year of the projected value. * - report_year - integer - Four-digit year in which the data was reported. * - scenario_atb - string - Technology innovation scenarios. https://atb.nrel.gov/electricity/2023/definitions#scenarios * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - wacc_nominal - number - Nominal weighted average cost of capital - average expected rate that is paid to finance assets. * - wacc_real - number - Real weighted average cost of capital - average expected rate that is paid to finance assets. .. _core_nrelatb__yearly_technology_status: ------------------------------------------------------------------------------- core_nrelatb__yearly_technology_status ------------------------------------------------------------------------------- Annual table indicating whether technologies in the ATB scenarios are mature,and whether they are the default technologies. **This table has no primary key.** `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - is_default - boolean - Indicator of whether the technology is default. * - is_technology_mature - boolean - 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. * - report_year - integer - Four-digit year in which the data was reported. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - technology_description_detail_1 - string - Technology details indicate resource levels and specific technology subcategories. * - technology_description_detail_2 - string - Technology details indicate resource levels and specific technology subcategories. .. _core_pudl__assn_eia_pudl_plants: ------------------------------------------------------------------------------- core_pudl__assn_eia_pudl_plants ------------------------------------------------------------------------------- Association between EIA Plant IDs and manually assigned PUDL Plant IDs **The table has the following primary key columns:** * plant_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. .. _core_pudl__assn_eia_pudl_utilities: ------------------------------------------------------------------------------- core_pudl__assn_eia_pudl_utilities ------------------------------------------------------------------------------- Associations between the EIA Utility IDs and the manually assigned PUDL Utility IDs. **The table has the following primary key columns:** * utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _core_pudl__assn_ferc1_dbf_pudl_utilities: ------------------------------------------------------------------------------- core_pudl__assn_ferc1_dbf_pudl_utilities ------------------------------------------------------------------------------- This table maps the assign utility ID FERC1 to the native utility ID from the FERC1 DBF inputs - originally reported as respondent_id. **The table has the following primary key columns:** * utility_id_ferc1_dbf `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_ferc1_dbf - integer - FERC-assigned respondent_id from DBF reporting years, identifying the reporting entity. Stable from year to year. .. _core_pudl__assn_ferc1_pudl_plants: ------------------------------------------------------------------------------- core_pudl__assn_ferc1_pudl_plants ------------------------------------------------------------------------------- FERC 1 Plants and their associated manually assigned PUDL Plant IDs **The table has the following primary key columns:** * utility_id_ferc1 * plant_name_ferc1 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - utility_id_ferc1 - integer - 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. .. _core_pudl__assn_ferc1_pudl_utilities: ------------------------------------------------------------------------------- core_pudl__assn_ferc1_pudl_utilities ------------------------------------------------------------------------------- This table maps two manually assigned utility IDs: a PUDL ID and a FERC1 ID. The PUDL ID maps EIA and FERC1 utilities. The FERC1 ID maps the older DBF respondent IDs to new XBRL entity IDs. This table is generated from a table stored in the PUDL repository: src/package_data/glue/utility_id_pudl.csv **The table has the following primary key columns:** * utility_id_ferc1 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _core_pudl__assn_ferc1_xbrl_pudl_utilities: ------------------------------------------------------------------------------- core_pudl__assn_ferc1_xbrl_pudl_utilities ------------------------------------------------------------------------------- This table maps the assign utility ID FERC1 to the native utility ID from the FERC1 XBRL inputs - originally reported as entity_id. **The table has the following primary key columns:** * utility_id_ferc1_xbrl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_ferc1_xbrl - string - FERC-assigned entity_id from XBRL reporting years, identifying the reporting entity. Stable from year to year. .. _core_pudl__assn_ferc714_csv_pudl_respondents: ------------------------------------------------------------------------------- core_pudl__assn_ferc714_csv_pudl_respondents ------------------------------------------------------------------------------- This table maps the PUDL-assigned respondent ID FERC714 to the native respondent ID from the FERC714 CSV inputs - originally reported as respondent_id. **The table has the following primary key columns:** * respondent_id_ferc714 * respondent_id_ferc714_csv `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - respondent_id_ferc714_csv - integer - 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. .. _core_pudl__assn_ferc714_pudl_respondents: ------------------------------------------------------------------------------- core_pudl__assn_ferc714_pudl_respondents ------------------------------------------------------------------------------- Home table for PUDL derived FERC 714 respondent IDs. These ID's 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 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 **The table has the following primary key columns:** * respondent_id_ferc714 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. .. _core_pudl__assn_ferc714_xbrl_pudl_respondents: ------------------------------------------------------------------------------- core_pudl__assn_ferc714_xbrl_pudl_respondents ------------------------------------------------------------------------------- This table maps the PUDL-assigned respondent ID FERC714 to the native respondent ID from the FERC714 XBRL inputs - originally reported as entity_id. **The table has the following primary key columns:** * respondent_id_ferc714 * respondent_id_ferc714_xbrl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - respondent_id_ferc714 - integer - PUDL-assigned identifying a respondent to FERC Form 714. This ID associates natively reported respondent IDs from the orignal CSV and XBRL data sources. * - respondent_id_ferc714_xbrl - string - 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. .. _core_pudl__assn_utilities_plants: ------------------------------------------------------------------------------- core_pudl__assn_utilities_plants ------------------------------------------------------------------------------- Associations between PUDL utility IDs and PUDL plant IDs. This table is read in from a spreadsheet stored in the PUDL repository: src/pudl/package_data/glue/pudl_id_mapping.xlsx **The table has the following primary key columns:** * utility_id_pudl * plant_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. .. _core_pudl__codes_data_maturities: ------------------------------------------------------------------------------- core_pudl__codes_data_maturities ------------------------------------------------------------------------------- Level of maturities of data records. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. **The table has the following primary key columns:** * code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - code - string - Originally reported short code. * - description - string - Long human-readable description of the meaning of a code/label. .. _core_pudl__codes_datasources: ------------------------------------------------------------------------------- core_pudl__codes_datasources ------------------------------------------------------------------------------- Static table defining codes associated with the data sources that PUDL integrates. **The table has the following primary key columns:** * datasource `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - datasource - string - Code identifying a dataset available within PUDL. * - doi - string - Unique digitial object identifier of Zenodo archive. * - partitions - string - The data parititions used to generate this instance of the database. * - pudl_version - string - The version of PUDL used to generate this database. .. _core_pudl__codes_subdivisions: ------------------------------------------------------------------------------- core_pudl__codes_subdivisions ------------------------------------------------------------------------------- Various static attributes associated with states, provinces, and other sub- national political subdivisions. **The table has the following primary key columns:** * country_code * subdivision_code `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - country_code - string - Three letter ISO-3166 country code (e.g. USA or CAN). * - country_name - string - Full country name (e.g. United States of America). * - division_code_us_census - string - 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 * - division_name_us_census - string - Longer human readable name describing the US Census division. * - is_epacems_state - boolean - Indicates whether the associated state reports data within the EPA's Continuous Emissions Monitoring System. * - region_name_us_census - string - Human-readable name of a US Census region. * - state_id_fips - string - Two digit state FIPS code. * - subdivision_code - string - Two-letter ISO-3166 political subdivision code (e.g. US state or Canadian provice abbreviations like CA or AB). * - subdivision_name - string - Full name of political subdivision (e.g. US state or Canadian province names like California or Alberta. * - subdivision_type - string - ISO-3166 political subdivision type. E.g. state, province, outlying_area. * - timezone_approx - string - IANA timezone name of the timezone which encompasses the largest portion of the population in the associated geographic area. .. _core_pudl__entity_plants_pudl: ------------------------------------------------------------------------------- core_pudl__entity_plants_pudl ------------------------------------------------------------------------------- Home table for PUDL assigned plant IDs. These 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 **The table has the following primary key columns:** * plant_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_pudl - string - Plant name, chosen arbitrarily from the several possible plant names available in the plant matching process. Included for human readability only. .. _core_pudl__entity_utilities_pudl: ------------------------------------------------------------------------------- core_pudl__entity_utilities_pudl ------------------------------------------------------------------------------- Home table for PUDL assigned utility IDs. These 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 **The table has the following primary key columns:** * utility_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_pudl - string - Utility name, chosen arbitrarily from the several possible utility names available in the utility matching process. Included for human readability only. .. _i_out_eia__monthly_capacity_factor_by_generator: ------------------------------------------------------------------------------- _out_eia__monthly_capacity_factor_by_generator ------------------------------------------------------------------------------- Monthly estimates of generator capacity factor. Capacity factor is calculated based on reported generator capacity and the allocated net generation reported in the generation and generation fuel tables. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. .. _i_out_eia__monthly_derived_generator_attributes: ------------------------------------------------------------------------------- _out_eia__monthly_derived_generator_attributes ------------------------------------------------------------------------------- Monthly generator capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh. These calculations are based on the allocation of net generation reported on the basis of plant, prime mover and energy source to individual generators. Heat rates by generator-month are estimated by using allocated estimates for per-generator net generation and fuel consumption as well as the :ref:`core_eia923__monthly_boiler_fuel` table, which reports fuel consumed by boiler. Heat rates are necessary to estimate the amount of fuel consumed by a generation unit, and thus the fuel cost per MWh generated. Plant specific fuel prices are taken from the :ref:`core_eia923__monthly_fuel_receipts_costs` table, which only has ~70% coverage, leading to some generators with heat rate estimates still lacking fuel cost estimates. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. .. _i_out_eia__monthly_fuel_cost_by_generator: ------------------------------------------------------------------------------- _out_eia__monthly_fuel_cost_by_generator ------------------------------------------------------------------------------- Monthly estimate of per-generator fuel costs both per MMBTU and per MWh. These calculations are based on the allocation of net generation and fuel consumption as well as plant-level delivered fuel prices reported in the fuel receipts and cost table. The intermediary heat rate calculation depends on having the unit ID filled in, which means fuel cost coverage is low. The fuel costs are also currently aggregated to coarse fuel categories rather than using the more detailed energy source codes.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _i_out_eia__monthly_heat_rate_by_generator: ------------------------------------------------------------------------------- _out_eia__monthly_heat_rate_by_generator ------------------------------------------------------------------------------- Monthly heat rate estimates by generator. These are actually just generation unit level heat rates, which have been broadcast across all constituent generator IDs, since heat rates really only have a well-defined meaning in the context of a generation unit.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. .. _i_out_eia__monthly_heat_rate_by_unit: ------------------------------------------------------------------------------- _out_eia__monthly_heat_rate_by_unit ------------------------------------------------------------------------------- Monthly heat rate estimates by generation unit. Generation units are identified by ``unit_id_pudl`` and are composed of a set of interconnected boilers and generators. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * unit_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. .. _i_out_eia__plants_utilities: ------------------------------------------------------------------------------- _out_eia__plants_utilities ------------------------------------------------------------------------------- Denormalized table containing all plant and utility IDs and names from EIA. **The table has the following primary key columns:** * report_date * plant_id_eia * utility_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _i_out_eia__yearly_capacity_factor_by_generator: ------------------------------------------------------------------------------- _out_eia__yearly_capacity_factor_by_generator ------------------------------------------------------------------------------- Yearly estimates of generator capacity factor. Capacity factor is calculated based on reported generator capacity and the allocated net generation reported in the generation and generation fuel tables. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. .. _i_out_eia__yearly_derived_generator_attributes: ------------------------------------------------------------------------------- _out_eia__yearly_derived_generator_attributes ------------------------------------------------------------------------------- Yearly generator capacity factor, heat rate, fuel cost per MMBTU and fuel cost per MWh. These calculations are based on the allocation of net generation reported on the basis of plant, prime mover and energy source to individual generators. Heat rates by generator-month are estimated by using allocated estimates for per-generator net generation and fuel consumption as well as the :ref:`core_eia923__monthly_boiler_fuel` table, which reports fuel consumed by boiler. Heat rates are necessary to estimate the amount of fuel consumed by a generation unit, and thus the fuel cost per MWh generated. Plant specific fuel prices are taken from the :ref:`core_eia923__monthly_fuel_receipts_costs` table, which only has ~70% coverage, leading to some generators with heat rate estimates still lacking fuel cost estimates. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - capacity_factor - number - Fraction of potential generation that was actually reported for a plant part. * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - total_fuel_cost - number - Total annual reported fuel costs for the plant part. Includes costs from all fuels. * - total_mmbtu - number - Total annual heat content of fuel consumed by a plant part record in the plant parts list. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. .. _i_out_eia__yearly_fuel_cost_by_generator: ------------------------------------------------------------------------------- _out_eia__yearly_fuel_cost_by_generator ------------------------------------------------------------------------------- Yearly estimate of per-generator fuel costs both per MMBTU and per MWh. These calculations are based on the allocation of net generation and fuel consumption as well as plant-level delivered fuel prices reported in the fuel receipts and cost table. The intermediary heat rate calculation depends on having the unit ID filled in, which means fuel cost coverage is low. The fuel costs are also currently aggregated to coarse fuel categories rather than using the more detailed energy source codes.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_cost_per_mmbtu - number - Average fuel cost per mmBTU of heat content in nominal USD. * - fuel_cost_per_mmbtu_source - string - 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). * - fuel_cost_per_mwh - number - Derived from MCOE, a unit level value. Average fuel cost per MWh of heat content in nominal USD. * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - report_date - date - Date reported. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. .. _i_out_eia__yearly_generators: ------------------------------------------------------------------------------- _out_eia__yearly_generators ------------------------------------------------------------------------------- Denormalized table containing all EIA generator attributes. **The table has the following primary key columns:** * plant_id_eia * generator_id * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - associated_combined_heat_power - boolean - Indicates whether the generator is associated with a combined heat and power system * - bga_source - string - 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). * - bypass_heat_recovery - boolean - Can this generator operate while bypassing the heat recovery steam generator? * - capacity_mw - number - Total installed (nameplate) capacity, in megawatts. * - carbon_capture - boolean - Indicates whether the generator uses carbon capture technology. * - city - string - Name of the city. * - cofire_fuels - boolean - Can the generator co-fire fuels?. * - county - string - County name. * - current_planned_generator_operating_date - date - The most recently updated effective date on which the generator is scheduled to start operation * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - deliver_power_transgrid - boolean - Indicate whether the generator can deliver power to the transmission grid. * - distributed_generation - boolean - Whether the generator is considered distributed generation * - duct_burners - boolean - Indicates whether the unit has duct-burners for supplementary firing of the turbine exhaust gas * - energy_source_1_transport_1 - string - Primary mode of transport for energy source 1. * - energy_source_1_transport_2 - string - Secondary mode of transport for energy source 1. * - energy_source_1_transport_3 - string - Tertiary mode of transport for energy source 1. * - energy_source_2_transport_1 - string - Primary mode of transport for energy source 2. * - energy_source_2_transport_2 - string - Secondary mode of transport for energy source 2. * - energy_source_2_transport_3 - string - Tertiary mode of transport for energy source 2. * - energy_source_code_1 - string - The code representing the most predominant type of energy that fuels the generator. * - energy_source_code_2 - string - The code representing the second most predominant type of energy that fuels the generator * - energy_source_code_3 - string - The code representing the third most predominant type of energy that fuels the generator * - energy_source_code_4 - string - The code representing the fourth most predominant type of energy that fuels the generator * - energy_source_code_5 - string - The code representing the fifth most predominant type of energy that fuels the generator * - energy_source_code_6 - string - The code representing the sixth most predominant type of energy that fuels the generator * - energy_storage_capacity_mwh - number - Energy storage capacity in MWh (e.g. for batteries). * - ferc_qualifying_facility - boolean - Indicates whether or not a generator is a qualifying FERC cogeneration facility. * - fluidized_bed_tech - boolean - Indicates whether the generator uses fluidized bed technology * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - generator_operating_date - date - Date the generator began commercial operation. If harvested values are inconsistent, we default to using the most recently reported date. * - generator_retirement_date - date - Date of the scheduled or effected retirement of the generator. * - latitude - number - Latitude of the plant's location, in degrees. * - longitude - number - Longitude of the plant's location, in degrees. * - minimum_load_mw - number - The minimum load at which the generator can operate at continuosuly. * - multiple_fuels - boolean - Can the generator burn multiple fuels? * - nameplate_power_factor - number - The nameplate power factor of the generator. * - net_capacity_mwdc - number - Generation capacity in megawatts of direct current that is subject to a net metering agreement. Typically used for behind-the-meter solar PV. * - operating_switch - string - Indicates whether the fuel switching generator can switch when operating * - operational_status - string - The operating status of the asset. For generators this is based on which tab the generator was listed in in EIA 860. * - operational_status_code - string - The operating status of the asset. * - original_planned_generator_operating_date - date - The date the generator was originally scheduled to be operational * - other_combustion_tech - boolean - Indicates whether the generator uses other combustion technologies * - other_modifications_date - date - Planned effective date that the generator is scheduled to enter commercial operation after any other planned modification is complete. * - other_planned_modifications - boolean - Indicates whether there are there other modifications planned for the generator. * - owned_by_non_utility - boolean - Whether any part of generator is owned by a nonutilty * - ownership_code - string - Identifies the ownership for each generator. * - planned_derate_date - date - Planned effective month that the generator is scheduled to enter operation after the derate modification. * - planned_energy_source_code_1 - string - New energy source code for the planned repowered generator. * - planned_generator_retirement_date - date - Planned effective date of the scheduled retirement of the generator. * - planned_modifications - boolean - Indicates whether there are any planned capacity uprates/derates, repowering, other modifications, or generator retirements scheduled for the next 5 years. * - planned_net_summer_capacity_derate_mw - number - Decrease in summer capacity expected to be realized from the derate modification to the equipment. * - planned_net_summer_capacity_uprate_mw - number - Increase in summer capacity expected to be realized from the modification to the equipment. * - planned_net_winter_capacity_derate_mw - number - Decrease in winter capacity expected to be realized from the derate modification to the equipment. * - planned_net_winter_capacity_uprate_mw - number - Increase in winter capacity expected to be realized from the uprate modification to the equipment. * - planned_new_capacity_mw - number - The expected new namplate capacity for the generator. * - planned_new_prime_mover_code - string - New prime mover for the planned repowered generator. * - planned_repower_date - date - Planned effective date that the generator is scheduled to enter operation after the repowering is complete. * - planned_uprate_date - date - Planned effective date that the generator is scheduled to enter operation after the uprate modification. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_eia - string - Plant name. * - previously_canceled - boolean - Indicates whether the generator was previously reported as indefinitely postponed or canceled * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - pulverized_coal_tech - boolean - Indicates whether the generator uses pulverized coal technology * - reactive_power_output_mvar - number - Reactive Power Output (MVAr) * - report_date - date - Date reported. * - rto_iso_lmp_node_id - string - The designation used to identify the price node in RTO/ISO Locational Marginal Price reports * - rto_iso_location_wholesale_reporting_id - string - The designation used to report ths specific location of the wholesale sales transactions to FERC for the Electric Quarterly Report * - solid_fuel_gasification - boolean - Indicates whether the generator is part of a solid fuel gasification system * - startup_source_code_1 - string - 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. * - startup_source_code_2 - string - 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. * - startup_source_code_3 - string - 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. * - startup_source_code_4 - string - 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. * - state - string - Two letter US state abbreviation. * - stoker_tech - boolean - Indicates whether the generator uses stoker technology * - street_address - string - Physical street address. * - subcritical_tech - boolean - Indicates whether the generator uses subcritical technology * - summer_capacity_estimate - boolean - Whether the summer capacity value was an estimate * - summer_capacity_mw - number - The net summer capacity. * - summer_estimated_capability_mw - number - EIA estimated summer capacity (in MWh). * - supercritical_tech - boolean - Indicates whether the generator uses supercritical technology * - switch_oil_gas - boolean - Indicates whether the generator switch between oil and natural gas. * - syncronized_transmission_grid - boolean - Indicates whether standby generators (SB status) can be synchronized to the grid. * - technology_description - string - High level description of the technology used by the generator to produce electricity. * - time_cold_shutdown_full_load_code - string - The minimum amount of time required to bring the unit to full load from shutdown. * - timezone - string - IANA timezone name * - topping_bottoming_code - string - 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 * - turbines_inverters_hydrokinetics - integer - Number of wind turbines, or hydrokinetic buoys. * - turbines_num - integer - Number of wind turbines, or hydrokinetic buoys. * - ultrasupercritical_tech - boolean - Indicates whether the generator uses ultra-supercritical technology * - unit_id_pudl - integer - 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. * - uprate_derate_completed_date - date - The date when the uprate or derate was completed. * - uprate_derate_during_year - boolean - Was an uprate or derate completed on this generator during the reporting year? * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_eia - string - The name of the utility. * - winter_capacity_estimate - boolean - Whether the winter capacity value was an estimate * - winter_capacity_mw - number - The net winter capacity. * - winter_estimated_capability_mw - number - EIA estimated winter capacity (in MWh). * - zip_code - string - Five digit US Zip Code. .. _i_out_eia__yearly_heat_rate_by_generator: ------------------------------------------------------------------------------- _out_eia__yearly_heat_rate_by_generator ------------------------------------------------------------------------------- Yearly heat rate estimates by generator. These are actually just generation unit level heat rates, which have been broadcast across all constituent generator IDs, since heat rates really only have a well-defined meaning in the context of a generation unit.Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * generator_id `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_type_code_pudl - string - Simplified fuel type code used in PUDL * - fuel_type_count - integer - A count of how many different simple energy sources there are associated with a generator. * - generator_id - string - Generator ID is usually numeric, but sometimes includes letters. Make sure you treat it as a string! * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - prime_mover_code - string - Code for the type of prime mover (e.g. CT, CG) * - report_date - date - Date reported. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. .. _i_out_eia__yearly_heat_rate_by_unit: ------------------------------------------------------------------------------- _out_eia__yearly_heat_rate_by_unit ------------------------------------------------------------------------------- Yearly heat rate estimates by generation unit. Generation units are identified by ``unit_id_pudl`` and are composed of a set of interconnected boilers and generators. Note that the values in this table are unfiltered and we expect some of the values are unreasonable and out of bounds.This table should not be used without filtering values to within logical boundaries. **The table has the following primary key columns:** * report_date * plant_id_eia * unit_id_pudl `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - fuel_consumed_for_electricity_mmbtu - number - Total consumption of fuel to produce electricity, in physical unit, year to date. * - net_generation_mwh - number - Net electricity generation for the specified period in megawatt-hours (MWh). * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - unit_heat_rate_mmbtu_per_mwh - number - Fuel content per unit of electricity generated. Coming from MCOE calculation. * - unit_id_pudl - integer - 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. .. _i_out_ferc1__yearly_plants_utilities: ------------------------------------------------------------------------------- _out_ferc1__yearly_plants_utilities ------------------------------------------------------------------------------- Denormalized table that contains FERC plant and utility information. **The table has the following primary key columns:** * utility_id_ferc1 * plant_name_ferc1 `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - plant_id_pudl - integer - A manually assigned PUDL plant ID. May not be constant over time. * - plant_name_ferc1 - string - Name of the plant, as reported to FERC. This is a freeform string, not guaranteed to be consistent across references to the same plant. * - utility_id_ferc1 - integer - PUDL-assigned utility ID, identifying a FERC1 utility. This is an auto-incremented ID and is not expected to be stable from year to year. * - utility_id_pudl - integer - A manually assigned PUDL utility ID. May not be stable over time. * - utility_name_ferc1 - string - Name of the responding utility, as it is reported in FERC Form 1. For human readability only. .. _i_core_eia860__cooling_equipment: ------------------------------------------------------------------------------- _core_eia860__cooling_equipment ------------------------------------------------------------------------------- Information about cooling equipment at generation facilities, from EIA-860 Schedule 6D. Note: This table has been cleaned, but not 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. Once this table has been harvested, it will be removed from the PUDL database. **The table has the following primary key columns:** * plant_id_eia * utility_id_eia * cooling_id_eia * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - chlorine_equipment_cost - number - Actual installed cost for the existing chlorine discharge control system or the anticipated cost to bring the chlorine discharge control system into commercial operation * - chlorine_equipment_operating_date - date - Actual or projected in-service date for chlorine discharge control structures and equipment * - cooling_equipment_total_cost - number - Actual installed cost for the existing system or the anticipated cost to bring the total system into commercial operation * - cooling_id_eia - string - 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) * - cooling_status_code - string - Operating status of cooling system * - cooling_system_operating_date - date - The actual or projected in-service datetime of this cooling system * - cooling_type_1 - string - Type of cooling system * - cooling_type_2 - string - Type of cooling system * - cooling_type_3 - string - Type of cooling system * - cooling_type_4 - string - Type of cooling system * - cooling_water_discharge - string - Name of river, lake, or water source that cooling water is discharged into * - cooling_water_source - string - Name of river, lake, or water source that provides cooling water * - county - string - County name. * - intake_distance_shore_feet - number - Maximum distance from shore to intake * - intake_distance_surface_feet - number - Average distance below water surface to intake * - intake_rate_100pct_gallons_per_minute - number - Design cooling water flow rate at 100 percent load at in-take * - outlet_distance_shore_feet - number - Maximum distance from shore to outlet * - outlet_distance_surface_feet - number - Average distance below water surface to outlet * - percent_dry_cooling - number - Percent of cooling load served by dry cooling components * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_name_eia - string - Plant name. * - plant_summer_capacity_mw - number - The plant summer capacity associated with the operating generators at the plant * - pond_cost - number - Actual installed cost for the existing cooling ponds or the anticipated cost to bring the cooling ponds into commercial operation * - pond_operating_date - date - Cooling ponds actual or projected in-service date * - pond_surface_area_acres - number - Total surface area of cooling pond * - pond_volume_acre_feet - number - Total volume of water in cooling pond * - power_requirement_mw - number - Maximum power requirement for cooling towers at 100 percent load * - report_date - date - Date reported. * - state - string - Two letter US state abbreviation. * - steam_plant_type_code - integer - Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details. * - tower_cost - number - Actual installed cost for the existing cooling towers or the anticipated cost to bring the cooling towers into commercial operation * - tower_operating_date - date - Cooling towers actual or projected in-service date * - tower_type_1 - string - Types of cooling towers at this plant * - tower_type_2 - string - Types of cooling towers at this plant * - tower_type_3 - string - Types of cooling towers at this plant * - tower_type_4 - string - Types of cooling towers at this plant * - tower_water_rate_100pct_gallons_per_minute - number - Maximum design rate of water flow at 100 percent load for the cooling towers * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - water_source - string - Name of water source associated with the plant. * - water_source_code - string - Type of cooling water source * - water_type_code - string - Type of cooling water .. _i_core_eia860__fgd_equipment: ------------------------------------------------------------------------------- _core_eia860__fgd_equipment ------------------------------------------------------------------------------- Information about flue gas desulfurization equipment at generation facilities, from EIA-860 Schedule 6E. Note: This table has been cleaned, but not 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. Once this table has been harvested, it will be removed from the PUDL database. **The table has the following primary key columns:** * plant_id_eia * so2_control_id_eia * report_date `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - byproduct_recovery - boolean - Is salable byproduct is recovered by the unit? * - county - string - County name. * - county_id_fips - string - County ID from the Federal Information Processing Standard Publication 6-4. * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - fgd_manufacturer - string - Name of flue gas desulfurization equipment manufacturer. * - fgd_manufacturer_code - string - Code corresponding to name of flue gas desulfurization equipment manufacturer. * - fgd_operating_date - date - The actual or projected in-service datetime of this flue gas desulfurization system * - fgd_operational_status_code - string - Operating status code for flue gas desulfurization equipment. * - fgd_other_cost - number - 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. * - fgd_structure_cost - number - 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. * - fgd_trains_100pct - number - Total number of flue gas desulfurization unit scrubber trains operated at 100 percent load. * - fgd_trains_total - number - Total number of flue gas desulfurization unit scrubber trains. * - flue_gas_bypass_fgd - boolean - Indicates whether flue gas can bypass the flue gas desulfurization unit. * - flue_gas_entering_fgd_pct_of_total - number - Ratio of all flue gas that is entering the flue gas desulfurization unit. * - flue_gas_exit_rate_cubic_feet_per_minute - number - Actual flue gas exit rate, in cubic feet per minute. * - flue_gas_exit_temperature_fahrenheit - number - Flue gas exit temperature, in degrees Fahrenheit. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - plant_summer_capacity_mw - number - The plant summer capacity associated with the operating generators at the plant * - pond_landfill_requirements_acre_foot_per_year - number - Annual pond and land fill requirements for flue gas desulfurization equipment. * - report_date - date - Date reported. * - sludge_disposal_cost - number - 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. * - sludge_pond - boolean - Indicates if there is a sludge pond associated with this unit. * - sludge_pond_lined - boolean - Indicates whether the sludge pond is lined. * - so2_control_id_eia - string - Sulfur dioxide control identification number. This ID is not a unique identifier. * - so2_emission_rate_lbs_per_hour - number - Sulfur dioxide emission rate when operating at 100 percent load (pounds per hour). * - so2_equipment_type_1 - string - Type of sulfur dioxide control equipment. * - so2_equipment_type_2 - string - Type of sulfur dioxide control equipment. * - so2_equipment_type_3 - string - Type of sulfur dioxide control equipment. * - so2_equipment_type_4 - string - Type of sulfur dioxide control equipment. * - so2_removal_efficiency_design - number - 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. * - sorbent_type_1 - string - Type of sorbent used by this sulfur dioxide control equipment. * - sorbent_type_2 - string - Type of sorbent used by this sulfur dioxide control equipment. * - sorbent_type_3 - string - Type of sorbent used by this sulfur dioxide control equipment. * - sorbent_type_4 - string - Type of sorbent used by this sulfur dioxide control equipment. * - specifications_of_coal_ash - number - Design fuel specifications for ash when burning coal or petroleum coke (nearest 0.1 percent by weight). * - specifications_of_coal_sulfur - number - Design fuel specifications for sulfur when burning coal or petroleum coke (nearest 0.1 percent by weight). * - state - string - Two letter US state abbreviation. * - state_id_fips - string - Two digit state FIPS code. * - steam_plant_type_code - integer - Code that describes types of steam plants from EIA 860. See steam_plant_types_eia table for more details. * - total_fgd_equipment_cost - number - 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. * - utility_id_eia - integer - The EIA Utility Identification number. * - utility_name_eia - string - The name of the utility. * - water_source - string - Name of water source associated with the plant. .. _i_core_eia923__cooling_system_information: ------------------------------------------------------------------------------- _core_eia923__cooling_system_information ------------------------------------------------------------------------------- EIA-923 Cooling System Information, from EIA-923 Schedule 8D. Reports monthly information about cooling systems at generation facilities, mainly water volumes and temperatures. In 2008 and 2009, EIA only reports annual averages, but in later years all data is monthly. Note: This table has been cleaned, but not 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. Once this table has been harvested, it will be removed from the PUDL database. **The table has the following primary key columns:** * plant_id_eia * report_date * cooling_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - annual_average_consumption_rate_gallons_per_minute - number - Annual average consumption rate of cooling water * - annual_average_discharge_rate_gallons_per_minute - number - Annual average discharge rate of cooling water * - annual_average_withdrawal_rate_gallons_per_minute - number - Annual average withdrawal rate of cooling water * - annual_maximum_intake_summer_temperature_fahrenheit - number - Maximum cooling water temperature at intake during the summer * - annual_maximum_intake_winter_temperature_fahrenheit - number - Maximum cooling water temperature at intake in winter * - annual_maximum_outlet_summer_temperature_fahrenheit - number - Maximum cooling water temperature at outlet in summer * - annual_maximum_outlet_winter_temperature_fahrenheit - number - Maximum cooling water temperature at outlet in winter * - annual_total_chlorine_lbs - number - Amount of elemental chlorine added to cooling water annually. May be just the amount of chlorine-containing compound if schedule 9 is filled out. * - cooling_id_eia - string - 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) * - cooling_status_code - string - Operating status of cooling system * - cooling_type - string - Type of cooling system * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - flow_rate_method - string - Calculation method for flow rates (actual or method of estimation) * - monthly_average_consumption_rate_gallons_per_minute - number - Monthly average consumption rate of cooling water * - monthly_average_discharge_rate_gallons_per_minute - number - Monthly average discharge rate of cooling water * - monthly_average_discharge_temperature_fahrenheit - number - Average cooling water temperature at discharge point * - monthly_average_diversion_rate_gallons_per_minute - number - Monthly average diversion rate of cooling water * - monthly_average_intake_temperature_fahrenheit - number - Average cooling water temperature at intake point * - monthly_average_withdrawal_rate_gallons_per_minute - number - Monthly average withdrawal rate of cooling water * - monthly_maximum_discharge_temperature_fahrenheit - number - Maximum cooling water temperature at discharge * - monthly_maximum_intake_temperature_fahrenheit - number - Maximum cooling water temperature at intake * - monthly_total_chlorine_lbs - number - Amount of elemental chlorine added to cooling water monthly. May be just the amount of chlorine-containing compound if schedule 9 is filled out. * - monthly_total_consumption_volume_gallons - number - Monthly volume of water consumed at consumption point (accurate to 0.1 million gal) * - monthly_total_cooling_hours_in_service - integer - Total hours the system operated during the month * - monthly_total_discharge_volume_gallons - number - Monthly volume of water discharged at discharge point (accurate to 0.1 million gal) * - monthly_total_diversion_volume_gallons - number - Monthly volume of water diverted at diversion point (accurate to 0.1 million gal) * - monthly_total_withdrawal_volume_gallons - number - Monthly volume of water withdrawn at withdrawal point (accurate to 0.1 million gal) * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - temperature_method - string - Method for measurement of temperatures .. _i_core_eia923__fgd_operation_maintenance: ------------------------------------------------------------------------------- _core_eia923__fgd_operation_maintenance ------------------------------------------------------------------------------- EIA-923 FGD Operation & Maintenance, from EIA-923 Schedule 8C. Reports annual information about flue gas desulfurization systems at generation facilities, mainly operational expenses. From 2008-2011 this table also reported operational characteristics that are now reported in 923 Air Emissions Control Info. Note: This table has been cleaned, but not 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. Once this table has been harvested, it will be removed from the PUDL database. **The table has the following primary key columns:** * plant_id_eia * report_date * so2_control_id_eia `Browse or query this table in Datasette. `__ .. list-table:: :widths: auto :header-rows: 1 * - **Field Name** - **Type** - **Description** * - data_maturity - string - Level of maturity of the data record. Some data sources report less-than-final data. PUDL sometimes includes this data, but use at your own risk. * - fgd_control_flag - boolean - Indicates whether or not a plant has a flue gas desulfurization control unit. * - fgd_electricity_consumption_mwh - number - Electric power consumed by the flue gas desulfurization unit (in MWh). * - fgd_hours_in_service - integer - Number of hours the flue gas desulfurization equipment was in operation during the year. * - fgd_operational_status_code - string - Operating status code for flue gas desulfurization equipment. * - fgd_sorbent_consumption_1000_tons - number - Quantity of flue gas desulfurization sorbent used, to the nearest 0.1 thousand tons. * - opex_fgd_feed_materials_chemical - integer - Annual operation and maintenance expenditures for feed materials and chemicals for flue gas desulfurization equipment, excluding electricity. * - opex_fgd_labor_supervision - integer - Annual operation and maintenance expenditures for labor and supervision of flue gas desulfurization equipment, excluding electricity. * - opex_fgd_land_acquisition - integer - Annual operation and maintenance expenditures for land acquisition for flue gas desulfurization equipment, excluding electricity. * - opex_fgd_maintenance_material_other - integer - Annual operation and maintenance expenditures for maintenance, materials and all other costs of flue gas desulfurization equipment, excluding electricity * - opex_fgd_total_cost - integer - Annual total cost of operation and maintenance expenditures on flue gas desulfurization equipment, excluding electricity * - opex_fgd_waste_disposal - integer - Annual operation and maintenance expenditures for waste disposal, excluding electricity. * - plant_id_eia - integer - The unique six-digit facility identification number, also called an ORISPL, assigned by the Energy Information Administration. * - report_date - date - Date reported. * - so2_control_id_eia - string - Sulfur dioxide control identification number. This ID is not a unique identifier. * - so2_removal_efficiency_annual - number - Removal efficiency for sulfur dioxide (to the nearest 0.1 percent by weight) based on designed firing rate and hours in operation (listed as a percentage). * - so2_removal_efficiency_tested - number - Removal efficiency for sulfur dioxide (to the nearest 0.1 percent by weight) at tested rate at 100 percent load. * - so2_test_date - date - Date of most recent test for sulfur dioxide removal efficiency.