urbanopt-cli 0.9.3 → 0.10.0

data/example_files/resources/hpxml-measures/docs/source/workflow_outputs.rst

@@ -18,6 +18,10 @@ OpenStudio-HPXML generates a number of workflow outputs:
   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
@@ -80,59 +84,62 @@ Annual Outputs
 OpenStudio-HPXML will always generate an annual output file called ``results_annual.csv`` (or ``results_annual.json`` or ``results_annual.msgpack``), located in the run directory.
 The file includes the following sections of output:
 
-Annual Energy Consumption
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Annual Energy
+~~~~~~~~~~~~~
 
-Annual energy consumption outputs are listed below.
+Annual energy outputs are listed below.
 
   ====================================  ===========================
   Type                                  Notes
   ====================================  ===========================
-  Energy Use: Total (MBtu)              Includes any battery charging/discharging
-  Energy Use: Net (MBtu)                Subtracts any power produced by PV or generators.
+  Energy Use: Total (MBtu)              Total energy consumption; includes any battery charging/discharging
+  Energy Use: Net (MBtu)                Subtracts any power produced by PV or generators
   ====================================  ===========================
 
-Annual Energy Consumption by Fuel Use
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Annual Energy by Fuel Use
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Fuel uses are listed below.
 
    ====================================  ===========================
    Type                                  Notes
    ====================================  ===========================
-   Fuel Use: Electricity: Total (MBtu)   Includes any battery charging/discharging
-   Fuel Use: Electricity: Net (MBtu)     Subtracts any power produced by PV or generators.
+   Fuel Use: Electricity: Total (MBtu)   Total electricity consumption, includes any battery charging/discharging
+   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)      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: 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".
+   Fuel Use: Coal: Total (MBtu)          Includes "coal", "anthracite coal", "bituminous coal", and "coke"
    ====================================  ===========================
 
