Outputs

Financial results keys:

• lcc Optimal lifecycle cost
• lifecycle_generation_tech_capital_costs LCC component. Net capital costs for all generation technologies, in present value, including replacement costs and incentives. This value does not include offgridothercapital_costs.
• lifecycle_storage_capital_costs LCC component. Net capital costs for all storage technologies, in present value, including replacement costs and incentives. This value does not include offgridothercapital_costs.
• lifecycle_om_costs_after_tax LCC component. Present value of all O&M costs, after tax. (does not include fuel costs)
• lifecycle_fuel_costs_after_tax LCC component. Present value of all fuel costs over the analysis period, after tax.
• lifecycle_chp_standby_cost_after_tax LCC component. Present value of all CHP standby charges, after tax.
• lifecycle_elecbill_after_tax LCC component. Present value of all electric utility charges, including compensation for exports, after tax.
• lifecycle_production_incentive_after_tax LCC component. Present value of all production-based incentives, after tax.
• lifecycle_offgrid_other_annual_costs_after_tax LCC component. Present value of offgridotherannual_costs over the analysis period, after tax.
• lifecycle_offgrid_other_capital_costs LCC component. Equal to offgridothercapital_costs with straight line depreciation applied over analysis period. The depreciation expense is assumed to reduce the owner's taxable income.
• lifecycle_outage_cost LCC component. Expected outage cost.
• lifecycle_MG_upgrade_and_fuel_cost LCC component. Cost to upgrade generation and storage technologies to be included in microgrid, plus expected microgrid fuel costs, assuming outages occur in first year with specified probabilities.
• lifecycle_om_costs_before_tax Present value of all O&M costs, before tax.
• year_one_total_operating_cost_before_tax Year one total operating costs, before tax. Includes energy costs, export value, O&M, fuel, and standby costs.
• year_one_total_operating_cost_after_tax Year one total operating costs, after tax. Includes energy costs, export value, O&M, fuel, and standby costs.
• year_one_fuel_cost_before_tax Year one fuel costs, before tax. Does not include fuel use during outages if using multiple outage modeling.
• year_one_fuel_cost_after_tax Year one fuel costs, after tax. Does not include fuel use during outages if using multiple outage modeling.
• year_one_om_costs_before_tax Year one O&M costs, before tax.
• year_one_om_costs_after_tax Year one O&M costs, after tax.
• year_one_chp_standby_cost_after_tax Year one CHP standby costs, after tax.
• year_one_chp_standby_cost_before_tax Year one CHP standby costs, before tax.
• lifecycle_capital_costs_plus_om_after_tax Capital cost for all technologies plus present value of operations and maintenance over anlaysis period.
• lifecycle_capital_costs Net capital costs for all technologies, in present value, including replacement costs and incentives.
• initial_capital_costs Up-front capital costs for all technologies, in present value, excluding replacement costs and incentives. If third party ownership, represents cost to third party.
• initial_capital_costs_after_incentives Up-front capital costs for all technologies, in present value, excluding replacement costs, and accounting for incentives. Note: the ITC and MACRS are discounted by 1 year, and 1-7 years, respectively, to obtain the present value. If third party ownership, represents cost to third party.
• replacements_future_cost_after_tax Future cost of replacing storage and/or generator systems, after tax.
• replacements_present_cost_after_tax Present value cost of replacing storage and/or generator systems, after tax.
• om_and_replacement_present_cost_after_tax Present value of all O&M and replacement costs, after tax.
• developer_om_and_replacement_present_cost_after_tax Present value of all O&M and replacement costs incurred by developer, after tax.
• offgrid_microgrid_lcoe_dollars_per_kwh Levelized cost of electricity for modeled off-grid system.
• lifecycle_emissions_cost_climate LCC component if Settings input includeclimatein_objective is true. Present value of CO2 emissions cost over the analysis period.
• lifecycle_emissions_cost_health LCC component if Settings input includehealthin_objective is true. Present value of NOx, SO2, and PM2.5 emissions cost over the analysis period.

