Workflow Outputs¶
Upon completing an OpenStudio-ERI run, a variety of summary output files and simulation files are available:
- Summary Outputs (CSV)
- Home Annual Outputs (CSV)
- Home Timeseries Outputs (CSV)
- Home Configurations (HPXML)
- Home EnergyPlus Files
Note
MBtu is defined as one million Btu.
Summary Outputs (CSV)¶
Based on which calculations were requested in the HPXML file, summary output files will be found in the results
directory.
Calculation File Notes ERI CO2e_Results.csv See CO2e_Results.csv. Only produced if 301-2019 Addendum D or newer. ERI ERI_Results.csv See ERI_Results.csv. ERI ERI_Worksheet.csv See ERI_Worksheet.csv. IECC ERI Pathway IECC_ERI_Results.csv See ERI_Results.csv (same format). IECC ERI Pathway IECC_ERI_Worksheet.csv See ERI_Worksheet.csv (same format). ENERGY STAR ES_Results.csv See ES_Results.csv.
CO2e_Results.csv¶
A CO2e_Results.csv
file will be produced when using ANSI/RESNET/ICC 301-2019 Addendum D or newer.
The file includes all of the outputs that are used in the CO2e Index calculation.
ERI_Results.csv¶
The ERI_Results.csv
file includes the ERI result as well as the high-level components (e.g., REUL, EC_r, EC_x, IAD_Save) that comprise the ERI calculation.
The file reflects the format of the Results tab of the HERS Method Test spreadsheet.
Note that multiple comma-separated values will be reported for many of these outputs if there are multiple heating, cooling, or hot water systems.
ERI_Worksheet.csv¶
The ERI_Worksheet.csv
file includes more detailed components that feed into the ERI_Results.csv values.
The file reflects the format of the Worksheet tab of the HERS Method Test spreadsheet.
Note that multiple comma-separated values will be reported for many of these outputs if there are multiple heating, cooling, or hot water systems.
ES_Results.csv¶
The ES_Results.csv
file includes the following:
Output Notes Reference Home ERI ERI of the ES Reference Home SAF (Size Adjustment Factor) Can only be less than 1 for some ES programs/versions SAF Adjusted ERI Target Reference Home ERI multiplied by SAF Rated Home ERI ERI of the Rated Home including OPP as allowed by the ES program/version Rated Home ERI w/o OPP ERI of the Rated Home excluding any on-site power production (OPP) ENERGY STAR Certification PASS or FAIL
Home Annual Outputs (CSV)¶
Based on which calculations were requested in the HPXML file, CSV annual output files will be found in the results
directory for each simulated home.
Calculation File Notes ERI CO2eRatedHome.csv CO2e Rated Home. Only produced if 301-2019 Addendum D or newer. ERI CO2eReferenceHome.csv CO2e Reference Home. Only produced if 301-2019 Addendum D or newer. ERI ERIRatedHome.csv ERI Rated Home. ERI ERIReferenceHome.csv ERI Reference Home. ERI ERIIndexAdjustmentDesign.csv ERI Index Adjustment Design. Only produced if 301-2014 Addendum E or newer. ERI ERIIndexAdjustmentReferenceHome.csv ERI Index Adjustment Reference Home. Only produced if 301-2014 Addendum E or newer. IECC ERI Pathway IECC_ERIRatedHome.csv IECC ERI Rated Home. IECC ERI Pathway IECC_ERIReferenceHome.csv IECC ERI Reference Home. IECC ERI Pathway IECC_ERIIndexAdjustmentDesign.csv IECC ERI Index Adjustment Design. IECC ERI Pathway IECC_ERIIndexAdjustmentReferenceHome.csv IECC ERI Index Adjustment Reference Home. ENERGY STAR ESRated_ERIRatedHome.csv ERI Rated Home for the ENERGY STAR rated home. ENERGY STAR ESRated_ERIReferenceHome.csv ERI Reference Home for the ENERGY STAR rated home. ENERGY STAR ESRated_ERIIndexAdjustmentDesign.csv ERI Index Adjustment Design for the ENERGY STAR rated home. ENERGY STAR ESRated_ERIIndexAdjustmentReferenceHome.csv ERI Index Adjustment Reference Home for the ENERGY STAR rated home. ENERGY STAR ESReference_ERIRatedHome.csv ERI Rated Home for the ENERGY STAR Reference Design. ENERGY STAR ESReference_ERIReferenceHome.csv ERI Reference Home for the ENERGY STAR Reference Design. ENERGY STAR ESReference_ERIIndexAdjustmentDesign.csv ERI Index Adjustment Design for the ENERGY STAR Reference Design. ENERGY STAR ESReference_ERIIndexAdjustmentReferenceHome.csv ERI Index Adjustment Reference Home for the ENERGY STAR Reference Design.
Each CSV file includes the following sections of output.
Annual Energy¶
Annual energy outputs are listed below.
Type Notes Energy Use: Total (MBtu) Total energy consumption Energy Use: Net (MBtu) Subtracts any power produced by PV or generators
Annual Energy by Fuel Type¶
Fuel uses are listed below.
Type Notes Fuel Use: Electricity: Total (MBtu) Total electricity consumption Fuel Use: Electricity: Net (MBtu) Subtracts any power produced by PV or generators Fuel Use: Natural Gas: Total (MBtu) Fuel Use: Fuel Oil: Total (MBtu) Fuel Use: Propane: Total (MBtu) Fuel Use: Wood Cord: Total (MBtu) Fuel Use: Wood Pellets: Total (MBtu) Fuel Use: Coal: Total (MBtu) Not used by OS-ERI
Annual Energy By End Use¶
End uses are listed below.
Note that all end uses are mutually exclusive – the “Electricity: Heating” end use, for example, excludes energy reported in the “Electricity: Heating Fans/Pumps” end use. So the sum of all end uses for a given fuel (e.g., sum of all “End Use: Natural Gas: *”) equal the above reported fuel use (e.g., “Fuel Use: Natural Gas: Total”).
Type Notes End Use: Electricity: Heating (MBtu) Excludes heat pump backup and fans/pumps End Use: Electricity: Heating Fans/Pumps (MBtu) Includes supply fan (air distribution) or circulating pump (hydronic distribution or geothermal loop) End Use: Electricity: Heating Heat Pump Backup (MBtu) Excludes heat pump backup fans/pumps End Use: Electricity: Heating Heat Pump Backup Fans/Pumps (MBtu) Includes supply fan (air distribution) or circulating pump (hydronic distribution) during heat pump backup End Use: Electricity: Cooling (MBtu) Excludes fans/pumps End Use: Electricity: Cooling Fans/Pumps (MBtu) Includes supply fan (air distribution) and circulating pump (geothermal loop) End Use: Electricity: Hot Water (MBtu) Excludes recirc pump and solar thermal pump End Use: Electricity: Hot Water Recirc Pump (MBtu) End Use: Electricity: Hot Water Solar Thermal Pump (MBtu) Non-zero only when using detailed (not simple) solar thermal inputs End Use: Electricity: Lighting Interior (MBtu) End Use: Electricity: Lighting Garage (MBtu) End Use: Electricity: Lighting Exterior (MBtu) End Use: Electricity: Mech Vent (MBtu) Excludes preheating/precooling End Use: Electricity: Mech Vent Preheating (MBtu) Shared ventilation preconditioning system End Use: Electricity: Mech Vent Precooling (MBtu) Shared ventilation preconditioning system End Use: Electricity: Whole House Fan (MBtu) End Use: Electricity: Refrigerator (MBtu) End Use: Electricity: Freezer (MBtu) Not used by OS-ERI End Use: Electricity: Dehumidifier (MBtu) End Use: Electricity: Dishwasher (MBtu) End Use: Electricity: Clothes Washer (MBtu) End Use: Electricity: Clothes Dryer (MBtu) End Use: Electricity: Range/Oven (MBtu) End Use: Electricity: Ceiling Fan (MBtu) End Use: Electricity: Television (MBtu) End Use: Electricity: Plug Loads (MBtu) Excludes independently reported plug loads (e.g., well pump) End Use: Electricity: Electric Vehicle Charging (MBtu) Not used by OS-ERI End Use: Electricity: Well Pump (MBtu) Not used by OS-ERI End Use: Electricity: Pool Heater (MBtu) Not used by OS-ERI End Use: Electricity: Pool Pump (MBtu) Not used by OS-ERI End Use: Electricity: Hot Tub Heater (MBtu) Not used by OS-ERI End Use: Electricity: Hot Tub Pump (MBtu) Not used by OS-ERI End Use: Electricity: PV (MBtu) Negative value for any power produced End Use: Electricity: Generator (MBtu) Negative value for any power produced End Use: Electricity: Battery (MBtu) Not used by OS-ERI End Use: Natural Gas: Heating (MBtu) Excludes heat pump backup End Use: Natural Gas: Heating Heat Pump Backup (MBtu) End Use: Natural Gas: Hot Water (MBtu) End Use: Natural Gas: Clothes Dryer (MBtu) End Use: Natural Gas: Range/Oven (MBtu) End Use: Natural Gas: Mech Vent Preheating (MBtu) Shared ventilation preconditioning system End Use: Natural Gas: Pool Heater (MBtu) Not used by OS-ERI End Use: Natural Gas: Hot Tub Heater (MBtu) Not used by OS-ERI End Use: Natural Gas: Grill (MBtu) Not used by OS-ERI End Use: Natural Gas: Lighting (MBtu) Not used by OS-ERI End Use: Natural Gas: Fireplace (MBtu) Not used by OS-ERI End Use: Natural Gas: Generator (MBtu) Positive value for any fuel consumed End Use: Fuel Oil: Heating (MBtu) Excludes heat pump backup End Use: Fuel Oil: Heating Heat Pump Backup (MBtu) End Use: Fuel Oil: Hot Water (MBtu) End Use: Fuel Oil: Clothes Dryer (MBtu) End Use: Fuel Oil: Range/Oven (MBtu) End Use: Fuel Oil: Mech Vent Preheating (MBtu) Shared ventilation preconditioning system End Use: Fuel Oil: Grill (MBtu) Not used by OS-ERI End Use: Fuel Oil: Lighting (MBtu) Not used by OS-ERI End Use: Fuel Oil: Fireplace (MBtu) Not used by OS-ERI End Use: Fuel Oil: Generator (MBtu) Positive value for any fuel consumed End Use: Propane: Heating (MBtu) Excludes heat pump backup End Use: Propane: Heating Heat Pump Backup (MBtu) End Use: Propane: Hot Water (MBtu) End Use: Propane: Clothes Dryer (MBtu) End Use: Propane: Range/Oven (MBtu) End Use: Propane: Mech Vent Preheating (MBtu) Shared ventilation preconditioning system End Use: Propane: Grill (MBtu) Not used by OS-ERI End Use: Propane: Lighting (MBtu) Not used by OS-ERI End Use: Propane: Fireplace (MBtu) Not used by OS-ERI End Use: Propane: Generator (MBtu) Positive value for any fuel consumed End Use: Wood Cord: Heating (MBtu) Excludes heat pump backup End Use: Wood Cord: Heating Heat Pump Backup (MBtu) End Use: Wood Cord: Hot Water (MBtu) End Use: Wood Cord: Clothes Dryer (MBtu) End Use: Wood Cord: Range/Oven (MBtu) End Use: Wood Cord: Mech Vent Preheating (MBtu) Shared ventilation preconditioning system End Use: Wood Cord: Grill (MBtu) Not used by OS-ERI End Use: Wood Cord: Lighting (MBtu) Not used by OS-ERI End Use: Wood Cord: Fireplace (MBtu) Not used by OS-ERI End Use: Wood Cord: Generator (MBtu) Positive value for any fuel consumed End Use: Wood Pellets: Heating (MBtu) Excludes heat pump backup End Use: Wood Pellets: Heating Heat Pump Backup (MBtu) End Use: Wood Pellets: Hot Water (MBtu) End Use: Wood Pellets: Clothes Dryer (MBtu) End Use: Wood Pellets: Range/Oven (MBtu) End Use: Wood Pellets: Mech Vent Preheating (MBtu) Shared ventilation preconditioning system End Use: Wood Pellets: Grill (MBtu) Not used by OS-ERI End Use: Wood Pellets: Lighting (MBtu) Not used by OS-ERI End Use: Wood Pellets: Fireplace (MBtu) Not used by OS-ERI End Use: Wood Pellets: Generator (MBtu) Positive value for any fuel consumed End Use: Coal: Heating (MBtu) Excludes heat pump backup End Use: Coal: Heating Heat Pump Backup (MBtu) End Use: Coal: Hot Water (MBtu) Not used by OS-ERI End Use: Coal: Clothes Dryer (MBtu) Not used by OS-ERI End Use: Coal: Range/Oven (MBtu) Not used by OS-ERI End Use: Coal: Mech Vent Preheating (MBtu) Not used by OS-ERI End Use: Coal: Grill (MBtu) Not used by OS-ERI End Use: Coal: Lighting (MBtu) Not used by OS-ERI End Use: Coal: Fireplace (MBtu) Not used by OS-ERI End Use: Coal: Generator (MBtu) Not used by OS-ERI
Annual Energy By System Use¶
Results for each end use of each heating, cooling, and water heating system defined in the HPXML file are listed as shown below. Non-zero end uses from Annual Energy By End Use will be included.
Type Notes System Use: <HeatingSystemID>: <FuelType>: <EndUse> (MBtu) End use energy for the heating system System Use: <CoolingSystemID>: <FuelType>: <EndUse> (MBtu) End use energy for the cooling system System Use: <HeatPumpID>: <FuelType>: <EndUse> (MBtu) End use energy for the heat pump system System Use: <WaterHeatingSystemID>: <FuelType>: <EndUse> (MBtu) End use energy for the water heating system System Use: <VentilationFanID>: <FuelType>: <EndUse> (MBtu) End use energy for the ventilation fan system (preheating/precooling only)
Annual Emissions¶
Annual emissions are listed below.
Emissions for each emissions type (CO2e, NOx, and SO2) are provided.
Type Notes Emissions: <EmissionsType>: RESNET: Total (lb) Total emissions Emissions: <EmissionsType>: RESNET: Net (lb) Subtracts any power produced by PV or generators
Annual Emissions by Fuel Use¶
Annual emissions by fuel use are listed below.
Emissions for each emissions type (CO2e, NOx, and SO2) are provided.
Type Notes Emissions: <EmissionsType>: RESNET: Electricity: Total (lb) Emissions for Electricity only Emissions: <EmissionsType>: RESNET: Electricity: Net (lb) Subtracts any power produced by PV or generators Emissions: <EmissionsType>: RESNET: Natural Gas: Total (lb) Emissions for Natural Gas only Emissions: <EmissionsType>: RESNET: Fuel Oil: Total (lb) Emissions for Fuel Oil only Emissions: <EmissionsType>: RESNET: Propane: Total (lb) Emissions for Propane only Emissions: <EmissionsType>: RESNET: Wood Cord: Total (lb) Emissions for Wood Cord only Emissions: <EmissionsType>: RESNET: Wood Pellets: Total (lb) Emissions for Wood Pellets only Emissions: <EmissionsType>: RESNET: Coal: Total (lb) Not used by OS-ERI
Annual Emissions by End Use¶
Annual emissions by end use are listed below.
Emissions for each emissions type (CO2e, NOx, and SO2) are provided. Every end use from Annual Energy By End Use will be included.
Type Notes Emissions: <EmissionsType>: RESNET: Electricity: <EndUse> (lb) Emissions for this Electricity end use only (one row per end use) Emissions: <EmissionsType>: RESNET: Natural Gas: <EndUse> (lb) Emissions for this Natural Gas end use only (one row per end use) Emissions: <EmissionsType>: RESNET: Fuel Oil: <EndUse> (lb) Emissions for this Fuel Oil end use only (one row per end use) Emissions: <EmissionsType>: RESNET: Propane: <EndUse> (lb) Emissions for this Propane end use only (one row per end use) Emissions: <EmissionsType>: RESNET: Wood Cord: <EndUse> (lb) Emissions for this Wood Cord end use only (one row per end use) Emissions: <EmissionsType>: RESNET: Wood Pellets: <EndUse> (lb) Emissions for this Wood Pellets end use only (one row per end use) Emissions: <EmissionsType>: RESNET: Coal: <EndUse> (lb) Not used by OS-ERI
Annual Building Loads¶
Annual building loads are listed below.
Type Notes Load: Heating: Delivered (MBtu) Total heating load delivered, including distribution losses. Load: Heating: Heat Pump Backup (MBtu) Heating load delivered by the heat pump backup only, including distribution losses. Load: Cooling: Delivered (MBtu) Total cooling load delivered, including distribution losses. Load: Hot Water: Delivered (MBtu) Total hot water load delivered, including contributions by desuperheaters or solar thermal systems. Load: Hot Water: Tank Losses (MBtu) Load: Hot Water: Desuperheater (MBtu) Hot water load delivered by the desuperheater. Load: Hot Water: Solar Thermal (MBtu) Hot water load delivered by the solar thermal system.
Note that the “Delivered” loads represent the energy delivered by the HVAC/DHW system; if a system is significantly undersized, there will be unmet load not reflected by these values.
Annual Unmet Hours¶
Annual unmet hours are listed below.
Type Notes Unmet Hours: Heating (hr) Number of hours where the heating setpoint is not maintained. Unmet Hours: Cooling (hr) Number of hours where the cooling setpoint is not maintained.
These numbers reflect the number of hours during the year when the conditioned space temperature is more than 0.2 deg-C (0.36 deg-F) from the setpoint during heating/cooling.
Peak Building Electricity¶
Peak building electricity outputs are listed below.
Type Notes Peak Electricity: Winter Total (W) Maximum value in Dec/Jan/Feb (or Jun/Jul/Aug in the southern hemisphere) Peak Electricity: Summer Total (W) Maximum value in Jun/Jul/Aug (or Dec/Jan/Feb in the southern hemisphere)
Peak Building Loads¶
Peak building loads are listed below.
Type Notes Peak Load: Heating: Delivered (kBtu/hr) Includes HVAC distribution losses. Peak Load: Cooling: Delivered (kBtu/hr) Includes HVAC distribution losses.
Note that the “Delivered” peak loads represent the energy delivered by the HVAC system; if a system is significantly undersized, there will be unmet peak load not reflected by these values.
Annual Component Building Loads¶
Note: This section is only available if the --add-component-loads
argument is used.
The argument is not used by default for faster performance.
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.
Component loads disaggregated by Heating/Cooling are listed below.
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 Floor
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 Conduction (MBtu) Heat gain/loss attributed to conduction through HPXML Window
elements adjacent to conditioned spaceComponent Load: *: Windows Solar (MBtu) Heat gain/loss attributed to solar gains through HPXML Window
elements adjacent to conditioned spaceComponent Load: *: Skylights Conduction (MBtu) Heat gain/loss attributed to conduction through HPXML Skylight
elements adjacent to conditioned spaceComponent Load: *: Skylights Solar (MBtu) Heat gain/loss attributed to solar gains through HPXML Skylight
elements adjacent to conditioned spaceComponent Load: *: Floors (MBtu) Heat gain/loss through HPXML Floor
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 mechanical ventilation systems 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, plug loads, water heater tank losses, etc. in the conditioned space Component Load: *: Lighting (MBtu) Heat gain/loss from lighting in the conditioned space
Annual Hot Water Uses¶
Annual hot water uses are listed below.
Type Notes Hot Water: Clothes Washer (gal) Hot Water: Dishwasher (gal) Hot Water: Fixtures (gal) Showers and faucets. Hot Water: Distribution Waste (gal)
HVAC Capacities¶
System outputs are listed below. Autosized HVAC systems are based on HVAC design temperatures/loads described below. Capacities for individual HVAC systems can be found in the, e.g., ERIReferenceHome.xml file.
Type Notes HVAC Capacity: Cooling (Btu/h) Total HVAC cooling capacity HVAC Capacity: Heating (Btu/h) Total HVAC heating capacity HVAC Capacity: Heat Pump Backup (Btu/h) Total HVAC heat pump backup capacity
HVAC Design Temperatures¶
Design temperatures are used in the design load calculations for autosizing of HVAC equipment. 1%/99% design temperatures are obtained from the DESIGN CONDITIONS header section inside the EPW weather file. If they are not available in the EPW header, the design temperatures are calculated from the 8760 hourly temperatures in the EPW. Design temperatures can also be found in the, e.g., ERIReferenceHome.xml file.
Type Notes HVAC Design Temperature: Heating (F) 99% heating drybulb temperature HVAC Design Temperature: Cooling (F) 1% cooling drybulb temperature
HVAC Design Loads¶
Design load outputs, used for autosizing of HVAC equipment, are listed below. Design loads are based on block load ACCA Manual J calculations using 1%/99% design temperatures. Design loads can also be found in the, e.g., ERIReferenceHome.xml file.
Type Notes HVAC Design Load: Heating: Total (Btu/h) Total heating design load HVAC Design Load: Heating: Ducts (Btu/h) Heating design load for ducts HVAC Design Load: Heating: Windows (Btu/h) Heating design load for windows HVAC Design Load: Heating: Skylights (Btu/h) Heating design load for skylights HVAC Design Load: Heating: Doors (Btu/h) Heating design load for doors HVAC Design Load: Heating: Walls (Btu/h) Heating design load for walls HVAC Design Load: Heating: Roofs (Btu/h) Heating design load for roofs HVAC Design Load: Heating: Floors (Btu/h) Heating design load for floors HVAC Design Load: Heating: Slabs (Btu/h) Heating design load for slabs HVAC Design Load: Heating: Ceilings (Btu/h) Heating design load for ceilings HVAC Design Load: Heating: Infiltration/Ventilation (Btu/h) Heating design load for infiltration/ventilation HVAC Design Load: Cooling Sensible: Total (Btu/h) Total sensible cooling design load HVAC Design Load: Cooling Sensible: Ducts (Btu/h) Sensible cooling design load for ducts HVAC Design Load: Cooling Sensible: Windows (Btu/h) Sensible cooling design load for windows HVAC Design Load: Cooling Sensible: Skylights (Btu/h) Sensible cooling design load for skylights HVAC Design Load: Cooling Sensible: Doors (Btu/h) Sensible cooling design load for doors HVAC Design Load: Cooling Sensible: Walls (Btu/h) Sensible cooling design load for walls HVAC Design Load: Cooling Sensible: Roofs (Btu/h) Sensible cooling design load for roofs HVAC Design Load: Cooling Sensible: Floors (Btu/h) Sensible cooling design load for floors HVAC Design Load: Cooling Sensible: Slabs (Btu/h) Sensible cooling design load for slabs HVAC Design Load: Cooling Sensible: Ceilings (Btu/h) Sensible cooling design load for ceilings HVAC Design Load: Cooling Sensible: Infiltration/Ventilation (Btu/h) Sensible cooling design load for infiltration/ventilation HVAC Design Load: Cooling Sensible: Internal Gains (Btu/h) Sensible cooling design load for internal gains HVAC Design Load: Cooling Latent: Total (Btu/h) Total latent cooling design load HVAC Design Load: Cooling Latent: Ducts (Btu/h) Latent cooling design load for ducts HVAC Design Load: Cooling Latent: Infiltration/Ventilation (Btu/h) Latent cooling design load for infiltration/ventilation HVAC Design Load: Cooling Latent: Internal Gains (Btu/h) Latent cooling design load for internal gains
Home Timeseries Outputs (CSV)¶
See the Running Calculations section for requesting timeseries outputs.
When requested, a CSV file of timeseries outputs is written for the Reference/Rated Homes (e.g., ERIReferenceHome_Hourly.csv
, ERIReferenceHome_Daily.csv
, or ERIReferenceHome_Monthly.csv
for the Reference home).
Depending on the outputs requested, CSV files may include:
Type Notes Total Consumptions Energy use for building total. 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). System Use Consumptions Energy use for each HVAC and water heating system (in kBtu). Emissions Emissions (CO2e, NOx, SO2). Emission Fuels Emissions (CO2e, NOx, SO2) disaggregated by fuel type. Emission End Uses Emissions (CO2e, NOx, SO2) disaggregated by end use. Hot Water Uses Water use for each end use type (in gallons). Total Loads Heating, cooling, and hot water loads (in kBtu). Component Loads Heating and cooling loads (in kBtu) disaggregated by component (e.g., Walls, Windows, Infiltration, Ducts, etc.). Zone Temperatures Zone temperatures (in deg-F) for each space (e.g., living space, attic, garage, basement, crawlspace, etc.) plus heating/cooling setpoints. 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.
Timeseries outputs can be one of the following frequencies: hourly, daily, or monthly.
Timestamps in the output use the start-of-period convention. Most outputs will be summed over the hour (e.g., energy) but some will be averaged over the hour (e.g., temperatures, airflows).
Home Configurations (HPXML)¶
Based on which calculations were requested in the HPXML file, home configuration details in HPXML format will be found in the results
directory for each simulated home.
The HPXML files will have the same filename as the Home Annual Outputs (CSV) output files, but with a .xml extension instead of .csv.
The files reflect the configuration of the home after applying, e.g., the ERI 301 ruleset.
The files will also show HPXML default values that are applied as part of modeling the home. Defaults will be applied for a few different reasons:
- Optional ERI inputs aren’t provided (e.g., ventilation rate for a vented attic, SHR for an air conditioner, etc.)
- Modeling assumptions (e.g., 1 hour timestep, Jan 1 - Dec 31 run period, appliance schedules, etc.)
- HVAC sizing calculations (e.g., autosized HVAC capacities and airflow rates, heating/cooling design temperatures and loads)
Any defaulted values will include the dataSource='software'
attribute in the HPXML file.
Home EnergyPlus Files¶
In addition, raw EnergyPlus simulation input/output files are available for each simulation (e.g., ERIRatedHome
, ERIReferenceHome
, etc. directories).
Warning
It is highly discouraged for software tools to read the raw EnergyPlus output files. The EnergyPlus input/output files are made available for inspection, but the outputs for certain situations can be misleading if one does not know how the model was created. If there are additional outputs of interest that are not available in the annual/timeseries output files, please send us a request.