-Annual Energy Consumption By End Use
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _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 Heat Pump Backup (MBtu)
-   End Use: Electricity: Heating Fans/Pumps (MBtu)
-   End Use: Electricity: Cooling (MBtu)                                 Excludes fans/pumps
-   End Use: Electricity: Cooling Fans/Pumps (MBtu)
-   End Use: Electricity: Hot Water (MBtu)                               Excludes recirc pump and solar thermal pump
+   ================================================================  ====================================================
+   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: 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: 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)
@@ -145,106 +152,142 @@ So the sum of all end uses for a given fuel (e.g., sum of all "End Use: Natural
    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: Plug Loads (MBtu)                           Excludes independently reported plug loads (e.g., well pump)
    End Use: Electricity: Electric Vehicle Charging (MBtu)
    End Use: Electricity: Well Pump (MBtu)
    End Use: Electricity: Pool Heater (MBtu)
    End Use: Electricity: Pool Pump (MBtu)
    End Use: Electricity: Hot Tub Heater (MBtu)
    End Use: Electricity: Hot Tub 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: Natural Gas: Heating (MBtu)                                 Excludes heat pump backup
+   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: 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: Mech Vent Precooling (MBtu)
    End Use: Natural Gas: Pool Heater (MBtu)
    End Use: Natural Gas: Hot Tub 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: 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: Mech Vent Precooling (MBtu)
    End Use: Fuel Oil: Grill (MBtu)
    End Use: Fuel Oil: Lighting (MBtu)
    End Use: Fuel Oil: Fireplace (MBtu)
-   End Use: Propane: Heating (MBtu)                                     Excludes heat pump backup
+   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: Mech Vent Precooling (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: 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: Mech Vent Precooling (MBtu)
    End Use: Wood Cord: Grill (MBtu)
    End Use: Wood Cord: Lighting (MBtu)
    End Use: Wood Cord: Fireplace (MBtu)
-   End Use: Wood Pellets: Heating (MBtu)                                Excludes heat pump backup
+   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: Mech Vent Precooling (MBtu)
    End Use: Wood Pellets: Grill (MBtu)
    End Use: Wood Pellets: Lighting (MBtu)
    End Use: Wood Pellets: Fireplace (MBtu)
-   End Use: Coal: Heating (MBtu)                                        Excludes heat pump backup
+   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: Mech Vent Precooling (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: <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
 ~~~~~~~~~~~~~~~~
 
 Results for each emissions scenario defined in the HPXML file are listed as shown below.
-Note that rows below with values of zero will be excluded.
 
    =======================================================================  ==================================================================
    Type                                                                     Notes
    =======================================================================  ==================================================================
-   Emissions: <EmissionsType>: <ScenarioName>: Total (lb)                   Scenario total emissions
-   Emissions: <EmissionsType>: <ScenarioName>: Electricity: Total (lb)      Scenario emissions for Electricity only
-   Emissions: <EmissionsType>: <ScenarioName>: Electricity: <EndUse> (lb)   Scenario emissions for this Electricity end use only (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Total (lb)                   Scenario total emissions, includes any battery charging/discharging
+   Emissions: <EmissionsType>: <ScenarioName>: Net (lb)                     Subtracts any power produced by PV or generators
+   =======================================================================  ==================================================================
+
+Annual Emissions by Fuel Use
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Results for each emissions scenario defined in the HPXML file are listed as shown below.
+
+   =======================================================================  ==================================================================
+   Type                                                                     Notes
+   =======================================================================  ==================================================================
+   Emissions: <EmissionsType>: <ScenarioName>: Electricity: Total (lb)      Scenario total emissions for Electricity only, includes any battery charging/discharging
+   Emissions: <EmissionsType>: <ScenarioName>: Electricity: Net (lb)        Subtracts any power produced by PV or generators
    Emissions: <EmissionsType>: <ScenarioName>: Natural Gas: Total (lb)      Scenario emissions for Natural Gas only
-   Emissions: <EmissionsType>: <ScenarioName>: Natural Gas: <EndUse> (lb)   Scenario emissions for this Natural Gas end use only (one row per end use)
    Emissions: <EmissionsType>: <ScenarioName>: Fuel Oil: Total (lb)         Scenario emissions for Fuel Oil only
-   Emissions: <EmissionsType>: <ScenarioName>: Fuel Oil: <EndUse> (lb)      Scenario emissions for this Fuel Oil end use only (one row per end use)
    Emissions: <EmissionsType>: <ScenarioName>: Propane: Total (lb)          Scenario emissions for Propane only
-   Emissions: <EmissionsType>: <ScenarioName>: Propane: <EndUse> (lb)       Scenario emissions for this Propane end use only (one row per end use)
    Emissions: <EmissionsType>: <ScenarioName>: Wood Cord: Total (lb)        Scenario emissions for Wood Cord only
-   Emissions: <EmissionsType>: <ScenarioName>: Wood Cord: <EndUse> (lb)     Scenario emissions for this Wood Cord end use only (one row per end use)
    Emissions: <EmissionsType>: <ScenarioName>: Wood Pellets: Total (lb)     Scenario emissions for Wood Pellets only
-   Emissions: <EmissionsType>: <ScenarioName>: Wood Pellets: <EndUse> (lb)  Scenario emissions for this Wood Pellets end use only (one row per end use)
    Emissions: <EmissionsType>: <ScenarioName>: Coal: Total (lb)             Scenario emissions for Coal only
-   Emissions: <EmissionsType>: <ScenarioName>: Coal: <EndUse> (lb)          Scenario emissions for this Coal end use only (one row per end use)
+   =======================================================================  ==================================================================
+
+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: <EmissionsType>: <ScenarioName>: Electricity: <EndUse> (lb)   Scenario emissions for this Electricity end use (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Natural Gas: <EndUse> (lb)   Scenario emissions for this Natural Gas end use (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Fuel Oil: <EndUse> (lb)      Scenario emissions for this Fuel Oil end use (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Propane: <EndUse> (lb)       Scenario emissions for this Propane end use (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Wood Cord: <EndUse> (lb)     Scenario emissions for this Wood Cord end use (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Wood Pellets: <EndUse> (lb)  Scenario emissions for this Wood Pellets end use (one row per end use)
+   Emissions: <EmissionsType>: <ScenarioName>: Coal: <EndUse> (lb)          Scenario emissions for this Coal end use (one row per end use)
    =======================================================================  ==================================================================
 
 Annual Building Loads
@@ -252,18 +295,20 @@ Annual Building Loads
 
 Annual building loads are listed below.
 
-   =====================================  ==================================================================
-   Type                                   Notes
-   =====================================  ==================================================================
-   Load: Heating: Delivered (MBtu)        Includes HVAC distribution losses.
-   Load: Cooling: Delivered (MBtu)        Includes HVAC distribution losses.
-   Load: Hot Water: Delivered (MBtu)      Includes contributions by desuperheaters or solar thermal systems.
+   ======================================  ==================================================================
+   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)  Load served by the desuperheater.
-   Load: Hot Water: Solar Thermal (MBtu)  Load served by the solar thermal system.
-   =====================================  ==================================================================
+   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
 ~~~~~~~~~~~~~~~~~~
@@ -284,12 +329,12 @@ Peak Building Electricity
 
 Peak building electricity outputs are listed below.
 
-   ==================================  =========================================================
+   ==================================  =============================================================
    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 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
 ~~~~~~~~~~~~~~~~~~~
@@ -304,6 +349,7 @@ Peak building loads are listed below.
    =======================================  ==================================
 
 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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -325,8 +371,10 @@ Component loads disaggregated by Heating/Cooling are listed below.
    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 (MBtu)                 Heat gain/loss through HPXML ``Window`` elements adjacent to conditioned space, including solar
-   Component Load: \*: Skylights (MBtu)               Heat gain/loss through HPXML ``Skylight`` elements adjacent to conditioned space, including solar
+   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
@@ -335,9 +383,12 @@ Component loads disaggregated by Heating/Cooling are listed below.
    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, lighting, plug loads, water heater tank losses, etc. in the 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
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -370,9 +421,7 @@ Capacities for individual HVAC systems can be found in the `in.xml` file.
 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 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.
 
    =====================================================================  ====================
@@ -437,11 +486,12 @@ Depending on the outputs requested, the file may include:
    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 (e.g., CO2) for each scenario defined in the HPXML file.
    Emission Fuels                       Emissions (e.g., CO2) disaggregated by fuel type for each scenario defined in the HPXML file.
    Emission End Uses                    Emissions (e.g., CO2) disaggregated by end use for each scenario defined in the HPXML file.
    Hot Water Uses                       Water use for each end use type (in gallons).
-   Total Loads                          Heating, cooling, and hot water loads (in kBtu) for the building.
+   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.).
    Unmet Hours                          Heating and cooling unmet hours.
    Zone Temperatures                    Zone temperatures (in deg-F) for each space (e.g., living space, attic, garage, basement, crawlspace, etc.) plus heating/cooling setpoints.
@@ -456,6 +506,8 @@ Timestamps in the output use the start-of-period convention unless you have requ
 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 living space will reflect a fully conditioned home due to the way these systems are modeled in EnergyPlus.
+
 .. _bill_outputs:
 
 Utility Bill Outputs
@@ -465,7 +517,6 @@ OpenStudio-HPXML can optionally generate a utility bills output file.
 The utility bills output file is called ``results_bills.csv`` (or ``results_bills.json`` or ``results_bills.msgpack``) and located in the run directory.
 
 Results for each utility bill scenario defined in the HPXML file are listed as shown below.
-Note that rows below with values of zero will be excluded.
 
    =============================================  ====================
    Type                                           Notes