calculated in combine_results function if BAU scenario is run:

• breakeven_cost_of_emissions_reduction_per_tonne_CO2

combine_results(bau::Dict, opt::Dict)

Combine two results dictionaries into one using BAU and optimal scenario results. New fields added to the Financial output/results:

• npv: Net Present Value of the optimal scenario
• year_one_total_operating_cost_savings_before_tax: Total operating cost savings in year 1 before tax
• year_one_total_operating_cost_savings_after_tax: Total operating cost savings in year 1 after tax
• breakeven_cost_of_emissions_reduction_per_tonne_CO2: Breakeven cost of CO2 (usd per tonne) that would yield an npv of 0, holding all other inputs constant
• lifecycle_emissions_reduction_CO2_fraction: Fraction of CO2 emissions reduced in the optimal scenario compared to the BAU scenario

ElectricLoad results keys:

• load_series_kw # vector of BAU site load in every time step. Does not include electric load for any new heating or cooling techs.
• critical_load_series_kw # vector of site critical load in every time step
• annual_calculated_kwh # sum of the load_series_kw. Does not include electric load for any new heating or cooling techs.
• annual_electric_load_with_thermal_conversions_kwh # Total end-use electrical load, including electrified heating and cooling end-use load
• offgrid_load_met_series_kw # vector of electric load met by generation techs, for off-grid scenarios only
• offgrid_load_met_fraction # percentage of total electric load met on an annual basis, for off-grid scenarios only
• offgrid_annual_oper_res_required_series_kwh # total operating reserves required (for load and techs) on an annual basis, for off-grid scenarios only
• offgrid_annual_oper_res_provided_series_kwh # total operating reserves provided on an annual basis, for off-grid scenarios only
• monthly_calculated_kwh # vector of monthly energy consumption at a site
• monthly_peaks_kw # vector of monthly peak demand
• annual_peak_kw # annual peak electricity demand

ElectricUtility results keys:

• annual_energy_supplied_kwh # Total energy supplied from the grid in an average year.
• electric_to_load_series_kw # Vector of power drawn from the grid to serve load.
• electric_to_storage_series_kw # Vector of power drawn from the grid to charge the battery.
• annual_renewable_electricity_supplied_kwh # Total renewable electricity supplied from the grid in an average year.
• annual_emissions_tonnes_CO2 # Average annual total tons of CO2 emissions associated with the site's grid-purchased electricity. If includeexportedelecemissionsin_total is False, this value only reflects grid purchases. Otherwise, it accounts for emissions offset from any export to the grid.
• annual_emissions_tonnes_NOx # Average annual total tons of NOx emissions associated with the site's grid-purchased electricity. If includeexportedelecemissionsin_total is False, this value only reflects grid purchases. Otherwise, it accounts for emissions offset from any export to the grid.
• annual_emissions_tonnes_SO2 # Average annual total tons of SO2 emissions associated with the site's grid-purchased electricity. If includeexportedelecemissionsin_total is False, this value only reflects grid purchases. Otherwise, it accounts for emissions offset from any export to the grid.
• annual_emissions_tonnes_PM25 # Average annual total tons of PM25 emissions associated with the site's grid-purchased electricity. If includeexportedelecemissionsin_total is False, this value only reflects grid purchsaes. Otherwise, it accounts for emissions offset from any export to the grid.
• lifecycle_emissions_tonnes_CO2 # Total tons of CO2 emissions associated with the site's grid-purchased electricity over the analysis period. If includeexportedelecemissionsin_total is False, this value only reflects grid purchaes. Otherwise, it accounts for emissions offset from any export to the grid.
• lifecycle_emissions_tonnes_NOx # Total tons of NOx emissions associated with the site's grid-purchased electricity over the analysis period. If includeexportedelecemissionsin_total is False, this value only reflects grid purchaes. Otherwise, it accounts for emissions offset from any export to the grid.
• lifecycle_emissions_tonnes_SO2 # Total tons of SO2 emissions associated with the site's grid-purchased electricity over the analysis period. If includeexportedelecemissionsin_total is False, this value only reflects grid purchaes. Otherwise, it accounts for emissions offset from any export to the grid.
• lifecycle_emissions_tonnes_PM25 # Total tons of PM2.5 emissions associated with the site's grid-purchased electricity over the analysis period. If includeexportedelecemissionsin_total is False, this value only reflects grid purchaes. Otherwise, it accounts for emissions offset from any export to the grid.
• avert_emissions_region # EPA AVERT region of the site. Used for health-related emissions from grid electricity (populated if default emissions values are used) and climate emissions if "co2fromavert" is set to true.
• distance_to_avert_emissions_region_meters # Distance in meters from the site to the nearest AVERT emissions region.
• cambium_region # NREL Cambium region of the site. Used for climate-related emissions from grid electricity (populated only if default (Cambium) climate emissions values are used)

