Merge branch 'develop' into latest-os-hpxml

CHANGELOG.md

@@ -19,6 +19,7 @@ Fixes
 - Reorganize the emissions and utility rates data folders such that their sources and functions are more clear ([#1195](https://github.com/NREL/resstock/pull/1195))
 - Move location of out-of-unit (shared) water heaters to conditioned mechanical room ([#1201](https://github.com/NREL/resstock/pull/1201))
 - Update the Alaska residential stock characterization using the Alaska Retrofit Information System data ([#1214](https://github.com/NREL/resstock/pull/1214))
+- Enable HVAC airflor and capacity scaling factors to oversize or undersize the equipment. ([#1218](https://github.com/NREL/resstock/pull/1218))
 
 
 ## ResStock v3.2.0

docs/read_the_docs/source/workflow_inputs/characteristics.rst

@@ -3118,6 +3118,58 @@ Arguments
      -
      - Diffusivity of the ground soil. If provided, overrides the previous site and moisture type input.
 
+.. _hvac_cooling_autosizing_factor:
+
+HVAC Cooling Autosizing Factor
+------------------------------
+
+Description
+***********
+
+The cooling airflow and capacity scaling factor applied to the auto-sizing methodology (not used in project_national).
+
+Created by
+**********
+
+manually created
+
+Source
+******
+
+- \Engineering Judgment
+
+
+Assumption
+**********
+
+- \HVAC sizing follows ACCA Manual J and Manual S. There is no additional oversizing or undersizing the airflow and capacity of the HVAC system.
+
+
+Arguments
+*********
+
+.. list-table::
+   :header-rows: 1
+
+   * - Name
+     - Required
+     - Units
+     - Type
+     - Choices
+     - Description
+   * - ``cooling_system_cooling_autosizing_factor``
+     - false
+     - 
+     - Double
+     -
+     - The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+   * - ``heat_pump_cooling_autosizing_factor``
+     - false
+     - 
+     - Double
+     -
+     - The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
 .. _hvac_cooling_efficiency:
 
 HVAC Cooling Efficiency
@@ -3416,6 +3468,70 @@ Source
 - \n/a
 
 
+.. _hvac_heating_autosizing_factor:
+
+HVAC Heating Autosizing Factor
+------------------------------
+
+Description
+***********
+
+The heating airflow and capacity scaling factor applied to the auto-sizing methodology (not used in project_national).
+
+Created by
+**********
+
+manually created
+
+Source
+******
+
+- \Engineering Judgment
+
+
+Assumption
+**********
+
+- \HVAC sizing follows ACCA Manual J and Manual S. There is no additional oversizing or undersizing the airflow and capacity of the HVAC system.
+
+
+Arguments
+*********
+
+.. list-table::
+   :header-rows: 1
+
+   * - Name
+     - Required
+     - Units
+     - Type
+     - Choices
+     - Description
+   * - ``heating_system_heating_autosizing_factor``
+     - false
+     - 
+     - Double
+     -
+     - The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+   * - ``heat_pump_heating_autosizing_factor``
+     - false
+     - 
+     - Double
+     -
+     - The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+   * - ``heat_pump_backup_heating_autosizing_factor``
+     - false
+     - 
+     - Double
+     -
+     - The scaling factor applied to the auto-sizing methodology if Backup Type is 'integrated'. If not provided, 1.0 is used. If Backup Type is 'separate', use Heating System 2: Heating Autosizing Factor.
+   * - ``heating_system_2_heating_autosizing_factor``
+     - false
+     - 
+     - Double
+     -
+     - The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
 .. _hvac_heating_efficiency:
 
 HVAC Heating Efficiency
@@ -4246,6 +4362,27 @@ Source
 - \Assuming no faults until we have data necessary to characterize all types of ACs and heat pumps (https://github.com/NREL/resstock/issues/733).
 
 
+.. _hvac_system_is_scaled:
+
+HVAC System Is Scaled
+---------------------
+
+Description
+***********
+
+Whether the HVAC system has been undersized or oversized (not used in project_national).
+
+Created by
+**********
+
+manually created
+
+Source
+******
+
+- \Assuming no oversizing or undersizing until we have data necessary to characterize all types of systems.
+
+
 .. _hvac_system_single_speed_ac_airflow:
 
 HVAC System Single Speed AC Airflow

docs/read_the_docs/source/workflow_outputs/csv_tables/characteristics.csv

@@ -72,12 +72,14 @@ build_existing_model.holiday_lighting,:ref:`holiday_lighting`
 build_existing_model.hot_water_distribution,:ref:`hot_water_distribution`
 build_existing_model.hot_water_fixtures,:ref:`hot_water_fixtures`
 build_existing_model.household_has_tribal_persons,:ref:`household_has_tribal_persons`
+build_existing_model.hvac_cooling_autosizing_factor,:ref:`hvac_cooling_autosizing_factor`
 build_existing_model.hvac_cooling_efficiency,:ref:`hvac_cooling_efficiency`
 build_existing_model.hvac_cooling_partial_space_conditioning,:ref:`hvac_cooling_partial_space_conditioning`
 build_existing_model.hvac_cooling_type,:ref:`hvac_cooling_type`
 build_existing_model.hvac_has_ducts,:ref:`hvac_has_ducts`
 build_existing_model.hvac_has_shared_system,:ref:`hvac_has_shared_system`
 build_existing_model.hvac_has_zonal_electric_heating,:ref:`hvac_has_zonal_electric_heating`
+build_existing_model.hvac_heating_autosizing_factor,:ref:`hvac_heating_autosizing_factor`
 build_existing_model.hvac_heating_efficiency,:ref:`hvac_heating_efficiency`
 build_existing_model.hvac_heating_type,:ref:`hvac_heating_type`
 build_existing_model.hvac_heating_type_and_fuel,:ref:`hvac_heating_type_and_fuel`
@@ -87,6 +89,7 @@ build_existing_model.hvac_secondary_heating_partial_space_conditioning,:ref:`hva
 build_existing_model.hvac_secondary_heating_type,:ref:`hvac_secondary_heating_type`
 build_existing_model.hvac_shared_efficiencies,:ref:`hvac_shared_efficiencies`
 build_existing_model.hvac_system_is_faulted,:ref:`hvac_system_is_faulted`
+build_existing_model.hvac_system_is_scaled,:ref:`hvac_system_is_scaled`
 build_existing_model.hvac_system_single_speed_ac_airflow,:ref:`hvac_system_single_speed_ac_airflow`
 build_existing_model.hvac_system_single_speed_ac_charge,:ref:`hvac_system_single_speed_ac_charge`
 build_existing_model.hvac_system_single_speed_ashp_airflow,:ref:`hvac_system_single_speed_ashp_airflow`

measures/ResStockArguments/README.md

@@ -1530,6 +1530,17 @@ The output heating capacity of the heating system. If not provided, the OS-HPXML
 
 <br/>
 
+**Heating System: Heating Autosizing Factor**
+
+The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
+- **Name:** ``heating_system_heating_autosizing_factor``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Heating System: Fraction Heat Load Served**
 
 The heating load served by the heating system.
@@ -1626,6 +1637,17 @@ The output cooling capacity of the cooling system. If not provided, the OS-HPXML
 
 <br/>
 
+**Cooling System: Cooling Autosizing Factor**
+
+The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
+- **Name:** ``cooling_system_cooling_autosizing_factor``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Cooling System: Fraction Cool Load Served**
 
 The cooling load served by the cooling system.
@@ -1805,6 +1827,17 @@ The output heating capacity of the heat pump. If not provided, the OS-HPXML auto
 
 <br/>
 
+**Heat Pump: Heating Autosizing Factor**
+
+The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
+- **Name:** ``heat_pump_heating_autosizing_factor``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Heat Pump: Heating Capacity Retention Fraction**
 
 The output heating capacity of the heat pump at a user-specified temperature (e.g., 17F or 5F) divided by the above nominal heating capacity. Applies to all heat pump types except ground-to-air. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'>Air-to-Air Heat Pump</a>, <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'>Mini-Split Heat Pump</a>, <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'>Packaged Terminal Heat Pump</a>, <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'>Room Air Conditioner w/ Reverse Cycle</a>) is used.
@@ -1838,6 +1871,17 @@ The output cooling capacity of the heat pump. If not provided, the OS-HPXML auto
 
 <br/>
 
+**Heat Pump: Cooling Autosizing Factor**
+
+The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
+- **Name:** ``heat_pump_cooling_autosizing_factor``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Heat Pump: Fraction Heat Load Served**
 
 The heating load served by the heat pump.
@@ -1888,6 +1932,17 @@ The backup type of the heat pump. If 'integrated', represents e.g. built-in elec
 
 <br/>
 
+**Heat Pump: Backup Heating Autosizing Factor**
+
+The scaling factor applied to the auto-sizing methodology if Backup Type is 'integrated'. If not provided, 1.0 is used. If Backup Type is 'separate', use Heating System 2: Heating Autosizing Factor.
+
+- **Name:** ``heat_pump_backup_heating_autosizing_factor``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Heat Pump: Backup Fuel Type**
 
 The backup fuel type of the heat pump. Only applies if Backup Type is 'integrated'.
@@ -2277,6 +2332,17 @@ The output heating capacity of the second heating system. If not provided, the O
 
 <br/>
 
+**Heating System 2: Heating Autosizing Factor**
+
+The scaling factor applied to the auto-sizing methodology. If not provided, 1.0 is used.
+
+- **Name:** ``heating_system_2_heating_autosizing_factor``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Heating System 2: Fraction Heat Load Served**
 
 The heat load served fraction of the second heating system. Ignored if this heating system serves as a backup system for a heat pump.