SimulationOutputReport Measure¶
The SimulationOutputReport reporting measure generates a variety of annual (and optionally, timeseries) outputs for a residential HPXML-based model.
Annual Outputs¶
The measure will always generate an annual CSV output file called results_annual.csv, co-located with the EnergyPlus output. The CSV file includes the following sections of output:
Annual Energy Consumption by Fuel Type¶
Current fuel types are:
Type Notes Electricity: Total (MBtu) Electricity: Net (MBtu) Excludes any PV generation. Natural Gas: Total (MBtu) Fuel Oil: Total (MBtu) Propane: Total (MBtu) Wood: Total (MBtu) Wood Pellets: Total (MBtu)
Annual Energy Consumption By Fuel Type and End Use¶
Current end use/fuel type combinations are:
Type Notes Type (cont’d) Notes Electricity: Heating (MBtu) Natural Gas: Heating (MBtu) Electricity: Heating Fans/Pumps (MBtu) Natural Gas: Hot Water (MBtu) Electricity: Cooling (MBtu) Natural Gas: Clothes Dryer (MBtu) Electricity: Cooling Fans/Pumps (MBtu) Natural Gas: Range/Oven (MBtu) Electricity: Hot Water (MBtu) Fuel Oil: Heating (MBtu) Electricity: Hot Water Recirc Pump (MBtu) Fuel Oil: Hot Water (MBtu) Electricity: Hot Water Solar Thermal Pump (MBtu) Fuel Oil: Clothes Dryer (MBtu) Electricity: Lighting Interior (MBtu) Fuel Oil: Range/Oven (MBtu) Electricity: Lighting Garage (MBtu) Propane: Heating (MBtu) Electricity: Lighting Exterior (MBtu) Propane: Hot Water (MBtu) Electricity: Mech Vent (MBtu) Propane: Clothes Dryer (MBtu) Electricity: Whole House Fan (MBtu) Propane: Range/Oven (MBtu) Electricity: Refrigerator (MBtu) Wood: Heating (MBtu) Electricity: Dehumidifier (MBtu) Wood: Hot Water (MBtu) Electricity: Dishwasher (MBtu) Wood: Clothes Dryer (MBtu) Electricity: Clothes Washer (MBtu) Wood: Range/Oven (MBtu) Electricity: Clothes Dryer (MBtu) Wood Pellets: Heating (MBtu) Electricity: Range/Oven (MBtu) Electricity: Ceiling Fan (MBtu) Electricity: Television (MBtu) Electricity: Plug Loads (MBtu) Electricity: PV (MBtu)
Annual Building Loads¶
Current annual building loads are:
Type Notes Load: Heating (MBtu) Includes HVAC distribution losses. Load: Cooling (MBtu) Includes HVAC distribution losses. Load: Hot Water: Delivered (MBtu) Includes contributions by desuperheaters or solar thermal systems. Load: Hot Water: Tank Losses (MBtu) Load: Hot Water: Desuperheater (MBtu) Load served by the desuperheater. Load: Hot Water: Solar Thermal (MBtu) Load served by the solar thermal system.
Annual Unmet Building Loads¶
Current annual unmet building loads are:
Type Notes Unmet Load: Heating (MBtu) Unmet Load: Cooling (MBtu)
These numbers reflect the amount of heating/cooling load that is not met by the HVAC system, indicating the degree to which the HVAC system is undersized. An HVAC system with sufficient capacity to perfectly maintain the thermostat setpoints will report an unmet load of zero.
Peak Building Electricity¶
Current peak building electricity outputs are:
Type Notes Peak Electricity: Winter Total (W) Winter season defined by operation of the heating system. Peak Electricity: Summer Total (W) Summer season defined by operation of the cooling system.
Peak Building Loads¶
Current peak building loads are:
Type Notes Peak Load: Heating (kBtu) Includes HVAC distribution losses. Peak Load: Cooling (kBtu) Includes HVAC distribution losses.
Annual Component Building Loads¶
Component loads represent the estimated contribution of different building components to the annual heating/cooling building loads. The sum of component loads for heating (or cooling) will roughly equal the annual heating (or cooling) building load reported above. Current component loads disaggregated by Heating/Cooling are:
Type Notes Component Load: *: Roofs (MBtu) Heat gain/loss through HPXML Roof
elements adjacent to conditioned spaceComponent Load: *: Ceilings (MBtu) Heat gain/loss through HPXML FrameFloor
elements (inferred to be ceilings) adjacent to conditioned spaceComponent Load: *: Walls (MBtu) Heat gain/loss through HPXML Wall
elements adjacent to conditioned spaceComponent Load: *: Rim Joists (MBtu) Heat gain/loss through HPXML RimJoist
elements adjacent to conditioned spaceComponent Load: *: Foundation Walls (MBtu) Heat gain/loss through HPXML FoundationWall
elements adjacent to conditioned spaceComponent Load: *: Doors (MBtu) Heat gain/loss through HPXML Door
elements adjacent to conditioned spaceComponent Load: *: Windows (MBtu) Heat gain/loss through HPXML Window
elements adjacent to conditioned space, including solarComponent Load: *: Skylights (MBtu) Heat gain/loss through HPXML Skylight
elements adjacent to conditioned space, including solarComponent Load: *: Floors (MBtu) Heat gain/loss through HPXML FrameFloor
elements (inferred to be floors) adjacent to conditioned spaceComponent Load: *: Slabs (MBtu) Heat gain/loss through HPXML Slab
elements adjacent to conditioned spaceComponent Load: *: Internal Mass (MBtu) Heat gain/loss from internal mass (e.g., furniture, interior walls/floors) in conditioned space Component Load: *: Infiltration (MBtu) Heat gain/loss from airflow induced by stack and wind effects Component Load: *: Natural Ventilation (MBtu) Heat gain/loss from airflow through operable windows Component Load: *: Mechanical Ventilation (MBtu) Heat gain/loss from airflow/fan energy from a whole house mechanical ventilation system Component Load: *: Whole House Fan (MBtu) Heat gain/loss from airflow due to a whole house fan Component Load: *: Ducts (MBtu) Heat gain/loss from conduction and leakage losses through supply/return ducts outside conditioned space Component Load: *: Internal Gains (MBtu) Heat gain/loss from appliances, lighting, plug loads, water heater tank losses, etc. in the conditioned space
Annual Hot Water Uses¶
Current annual hot water uses are:
Type Notes Hot Water: Clothes Washer (gal) Hot Water: Dishwasher (gal) Hot Water: Fixtures (gal) Showers and faucets. Hot Water: Distribution Waste (gal)
Timeseries Outputs¶
The measure will generate a timeseries CSV output file if the Timeseries Reporting Frequency argument is specified and one or more Generate Timeseries Output arguments are true. The timeseries output file is called results_timeseries.csv and co-located with the EnergyPlus output.
Depending on the outputs requested, CSV files may include:
Type Notes Fuel Consumptions Energy use for each fuel type (in kBtu for fossil fuels and kWh for electricity). End Use Consumptions Energy use for each end use type (in kBtu for fossil fuels and kWh for electricity). Hot Water Uses Water use for each end use type (in gallons). Total Loads Heating and cooling loads (in kBtu) for the building. Component Loads Heating and cooling loads (in kBtu) disaggregated by component (e.g., Walls, Windows, Infiltration, Ducts, etc.). Zone Temperatures Average temperatures (in deg-F) for each space modeled (e.g., living space, attic, garage, basement, crawlspace, etc.). Airflows Airflow rates (in cfm) for infiltration, mechanical ventilation, natural ventilation, and whole house fans. Weather Weather file data including outdoor temperatures, relative humidity, wind speed, and solar.