PV results keys:

• size_kw Optimal PV DC capacity
• lifecycle_om_cost_after_tax Lifecycle operations and maintenance cost in present value, after tax
• year_one_energy_produced_kwh Energy produced over the first year
• annual_energy_produced_kwh Average annual energy produced, accounting for degradation. Includes curtailed energy.
• lcoe_per_kwh Levelized Cost of Energy produced by the PV system
• electric_to_load_series_kw Vector of power used to meet load over an average year
• electric_to_storage_series_kw Vector of power used to charge the battery over an average year
• electric_to_grid_series_kw Vector of power exported to the grid over an average year
• electric_curtailed_series_kw Vector of power curtailed over an average year
• annual_energy_exported_kwh Average annual energy exported to the grid
• production_factor_series PV production factor in each time step, either provided by user or obtained from PVWatts

Wind results keys:

• size_kw Optimal Wind capacity [kW]
• lifecycle_om_cost_after_tax Lifecycle operations and maintenance cost in present value, after tax
• year_one_om_cost_before_tax Operations and maintenance cost in the first year, before tax benefits
• electric_to_storage_series_kw Vector of power used to charge the battery over an average year
• electric_to_grid_series_kw Vector of power exported to the grid over an average year
• annual_energy_exported_kwh Average annual energy exported to the grid
• electric_to_load_series_kw Vector of power used to meet load over an average year
• annual_energy_produced_kwh Average annual energy produced, accounting for degradation. Includes curtailed energy.
• lcoe_per_kwh Levelized Cost of Energy produced by the PV system
• electric_curtailed_series_kw Vector of power curtailed over an average year
• production_factor_series Wind production factor in each time step, either provided by user or obtained from SAM

ElectricStorage results keys:

• size_kw Optimal inverter capacity
• size_kwh Optimal storage capacity
• soc_series_fraction Vector of normalized (0-1) state of charge values over the first year
• storage_to_load_series_kw Vector of power used to meet load over the first year
• initial_capital_cost Upfront capital cost for storage and inverter

The following results are reported if storage degradation is modeled:

• state_of_health
• maintenance_cost
• replacement_month # only applies is maintenance_strategy = "replacement"
• residual_value
• total_residual_kwh # only applies is maintenance_strategy = "replacement"

HotThermalStorage results keys:

• size_gal Optimal TES capacity, by volume [gal]
• soc_series_fraction Vector of normalized (0-1) state of charge values over the first year [-]
• storage_to_load_series_mmbtu_per_hour Vector of power used to meet load over the first year [MMBTU/hr]

HighTempThermalStorage results keys:

• size_kwh Optimal TES capacity, by energy capacity [kWh]
• soc_series_fraction Vector of normalized (0-1) state of charge values over the first year [-]
• storage_to_load_series_mmbtu_per_hour Vector of power used to meet load over the first year [MMBTU/hr]

ColdThermalStorage results:

• size_gal Optimal TES capacity, by volume [gal]
• soc_series_fraction Vector of normalized (0-1) state of charge values over the first year [-]
• storage_to_load_series_ton Vector of power used to meet load over the first year [ton]

Generator results keys:

