.. _workflow_outputs: Workflow Outputs ================ OpenStudio-HPXML generates a number of workflow outputs: ====================================================== ====================================== File Notes ====================================================== ====================================== in.xml See :ref:`hpxml_defaults`. HPXML file populated with defaulted values (e.g., autosized HVAC capacities). in.idf EnergyPlus input file. in.osm OpenStudio model file. Only generated if the ``debug`` argument is used. results_annual.csv (or .json or .msgpack) See :ref:`annual_outputs`. Simulation annual outputs, autosized HVAC capacities and design loads, etc. in CSV or JSON format. results_timeseries.csv (or .json or .msgpack) See :ref:`timeseries_outputs`. Simulation timeseries outputs in CSV or JSON format. Only generated if requested. results_bills.csv (or .json or .msgpack) See :ref:`bill_outputs`. Utility bill outputs in CSV or JSON format. results_panel.csv (or .json or .msgpack) See :ref:`panel_outputs`. Electric panel outputs in CSV or JSON format. results_design_load_details.csv (or .json or .msgpack) See :ref:`design_load_details`. Additional details related to HVAC design load calculations. run.log Errors/warnings generated by the OpenStudio-HPXML workflow. eplusout.* EnergyPlus output files (e.g., msgpack output, error log). Defaults to a subset of possible files; use ``debug`` to produce ALL files. ====================================================== ====================================== .. note:: MBtu is defined as one million Btu. .. _hpxml_defaults: HPXML Defaults -------------- OpenStudio-HPXML will always generate an HPXML file called ``in.xml``, located in the run directory. This file reflects the HPXML input file provided by the user but includes any default values that OpenStudio-HPXML has used. These default values will all be tagged with the ``dataSource='software'`` attribute. For example, suppose a central air conditioner is described in the HPXML input file like so: .. code-block:: XML central air conditioner electricity 1.0 SEER 13.0 The ``in.xml`` output file will include autosized HVAC capacities as well as some other details: .. code-block:: XML central air conditioner electricity 18773.0 single stage 1.0 SEER 13.0 0.0 0.0 0.375 781.0 .. _annual_outputs: Annual Outputs -------------- OpenStudio-HPXML will always generate an annual output file called ``results_annual.csv`` (or ``.json`` or ``.msgpack``), located in the run directory. The 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) Total energy consumption minus power produced by PV ==================================== =========================== Annual Energy by Fuel Use ~~~~~~~~~~~~~~~~~~~~~~~~~ Fuel uses are listed below. ==================================== =========================== Type Notes ==================================== =========================== Fuel Use: Electricity: Total (MBtu) Total electricity consumption Fuel Use: Electricity: Net (MBtu) Total energy consumption minus power produced by PV Fuel Use: Natural Gas: Total (MBtu) Fuel Use: Fuel Oil: Total (MBtu) Includes "fuel oil", "fuel oil 1", "fuel oil 2", "fuel oil 4", "fuel oil 5/6", "kerosene", and "diesel" Fuel Use: Propane: Total (MBtu) Fuel Use: Wood Cord: Total (MBtu) Fuel Use: Wood Pellets: Total (MBtu) Fuel Use: Coal: Total (MBtu) Includes "coal", "anthracite coal", "bituminous coal", and "coke" ==================================== =========================== .. _annualenduses: 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) Includes exterior holiday lighting End Use: Electricity: Mech Vent (MBtu) Excludes preheating/precooling End Use: Electricity: Mech Vent Preheating (MBtu) End Use: Electricity: Mech Vent Precooling (MBtu) End Use: Electricity: Whole House Fan (MBtu) End Use: Electricity: Refrigerator (MBtu) End Use: Electricity: Freezer (MBtu) 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: Well Pump (MBtu) End Use: Electricity: Pool Heater (MBtu) End Use: Electricity: Pool Pump (MBtu) End Use: Electricity: Permanent Spa Heater (MBtu) End Use: Electricity: Permanent Spa Pump (MBtu) 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) Positive value for charging (including efficiency losses); negative value for discharging End Use: Electricity: Electric Vehicle Charging (MBtu) 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) End Use: Natural Gas: Pool Heater (MBtu) End Use: Natural Gas: Permanent Spa Heater (MBtu) End Use: Natural Gas: Grill (MBtu) End Use: Natural Gas: Lighting (MBtu) End Use: Natural Gas: Fireplace (MBtu) 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) End Use: Fuel Oil: Grill (MBtu) End Use: Fuel Oil: Lighting (MBtu) End Use: Fuel Oil: Fireplace (MBtu) 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) End Use: Propane: Grill (MBtu) End Use: Propane: Lighting (MBtu) End Use: Propane: Fireplace (MBtu) 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) End Use: Wood Cord: Grill (MBtu) End Use: Wood Cord: Lighting (MBtu) End Use: Wood Cord: Fireplace (MBtu) 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) End Use: Wood Pellets: Grill (MBtu) End Use: Wood Pellets: Lighting (MBtu) End Use: Wood Pellets: Fireplace (MBtu) 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) End Use: Coal: Clothes Dryer (MBtu) End Use: Coal: Range/Oven (MBtu) End Use: Coal: Mech Vent Preheating (MBtu) End Use: Coal: Grill (MBtu) End Use: Coal: Lighting (MBtu) End Use: Coal: Fireplace (MBtu) End Use: Coal: Generator (MBtu) Positive value for any fuel consumed ================================================================ ==================================================== 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 :ref:`annualenduses` will be included. =============================================================== ============================================= Type Notes =============================================================== ============================================= System Use: : : (MBtu) End use energy for the heating system System Use: : : (MBtu) End use energy for the cooling system System Use: : : (MBtu) End use energy for the heat pump system System Use: : : (MBtu) End use energy for the water heating system System Use: : : (MBtu) End use energy for the ventilation fan system (preheating/precooling only) =============================================================== ============================================= Annual Emissions ~~~~~~~~~~~~~~~~ When no emissions scenarios are specified, emissions outputs will not be reported. See :ref:`hpxml_emissions_scenarios` for more information about specifying emissions scenarios. Results for each emissions scenario defined in the HPXML file are listed as shown below. ======================================================================= ================================================================== Type Notes ======================================================================= ================================================================== Emissions: : : Total (lb) Scenario total emissions Emissions: : : Net (lb) Scenario total emissions minus power produced by PV ======================================================================= ================================================================== Annual Emissions by Fuel Use ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Results for each emissions scenario defined in the HPXML file are listed as shown below. ======================================================================= ================================================================== Type Notes ======================================================================= ================================================================== Emissions: : : Electricity: Total (lb) Scenario total emissions for Electricity only Emissions: : : Electricity: Net (lb) Scenario total emissions for Electricity only minus power produced by PV Emissions: : : Natural Gas: Total (lb) Scenario emissions for Natural Gas only Emissions: : : Fuel Oil: Total (lb) Scenario emissions for Fuel Oil only Emissions: : : Propane: Total (lb) Scenario emissions for Propane only Emissions: : : Wood Cord: Total (lb) Scenario emissions for Wood Cord only Emissions: : : Wood Pellets: Total (lb) Scenario emissions for Wood Pellets only Emissions: : : Coal: Total (lb) Scenario emissions for Coal only ======================================================================= ================================================================== Annual Emissions by End Use ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Results for each emissions scenario defined in the HPXML file are listed as shown below. Every end use from :ref:`annualenduses` will be included. ======================================================================= ================================================================== Type Notes ======================================================================= ================================================================== Emissions: : : Electricity: (lb) Scenario emissions for this Electricity end use (one row per end use) Emissions: : : Natural Gas: (lb) Scenario emissions for this Natural Gas end use (one row per end use) Emissions: : : Fuel Oil: (lb) Scenario emissions for this Fuel Oil end use (one row per end use) Emissions: : : Propane: (lb) Scenario emissions for this Propane end use (one row per end use) Emissions: : : Wood Cord: (lb) Scenario emissions for this Wood Cord end use (one row per end use) Emissions: : : Wood Pellets: (lb) Scenario emissions for this Wood Pellets end use (one row per end use) Emissions: : : Coal: (lb) Scenario emissions for this Coal end use (one row per end use) ======================================================================= ================================================================== 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. If the home is not fully conditioned (e.g., a room air conditioner that only meets 30% of the cooling load), the reported load will be likewise reduced compared to a home that is fully conditioned. .. _annual_unmet_hours: 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. Unmet Hours: EV Driving (hr) Number of hours where the EV driving demand is not met. [#]_ ============================ ===== .. [#] The unmet heating and cooling numbers reflect the number of hours during the heating/cooling season when the conditioned space temperature deviates more than 0.2 deg-C (0.36 deg-F) from the heating/cooling setpoint. .. [#] The unmet EV driving number represents the total time in which the electric vehicle discharge schedule exceeds zero while the EV battery's state of charge is at its minimum level. Unmet EV driving hours indicate unrealized driving events and reduced EV charging energy. Unmet hours will only occur when using the detailed electric vehicle model in :ref:`hpxml_vehicles`, not the simple EV charging in :ref:`plug_loads`. Peak Building Electricity ~~~~~~~~~~~~~~~~~~~~~~~~~ Peak building electricity outputs are listed below. Values are calculated as the maximum energy use for any individual timestep divided by the timestep length. ================================== ============================================================= Type Notes ================================== ============================================================= Peak Electricity: Winter Total (W) Winter maximum for total electricity consumption [#]_ Peak Electricity: Summer Total (W) Summer maximum for total electricity consumption [#]_ Peak Electricity: Annual Total (W) Annual maximum for total electricity consumption Peak Electricity: Winter Net (W) Winter maximum for total electricity consumption minus power produced by PV Peak Electricity: Summer Net (W) Summer maximum for total electricity consumption minus power produced by PV Peak Electricity: Annual Net (W) Annual maximum for total electricity consumption minus power produced by PV ================================== ============================================================= .. [#] Winter is Dec/Jan/Feb (or Jun/Jul/Aug in the southern hemisphere). .. [#] Summer is Jun/Jul/Aug (or Dec/Jan/Feb in the southern hemisphere). Peak Building Loads ~~~~~~~~~~~~~~~~~~~ Peak building loads are listed below. Values are calculated as the maximum load for any individual timestep divided by the timestep length. ======================================= ================================== 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. If the home is not fully conditioned (e.g., a room air conditioner that only meets 30% of the cooling load), the reported peak load will be likewise reduced compared to a home that is fully conditioned. 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 space Component Load: \*: Ceilings (MBtu) Heat gain/loss through HPXML ``Floor`` elements (inferred to be ceilings) adjacent to conditioned space Component Load: \*: Walls (MBtu) Heat gain/loss through HPXML ``Wall`` elements adjacent to conditioned space Component Load: \*: Rim Joists (MBtu) Heat gain/loss through HPXML ``RimJoist`` elements adjacent to conditioned space Component Load: \*: Foundation Walls (MBtu) Heat gain/loss through HPXML ``FoundationWall`` elements adjacent to conditioned space Component Load: \*: Doors (MBtu) Heat gain/loss through HPXML ``Door`` elements adjacent to conditioned space Component Load: \*: Windows Conduction (MBtu) Heat gain/loss attributed to conduction through HPXML ``Window`` elements adjacent to conditioned space Component Load: \*: Windows Solar (MBtu) Heat gain/loss attributed to solar gains through HPXML ``Window`` elements adjacent to conditioned space Component Load: \*: Skylights Conduction (MBtu) Heat gain/loss attributed to conduction through HPXML ``Skylight`` elements adjacent to conditioned space Component Load: \*: Skylights Solar (MBtu) Heat gain/loss attributed to solar gains through HPXML ``Skylight`` elements adjacent to conditioned space Component Load: \*: Floors (MBtu) Heat gain/loss through HPXML ``Floor`` elements (inferred to be floors) adjacent to conditioned space Component Load: \*: Slabs (MBtu) Heat gain/loss through HPXML ``Slab`` elements adjacent to conditioned space Component 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 (including clothes dryer exhaust) 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 ================================================= ========================================================================================================= If the home is not fully conditioned (e.g., a room air conditioner that only meets 30% of the cooling load), the reported component loads will be likewise reduced compared to a home that is fully conditioned. 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) =================================== ==================== .. note:: All values are gallons of *hot* water (e.g., at water heater setpoint), not *total* water (e.g., at the fixture temperature). Resilience ~~~~~~~~~~ Resilience outputs are listed below. =================================== ==================== Type Notes =================================== ==================== Resilience: Battery (hr) Average length of time the battery state of charge can meet the electric load [#]_ =================================== ==================== .. [#] Calculation is performed every timestep and then averaged, which assumes a power outage is equally likely to occur every hour of the year. The entire electric load is treated as a "critical load" that would be supported during an outage. Resilience hours are set to 0 for any timestep where the battery is not charged, even if there is sufficient PV to power the building. HVAC Capacities ~~~~~~~~~~~~~~~ System outputs are listed below. Capacities for individual HVAC systems can be found in the ``in.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 ==================================================== ==================== .. note:: Autosized HVAC systems are based on :ref:`hvac_design_temps` and :ref:`hvac_design_loads`. For heat pumps with a minimum compressor lockout temperature greater than the heating design temperature (e.g., a dual-fuel heat pump in a cold climate), the compressor will be sized based on heating design loads calculated at the compressor lockout temperature. This is done to prevent unutilized capacity at temperatures below the compressor lockout temperature. Any heat pump backup will still be based on heating design loads calculated using the heating design temperature. .. _hvac_design_temps: HVAC Design Temperatures ~~~~~~~~~~~~~~~~~~~~~~~~ Design temperatures are used in the design load calculations for autosizing of HVAC equipment; see :ref:`hvac_sizing_control` for how they are derived. Design temperatures can also be found in the ``in.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: 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 :ref:`hvac_design_temps`. Design loads can also be found in the ``in.xml`` file. Additional detail related to design loads can be found in the :ref:`design_load_details`. ===================================================================== ==================== 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 (Btu/h) Heating design load for infiltration HVAC Design Load: Heating: Ventilation (Btu/h) Heating design load for ventilation HVAC Design Load: Heating: Piping (Btu/h) Heating design load for hydronic piping 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 (Btu/h) Sensible cooling design load for infiltration HVAC Design Load: Cooling Sensible: Ventilation (Btu/h) Sensible cooling design load for ventilation HVAC Design Load: Cooling Sensible: Internal Gains (Btu/h) Sensible cooling design load for internal gains HVAC Design Load: Cooling Sensible: Blower Heat (Btu/h) Sensible cooling design load for blower fan heat HVAC Design Load: Cooling Sensible: AED Excursion (Btu/h) Sensible cooling design load for Adequate Exposure Diversity (AED) excursion 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 (Btu/h) Latent cooling design load for infiltration HVAC Design Load: Cooling Latent: Ventilation (Btu/h) Latent cooling design load for ventilation HVAC Design Load: Cooling Latent: Internal Gains (Btu/h) Latent cooling design load for internal gains ===================================================================== ==================== .. _hvac_zone_design_loads: HVAC Zone Design Loads ~~~~~~~~~~~~~~~~~~~~~~ For each conditioned zone (see :ref:`zones_spaces`), zone-level design loads are available as listed below. Zone design loads can also be found in the ``in.xml`` file. Additional detail related to zone design loads can be found in the :ref:`design_load_details`:. ===================================================================================== ==================== Type Notes ===================================================================================== ==================== HVAC Zone Design Load: : Heating: Total (Btu/h) Total heating design load HVAC Zone Design Load: : Heating: Ducts (Btu/h) Heating design load for ducts HVAC Zone Design Load: : Heating: Windows (Btu/h) Heating design load for windows HVAC Zone Design Load: : Heating: Skylights (Btu/h) Heating design load for skylights HVAC Zone Design Load: : Heating: Doors (Btu/h) Heating design load for doors HVAC Zone Design Load: : Heating: Walls (Btu/h) Heating design load for walls HVAC Zone Design Load: : Heating: Roofs (Btu/h) Heating design load for roofs HVAC Zone Design Load: : Heating: Floors (Btu/h) Heating design load for floors HVAC Zone Design Load: : Heating: Slabs (Btu/h) Heating design load for slabs HVAC Zone Design Load: : Heating: Ceilings (Btu/h) Heating design load for ceilings HVAC Zone Design Load: : Heating: Infiltration (Btu/h) Heating design load for infiltration HVAC Zone Design Load: : Heating: Ventilation (Btu/h) Heating design load for ventilation HVAC Zone Design Load: : Heating: Piping (Btu/h) Heating design load for hydronic piping HVAC Zone Design Load: : Cooling Sensible: Total (Btu/h) Total sensible cooling design load HVAC Zone Design Load: : Cooling Sensible: Ducts (Btu/h) Sensible cooling design load for ducts HVAC Zone Design Load: : Cooling Sensible: Windows (Btu/h) Sensible cooling design load for windows HVAC Zone Design Load: : Cooling Sensible: Skylights (Btu/h) Sensible cooling design load for skylights HVAC Zone Design Load: : Cooling Sensible: Doors (Btu/h) Sensible cooling design load for doors HVAC Zone Design Load: : Cooling Sensible: Walls (Btu/h) Sensible cooling design load for walls HVAC Zone Design Load: : Cooling Sensible: Roofs (Btu/h) Sensible cooling design load for roofs HVAC Zone Design Load: : Cooling Sensible: Floors (Btu/h) Sensible cooling design load for floors HVAC Zone Design Load: : Cooling Sensible: Slabs (Btu/h) Sensible cooling design load for slabs HVAC Zone Design Load: : Cooling Sensible: Ceilings (Btu/h) Sensible cooling design load for ceilings HVAC Zone Design Load: : Cooling Sensible: Infiltration (Btu/h) Sensible cooling design load for infiltration HVAC Zone Design Load: : Cooling Sensible: Ventilation (Btu/h) Sensible cooling design load for ventilation HVAC Zone Design Load: : Cooling Sensible: Internal Gains (Btu/h) Sensible cooling design load for internal gains HVAC Zone Design Load: : Cooling Sensible: Blower Heat (Btu/h) Sensible cooling design load for blower fan heat HVAC Zone Design Load: : Cooling Sensible: AED Excursion (Btu/h) Sensible cooling design load for Adequate Exposure Diversity (AED) excursion HVAC Zone Design Load: : Cooling Latent: Total (Btu/h) Total latent cooling design load HVAC Zone Design Load: : Cooling Latent: Ducts (Btu/h) Latent cooling design load for ducts HVAC Zone Design Load: : Cooling Latent: Infiltration (Btu/h) Latent cooling design load for infiltration HVAC Zone Design Load: : Cooling Latent: Ventilation (Btu/h) Latent cooling design load for ventilation HVAC Zone Design Load: : Cooling Latent: Internal Gains (Btu/h) Latent cooling design load for internal gains ===================================================================================== ==================== .. _hvac_space_design_loads: HVAC Space Design Loads ~~~~~~~~~~~~~~~~~~~~~~~ For each space in a conditioned zone (see :ref:`zones_spaces`), space-level design loads are available as listed below. Space design loads can also be found in the ``in.xml`` file. Additional detail related to space design loads can be found in the :ref:`design_load_details`:. ===================================================================================== ==================== Type Notes ===================================================================================== ==================== HVAC Space Design Load: : Heating: Total (Btu/h) Total heating design load HVAC Space Design Load: : Heating: Ducts (Btu/h) Heating design load for ducts HVAC Space Design Load: : Heating: Windows (Btu/h) Heating design load for windows HVAC Space Design Load: : Heating: Skylights (Btu/h) Heating design load for skylights HVAC Space Design Load: : Heating: Doors (Btu/h) Heating design load for doors HVAC Space Design Load: : Heating: Walls (Btu/h) Heating design load for walls HVAC Space Design Load: : Heating: Roofs (Btu/h) Heating design load for roofs HVAC Space Design Load: : Heating: Floors (Btu/h) Heating design load for floors HVAC Space Design Load: : Heating: Slabs (Btu/h) Heating design load for slabs HVAC Space Design Load: : Heating: Ceilings (Btu/h) Heating design load for ceilings HVAC Space Design Load: : Heating: Infiltration (Btu/h) Heating design load for infiltration HVAC Space Design Load: : Cooling Sensible: Total (Btu/h) Total sensible cooling design load HVAC Space Design Load: : Cooling Sensible: Ducts (Btu/h) Sensible cooling design load for ducts HVAC Space Design Load: : Cooling Sensible: Windows (Btu/h) Sensible cooling design load for windows HVAC Space Design Load: : Cooling Sensible: Skylights (Btu/h) Sensible cooling design load for skylights HVAC Space Design Load: : Cooling Sensible: Doors (Btu/h) Sensible cooling design load for doors HVAC Space Design Load: : Cooling Sensible: Walls (Btu/h) Sensible cooling design load for walls HVAC Space Design Load: : Cooling Sensible: Roofs (Btu/h) Sensible cooling design load for roofs HVAC Space Design Load: : Cooling Sensible: Floors (Btu/h) Sensible cooling design load for floors HVAC Space Design Load: : Cooling Sensible: Slabs (Btu/h) Sensible cooling design load for slabs HVAC Space Design Load: : Cooling Sensible: Ceilings (Btu/h) Sensible cooling design load for ceilings HVAC Space Design Load: : Cooling Sensible: Infiltration (Btu/h) Sensible cooling design load for infiltration HVAC Space Design Load: : Cooling Sensible: Internal Gains (Btu/h) Sensible cooling design load for internal gains HVAC Space Design Load: : Cooling Sensible: AED Excursion (Btu/h) Sensible cooling design load for Adequate Exposure Diversity (AED) excursion ===================================================================================== ==================== HVAC Geothermal Loop ~~~~~~~~~~~~~~~~~~~~ Geothermal loop outputs are listed below. Outputs for individual geothermal loops can be found in the ``in.xml`` file. ===================================================================== ==================== Type Notes ===================================================================== ==================== HVAC Geothermal Loop: Borehole/Trench Count Total number of vertical boreholes HVAC Geothermal Loop: Borehole/Trench Length (ft) Length (i.e., average depth) of each borehole ===================================================================== ==================== .. _timeseries_outputs: Timeseries Outputs ------------------ OpenStudio-HPXML can optionally generate a timeseries output file. **Note**: This output file is only available when timeseries outputs are requested. The timeseries output file is called ``results_timeseries.csv`` (or ``.json`` or ``.msgpack``) and located in the run directory. If multiple timeseries frequencies are requested (e.g., hourly and daily), the timeseries output filenames will include the frequency (e.g., ``run/results_timeseries_daily.csv``). Depending on the outputs requested, the file may include: ================================== =================== ================================================================================================================================== Type Argument [#]_ Notes ================================== =================== ================================================================================================================================== Total Consumptions ``total`` Energy use for building total and net (i.e., subtracts any power produced by PV). Fuel Consumptions ``fuels`` Energy use for each fuel type (in kBtu for fossil fuels and kWh for electricity). End Use Consumptions ``enduses`` Energy use for each end use type (in kBtu for fossil fuels and kWh for electricity). System Use Consumptions ``systemuses`` Energy use for each HVAC and water heating system (in kBtu). Emissions ``emissions`` Emissions (e.g., CO2) for each scenario defined in the HPXML file. Emission Fuels ``emissionfuels`` Emissions (e.g., CO2) disaggregated by fuel type for each scenario defined in the HPXML file. Emission End Uses ``emissionenduses`` Emissions (e.g., CO2) disaggregated by end use for each scenario defined in the HPXML file. Hot Water Uses ``hotwater`` Water use for each end use type (in gallons). Total Loads ``loads`` Heating, cooling, and hot water loads (in kBtu). Component Loads ``componentloads`` Heating and cooling loads (in kBtu) disaggregated by component (e.g., Walls, Windows, Infiltration, Ducts, etc.). Unmet Hours ``unmethours`` Heating, cooling, and EV driving unmet hours. Zone Temperatures ``temperatures`` Zone temperatures (in deg-F) for each space (e.g., conditioned space, attic, garage, basement, crawlspace, etc.) plus heating/cooling setpoints. Zone Conditions ``conditions`` Zone conditions (humidity ratio and relative humidity and dewpoint, radiant, and operative temperatures) Airflows ``airflows`` Airflow rates (in cfm) for infiltration, mechanical ventilation (including clothes dryer exhaust), natural ventilation, whole house fans. Weather ``weather`` Weather file data including outdoor temperatures, relative humidity, wind speed, and solar. Resilience ``resilience`` Resilience outputs (currently only average resilience hours for battery storage). EnergyPlus Output Variables/Meters Any user-specified EnergyPlus output variables/meters (e.g., 'Zone People Occupant Count', 'MainsWater:Facility'). ================================== =================== ================================================================================================================================== .. [#] This is the argument provided to ``run_simulation.rb`` as described in the :ref:`basic_run` usage instructions. Timeseries outputs can be one of the following frequencies: hourly, daily, monthly, or timestep (i.e., equal to the simulation timestep, which defaults to an hour but can be sub-hourly). Timestamps in the output use the start-of-period convention unless you have requested the end-of-period timestamp convention. Additional timestamp columns can be optionally requested that reflect daylight saving time (DST) and/or coordinated universal time (UTC). Most outputs will be summed over the hour (e.g., energy) but some will be averaged over the hour (e.g., temperatures, airflows). Note that if the home is not fully conditioned (e.g., a room air conditioner that only meets 30% of the cooling load), the reported zone temperature for the conditioned space will reflect a fully conditioned home due to the way these systems are modeled in EnergyPlus. .. _bill_outputs: Utility Bill Outputs -------------------- OpenStudio-HPXML can optionally generate utility bill output files (annual, monthly, or both). **Note**: These output files are only available when utility bill scenarios are specified. When no utility bill scenarios are specified, utility bill output files are not generated. See :ref:`hpxml_utility_bill_scenarios` for more information about specifying utility bill scenarios. The annual utility bills output file is called ``results_bills.csv`` (or ``.json`` or ``.msgpack``) and located in the run directory. The monthly utility bills output file is called ``results_bills_monthly.csv`` (or ``.json`` or ``.msgpack``) and located in the run directory. Annual Bills by Fuel Use ~~~~~~~~~~~~~~~~~~~~~~~~ Annual results for each utility bill scenario defined in the HPXML file are listed as shown below. ================================================= ==================== Type Notes ================================================= ==================== : Total (USD) Scenario annual total charges. : Electricity: Fixed (USD) Scenario annual fixed charges for electricity. : Electricity: Energy (USD) Scenario annual energy charges for electricity. : Electricity: PV Credit (USD) Scenario annual production credit (negative value) for PV. : Electricity: Total (USD) Scenario annual total charges for electricity. : Natural Gas: Fixed (USD) Scenario annual fixed charges for natural gas. : Natural Gas: Energy (USD) Scenario annual energy charges for natural gas. : Natural Gas: Total (USD) Scenario annual total charges for natural gas. : Fuel Oil: Fixed (USD) Scenario annual fixed charges for fuel oil. : Fuel Oil: Energy (USD) Scenario annual energy charges for fuel oil. : Fuel Oil: Total (USD) Scenario annual total charges for fuel oil. : Propane: Fixed (USD) Scenario annual fixed charges for propane. : Propane: Energy (USD) Scenario annual energy charges for propane. : Propane: Total (USD) Scenario annual total charges for propane. : Wood Cord: Fixed (USD) Scenario annual fixed charges for wood cord. : Wood Cord: Energy (USD) Scenario annual energy charges for wood cord. : Wood Cord: Total (USD) Scenario annual total charges for wood cord. : Wood Pellets: Fixed (USD) Scenario annual fixed charges for wood pellets. : Wood Pellets: Energy (USD) Scenario annual energy charges for wood pellets. : Wood Pellets: Total (USD) Scenario annual total charges for wood pellets. : Coal: Fixed (USD) Scenario annual fixed charges for coal. : Coal: Energy (USD) Scenario annual energy charges for coal. : Coal: Total (USD) Scenario annual total charges for coal. ================================================= ==================== Monthly Bills by Fuel Use ~~~~~~~~~~~~~~~~~~~~~~~~~ Monthly results for each utility bill scenario defined in the HPXML file are listed as rows corresponding to Month, and columns corresponding to Type. .. _panel_outputs: Electric Panel Outputs ---------------------- OpenStudio-HPXML can optionally generate an electric panel output file. **Note**: This output file is only available when electric panel load calculation outputs are requested. When no load calculation types are specified, the electric panels output file is not generated. See :ref:`hpxml_electric_panel_calculations` for more information about specifying electric panel load calculation types. The electric panels output file is called ``results_panel.csv`` (or ``.json`` or ``.msgpack``) and located in the run directory. Panel breaker spaces and loads can also be found in the ``in.xml`` file. Breaker Spaces ~~~~~~~~~~~~~~ Electric panel breaker space counts are available as listed below. End use categories (e.g., Heating, Cooling, Hot Water) report occupied spaces for dedicated circuits except for Other which reports otherwise uncategorized or shared circuits. ================================================================================ ==================== Type Notes ================================================================================ ==================== Electric Panel Breaker Spaces: Heating Count Sum of heating system and heat pump heating occupied spaces Electric Panel Breaker Spaces: Cooling Count Sum of cooling system and heat pump cooling occupied spaces Electric Panel Breaker Spaces: Hot Water Count Sum of water heating system occupied spaces Electric Panel Breaker Spaces: Clothes Dryer Count Sum of clothes dryer occupied spaces Electric Panel Breaker Spaces: Dishwasher Count Sum of dishwasher occupied spaces Electric Panel Breaker Spaces: Range/Oven Count Sum of range/oven occupied spaces Electric Panel Breaker Spaces: Mech Vent Count Sum of mechanical ventilation occupied spaces Electric Panel Breaker Spaces: Permanent Spa Heater Count Sum of permanent spa heater occupied spaces Electric Panel Breaker Spaces: Permanent Spa Pump Count Sum of permanent spa pump occupied spaces Electric Panel Breaker Spaces: Pool Heater Count Sum of pool heater occupied spaces Electric Panel Breaker Spaces: Pool Pump Count Sum of pool pump occupied spaces Electric Panel Breaker Spaces: Well Pump Count Sum of well pump occupied spaces Electric Panel Breaker Spaces: Electric Vehicle Charging Count Sum of electric vehicle charging occupied spaces Electric Panel Breaker Spaces: Other Count Sum of other occupied spaces Electric Panel Breaker Spaces: Total Count Total rated number of spaces on the panel Electric Panel Breaker Spaces: Occupied Count Total number of occupied spaces on the panel Electric Panel Breaker Spaces: Headroom Count Total Count minus Occupied Count ================================================================================ ==================== .. note:: Headroom is calculated as the panel's total rated breaker spaces minus occupied breaker spaces. A positive value indicates panel availability whereas a negative value indicates panel constraint. Loads ~~~~~ Electric panel loads, as well as calculated total loads and capacities for each calculation type (see :ref:`hpxml_electric_panel_calculations`), are available as listed below. ================================================================================ ==================== Type Notes ================================================================================ ==================== Electric Panel Load: Heating (W) Sum of heating system and heat pump heating loads Electric Panel Load: Cooling (W) Sum of cooling system and heat pump cooling loads Electric Panel Load: Hot Water (W) Sum of water heating system loads Electric Panel Load: Clothes Dryer (W) Sum of clothes dryer loads Electric Panel Load: Dishwasher (W) Sum of dishwasher loads Electric Panel Load: Range/Oven (W) Sum of range/oven loads Electric Panel Load: Mech Vent (W) Sum of mechanical ventilation loads Electric Panel Load: Permanent Spa Heater (W) Sum of permanent spa heater loads Electric Panel Load: Permanent Spa Pump (W) Sum of permanent spa pump loads Electric Panel Load: Pool Heater (W) Sum of pool heater loads Electric Panel Load: Pool Pump (W) Sum of pool pump loads Electric Panel Load: Well Pump (W) Sum of well pump loads Electric Panel Load: Electric Vehicle Charging (W) Sum of electric vehicle charging loads Electric Panel Load: Other (W) Sum of other loads Electric Panel Load: : Total Load (W) Calculated NEC total load capacity Electric Panel Load: : Total Capacity (A) Total Load (W) divided by panel voltage Electric Panel Load: : Headroom Capacity (A) Panel max current rating (A) minus Total Capacity (A) ================================================================================ ==================== .. note:: Headroom is calculated as the panel's maximum current rating minus calculated capacity. A positive value indicates panel availability whereas a negative value indicates panel constraint. .. _design_load_details: Design Load Details Outputs --------------------------- OpenStudio-HPXML provides an additional output file called ``results_design_load_details.csv`` (or ``.json`` or ``.msgpack``) that includes details related to the calculation of HVAC design loads for sizing equipment. The file includes values pertaining to ACCA Form J1 (see example on page 2 of `here `_). The file is organized into a few different reports described below. Report: : Summary ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For each HPXML Building, the following output types are reported. =========================== =========== ================ ================ ================ ================ Type Orientation Heating HTM [#]_ Cooling HTM [#]_ Heating CFM [#]_ Cooling CFM [#]_ =========================== =========== ================ ================ ================ ================ Windows: X X X Skylights: X X X Doors: X X X Above Grade Walls: X X X Below Grade Walls: X X X Ceilings: X X Floors: X X Infiltration X X Ventilation X X =========================== =========== ================ ================ ================ ================ .. [#] Heating HTM is the heating heat transfer multiplier (Btu/ft^2), which is multiplier by surface area to calculate the heating design load. .. [#] Cooling HTM is the cooling heat transfer multiplier (Btu/ft^2), which is multiplier by surface area to calculate the sensible cooling design load. .. [#] Heating CFM is the airflow rate (ft^3/min) during the heating season. .. [#] Cooling CFM is the airflow rate (ft^3/min) during the cooling season. Report: : Loads ~~~~~~~~~~~~~~~~~~~~~~~~~~~ For each HPXML Building, the following output types are reported. =========================== =========== =========== =============== ============== ======================= ===================== Type Area (ft^2) Length (ft) Wall Area Ratio Heating (Btuh) Cooling Sensible (Btuh) Cooling Latent (Btuh) =========================== =========== =========== =============== ============== ======================= ===================== Windows: X X X Skylights: X X X Doors: X X X Above Grade Walls: X X X Below Grade Walls: X X X Ceilings: X X X Floors: X See [#]_ X X Infiltration X X X X Internal Gains X X Ducts X X X Ventilation X X X Piping X Blower Heat X AED Excursion X Total X X X =========================== =========== =========== =============== ============== ======================= ===================== .. [#] Length will be provided for a slab floor under conditioned space. Report: : : Loads ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For each HPXML conditioned Zone (see :ref:`zones_spaces`), the following output types are reported. Only those surfaces attached to a space in the given zone will be included. =========================== =========== =========== =============== ============== ======================= ===================== Type Area (ft^2) Length (ft) Wall Area Ratio Heating (Btuh) Cooling Sensible (Btuh) Cooling Latent (Btuh) =========================== =========== =========== =============== ============== ======================= ===================== Windows: X X X Skylights: X X X Doors: X X X Above Grade Walls: X X X Below Grade Walls: X X X Ceilings: X X X Floors: X See [#]_ X X Infiltration X X X X Internal Gains X X Ducts X X X Ventilation X X X Piping X Blower Heat X AED Excursion X Total X X X =========================== =========== =========== =============== ============== ======================= ===================== .. [#] Length will be provided for a slab floor under conditioned space. Report: : : Loads ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For each HPXML Space in a conditioned zone (see :ref:`zones_spaces`), the following output types are reported. Only those surfaces attached to the given space will be included. =========================== =========== =========== =============== ============== ======================= Type Area (ft^2) Length (ft) Wall Area Ratio Heating (Btuh) Cooling Sensible (Btuh) =========================== =========== =========== =============== ============== ======================= Windows: X X X Skylights: X X X Doors: X X X Above Grade Walls: X X X Ceilings: X X X Floors: X See [#]_ X X Infiltration X X X Internal Gains X Ducts X X AED Excursion X Total X X =========================== =========== =========== =============== ============== ======================= .. [#] Length will be provided for a slab floor under conditioned space. Report: : AED Curve ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For each HPXML Building (and any HPXML spaces, see :ref:`zones_spaces`), the hourly cooling fenestration load curve (AED curve) from 8am to 8pm is provided. ======================= =========== =========== ============ ============ ============ ============ ============ ============ ============ ============ ============ ============ Type Hr 8 (Btuh) Hr 9 (Btuh) Hr 10 (Btuh) Hr 11 (Btuh) Hr 12 (Btuh) Hr 13 (Btuh) Hr 14 (Btuh) Hr 15 (Btuh) Hr 16 (Btuh) Hr 17 (Btuh) Hr 18 (Btuh) Hr 19 (Btuh) ======================= =========== =========== ============ ============ ============ ============ ============ ============ ============ ============ ============ ============ X X X X X X X X X X X X : X X X X X X X X X X X X ======================= =========== =========== ============ ============ ============ ============ ============ ============ ============ ============ ============ ============