eia923_generation.py

Description:
Download and import EIA 923 data, which primarily includes electricity generated and fuel used by facility. The module will download the data as needed and provides functions to access different pages of the excel file.

Functions:

• eia923_download_extract: This function returns a summarized dataframe of power plant generation and fuel usage. Data is grouped as defined by the parameter group_cols, which contains a list of the columns by which to group the data. If none are provided then the function defaults to Plant Id, Plant Name, State, NAICS Code, Reported Prime Mover, Reported Fuel Type Code, Year.

• eia923_primary_fuel: Determine the primary fuel for each power plant. Include the NAICS code for each plant in output. Primary fuel can be determined using either generation (output) or fuel consumption (input). EIA923 doesn't list fuel inputs for non-combustion generation (wind, sun, hydro, etc), so an additional step to determine the primary fuel of these plants if 'Total Fuel Consumption MMBtu' is selected as the method.

• build_generation_data: Build a dataset of facility-level generation using EIA923. This function will apply filters for positive generation, generation efficiency within a given range, and a minimum percent of generation from the primary fuel (if set in the config file). The returned dataframe also includes the balancing authority for every power plant.

• eia923_generation_and_fuel: Returns all data from page 1. This avoids the grouping performed in eia923_download_extract.

• eia923_boiler_fuel: Returns boiler-level fuel consumption. Used by ampd_plant_emissions.py to generate emission factors.

• eia923_sched8_aec: Returns boiler-level air emissions control information. Used by ampd_plant_emissions.py to generate emission factors.