urbanopt-cli 0.8.3 → 0.9.1

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

@@ -11,9 +11,8 @@ OpenStudio-HPXML generates a number of workflow outputs:
   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 in CSV or JSON format.
+  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_hpxml.csv (or .json or .msgpack)       See :ref:`hpxml_outputs`. HPXML outputs in CSV or JSON format (e.g., enclosure summary, autosized HVAC capacities, design loads, etc.).
   results_bills.csv (or .json or .msgpack)       See :ref:`bill_outputs`. Utility bill outputs in CSV or JSON format.
   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.
@@ -81,6 +80,18 @@ 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 consumption 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.
+  ====================================  ===========================
+
 Annual Energy Consumption by Fuel Use
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -89,8 +100,8 @@ Fuel uses are listed below.
    ====================================  ===========================
    Type                                  Notes
    ====================================  ===========================
-   Fuel Use: Electricity: Total (MBtu)
-   Fuel Use: Electricity: Net (MBtu)     Subtracts any power produced by PV (including any battery storage) or generators.
+   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: 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)
@@ -120,7 +131,7 @@ So the sum of all end uses for a given fuel (e.g., sum of all "End Use: Natural
    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: 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)
@@ -141,8 +152,9 @@ So the sum of all end uses for a given fuel (e.g., sum of all "End Use: Natural
    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 (including any battery storage)
+   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)
@@ -212,29 +224,28 @@ So the sum of all end uses for a given fuel (e.g., sum of all "End Use: Natural
 Annual Emissions
 ~~~~~~~~~~~~~~~~
 
-Results for each emissions scenario defined in the HPXML file is listed as shown below.
-
-   ==============================================================  ==================================================================
-   Type                                                            Notes
-   ==============================================================  ==================================================================
-   Emissions: <EmissionsType>: <Scenario1Name>: Total (lb)         Scenario 1 total emissions
-   Emissions: <EmissionsType>: <Scenario1Name>: Electricity (lb)   Scenario 1 emissions for Electricity only
-   Emissions: <EmissionsType>: <Scenario1Name>: Natural Gas (lb)   Scenario 1 emissions for Natural Gas only
-   Emissions: <EmissionsType>: <Scenario1Name>: Fuel Oil (lb)      Scenario 1 emissions for Fuel Oil only
-   Emissions: <EmissionsType>: <Scenario1Name>: Propane (lb)       Scenario 1 emissions for Propane only
-   Emissions: <EmissionsType>: <Scenario1Name>: Wood Cord (lb)     Scenario 1 emissions for Wood Cord only
-   Emissions: <EmissionsType>: <Scenario1Name>: Wood Pellets (lb)  Scenario 1 emissions for Wood Pellets only
-   Emissions: <EmissionsType>: <Scenario1Name>: Coal (lb)          Scenario 1 emissions for Coal only
-   Emissions: <EmissionsType>: <Scenario2Name>: Total (lb)         Scenario 2 total emissions
-   Emissions: <EmissionsType>: <Scenario2Name>: Electricity (lb)   Scenario 2 emissions for Electricity only
-   Emissions: <EmissionsType>: <Scenario2Name>: Natural Gas (lb)   Scenario 2 emissions for Natural Gas only
-   Emissions: <EmissionsType>: <Scenario2Name>: Fuel Oil (lb)      Scenario 2 emissions for Fuel Oil only
-   Emissions: <EmissionsType>: <Scenario2Name>: Propane (lb)       Scenario 2 emissions for Propane only
-   Emissions: <EmissionsType>: <Scenario2Name>: Wood Cord (lb)     Scenario 2 emissions for Wood Cord only
-   Emissions: <EmissionsType>: <Scenario2Name>: Wood Pellets (lb)  Scenario 2 emissions for Wood Pellets only
-   Emissions: <EmissionsType>: <Scenario2Name>: Coal (lb)          Scenario 2 emissions for Coal only
-   ...
-   ==============================================================  ==================================================================
+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>: 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 Building Loads
 ~~~~~~~~~~~~~~~~~~~~~
@@ -266,7 +277,7 @@ Annual unmet hours are listed below.
    Unmet Hours: Cooling (hr)  Number of hours where the cooling setpoint is not maintained.
    =========================  =====
 
-These numbers reflect the number of hours of the year when the conditioned space temperature is more than 0.2 deg-C (0.36 deg-F) from the setpoint during heating/cooling.
+These 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.
 
 Peak Building Electricity
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -285,12 +296,12 @@ Peak Building Loads
 
 Peak building loads are listed below.
 
-   ====================================  ==================================
-   Type                                  Notes
-   ====================================  ==================================
-   Peak Load: Heating: Delivered (kBtu)  Includes HVAC distribution losses.
-   Peak Load: Cooling: Delivered (kBtu)  Includes HVAC distribution losses.
-   ====================================  ==================================
+   =======================================  ==================================
+   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.
 
@@ -309,14 +320,14 @@ 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 ``FrameFloor`` elements (inferred to be ceilings) 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 (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: \*: Floors (MBtu)                  Heat gain/loss through HPXML ``FrameFloor`` elements (inferred to be floors) 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
@@ -341,6 +352,75 @@ Annual hot water uses are listed below.
    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 `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
+   ====================================================  ====================
+
+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 `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
+~~~~~~~~~~~~~~~~~
+
+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 `in.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
+   =====================================================================  ====================
+
 .. _timeseries_outputs:
 
 Timeseries Outputs
@@ -358,10 +438,13 @@ Depending on the outputs requested, the file may include:
    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).
    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.
    Component Loads                      Heating and cooling loads (in kBtu) disaggregated by component (e.g., Walls, Windows, Infiltration, Ducts, etc.).
-   Zone Temperatures                    Average temperatures (in deg-F) for each space modeled (e.g., living space, attic, garage, basement, crawlspace, etc.).
+   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.
    Airflows                             Airflow rates (in cfm) for infiltration, mechanical ventilation (including clothes dryer exhaust), natural ventilation, whole house fans.
    Weather                              Weather file data including outdoor temperatures, relative humidity, wind speed, and solar.
    EnergyPlus Output Variables          These are optional and can be requested with the ReportSimulationOutput ``user_output_variables`` argument.
@@ -369,109 +452,10 @@ Depending on the outputs requested, the file may include:
 
 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 end-of-hour (or end-of-day for daily frequency, etc.) convention.
+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).
 
-.. _hpxml_outputs:
-
-HPXML Outputs
--------------
-
-OpenStudio-HPXML will always generate an output file called ``results_hpxml.csv`` (or ``results_hpxml.json`` or ``results_hpxml.msgpack``), located in the run directory.
-Unlike the other output files that are based on EnergyPlus simulation results, this file contains outputs summarizing the HPXML file (including defaults like auto-sized HVAC systems).
-The file includes the following sections of output:
-
-Enclosure
-~~~~~~~~~
-
-Enclosure outputs are listed below.
-
-   =======================================================  ====================
-   Type                                                     Notes
-   =======================================================  ====================
-   Enclosure: Wall Area Thermal Boundary (ft^2)             Total thermal boundary wall area
-   Enclosure: Wall Area Exterior (ft^2)                     Total exterior wall area
-   Enclosure: Foundation Wall Area Exterior (ft^2)          Total exterior foundation wall area
-   Enclosure: Floor Area Conditioned (ft^2)                 Total conditioned floor area
-   Enclosure: Floor Area Lighting (ft^2)                    Total lighting floor area
-   Enclosure: Floor Area Foundation (ft^2)                  Total foundation floor area
-   Enclosure: Ceiling Area Thermal Boundary (ft^2)          Total thermal boundary ceiling area
-   Enclosure: Roof Area (ft^2)                              Total roof area
-   Enclosure: Window Area (ft^2)                            Total window area
-   Enclosure: Door Area (ft^2)                              Total door area
-   Enclosure: Duct Area Unconditioned (ft^2)                Total unconditioned duct area
-   Enclosure: Rim Joist Area (ft^2)                         Total rim joist area
-   Enclosure: Slab Exposed Perimeter Thermal Boundary (ft)  Total thermal boundary slab exposed perimeter
-   =======================================================  ====================
-
-Systems
-~~~~~~~
-
-System outputs are listed below.
-Autosized HVAC systems are based on ACCA Manual S calculations.
-
-   =======================================================  ====================
-   Type                                                     Notes
-   =======================================================  ====================
-   Systems: Cooling Capacity (Btu/h)                        Total HVAC cooling capacity
-   Systems: Heating Capacity (Btu/h)                        Total HVAC heating capacity
-   Systems: Heat Pump Backup Capacity (Btu/h)               Total HVAC heat pump backup capacity
-   Systems: Water Heater Tank Volume (gal)                  Total water heater tank volume
-   Systems: Mechanical Ventilation Flow Rate (cfm)          Total mechanical ventilation flow rate
-   =======================================================  ====================
-
-If the HPXML file has ``Systems/HVAC/HVACPlant/PrimarySystems`` populated, then additional system outputs will be provided:
-
-   =======================================================  ====================
-   Type                                                     Notes
-   =======================================================  ====================
-   Primary Systems: Cooling Capacity (Btu/h)                Cooling capacity of primary system
-   Primary Systems: Heating Capacity (Btu/h)                Heating capacity of primary system
-   Primary Systems: Heat Pump Backup Capacity (Btu/h)       Heat pump backup capacity of primary system
-   Secondary Systems: Cooling Capacity (Btu/h)              Cooling capacity of secondary system; only provided if a non-primary system is present
-   Secondary Systems: Heating Capacity (Btu/h)              Heating capacity of secondary system; only provided if a non-primary system is present
-   Secondary Systems: Heat Pump Backup Capacity (Btu/h)     Heat pump backup capacity of secondary system; only provided if a non-primary system is present
-   =======================================================  ====================
-
-Design Loads
-~~~~~~~~~~~~
-
-Design load outputs are listed below.
-Design loads are based on block load ACCA Manual J calculations.
-
-   ================================================================  ====================
-   Type                                                              Notes
-   ================================================================  ====================
-   Design Loads Heating: Total (Btu/h)                               Total heating design load
-   Design Loads Heating: Ducts (Btu/h)                               Heating design load for ducts
-   Design Loads Heating: Windows (Btu/h)                             Heating design load for windows
-   Design Loads Heating: Skylights (Btu/h)                           Heating design load for skylights
-   Design Loads Heating: Doors (Btu/h)                               Heating design load for doors
-   Design Loads Heating: Walls (Btu/h)                               Heating design load for walls
-   Design Loads Heating: Roofs (Btu/h)                               Heating design load for roofs
-   Design Loads Heating: Floors (Btu/h)                              Heating design load for floors
-   Design Loads Heating: Slabs (Btu/h)                               Heating design load for slabs
-   Design Loads Heating: Ceilings (Btu/h)                            Heating design load for ceilings
-   Design Loads Heating: Infiltration/Ventilation (Btu/h)            Heating design load for infiltration/ventilation
-   Design Loads Cooling Sensible: Total (Btu/h)                      Total sensible cooling design load
-   Design Loads Cooling Sensible: Ducts (Btu/h)                      Sensible cooling design load for ducts
-   Design Loads Cooling Sensible: Windows (Btu/h)                    Sensible cooling design load for windows
-   Design Loads Cooling Sensible: Skylights (Btu/h)                  Sensible cooling design load for skylights
-   Design Loads Cooling Sensible: Doors (Btu/h)                      Sensible cooling design load for doors
-   Design Loads Cooling Sensible: Walls (Btu/h)                      Sensible cooling design load for walls
-   Design Loads Cooling Sensible: Roofs (Btu/h)                      Sensible cooling design load for roofs
-   Design Loads Cooling Sensible: Floors (Btu/h)                     Sensible cooling design load for floors
-   Design Loads Cooling Sensible: Slabs (Btu/h)                      Sensible cooling design load for slabs
-   Design Loads Cooling Sensible: Ceilings (Btu/h)                   Sensible cooling design load for ceilings
-   Design Loads Cooling Sensible: Infiltration/Ventilation (Btu/h)   Sensible cooling design load for infiltration/ventilation
-   Design Loads Cooling Sensible: Internal Gains (Btu/h)             Sensible cooling design load for internal gains
-   Design Loads Cooling Latent: Total (Btu/h)                        Total latent cooling design load
-   Design Loads Cooling Latent: Ducts (Btu/h)                        Latent cooling design load for ducts
-   Design Loads Cooling Latent: Infiltration/Ventilation (Btu/h)     Latent cooling design load for infiltration/ventilation
-   Design Loads Cooling Latent: Internal Gains (Btu/h)               Latent cooling design load for internal gains
-   ================================================================  ====================
-
 .. _bill_outputs:
 
 Utility Bill Outputs
@@ -479,24 +463,34 @@ Utility Bill Outputs
 
 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.
-Monthly fixed charges and marginal rates, as well as PV compensation types/rates/fees, are defined to determine how utility bills are calculated.
 
-The file includes:
+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
    =============================================  ====================
-   Total ($)                                      Annual total charges.
-   Electricity: Fixed ($)                         Annual fixed charges for electricity.
-   Electricity: Marginal ($)                      Annual energy charges for electricity.
-   Electricity: PV Credit ($)                     Annual production credit (negative value) for PV.
-   Electricity: Total ($)                         Annual total charges for electricity.
-   Natural Gas: Fixed ($)                         Annual fixed charges for natural gas.
-   Natural Gas: Marginal ($)                      Annual energy charges for natural gas.
-   Natural Gas: Total ($)                         Annual total charges for natural gas.
-   Fuel Oil: Total ($)                            Annual total charges for fuel oil.
-   Propane: Total ($)                             Annual total charges for propane.
-   Wood Cord: Total ($)                           Annual total charges for wood cord.
-   Wood Pellets: Total ($)                        Annual total charges for wood pellets.
-   Coal: Total ($)                                Annual total charges for coal.
+   <ScenarioName>: Total ($)                      Scenario annual total charges.
+   <ScenarioName>: Electricity: Fixed ($)         Scenario annual fixed charges for electricity.
+   <ScenarioName>: Electricity: Energy ($)        Scenario annual energy charges for electricity.
+   <ScenarioName>: Electricity: PV Credit ($)     Scenario annual production credit (negative value) for PV.
+   <ScenarioName>: Electricity: Total ($)         Scenario annual total charges for electricity.
+   <ScenarioName>: Natural Gas: Fixed ($)         Scenario annual fixed charges for natural gas.
+   <ScenarioName>: Natural Gas: Energy ($)        Scenario annual energy charges for natural gas.
+   <ScenarioName>: Natural Gas: Total ($)         Scenario annual total charges for natural gas.
+   <ScenarioName>: Fuel Oil: Fixed ($)            Scenario annual fixed charges for fuel oil.
+   <ScenarioName>: Fuel Oil: Energy ($)           Scenario annual energy charges for fuel oil.
+   <ScenarioName>: Fuel Oil: Total ($)            Scenario annual total charges for fuel oil.
+   <ScenarioName>: Propane: Fixed ($)             Scenario annual fixed charges for propane.
+   <ScenarioName>: Propane: Energy ($)            Scenario annual energy charges for propane.
+   <ScenarioName>: Propane: Total ($)             Scenario annual total charges for propane.
+   <ScenarioName>: Wood Cord: Fixed ($)           Scenario annual fixed charges for wood cord.
+   <ScenarioName>: Wood Cord: Energy ($)          Scenario annual energy charges for wood cord.
+   <ScenarioName>: Wood Cord: Total ($)           Scenario annual total charges for wood cord.
+   <ScenarioName>: Wood Pellets: Fixed ($)        Scenario annual fixed charges for wood pellets.
+   <ScenarioName>: Wood Pellets: Energy ($)       Scenario annual energy charges for wood pellets.
+   <ScenarioName>: Wood Pellets: Total ($)        Scenario annual total charges for wood pellets.
+   <ScenarioName>: Coal: Fixed ($)                Scenario annual fixed charges for coal.
+   <ScenarioName>: Coal: Energy ($)               Scenario annual energy charges for coal.
+   <ScenarioName>: Coal: Total ($)                Scenario annual total charges for coal.
    =============================================  ====================