Optional Outputs¶
Optional outputs include annual component loads, emissions, utility bills, and quantities of interest. Additionally, timeseries outputs can be requested.
To be generated, some optional outputs need only a single switch enabled (e.g., component loads). Others need additional input arguments specified (e.g., emissions, utility bills).
Note that enabling a set of optional outputs will by default generate the entire set. For example, requesting emissions outputs will result in columns for totals by fuel and by end use. There is currently no way to request totals by fuel while excluding totals by end use.
Component Loads¶
Component loads represent the estimated contribution of different building components to the annual heating/cooling building loads.
report_simulation_output.component_load_cooling_ceilings_m_btu |
report_simulation_output.component_load_cooling_doors_m_btu |
report_simulation_output.component_load_cooling_ducts_m_btu |
report_simulation_output.component_load_cooling_floors_m_btu |
report_simulation_output.component_load_cooling_foundation_walls_m_btu |
report_simulation_output.component_load_cooling_infiltration_m_btu |
report_simulation_output.component_load_cooling_internal_gains_m_btu |
report_simulation_output.component_load_cooling_internal_mass_m_btu |
report_simulation_output.component_load_cooling_lighting_m_btu |
report_simulation_output.component_load_cooling_mechanical_ventilation_m_btu |
report_simulation_output.component_load_cooling_natural_ventilation_m_btu |
report_simulation_output.component_load_cooling_rim_joists_m_btu |
report_simulation_output.component_load_cooling_roofs_m_btu |
report_simulation_output.component_load_cooling_skylights_conduction_m_btu |
report_simulation_output.component_load_cooling_skylights_solar_m_btu |
report_simulation_output.component_load_cooling_slabs_m_btu |
report_simulation_output.component_load_cooling_walls_m_btu |
report_simulation_output.component_load_cooling_whole_house_fan_m_btu |
report_simulation_output.component_load_cooling_windows_conduction_m_btu |
report_simulation_output.component_load_cooling_windows_solar_m_btu |
report_simulation_output.component_load_heating_ceilings_m_btu |
report_simulation_output.component_load_heating_doors_m_btu |
report_simulation_output.component_load_heating_ducts_m_btu |
report_simulation_output.component_load_heating_floors_m_btu |
report_simulation_output.component_load_heating_foundation_walls_m_btu |
report_simulation_output.component_load_heating_infiltration_m_btu |
report_simulation_output.component_load_heating_internal_gains_m_btu |
report_simulation_output.component_load_heating_internal_mass_m_btu |
report_simulation_output.component_load_heating_lighting_m_btu |
report_simulation_output.component_load_heating_mechanical_ventilation_m_btu |
report_simulation_output.component_load_heating_natural_ventilation_m_btu |
report_simulation_output.component_load_heating_rim_joists_m_btu |
report_simulation_output.component_load_heating_roofs_m_btu |
report_simulation_output.component_load_heating_skylights_conduction_m_btu |
report_simulation_output.component_load_heating_skylights_solar_m_btu |
report_simulation_output.component_load_heating_slabs_m_btu |
report_simulation_output.component_load_heating_walls_m_btu |
report_simulation_output.component_load_heating_whole_house_fan_m_btu |
report_simulation_output.component_load_heating_windows_conduction_m_btu |
report_simulation_output.component_load_heating_windows_solar_m_btu |
These outputs require that only a single switch is enabled.
See the Residential HPXML Workflow Generator documentation page (i.e., build_existing_model
section) for more information.
See the OpenStudio-HPXML Workflow Outputs section on Annual Component Building Loads for more information about component loads.
Emissions¶
Optional emissions outputs include annual total, by fuel, and by end use, for each emissions scenario requested.
See the Residential HPXML Workflow Generator documentation page (i.e., emissions
section) for more information on how to request emissions outputs by scenario.
See the OpenStudio-HPXML Workflow Outputs section on Annual Emissions for more information about annual emissions.
For the example below, the “LRMER_MidCase_15” emissions scenario was requested. See the list of available emissions scenario choices at https://github.com/NREL/resstock/tree/develop/resources/data/cambium.
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_ceiling_fan_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_clothes_dryer_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_clothes_washer_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_cooling_fans_pumps_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_cooling_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_dehumidifier_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_dishwasher_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_electric_vehicle_charging_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_freezer_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_heating_fans_pumps_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_heating_heat_pump_backup_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_heating_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_hot_tub_heater_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_hot_tub_pump_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_hot_water_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_hot_water_recirc_pump_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_hot_water_solar_thermal_pump_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_lighting_exterior_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_lighting_garage_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_lighting_interior_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_mech_vent_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_plug_loads_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_pool_heater_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_pool_pump_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_pv_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_range_oven_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_refrigerator_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_total_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_electricity_well_pump_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_fuel_oil_heating_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_fuel_oil_hot_water_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_fuel_oil_total_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_clothes_dryer_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_fireplace_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_grill_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_heating_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_hot_tub_heater_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_hot_water_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_lighting_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_pool_heater_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_range_oven_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_natural_gas_total_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_propane_clothes_dryer_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_propane_heating_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_propane_hot_water_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_propane_range_oven_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_propane_total_lb |
report_simulation_output.emissions_co_2_e_lrmer_mid_case_15_total_lb |
Utility Bills¶
Optional utility bill outputs include annual fixed and marginal costs (total, by fuel type), and PV credits for electricity, for each utility bill scenario requested.
See the Residential HPXML Workflow Generator documentation page (i.e., utility_bills
section) for more information on how to request utility bill outputs by scenario.
See the OpenStudio-HPXML Workflow Outputs section on Utility Bill Outputs for more information about utility bill outputs.
report_utility_bills.bills_electricity_energy_usd |
report_utility_bills.bills_electricity_fixed_usd |
report_utility_bills.bills_electricity_pv_credit_usd |
report_utility_bills.bills_electricity_total_usd |
report_utility_bills.bills_fuel_oil_energy_usd |
report_utility_bills.bills_fuel_oil_total_usd |
report_utility_bills.bills_natural_gas_energy_usd |
report_utility_bills.bills_natural_gas_fixed_usd |
report_utility_bills.bills_natural_gas_total_usd |
report_utility_bills.bills_propane_energy_usd |
report_utility_bills.bills_propane_total_usd |
report_utility_bills.bills_total_usd |
Quantities of Interest¶
These outputs require that only a single switch is enabled.
See the Residential HPXML Workflow Generator documentation page (i.e., reporting_measures
section) for more information on how to request quantities of interest outputs.
qoi_report.qoi_average_maximum_daily_timing_cooling_hour |
qoi_report.qoi_average_maximum_daily_timing_heating_hour |
qoi_report.qoi_average_maximum_daily_timing_overlap_hour |
qoi_report.qoi_average_maximum_daily_use_cooling_kw |
qoi_report.qoi_average_maximum_daily_use_heating_kw |
qoi_report.qoi_average_maximum_daily_use_overlap_kw |
qoi_report.qoi_average_minimum_daily_use_cooling_kw |
qoi_report.qoi_average_minimum_daily_use_heating_kw |
qoi_report.qoi_average_minimum_daily_use_overlap_kw |
qoi_report.qoi_average_of_top_ten_highest_peaks_timing_cooling_hour |
qoi_report.qoi_average_of_top_ten_highest_peaks_timing_heating_hour |
qoi_report.qoi_average_of_top_ten_highest_peaks_use_cooling_kw |
qoi_report.qoi_average_of_top_ten_highest_peaks_use_heating_kw |
qoi_report.qoi_peak_magnitude_timing_hour |
qoi_report.qoi_peak_magnitude_use_kw |
Timeseries¶
Specifying any timeseries frequency other than “none” results in, by default, end use consumptions and total loads timeseries output requests.
See the Residential HPXML Workflow Generator documentation page (i.e., simulation_output_report
section) for more information on how to request various timeseries outputs (or override default requests).
See the OpenStudio-HPXML Workflow Outputs section on Timeseries Outputs for more information on timeseries outputs.