• size_kw Optimal generator capacity
• lifecycle_fixed_om_cost_after_tax Lifecycle fixed operations and maintenance cost in present value, after tax
• year_one_fixed_om_cost_before_tax fixed operations and maintenance cost over the first year, before considering tax benefits
• lifecycle_variable_om_cost_after_tax Lifecycle variable operations and maintenance cost in present value, after tax
• year_one_variable_om_cost_before_tax variable operations and maintenance cost over the first year, before considering tax benefits
• lifecycle_fuel_cost_after_tax Lifecycle fuel cost in present value, after tax
• year_one_fuel_cost_before_tax Fuel cost over the first year, before considering tax benefits. Does not include fuel use during outages if using multiple outage modeling.
• year_one_fuel_cost_after_tax Fuel cost over the first year, after considering tax benefits. Does not include fuel use during outages if using multiple outage modeling.
• annual_fuel_consumption_gal Gallons of fuel used in each year
• electric_to_storage_series_kw Vector of power sent to battery in an average year
• electric_to_grid_series_kw Vector of power sent to grid in an average year
• electric_to_load_series_kw Vector of power sent to load in an average year
• annual_energy_produced_kwh Average annual energy produced over analysis period

ExistingBoiler results keys:

• size_mmbtu_per_hour # Thermal production capacity size of the Boiler [MMBtu/hr]
• fuel_consumption_series_mmbtu_per_hour # Fuel consumption series [MMBtu/hr]
• annual_fuel_consumption_mmbtu # Fuel consumed in a year [MMBtu]
• thermal_production_series_mmbtu_per_hour # Thermal energy production series [MMBtu/hr]
• annual_thermal_production_mmbtu # Thermal power production in a year [MMBtu]
• thermal_to_storage_series_mmbtu_per_hour # Thermal power production to TES (HotThermalStorage) series [MMBtu/hr]
• thermal_to_steamturbine_series_mmbtu_per_hour # Thermal power production to SteamTurbine series [MMBtu/hr]
• thermal_to_load_series_mmbtu_per_hour # Thermal power production to serve the heating load series [MMBtu/hr]
• lifecycle_fuel_cost_after_tax # Life cycle fuel cost [$]
• year_one_fuel_cost_before_tax # Year one fuel cost, before tax [$]
• year_one_fuel_cost_after_tax # Year one fuel cost, after tax [$]

CHP results keys:

• size_kw Power capacity size of the CHP system [kW]
• size_supplemental_firing_kw Power capacity of CHP supplementary firing system [kW]
• annual_fuel_consumption_mmbtu Fuel consumed in a year [MMBtu]
• annual_electric_production_kwh Electric energy produced in a year [kWh]
• annual_thermal_production_mmbtu Thermal energy produced in a year (not including curtailed thermal) [MMBtu]
• electric_production_series_kw Electric power production time-series array [kW]
• electric_to_grid_series_kw Electric power exported time-series array [kW]
• electric_to_storage_series_kw Electric power to charge the battery storage time-series array [kW]
• electric_to_load_series_kw Electric power to serve the electric load time-series array [kW]
• thermal_to_storage_series_mmbtu_per_hour Thermal power to TES (HotThermalStorage) time-series array [MMBtu/hr]
• thermal_curtailed_series_mmbtu_per_hour Thermal power wasted/unused/vented time-series array [MMBtu/hr]
• thermal_to_load_series_mmbtu_per_hour Thermal power to serve the heating load time-series array [MMBtu/hr]
• thermal_to_steamturbine_series_mmbtu_per_hour Thermal (steam) power to steam turbine time-series array [MMBtu/hr]
• year_one_fuel_cost_before_tax Cost of fuel consumed by the CHP system in year one, before tax [$]
• year_one_fuel_cost_after_tax Cost of fuel consumed by the CHP system in year one, after tax
• lifecycle_fuel_cost_after_tax Present value of cost of fuel consumed by the CHP system, after tax [$]
• year_one_standby_cost_before_tax CHP standby charges in year one, before tax [$]
• year_one_standby_cost_after_tax CHP standby charges in year one, after tax
• lifecycle_standby_cost_after_tax Present value of all CHP standby charges, after tax.
• thermal_production_series_mmbtu_per_hour
• initial_capital_costs Initial capital costs of the CHP system, before incentives [$]

