Outputs
Financial outputs
REopt.add_financial_results — FunctionFinancial results keys:
lccOptimal lifecycle costlifecycle_generation_tech_capital_costsLCC 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_costsLCC 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_taxLCC component. Present value of all O&M costs, after tax.lifecycle_fuel_costs_after_taxLCC component. Present value of all fuel costs over the analysis period, after tax.lifecycle_chp_standby_cost_after_taxLCC component. Present value of all CHP standby charges, after tax.lifecycle_elecbill_after_taxLCC component. Present value of all electric utility charges, after tax.lifecycle_production_incentive_after_taxLCC component. Present value of all production-based incentives, after tax.lifecycle_offgrid_other_annual_costs_after_taxLCC component. Present value of offgridotherannual_costs over the analysis period, after tax.lifecycle_offgrid_other_capital_costsLCC 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_costLCC component. Expected outage cost.lifecycle_MG_upgrade_and_fuel_costLCC component. Cost to upgrade generation and storage technologies to be included in microgrid, plus present value of microgrid fuel costs.lifecycle_om_costs_before_taxPresent value of all O&M costs, before tax.year_one_om_costs_before_taxYear one O&M costs, before tax.year_one_om_costs_after_taxYear one O&M costs, after tax.lifecycle_capital_costs_plus_om_after_taxCapital cost for all technologies plus present value of operations and maintenance over anlaysis period. This value does not include offgridothercapital_costs.lifecycle_capital_costsNet capital costs for all technologies, in present value, including replacement costs and incentives. This value does not include offgridothercapital_costs.initial_capital_costsUp-front capital costs for all technologies, in present value, excluding replacement costs and incentives. This value does not include offgridothercapital_costs.initial_capital_costs_after_incentivesUp-front capital costs for all technologies, in present value, excluding replacement costs, and accounting for incentives. This value does not include offgridothercapital_costs.replacements_future_cost_after_taxFuture cost of replacing storage and/or generator systems, after tax.replacements_present_cost_after_taxPresent value cost of replacing storage and/or generator systems, after tax.om_and_replacement_present_cost_after_taxPresent value of all O&M and replacement costs, after tax.developer_om_and_replacement_present_cost_after_taxPresent value of all O&M and replacement costs incurred by developer, after tax.offgrid_microgrid_lcoe_dollars_per_kwhLevelized cost of electricity for modeled off-grid system.lifecycle_emissions_cost_climateLCC component if Settings input includeclimatein_objective is true. Present value of CO2 emissions cost over the analysis period.lifecycle_emissions_cost_healthLCC component if Settings input includehealthin_objective is true. Present value of NOx, SO2, and PM2.5 emissions cost over the analysis period.
calculated in combineresults function if BAU scenario is run: - `breakevencostofemissionsreductionpertonnesCO2`
ElectricTariff outputs
REopt.add_electric_tariff_results — MethodElectricTariff results keys:
lifecycle_energy_cost_after_taxlifecycle cost of energy from the grid in present value, after taxyear_one_energy_cost_before_taxcost of energy from the grid over the first year, before considering tax benefitslifecycle_demand_cost_after_taxlifecycle cost of power from the grid in present value, after taxyear_one_demand_cost_before_taxcost of power from the grid over the first year, before considering tax benefitslifecycle_fixed_cost_after_taxlifecycle fixed cost in present value, after taxyear_one_fixed_cost_before_taxfixed cost over the first year, before considering tax benefitslifecycle_min_charge_adder_after_taxlifecycle minimum charge in present value, after taxyear_one_min_charge_adder_before_taxminimum charge over the first year, before considering tax benefitsyear_one_bill_before_taxsum ofyear_one_energy_cost_before_tax,year_one_demand_cost_before_tax,year_one_fixed_cost_before_tax,year_one_min_charge_adder_before_tax, andyear_one_coincident_peak_cost_before_taxlifecycle_export_benefit_after_taxlifecycle export credits in present value, after taxyear_one_export_benefit_before_taxexport credits over the first year, before considering tax benefitslifecycle_coincident_peak_cost_after_taxlifecycle coincident peak charge in present value, after taxyear_one_coincident_peak_cost_before_taxcoincident peak charge over the first year
ElectricLoad outputs
REopt.add_electric_load_results — FunctionElectricLoad results keys:
load_series_kwvector of site load in every time stepcritical_load_series_kwvector of site critical load in every time stepannual_calculated_kwhsum of theload_series_kwoffgrid_load_met_series_kwvector of electric load met by generation techs, for off-grid scenarios onlyoffgrid_load_met_fractionpercentage of total electric load met on an annual basis, for off-grid scenarios onlyoffgrid_annual_oper_res_required_series_kwh, total operating reserves required (for load and techs) on an annual basis, for off-grid scenarios onlyoffgrid_annual_oper_res_provided_series_kwh, total operating reserves provided on an annual basis, for off-grid scenarios only
ElectricUtility outputs
REopt.add_electric_utility_results — MethodElectricUtility results keys:
year_one_energy_supplied_kwhTotal energy supplied from the grid in year one.year_one_to_load_series_kwVector of power drawn from the grid to serve load in year one.year_one_to_battery_series_kwVector of power drawn from the grid to charge the battery in year one.year_one_emissions_tonnes_CO2year_one_emissions_tonnes_NOxyear_one_emissions_tonnes_SO2year_one_emissions_tonnes_PM25lifecycle_emissions_tonnes_CO2lifecycle_emissions_tonnes_NOxlifecycle_emissions_tonnes_SO2lifecycle_emissions_tonnes_PM25emissions_regiondistance_to_emissions_region_meters
PV outputs
REopt.add_pv_results — MethodPV results keys:
size_kwOptimal PV capacitylifecycle_om_cost_after_taxLifecycle operations and maintenance cost in present value, after taxyear_one_energy_produced_kwhEnergy produced over the first yearaverage_annual_energy_produced_kwhAverage annual energy produced when accounting for degradationlcoe_per_kwhLevelized Cost of Energy produced by the PV systemyear_one_to_load_series_kwVector of power used to meet load over the first yearyear_one_to_battery_series_kwVector of power used to charge the battery over the first yearyear_one_to_grid_series_kwVector of power exported to the grid over the first yearyear_one_curtailed_production_series_kwVector of power curtailed over the first yearaverage_annual_energy_exported_kwhAverage annual energy exported to the grid
The key(s) used to access PV outputs in the results dictionary is determined by the PV.name value to allow for modeling multiple PV options. (The default PV.name is "PV".)
Wind outputs
REopt.add_wind_results — FunctionWind results keys:
size_kwOptimal Wind capacitylifecycle_om_cost_after_taxLifecycle operations and maintenance cost in present value, after taxyear_one_om_cost_before_taxOperations and maintenance cost in the first year, before tax benefitsyear_one_to_battery_series_kwVector of power used to charge the battery over the first yearyear_one_to_grid_series_kwVector of power exported to the grid over the first yearaverage_annual_energy_exported_kwhAverage annual energy exported to the gridyear_one_to_load_series_kwVector of power used to meet load over the first yearyear_one_energy_produced_kwhEnergy produced over the first yearaverage_annual_energy_produced_kwhAverage annual energy produced when accounting for degradationlcoe_per_kwhLevelized Cost of Energy produced by the PV systemyear_one_curtailed_production_series_kwVector of power curtailed over the first year
ElectricStorage outputs
REopt.add_electric_storage_results — MethodElectricStorage results keys:
size_kwOptimal inverter capacitysize_kwhOptimal storage capacityyear_one_soc_series_fractionVector of normalized (0-1) state of charge values over the first yearyear_one_to_load_series_kwVector of power used to meet load over the first yearinitial_capital_costUpfront capital cost for storage and inverter
The following results are reported if storage degradation is modeled
state_of_healthmaintenance_costreplacement_month
HotThermalStorage outputs
REopt.add_hot_storage_results — MethodHotThermalStorage results keys:
size_galOptimal TES capacity, by volume [gal]year_one_soc_series_fractionVector of normalized (0-1) state of charge values over the first year [-]year_one_to_load_series_mmbtu_per_hourVector of power used to meet load over the first year [MMBTU/hr]
ColdThermalStorage outputs
REopt.add_cold_storage_results — MethodColdThermalStorage results:
size_galOptimal TES capacity, by volume [gal]year_one_soc_series_fractionVector of normalized (0-1) state of charge values over the first year [-]year_one_to_load_series_tonVector of power used to meet load over the first year [ton]
Generator outputs
REopt.add_generator_results — MethodGenerator results keys:
size_kwOptimal generator capacitylifecycle_fixed_om_cost_after_taxLifecycle fixed operations and maintenance cost in present value, after taxyear_one_fixed_om_cost__before_taxfixed operations and maintenance cost over the first year, before considering tax benefitslifecycle_variable_om_cost_after_taxLifecycle variable operations and maintenance cost in present value, after taxyear_one_variable_om_cost_before_taxvariable operations and maintenance cost over the first year, before considering tax benefitslifecycle_fuel_cost_after_taxLifecycle fuel cost in present value, after taxyear_one_fuel_cost_before_taxFuel cost over the first year, before considering tax benefitsaverage_annual_fuel_used_galGallons of fuel used in each yearyear_one_to_battery_series_kwVector of power sent to battery in year oneyear_one_to_grid_series_kwVector of power sent to grid in year oneyear_one_to_load_series_kwVector of power sent to load in year oneyear_one_energy_produced_kwhTotal energy produced in year oneaverage_annual_energy_produced_kwhAverage annual energy produced over analysis period
ExistingBoiler outputs
REopt.add_existing_boiler_results — FunctionExistingBoiler results keys:
year_one_fuel_consumption_series_mmbtu_per_houryear_one_fuel_consumption_mmbtuyear_one_thermal_production_series_mmbtu_per_houryear_one_thermal_production_mmbtuyear_one_thermal_to_tes_series_mmbtu_per_houryear_one_thermal_to_load_series_mmbtu_per_hourlifecycle_fuel_cost_after_taxyear_one_fuel_cost_before_tax
CHP outputs
REopt.add_chp_results — FunctionCHP results keys:
size_kw# Power capacity size of the CHP system [kW]size_supplemental_firing_kw# Power capacity of CHP supplementary firing system [kW]year_one_fuel_used_mmbtu# Fuel consumed in year one [MMBtu]year_one_electric_energy_produced_kwh# Electric energy produced in year one [kWh]year_one_thermal_energy_produced_mmbtu# Thermal energy produced in year one [MMBtu]year_one_electric_production_series_kw# Electric power production time-series array [kW]year_one_to_grid_series_kw# Electric power exported time-series array [kW]year_one_to_battery_series_kw# Electric power to charge the battery storage time-series array [kW]year_one_to_load_series_kw# Electric power to serve the electric load time-series array [kW]year_one_thermal_to_tes_series_mmbtu_per_hour# Thermal power to TES time-series array [MMBtu/hr]year_one_thermal_to_waste_series_mmbtu_per_hour# Thermal power wasted/unused/vented time-series array [MMBtu/hr]year_one_thermal_to_load_series_mmbtu_per_hour# Thermal power to serve the heating load time-series array [MMBtu/hr]year_one_chp_fuel_cost_before_tax# Fuel cost from fuel consumed by the CHP system [$]lifecycle_chp_fuel_cost_after_tax# Fuel cost from fuel consumed by the CHP system, after tax [$]year_one_chp_standby_cost_before_tax# CHP standby charges in year one [$]
Boiler outputs
Missing docstring for REopt.add_boiler_results. Check Documenter's build log for details.
Uncertain Outages outputs
REopt.add_outage_results — FunctionOutages results keys:
expected_outage_costThe expected outage cost over the random outages modeled.max_outage_cost_per_outage_duration_seriesThe maximum outage cost in every outage duration modeled.unserved_load_seriesThe amount of unserved load in each outage and each time step.unserved_load_per_outage_seriesThe total unserved load in each outage.mg_storage_upgrade_costThe cost to include the storage system in the microgrid.storage_upgradedBoolean that is true if it is cost optimal to include the storage system in the microgrid.
= discharge_from_storage_series Array of storage power discharged in every outage modeled.
PVmg_kwOptimal microgrid PV capacity. Note that the namePVcan change based on user providedPV.name.mg_PV_upgrade_costThe cost to include the PV system in the microgrid.mgPV_to_storage_seriesArray of PV power sent to the battery in every outage modeled.mgPV_curtailed_seriesArray of PV curtailed in every outage modeled.mgPV_to_load_seriesArray of PV power used to meet load in every outage modeled.Generatormg_kwOptimal microgrid Generator capacity. Note that the nameGeneratorcan change based on user providedGenerator.name.mg_Generator_upgrade_costThe cost to include the Generator system in the microgrid.mgGenerator_to_storage_seriesArray of Generator power sent to the battery in every outage modeled.mgGenerator_curtailed_seriesArray of Generator curtailed in every outage modeled.mgGenerator_to_load_seriesArray of Generator power used to meet load in every outage modeled.mg_Generator_fuel_usedArray of Generator fuel used in every outage modeled.
The output keys for "Outages" are subject to change.
Outage results only added to results when multiple outages are modeled via the ElectricUtility.outage_durations input.
When modeling PV the name of the PV system is used for the output keys to allow for modeling multiple PV systems. The default PV name is PV.
The Outage results can be very large when many outages are modeled and can take a long time to generate.
AbsorptionChiller outputs
REopt.add_absorption_chiller_results — FunctionAbsorptionChiller results keys:
size_kwPower capacity size of the absorption chiller system [kW]size_tonyear_one_to_tes_series_tonyear_one_thermal_consumption_seriesyear_one_thermal_consumption_kwhyear_one_thermal_production_tonhouryear_one_electric_consumption_seriesyear_one_electric_consumption_kwh
FlexibleHVAC outputs
REopt.add_flexible_hvac_results — FunctionFlexibleHVAC results keys:
purchasedtemperatures_degC_node_by_timeupgrade_cost
SteamTurbine outputs
REopt.add_steam_turbine_results — FunctionSteamTurbine results keys:
size_kwPower capacity size [kW]year_one_thermal_consumption_mmbtuThermal (steam) consumption [MMBtu]year_one_electric_energy_produced_kwhElectric energy produced in a year [kWh]year_one_thermal_energy_produced_mmbtuThermal energy produced in a year [MMBtu]year_one_thermal_consumption_series_mmbtu_per_hourThermal (steam) energy consumption series [MMBtu/hr]year_one_electric_production_series_kwElectric power production series [kW]year_one_electric_to_grid_series_kwElectric power exported to grid series [kW]year_one_electric_to_battery_series_kwElectric power to charge the battery series [kW]year_one_electric_to_load_series_kwElectric power to serve load series [kW]year_one_thermal_to_tes_series_mmbtu_per_hourThermal production to charge the HotThermalStorage series [MMBtu/hr]year_one_thermal_to_load_series_mmbtu_per_hourThermal production to serve the heating load SERVICES [MMBtu/hr]