Output Variables

Description contributed by user @yifang-zhu-pge

• pgid: A unique geographic block identifier specific to how dGen agents are generated
• tract_id_alias: An additional geographic code corresponding to pgid
• bin_id: Is an unique id corresponding to to an unique agent_id, used for initial sampling of agents.
• bldg_id: Identifier for the building associated with the agent.
• state_abbr: Abbreviation of the state where the agent is located.
• census_division_abbr: Abbreviations of EIA U.S. Census Divisions. https://www.eia.gov/outlooks/aeo/pdf/f1.pdf. Not used in model, but this was kept to provide geographic context to the agents
• developable_roof_sqft: Final assessed area of an agent’s roof that is potentially developable for PV
• max_demand_kw: The maximum demand assessed in from the 8760 load profile of the agent
• avg_monthly_kwh: Average load consumed by an agent on a monthly basis
• crb_model: Customer Resource Behavior Model. This model is used to represent the type of dwelling and associated characteristics of a customer. The various types of buildings listed (e.g., Single-Family Detached, Multi-Family with 2-4 Units, Mobile Home) are categories that help define the behavior of customers, specifically their energy consumption, DER adoption rates, and economic viability.
• hdf_load_index: Internal code formerly used for binning agents in specific load regions. No longer used, but kept for internal context
• owner_occupancy_status: Either a 1 or a 2, indicating owner or renter, respectively
• cap_cost_multiplier: Regional capital cost added to capital cost assessed in the Annual Technology Baseline (ATB). Regional system cost estimates are sourced from https://www.nrel.gov/docs/fy19osti/72399.pdf
• solar_re_9809_gid: Internal geographic identifier used to assess the hourly solar resource for an agent. Data source: NSRDB (National Solar Radiation Database)
• tilt: Tilt angle of roof/solar system
• azimuth: Azimuth angle of the roof/solar system
• pct_of_bldgs_developable: Percentage of buildings that have roofs that are potentially developable
• bldg_size_class: Small is classified as less than 5000 square feet, Medium is classified as greater than or equal to 5000 square feet, Large is classified as greater than or equal to 25000 square feet
• i
• j
• cf_bin: capacity factor bin. Capacity Factor (CF) measures how efficiently a solar PV system operates over time.
• sector_abbr: The sector that an agent is representing (commercial or residential)
• tech: The technology the agent is representing. Is defaulted as ‘solar’ for the beta release.
• Ba: balancing area
• Rto: Regional Transmission Organization
• county_id: you can find the mapping in table “diffusion_shared.county_geoms”.
• tariff_name: Name of applied tariff. Data Source: Utility Rate Database https://openei.org/apps/USURDB/rate/view/5580540c5457a372516c88a6
• tariff_id: A dGen specific identifier used for various tariffs
• eia_id: Corresponds to the unique utility id associated with a region that a given agent is in.
• year
• nerc_region_abbr: NERC (North American Electric Reliability Corporation) divides North America into regions to ensure grid reliability.
• load_multiplier: a factor that represents the rate at which the load (demand for electricity) increases over time.
• load_kwh_per_customer_in_bin: The total load, in kWh, for a single building represented by a particular agent.
• customers_in_bin: Number of buildings represented by a particular agent.
• compensation_style: Defines the financial structure used to compensate solar system owners for excess electricity sent to the grid.
• nem_system_kw_limit: The maximum system size (in kW) eligible for Net Energy Metering (NEM) under local policies.
• elec_price_multiplier: change in present-year electric cost to 2016.
• elec_price_escalator: agent's assumption about future price changes.
• batt_eff: the efficiency of a battery system, expressed as a percentage of energy retained after storage and discharge.
• batt_lifetime_yrs: the expected lifetime of a battery system, measured in years.
• pv_kw_per_sqft: PV power density (in kilowatts per square foot).
• pv_degradation_factor: the rate at which the performance of PV panels decreases over time, expressed as a percentage per year.
• system_capex_per_kw: system capital expenditure per kw.
• system_om_per_kw: System Operations and Maintenance (O&M) costs per kw.
• system_variable_om_per_kw: variable Operations and Maintenance (O&M) costs per kilowatt (kW).
• batt_capex_per_kwh: the capital expenditure (CAPEX) for batteries, expressed in terms of cost per kilowatt-hour (kWh) of battery.
• batt_capex_per_kw: the capital expenditure (CAPEX) for batteries, expressed in terms of cost per kilowatt (kW) of battery.
• linear_constant: a base value for the cost of a battery system used in financial models within financial_functions.py.
• batt_om_per_kwh: the operation and maintenance (O&M) cost per kilowatt-hour (kWh) of battery capacity.
• batt_om_per_kw: the operation and maintenance (O&M) cost per kilowatt (kW) of battery capacity.
• system_capex_per_kw_combined:
• batt_capex_per_kwh_combined:
• linear_constant_combined:
• batt_om_per_kw_combined:
• batt_om_per_kwh_combined:
• value_of_resiliency_usd: the estimated economic value, in U.S. dollars, of improved resiliency in an energy system or infrastructure, typically reflecting the cost savings or benefits associated with reducing downtime, preventing disruptions, or mitigating the impact of power outages or other disruptions.
• grid_carbon_intensity_tco2_per_kwh: represents the carbon intensity of electricity generated by the grid, measured in tons of carbon dioxide (tCO₂) per kilowatt-hour (kWh). This metric indicates the amount of carbon dioxide emissions produced for each unit of electricity consumed.
• wholesale_elec_price_dollars_per_kwh: the price at which electricity is bought and sold in the wholesale market, measured in U.S. dollars per kilowatt-hour (kWh).
• economic_lifetime_yrs: the economic lifetime of the system, measured in years. It represents the number of years over which the system is expected to remain economically viable and provide value. After this period, the system might be considered outdated, inefficient, or no longer cost-effective, even if it still operates.
• loan_term_yrs: the length of the loan term used to finance the system, measured in years. It defines how long the financing agreement lasts before it must be fully paid off.
• loan_interest_rate: the loan interest rate.
• down_payment_fraction: the down payment fraction.
• real_discount_rate: the rate at which future cash flows are discounted to account for the time value of money, excluding inflation. It is expressed as a percentage.
• tax_rate: the tax rate that applies to the financial transactions or income generated by the syste. It’s expressed as a percentage and is used to calculate the amount of taxes owed on income or savings generated by the system.
• itc_fraction_of_capex: the fraction or percentage of the capital expenditure (CAPEX) for a project that is eligible to be offset by the Investment Tax Credit (ITC).
• inflation_rate: inflation rate.
• system_kw: how much power does the system have.
• batt_kw: the power of the battery.
• batt_kwh: battery energy capacity
• npv: net present value of system + storage
• payback_period: the amount of time required for an investment to repay its initial capital cost through net positive cash flows, savings, or profits. It is expressed in years.
• annual_energy_production_kwh: how much energy can this system produce.
• capacity_factor: the ratio of the actual output of a power system (e.g., solar panels or wind turbines) over a period to the maximum possible output if it operated at full capacity for the same period. It measures the system’s efficiency or utilization.
• first_year_elec_bill_with_system: the total electricity bill in the first year after installing the energy system, including both the cost of electricity from the grid and any contributions from the energy system.
• first_year_elec_bill_savings: the amount of money saved on the electricity bill in the first year due to the energy system, compared to the cost of electricity without the system.
• max_system_kw: the maximum power output (in kilowatts) that the energy system can generate at any given time.
• first_year_elec_bill_without_system: the total electricity bill in the first year if the energy system had not been installed, based on expected consumption and market electricity prices.
• avg_elec_price_cents_per_kwh: the average price of electricity, expressed in cents per kilowatt-hour (kWh), typically used in financial models or to calculate savings and costs.
• max_market_share: the maximum share of the market that a specific energy system or company is expected to capture, often used in market penetration models.
• developable_agent_weight: a weighting factor applied to different agents (such as customers or installations) based on their potential or eligibility for adopting the system.
• initial_batt_kw: the initial power capacity (in kilowatts) of the battery system at the time of installation.
• initial_batt_kwh: the initial energy storage capacity (in kilowatt-hours) of the battery system at the time of installation.
• adopters_cum_last_year: the cumulative number of adopters (e.g., customers or installations) of the system up until the end of the last year.
• system_kw_cum_last_year: the cumulative total power capacity (in kilowatts) of installed energy systems at the end of the previous year.
• batt_kw_cum_last_year: the cumulative total power capacity (in kilowatts) of installed battery systems at the end of the previous year.
• batt_kwh_cum_last_year: the cumulative total energy storage capacity (in kilowatt-hours) of installed battery systems at the end of the previous year.
• market_share_last_year: the percentage of the total market held by a specific product, company, or technology at the end of the previous year.
• bass_param_p: a parameter from the Bass diffusion model that represents the coefficient of innovation, or the rate at which new adopters are influenced by external factors such as advertising or marketing.
• bass_param_q: a parameter from the Bass diffusion model that represents the coefficient of imitation, or the rate at which new adopters are influenced by the adoption behavior of others.
• bass_param_teq: a parameter in the Bass diffusion model that represents the effective time for the adoption process, often related to the expected time when the market will reach a steady state.
• market_share: the current share of the market held by a specific energy system or company, often expressed as a percentage of total market volume or sales.
• new_market_share: the expected or predicted market share for a specific energy system or company in the upcoming period, such as the next year or quarter.
• new_adopters: the number of new adopters (e.g., customers or systems) for a particular energy technology or product in the current period.
• new_system_kw: the additional power capacity (in kilowatts) of new energy systems installed during the current period.
• new_batt_kw: the additional power capacity (in kilowatts) of new battery systems installed during the current period.
• new_batt_kwh: the additional energy storage capacity (in kilowatt-hours) of new battery systems installed during the current period.
• number_of_adopters: the total number of adopters (e.g., customers, installations, or systems) for a specific energy product or system, typically used as an indicator of market penetration.
• system_kw_cum: the cumulative total power capacity (in kilowatts) of all installed energy systems over time, regardless of the time period.
• batt_kw_cum: the cumulative total power capacity (in kilowatts) of all installed battery systems over time.
• batt_kwh_cum: the cumulative total energy storage capacity (in kilowatt-hours) of all installed battery systems over time.
• max_market_share_last_year: the maximum market share that a specific energy system or company achieved at any point in the previous year.