Boiler results keys:

• size_mmbtu_per_hour # Thermal production capacity size of the Boiler [MMBtu/hr]
• fuel_consumption_series_mmbtu_per_hour # Fuel consumption series [MMBtu/hr]
• annual_fuel_consumption_mmbtu # Fuel consumed in a year [MMBtu]
• thermal_production_series_mmbtu_per_hour # Thermal energy production series [MMBtu/hr]
• annual_thermal_production_mmbtu # Thermal energy produced in a year [MMBtu]
• thermal_to_storage_series_mmbtu_per_hour # Thermal power production to TES (HotThermalStorage) series [MMBtu/hr]
• thermal_to_steamturbine_series_mmbtu_per_hour # Thermal power production to SteamTurbine series [MMBtu/hr]
• thermal_to_load_series_mmbtu_per_hour # Thermal power production to serve the heating load series [MMBtu/hr]
• lifecycle_fuel_cost_after_tax # Life cycle fuel cost [$]
• year_one_fuel_cost_before_tax # Year one fuel cost, before tax [$]
• year_one_fuel_cost_after_tax # Year one fuel cost, after tax [$]
• lifecycle_per_unit_prod_om_costs # Life cycle production-based O&M cost [$]

HeatingLoad results keys:

• dhw_thermal_load_series_mmbtu_per_hour vector of site thermal domestic hot water load in every time step
• space_heating_thermal_load_series_mmbtu_per_hour vector of site thermal space heating load in every time step
• process_heat_thermal_load_series_mmbtu_per_hour vector of site thermal process heat load in every time step
• total_heating_thermal_load_series_mmbtu_per_hour vector of sum thermal heating load in every time step
• dhw_boiler_fuel_load_series_mmbtu_per_hour vector of site fuel domestic hot water load in every time step
• space_heating_boiler_fuel_load_series_mmbtu_per_hour vector of site fuel space heating load in every time step
• process_heat_boiler_fuel_load_series_mmbtu_per_hour vector of site fuel process heat load in every time step
• total_heating_thermal_load_series_mmbtu_per_hour vector of sum fuel heating load in every time step
• annual_calculated_dhw_thermal_load_mmbtu sum of the dhw_thermal_load_series_mmbtu_per_hour
• annual_calculated_space_heating_thermal_load_mmbtu sum of the space_heating_thermal_load_series_mmbtu_per_hour
• annual_calculated_process_heat_thermal_load_mmbtu sum of the process_heat_thermal_load_series_mmbtu_per_hour
• annual_calculated_total_heating_thermal_load_mmbtu sum of the total_heating_thermal_load_series_mmbtu_per_hour
• annual_calculated_dhw_boiler_fuel_load_mmbtu sum of the dhw_boiler_fuel_load_series_mmbtu_per_hour
• annual_calculated_space_heating_boiler_fuel_load_mmbtu sum of the space_heating_boiler_fuel_load_series_mmbtu_per_hour
• annual_calculated_process_heat_boiler_fuel_load_mmbtu sum of the process_heat_boiler_fuel_load_series_mmbtu_per_hour
• annual_calculated_total_heating_boiler_fuel_load_mmbtu sum of the total_heating_boiler_fuel_load_series_mmbtu_per_hour

CoolingLoad results keys:

• load_series_ton # vector of site cooling load in every time step
• annual_calculated_tonhour # sum of the load_series_ton. Annual site total cooling load [tonhr]
• electric_chiller_base_load_series_kw # Hourly total base load drawn from chiller [kW-electric]
• annual_electric_chiller_base_load_kwh # Annual total base load drawn from chiller [kWh-electric]

Outages results keys:

• expected_outage_cost The expected outage cost over the random outages modeled.
• max_outage_cost_per_outage_duration The maximum outage cost in every outage duration modeled.
• unserved_load_series_kw The amount of unserved load in each outage and each time step.
• unserved_load_per_outage_kwh The total unserved load in each outage.
• storage_microgrid_upgrade_cost The cost to include the storage system in the microgrid.
• storage_discharge_series_kw Array of storage power discharged in every outage modeled.
• pv_microgrid_size_kw Optimal microgrid PV capacity. Note that the name PV can change based on user provided PV.name.
• pv_microgrid_upgrade_cost The cost to include the PV system in the microgrid.
• pv_to_storage_series_kw Array of PV power sent to the battery in every outage modeled.
• pv_curtailed_series_kw Array of PV curtailed in every outage modeled.
• pv_to_load_series_kw Array of PV power used to meet load in every outage modeled.
• wind_microgrid_size_kw Optimal microgrid Wind capacity.
• wind_microgrid_upgrade_cost The cost to include the Wind system in the microgrid.
• wind_to_storage_series_kw Array of Wind power sent to the battery in every outage modeled.
• wind_curtailed_series_kw Array of Wind curtailed in every outage modeled.
• wind_to_load_series_kw Array of Wind power used to meet load in every outage modeled.
• generator_microgrid_size_kw Optimal microgrid Generator capacity. Note that the name Generator can change based on user provided Generator.name.
• generator_microgrid_upgrade_cost The cost to include the Generator system in the microgrid.
• generator_to_storage_series_kw Array of Generator power sent to the battery in every outage modeled.
• generator_curtailed_series_kw Array of Generator curtailed in every outage modeled.
• generator_to_load_series_kw Array of Generator power used to meet load in every outage modeled.
• generator_fuel_used_per_outage_gal Array of fuel used in every outage modeled, summed over all Generators.
• chp_microgrid_size_kw Optimal microgrid CHP capacity.
• chp_microgrid_upgrade_cost The cost to include the CHP system in the microgrid.
• chp_to_storage_series_kw Array of CHP power sent to the battery in every outage modeled.
• chp_curtailed_series_kw Array of CHP curtailed in every outage modeled.
• chp_to_load_series_kw Array of CHP power used to meet load in every outage modeled.
• chp_fuel_used_per_outage_mmbtu Array of fuel used in every outage modeled, summed over all CHPs.
• microgrid_upgrade_capital_cost Total capital cost of including technologies in the microgrid
• critical_loads_per_outage_series_kw Critical load series in every outage modeled
• soc_series_fraction ElectricStorage state of charge series in every outage modeled

AbsorptionChiller results keys:

• size_kw # Optimal power capacity size of the absorption chiller system [kW]
• size_ton
• thermal_to_storage_series_ton # Thermal production to ColdThermalStorage
• thermal_to_load_series_ton # Thermal production to cooling load
• thermal_consumption_series_mmbtu_per_hour
• annual_thermal_consumption_mmbtu
• annual_thermal_production_tonhour
• electric_consumption_series_kw
• annual_electric_consumption_kwh

FlexibleHVAC results keys:

• purchased
• temperatures_degC_node_by_time
• upgrade_cost

SteamTurbine results keys:

• size_kw Power capacity size [kW]
• annual_thermal_consumption_mmbtu Thermal (steam) consumption [MMBtu]
• annual_electric_production_kwh Electric energy produced in a year [kWh]
• annual_thermal_production_mmbtu Thermal energy produced in a year [MMBtu]
• thermal_consumption_series_mmbtu_per_hour Thermal (steam) energy consumption series [MMBtu/hr]
• electric_production_series_kw Electric power production series [kW]
• electric_to_grid_series_kw Electric power exported to grid series [kW]
• electric_to_storage_series_kw Electric power to charge the battery series [kW]
• electric_to_load_series_kw Electric power to serve load series [kW]
• thermal_to_storage_series_mmbtu_per_hour Thermal production to charge the HotThermalStorage series [MMBtu/hr]
• thermal_to_load_series_mmbtu_per_hour Thermal production to serve the heating load SERVICES [MMBtu/hr]