openstudio-standards 0.2.16 → 0.2.17.rc1

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/set_num_boilers_chillers_towers.md

@@ -0,0 +1,49 @@
+Set number and types of boilers, chillers, and towers in baseline.
+
+# ASHRAE 90.1-2019
+
+G3.1.3.7 Type and Number of Chillers (Systems 7, 8, 11, 12, and 13)
+Electric chillers shall be used in the baseline building design regardless of the cooling
+energy source, e.g. direct-fired absorption or absorption from purchased steam. The
+baseline building design’s chiller plant shall be modeled with chillers having the number
+and type as indicated in Table G3.1.3.7 as a function of building peak cooling load.
+Exception to G3.1.3.7
+Systems using purchased chilled water shall be modeled in accordance with Section G3.1.1.3.
+
+Table G3.1.3.7 Type and Number of Chillers
+
+Building Peak Cooling Load Number and Type of Chillers  
+<=300 tons: 1 water-cooled screw chiller  
+\>300 tons, <600 tons: 2 water-cooled screw chillers sized equally  
+\>=600 tons: 2 water-cooled centrifugal chillers minimum with chillers added so that no chiller is larger than 800 tons, all sized equally
+
+G3.1.3.2 Type and Number of Boilers (Systems 1, 5, 7, 11, and 12)
+The boiler plant shall be natural draft, except as noted in Section G3.1.1.1. The baseline
+building design boiler plant shall be modeled as having a single boiler if the baseline
+building design plant serves a conditioned floor area of 15,000 ft2 or less, and as having
+two equally sized boilers for plants serving more than 15,000 ft2. Boilers shall be
+staged as required by the load.
+
+G3.1.3.11 Heat Rejection (Systems 7, 8, 11, 12, and 13)
+The heat-rejection device shall be an axial-fan open-circuit cooling tower with variablespeed
+fan control and shall have an efficiency of 38.2 gpm/hp at the conditions specified
+in Table 6.8.1-7.
+
+
+# Key Ruby Methods
+
+## plant_loop_apply_prm_number_of_boilers(plant_loop)
+
+Set boiler type and number of boilers based on floor area served by the boiler plant loop.
+Set staging to sequential.
+
+## plant_loop_apply_prm_number_of_chillers(plant_loop, sizing_run_dir)
+
+Set chiller type and number of chillers based on total cooling capacity
+Set staging to sequential.
+
+## plant_loop_apply_prm_number_of_cooling_towers(plant_loop)
+
+An alternate version of this method is located in ashrae_90_1_prm.PlantLoop.rb.
+This version keeps a single cooling tower, but adds a headered pump bank with one pump per chiller.
+

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/set_plug_load_measures.md

@@ -0,0 +1,80 @@
+Handle plug-load credits
+
+# ASHRAE 90.1-2019
+- G3.1 (12) Proposed: Receptacle and *process loads*, such as those for office and other equipment, shall be estimated based on the building area type or space type category and shall be assumed to be identical in the *proposed design* and *baseline building design*, except as specifically approved by the *rating authority* only when quantifying performance that exceeds the requirements of Standard 90.1 but not when the *Performance Rating Method* is used as an alternative path for minimum standard compliance in accordance with Section 4.2.1.1
+- G3.1 (12) Proposed: When receptacle controls installed in *spaces* where not required by Section 8.4.2 are included in the *proposed building design*, the hourly receptacle shall be reduced as follows:
+
+  ![RPC= RC * 10%](https://latex.codecogs.com/svg.latex?RPC=&space;RC&space;*&space;10%)
+    
+    where:
+    - *RPC* = receptacle power credit 
+    - *EPS<sub>pro</sub>* = EPS<sub>bas</sub> x (1-RPC)
+    - *RC* = percentage of all controlled receptacles
+    - *EPS<sub>bas</sub>* = baseline equipment power hourly schedule (fraction)
+    - *EPS<sub>pro</sub>* = proposed equipment power hourly schedule (fraction)
+- G3.1 (12) Baseline: Motors shall be modeled as having the *efficiency* ratings found in Table G3.9.1 Other systems covered by Section 10 and miscellaneous loads shall be modeled as identical to those in the *proposed design*, including schedules of operation and *control of the equipment*.
+
+# Code Requirement Interpretation
+For each space in the proposed building indicate which receptacle control strategies from the control list are included and the percentage of receptacles that are controlled.
+
+When receptacle controls are installed in spaces not required by 90.1-2019 Section 8.4.2, credit for receptacle controls in the proposed design can be taken by decreasing the receptacle schedule in the proposed building design according to the following:
+
+![RPC= RC * 10%](https://latex.codecogs.com/svg.latex?RPC=&space;RC&space;*&space;10%)
+
+# Implementation Methodology
+- **Step 1:** Check the required room types in Section 8.4.2, if matched, then skip the plug-load credits.
+The matching rule is based on closest space functions as described in Section 8.4.2. The Table below shows the mapping. It subjects to changes.
+
+| Rooms                                                     | Space type category 1                  | Space type category 2                          |
+|-----------------------------------------------------------|----------------------------------------|------------------------------------------------|
+| Private Offices                                           | office - enclosed <= 250 sf            |                                                |
+ | Conference Rooms                                          | conference/meeting/multipurpose        |                                                |
+| Room used primarily for printing and/or copying functions | copy/print                             |                                                |
+| Break rooms                                               | lounge/breakroom - all other           | lounge/breakroom - healthcare facility         |
+| Classrooms                                                | classroom/lecture/training - all other | classroom/lecture/training - preschool to 12th |
+| Individual workstation                                    | office - open                          |                                                |
+
+- **Step 2:** Check *userdata_electric_equipment* to verify user data
+  - **Step 2.1:** Check *userdata_electric_equipment* to identify if the the electric equipment is a motor / refrigeration / elevator.
+    - **Step 2.1.1:** If motor, retrieve data and save in the electric equipment object.
+    - **Step 2.1.2:** If refrigeration or elevator, skip the processing.
+  - **Step 2.2:** Else if *fraction_of_controlled_receptacle* (RC) data is available. If yes, get the user data (RC) and calculate the RPC
+  - **Step 2.3:** Else: check *receptacle_power_savings* (RPC) data is available. If yes, get the user data (RPC) and apply the credit.
+- **Step 3:** If apply credit, apply the credit at every hour of the existing electric equipment schedule with the equation:
+  - ![hr_{new} = {hr_{ex}}/{1.0-RPC}](https://latex.codecogs.com/svg.image?hr_{new}&space;=&space;{hr_{ex}}&space;/&space;(1.0-RPC))
+  - hr<sub>new</sub>: the adjusted hourly value
+  - hr<sub>ex</sub>: the original hourly value
+- **Step 4:** Repeat the similar process for *userdata_gas_equipment* user data.
+
+## Key Ruby Methods
+The above logic is implemented in the `space_type_apply_internal_loads` in the ashrae_90_1_prm.SpaceType class.
+Sub-logics are implemented in the `update_power_equipment_credits` function, which is called by `space_type_apply_internal_loads`
+
+## Test Case Documentation
+### Test case 1:
+- Prototype: Small Office
+- User data folder: */userdata_pe_01*
+- Summary:
+This case will test whether *fraction_of_controlled_receptacles* is read correctly for an electric equipment (*Office WholeBuilding - Sm Office Elec Equip*).
+Expected output: the baseline schedule is 5% higher than proposed schedule for the electric equipment: *Office WholeBuilding - Sm Office Elec Equip*.
+
+### Test case 2:
+- Prototype: Small Office
+- User data folder: */userdata_pe_02*
+- Summary:
+This case will test whether *receptacle_power_savings*  is read correctly for an electric equipment (*Office WholeBuilding - Sm Office Elec Equip*).
+Expected output: the baseline schedule is 15% higher than proposed schedule for the electric equipment: *Office WholeBuilding - Sm Office Elec Equip*.
+
+### Test case 3
+- Prototype: Small Office
+- User data folder: */userdata_pe_03*
+- Summary:
+This case will test whether *motor_horsepower*, *motor_efficiency* and *motor_is_exempt* are read correctly for an electric equipment (*Office WholeBuilding - Sm Office Elec Equip*).
+Expected output: the electric equipment in the baseline shall have three additional properties *motor_horsepower = 10.0*, *motor_efficiency = 0.72* and *motor_is_exempt = No* 
+
+
+### Test case 4
+- Prototype: Small Office
+- User data folder: */userdata_pe_04*
+- Summary:
+This case added space and space type to the user data. For equipment **Office WholeBuilding - Sm Office Elec Equip 4**, the receptacle credit was set to 0.05 however, it is then adjusted to 0.025 because one of the space type (conference/meeting/multipurpose) is on the exception list.

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/set_space_lpd.md

@@ -0,0 +1,73 @@
+Set lighting power density for each space by standard space category.
+
+# ASHRAE 90.1-2019
+- G3.1 (6) Baseline: Interior lighting power in the baseline building design shall be determined using the values in Table G3.7
+- G3.1 (6) Baseline: Lighting shall be modeled by having the automatic shutoff controls in buildings > 5000 ft2 (2500 m2) and occupancy sensors in employee lunch break rooms, conference/meeting rooms, and classrooms (not including shop classrooms, laboratory classrooms, and preschool through 12th-grade classrooms). These controls shall be reflected in the baseline building design lighting schedules. No additional automatic lighting controls, e.g., automatic controls for daylight utilization and occupancy sensors in space types not listed above, shall be modeled in the baseline building design.
+
+# Code Requirement Interpretation
+The requirement aim to determine the interior lighting power density according to the Table G3.7.
+For spaces mixed multiple space types, weighted LPD is calculated and the occupancy sensor reduction is weighted by the lighting power density of the space.
+
+# Implementation Methodology
+The method of assigning interior lighting power density for a single-type space is straightforward. However, when the space is a mixed-type, the lighting power density and occupancy sensor reduction are calculated in the example below.
+
+Example:
+
+| Space               | num_std_ltg_types | std_ltg_type01            | std_ltg_type_frac01 | std_ltg_type02        | std_ltg_type_frac02 |
+|---------------------|-------------------|---------------------------|---------------------|-----------------------|---------------------|
+| Perimeter_ZN_2      | 2                 | retail - whole building   | 0.8                 | retail dressing room  | 0.2                 |
+
+Where:
+
+| Space Type                | lighting per area (W/ft2) | occupancy sensor reduction |
+|---------------------------|---------------------------|----------------------------|
+| retail - whole building   | 1.5                       | 0.1                        |
+| retail dressing room      | 0.89                      | 0.1                        |
+
+The lighting power density of Perimeter_ZN_2 shall be determined as:
+
+**Weighted LPD** = 1.5 W/ft2 * 0.8 + 0.89 W/ft2 * 0.2 = 1.2 W/ft2 + 0.178 W/ft2 = 1.378 W/ft2
+
+**Weighted occupancy sensor reduction** = (0.1 * 1.2 W/ft2 + 0.1 * 0.178 W/ft2) / 1.378 W/ft2 = 0.1
+
+## Key Ruby Methods
+The function `space_type_apply_internal_loads` is used to calculate the LPDs and occupancy sensor reduction for each `Space` or `Space Type`. The logic is implemented by overriding this method in the `ashrae_90_1_prm_2019.SpaceType` class.
+
+## Test Case Documentation
+
+### Test case 1:
+- Prototype: Small Office
+- User data folder: */userdata_lpd_01*
+- Summary:
+
+| Space            | num_std_ltg_types | std_ltg_type01           | std_ltg_type_frac01 | std_ltg_type02          | std_ltg_type_frac02 | std_ltg_type03       | std_ltg_type_frac03 | Target_LPD (W/m2) |
+|------------------|-------------------|--------------------------|---------------------|-------------------------|---------------------|----------------------|---------------------|-------------------|
+| `Perimeter_ZN_2` | 2                 | retail - whole building  | 0.8                 | retail dressing room    | 0.2                 |                      |                     | 14.83267494       |      
+| `Perimeter_ZN_1` | 3                 | retail mall concourse    | 0.2                 | retail - whole building | 0.6                 | retail dressing room | 0.2                 | 15.26323154       |
+| `Perimeter_ZN_4` | 1                 | kitchen                  | 1.0                 |                         |                     |                      |                     | 12.91669806       |
+| `Perimeter_ZN_3` | 1                 | office                   | 1.0                 |                         |                     |                      |                     | 10.7639           |
+| `Perimeter_ZN_5` | 1                 | office                   | 1.0                 |                         |                     |                      |                     | 10.7639           |
+| `Attic`          | 2                 | warehouse - bulk storage | 0.5                 | workshop                | 0.5                 |                      |                     | 15.06948107       |
+
+
+### Test case 2:
+- Prototype: Small Office
+- User data folder: */userdata_lpd_02*
+- Summary:
+
+| Space Type                         | num_std_ltg_types | std_ltg_type01          | std_ltg_type_frac01 | std_ltg_type02 | std_ltg_type_frac02 | Target_LPD (W/m2) |
+|------------------------------------|-------------------|-------------------------|---------------------|----------------|---------------------|-------------------|
+| `Office WholeBuilding - Sm Office` | 2                 | atrium <= 40 ft height  | 0.5                 | workshop       | 0.5                 | 12.2452724        |
+
+The `Office WholeBuilding - Sm Office` is the space type used by `Perimeter_ZN_1` through `Perimeter_ZN_5`.
+
+- Note: In this test case, we also expect `Attic` to have `0 W/m2` LPD.
+
+
+### Test case 2:
+- Prototype: Small Office
+- User data folder: *N/A*
+- Summary:
+
+`Office` is used as the standard space type for all spaces except `Attic`. Therefore, in this test case, we are expecting LPD to be 10.7639 for spaces `Perimeter_ZN_1` through `Perimeter_ZN_5` except `Attic`.
+

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/unenclosed_and_unconditioned_spaces.md

@@ -0,0 +1,11 @@
+Unenclosed and Unconditioned Spaces
+
+# ASHRAE 90.1-2019 PRM Reference Manual
+Space types such as ventilated parking garage, attics, and crawlspaces are defined by Standard 90.1-2019 as unenclosed spaces, and for the purposes of envelope requirements, envelope components adjacent to them are treated as exterior surfaces.
+
+# Implementation
+# Key Ruby Methods
+## Existing
+* `model_apply_standard_constructions`: this method applies the standard construction to each surface in the model, based on the construction type currently assigned; code was added to handle surfaces adjacent to another space: if the space is conditioned, then the surface should be handled just like an exterior surface and be assigned the baseline constructions
+## New
+* `model_apply_constructions`: generic method used to call the PRM and non-PRM specific `model_apply_standard_constructions()` method 

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/unmet_load_hours.md

@@ -0,0 +1,20 @@
+Unmet Load Hours (UMLH)
+
+# ASHRAE 90.1-2019
+Unmet load hours for the proposed design or baseline building design shall not exceed 300 (of the 8760 hours simulated). Alternatively, unmet load hours exceeding these limits shall be permitted to be accepted upon approval of the rating authority, provided that sufficient justification is given indicating that the accuracy of the simulation is not significantly compromised by these unmet loads. 
+
+# ASHRAE 90.1-2019 PRM Reference Manual
+If the automatic oversizing percentage is not sufficient to meet demands, then UMLH are evaluated at the building level by looking at the UMLH for each thermal zone being modeled. The first step would be to determine if the UMLH are high (>300) for the proposed building design as well as the baseline building. If that is the case, the issue is usually related to fan operation, HVAC availability, and occupancy schedules where the HVAC system has an incorrectly specified schedule that makes it unavailable during occupied hours. Optimal start controls, if a part of the building design, can also help eliminate UMLH during startup times. Since the same schedules are used for the baseline design, UMLH are seen in the baseline building as well. Other user inputs that could cause UMLH include incorrectly specified zone minimum airflows, which could result in unmet heating load hours. In this case, the software should notify the user and ask the user to verify schedules of operation. If a space is being conditioned via transfer air, it might be that the temperature of the transfer air is not sufficient to meet space conditioning requirements. 
+* If this is not the case and UMLH are seen only with the baseline design, the user or software tool is required to incrementally increase system airflows and equipment capacities, following the steps outlined below.
+  * In the case where UMLH for cooling are a bigger problem, the equipment in the baseline building model is resized by first increasing the design airflow of all zones with significant UMLH (greater than 150 for an individual zone) by 10%, increasing the design airflow of all zones with some UMLH (between 50 and 150) by 5%. Then, the equipment capacity for the system(s) serving the affected zones is increased to handle the increased zone loads. For the central plant, the chiller(s) and towers are resized proportionally to handle the increased system loads.
+  * In the case where UMLH for heating are a bigger problem, the same procedure is followed, with zone airflows resized first, then heating secondary equipment capacity and then boiler capacity as necessary. The capacity of the boiler or furnace shall be increased in proportion to capacities of coils required to meet the increased airflows at the baseline supply air. For heat pumps, the capacity of the coil is increased so that the additional load is not met by auxiliary heat.
+
+# Implementation
+The user model unmet load hours are checked as the first step of the baseline generation process. If the number is greater than 300, an error is published and the process is stopped. This requires the user to address the UMLH in the user/proposed model prior to generating the baseline model(s) which can be take some time.
+
+At the end of the process, each baseline model's UMLH are checked. if the number is greater than 300, the process go through each zone and adjust the zone sizing factor by either increasing it by 5% or 10% for zones having respectively UMLH between 50 and 150 and greater than 150. Then, the model is re-ran and the check/adjustments are performed again until the number of UMLH is below 300. 
+
+# Key Ruby Methods 
+## New
+* `model_get_unmet_load_hours`: get the total unmet load hours during occupancy of a model that has been simulated
+* `thermal_zone_get_unmet_load_hours`: determine the number of unmet load hours during occupancy for a thermal zone

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/vav_parallel_piu_terminals_fan_control.md

@@ -0,0 +1,23 @@
+Fan power and control for systems 6 and 8
+
+# ASHRAE 90.1-2019
+G3.1.3.14
+Fans in parallel VAV fan-powered boxes shall run as the first stage of heating before the reheat coil is energized. Fans in parallel VAV fan-powered boxes shall be sized for 50% of the peak design primary air (from the VAV air-handling unit) flow rate and shall be modeled with 0.35 W/cfm fan power. Minimum volume set points for fan-powered boxes shall be equal to 30% of peak design primary airflow rate or the rate required to meet the minimum outdoor air ventilation requirement, whichever is larger. The supply air temperature set point shall be constant at the design condition.
+# PRM-RM
+* Fan Control: With parallel style fan-powered VAV boxes, the constant volume terminal unit fan is only on when the primary airflow is at design minimum and the zone temperature is less than 2°F above the heating setpoint schedule. When the system is scheduled to operate and the zone terminal fan is running, the box mixes plenum air with primary air. 
+* Heating Operation: During heating mode, the terminal unit discharge air temperature is increased from minimum to the design heating temperature. Throughout occupied heating the cooling, primary airflow is kept at design minimum and the terminal unit fan is running.
+* Deadband Operation: The cooling primary airflow is kept at minimum airflow and the heating valve is closed. The terminal unit fan will energize as the first stage of heating when the zone temperature drops to 2F. above heating setpoint. 
+* Cooling Operation: As the space temperature increases, the cooling supply airflow is increased from minimum to design cooling maximum. Throughout cooling the box fan is off. To comply with Standard 90.1-2019 Section 6.5.2.1, Exception (1), the minimum primary airflow for this control logic must be no larger than 30% of the zone design cooling airflow or the minimum airflow for ventilation.
+* Night Cycle Heating Control: A call for heating during night cycle control shall be met by running the terminal fan and increasing the terminal unit discharge air temperature from minimum to the design heating temperature without the use of primary air.
+# Code Requirement Intepretation
+The PRM-RM provides a good interpretation of the code requirement. It does miss to describe night cycle cooling operation. We believe that during these periods, the terminal fan should be off and that the central system fan should turn on to allows the central system to meet the load (as the terminals don't have any cooling coils).
+# Implementation
+Night cycle operation: will be implemented in `air_loop_hvac_enable_unoccupied_fan_shutoff` and the `CycleOnAnyCoolingOrHeatingZone` control type will be used to achieve the desired strategy. Note that we've identified a temporary issue with that control type in OpenStudio (see [here](https://github.com/NREL/OpenStudio/issues/4566)).
+
+Cooling and heating operation: the terminal fan should be off when the primary airflow fraction is greater than the minimum primary air flow. In EnergyPlus, this is dictated by the "Fan On Flow Fraction". The Fan On Flow Fraction will be set to 0.0 to allow operating of the secondary fan only when reheat is needed and when the primary air flow is at the minimum.
+# Key Ruby Methods
+## Exisiting
+* `air_loop_hvac_enable_unoccupied_fan_shutoff`: Shut off the system during unoccupied periods and handle night cycling operation.
+## New
+* `air_loop_hvac_has_parallel_piu_air_terminals?`: Determine if the air loop serves parallel PIU air terminals.
+* `air_terminal_single_duct_parallel_piu_reheat_fan_on_flow_fraction`: Return the fan on flow fraction for a parallel PIU terminal

data/lib/openstudio-standards/standards/ashrae_90_1_prm/docs/vav_terminals_min_flow_setpoint.md

@@ -0,0 +1,21 @@
+Minimum flow set points for VAV and fan powered terminals
+
+# ASHRAE 90.1-2019
+G3.1.3.13
+Minimum volume set points for VAV reheat boxes shall be 30% of zone peak airflow, the minimum outdoor airflow rate, or the airflow rate required to comply with applicable codes or accreditation standards, whichever is larger.
+
+G3.1.3.14
+Minimum volume set points for fan-powered boxes shall be equal to 30% of peak design primary airflow rate or the rate required to meet the minimum outdoor air ventilation requirement, whichever is larger.
+# Code Requirement Interpretation
+These requirements aim to determine the minimum damper position of standard VAV and parallel PIU air terminals. The position is based on either the minimum outdoor air requirement or 30% of the peak zone/primary airflow.
+# Implementation
+For each terminal, the zone outdoor airflow is calculated and the minimum damper position is determined by taking the largest of the 0.3 or the zone outdoor airflow divided by the maximum terminal airflow (or primary airflow for parallel PIU terminals). The determination is initiated in `air_loop_hvac_apply_minimum_vav_damper_positions` and the calculation and assignment is done in `air_terminal_single_duct_vav_reheat_apply_minimum_damper_position` and `air_terminal_single_duct_parallel_piu_reheat_apply_minimum_primary_airflow_fraction`.
+# Key Ruby Methods
+## Existing
+* `air_loop_hvac_apply_minimum_vav_damper_positions`: Set the minimum VAV damper positions.
+* `air_terminal_single_duct_vav_reheat_apply_minimum_damper_position`: Set the minimum damper position based on OA rate of the space and the template.
+* `air_terminal_single_duct_vav_reheat_minimum_damper_position`: Specifies the minimum damper position for VAV dampers.
+* `air_terminal_single_duct_parallel_piu_reheat_apply_prm_baseline_fan_power`: Sets the fan power of a PIU fan based on the W/cfm specified in the standard.
+## New
+* `air_terminal_single_duct_parallel_reheat_piu_minimum_primary_airflow_fraction`: Specifies the minimum primary air flow fraction for PFB boxes.
+* `air_terminal_single_duct_parallel_piu_reheat_apply_minimum_primary_airflow_fraction`: Set the minimum primary air flow fraction based on OA rate of the space and the template.

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_airloop_hvac.csv

@@ -0,0 +1 @@
+name,has_fan_power_credit_fully_ducted,has_fan_power_credit_return_or_exhaust_flow_control,fan_power_credit_exhaust_treatment,has_fan_power_credit_filtration_m9to12,has_fan_power_credit_filtration_m13to15,clean_filter_pressure_drop_for_fan_power_credit_filtration_m16plus,fan_power_credit_gas_phase_cleaners,fan_power_credit_biosafety,fan_power_credit_other_than_coil_runaround,has_fan_power_credit_coil_runaround,fan_power_credit_evaporative_humidifier_or_cooler,has_fan_power_credit_sound_attenuation,has_fan_power_credit_exhaust_serving_fume_hoods,has_fan_power_credit_lab_or_vivarium_highrise_vertical_duct,economizer_exception_for_gas_phase_air_cleaning,economizer_exception_for_open_refrigerated_cases,exhaust_energy_recovery_exception_for_toxic_fumes_etc,exhaust_energy_recovery_exception_for_type1_kitchen_hoods,exhaust_energy_recovery_exception_for_type_distributed_exhaust,exhaust_energy_recovery_exception_for_dehumidifcation_with_series_cooling_recovery,dcv_exception_airloop

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_airloop_hvac_doas.csv

@@ -0,0 +1 @@
+name,has_fan_power_credit_fully_ducted,has_fan_power_credit_return_or_exhaust_flow_control,fan_power_credit_exhaust_treatment,has_fan_power_credit_filtration_m9to12,has_fan_power_credit_filtration_m13to15,clean_filter_pressure_drop_for_fan_power_credit_filtration_m16plus,fan_power_credit_gas_phase_cleaners,fan_power_credit_biosafety,fan_power_credit_other_than_coil_runaround,has_fan_power_credit_coil_runaround,fan_power_credit_evaporative_humidifier_or_cooler,has_fan_power_credit_sound_attenuation,has_fan_power_credit_exhaust_serving_fume_hoods,has_fan_power_credit_lab_or_vivarium_highrise_vertical_duct

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_building.csv

@@ -0,0 +1 @@
+name,building_type_for_hvac,building_type_for_swh,building_type_for_wwr,is_exempt_from_rotations

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_design_specification_outdoor_air.csv

@@ -0,0 +1 @@
+name,outdoor_airflow_per_person,outdoor_airflow_per_floor_area,outdoor_air_flowrate,outdoor_air_flow_air_changes_per_hour

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_electric_equipment.csv

@@ -0,0 +1 @@
+name,fraction_of_controlled_receptacles,receptacle_power_savings,motor_horsepower,motor_efficiency,motor_is_exempt,elevator_weight_of_car,elevator_rated_load,elevator_counter_weight_of_car,elevator_speed_of_car,elevator_number_of_stories,elevator_number_of_lifts,elevator_area_ft2,elevator_ventilation_cfm,refrigeration_equipment_class,refrigeration_equipment_volume,refrigeration_equipment_total_display_area,,

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_exterior_lights.csv

@@ -0,0 +1 @@
+name,num_ext_lights_subcats,end_use_subcategory_01,end_use_measurement_value_01,end_use_subcategory_02,end_use_measurement_value_02,end_use_subcategory_03,end_use_measurement_value_03,end_use_subcategory_04,end_use_measurement_value_04,end_use_subcategory_05,end_use_measurement_value_05,end_use_subcategory_06,end_use_measurement_value_06,end_use_subcategory_07,end_use_measurement_value_07,end_use_subcategory_08,end_use_measurement_value_08,end_use_subcategory_09

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_gas_equipment.csv

@@ -0,0 +1 @@
+name,fraction_of_controlled_receptacles,receptacle_power_savings

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_lights.csv

@@ -0,0 +1 @@
+name,has_retail_display_exception,has_unregulated_exception,unregulated_category

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_space.csv

@@ -0,0 +1 @@
+name,building_type_for_wwr,num_std_ltg_types,std_ltg_type01,std_ltg_type_frac01,std_ltg_type02,std_ltg_type_frac02,std_ltg_type03,std_ltg_type_frac03,std_ltg_type04,std_ltg_type_frac04,std_ltg_type05,std_ltg_type_frac05,std_ltg_type06,std_ltg_type_frac06,std_ltg_type07,std_ltg_type_frac07,std_ltg_type08,std_ltg_type_frac08,std_ltg_type09,std_ltg_type_frac09,std_ltg_type10,std_ltg_type_frac10,std_ltg_type11,std_ltg_type_frac11,std_ltg_type12,std_ltg_type_frac12,std_ltg_type13,std_ltg_type_frac13,std_ltg_type14,std_ltg_type_frac14,std_ltg_type15,std_ltg_type_frac15,std_ltg_type16,std_ltg_type_frac16,std_ltg_type17,std_ltg_type_frac17,std_ltg_type18,std_ltg_type_frac18,std_ltg_type19,std_ltg_type_frac19,std_ltg_type20,std_ltg_type_frac20

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_spacetype.csv

@@ -0,0 +1 @@
+name,num_std_ltg_types,std_ltg_type01,std_ltg_type_frac01,std_ltg_type02,std_ltg_type_frac02,std_ltg_type03,std_ltg_type_frac03,std_ltg_type04,std_ltg_type_frac04,std_ltg_type05,std_ltg_type_frac05,std_ltg_type06,std_ltg_type_frac06,std_ltg_type07,std_ltg_type_frac07,std_ltg_type08,std_ltg_type_frac08,std_ltg_type09,std_ltg_type_frac09,std_ltg_type10,std_ltg_type_frac10,std_ltg_type11,std_ltg_type_frac11,std_ltg_type12,std_ltg_type_frac12,std_ltg_type13,std_ltg_type_frac13,std_ltg_type14,std_ltg_type_frac14,std_ltg_type15,std_ltg_type_frac15,std_ltg_type16,std_ltg_type_frac16,std_ltg_type17,std_ltg_type_frac17,std_ltg_type18,std_ltg_type_frac18,std_ltg_type19,std_ltg_type_frac19,std_ltg_type20,std_ltg_type_frac20

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_thermal_zone.csv

@@ -0,0 +1 @@
+name,building_type_for_hvac,number_of_systems, dcv_exception_thermal_zone,has_health_safety_night_cycle_exception

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_wateruse_connections.csv

@@ -0,0 +1 @@
+name,hot_water_supply_temperature_schedule,cold_water_supply_temperature_schedule

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_wateruse_equipment.csv

@@ -0,0 +1 @@
+name,bulding_type_swh

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_wateruse_equipment_definition.csv

@@ -0,0 +1 @@
+name,peak_flow_rate,flow_rate_fraction_schedule,target_temperature_schedule

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_zone_hvac.csv

@@ -0,0 +1 @@
+name,zone_hvac_object_type_name,has_fan_power_credit_fully_ducted,has_fan_power_credit_return_or_exhaust_flow_control,fan_power_credit_exhaust_treatment,has_fan_power_credit_filtration_m9to12,has_fan_power_credit_filtration_m13to15,clean_filter_pressure_drop_for_fan_power_credit_filtration_m16plus,fan_power_credit_gas_phase_cleaners,fan_power_credit_biosafety,fan_power_credit_other_than_coil_runaround,has_fan_power_credit_coil_runaround,fan_power_credit_evaporative_humidifier_or_cooler,has_fan_power_credit_sound_attenuation,has_fan_power_credit_exhaust_serving_fume_hoods,has_fan_power_credit_lab_or_vivarium_highrise_vertical_duct,exhaust_energy_recovery_exception_for_toxic_fumes_etc,exhaust_energy_recovery_exception_for_type1_kitchen_hoods,exhaust_energy_recovery_exception_for_type_distributed_exhaust,exhaust_energy_recovery_exception_for_dehumidifcation_with_series_cooling_recovery

data/lib/openstudio-standards/standards/ashrae_90_1_prm/userdata_csv/userdata_zone_infiltration.csv

@@ -0,0 +1 @@
+name,is_controlled

data/lib/openstudio-standards/standards/cbes/data/cbes.fans.json

@@ -264,6 +264,18 @@
       "fan_curve": "Multi zone VAV with static pressure reset",
       "notes": null
     },
+    {
+      "name": "PSZ_VAV_System_Fan",
+      "type": "VariableVolume",
+      "pressure_rise": 2.5,
+      "fan_efficiency": 0.54,
+      "motor_efficiency": 0.9,
+      "motor_in_airstream_fraction": 1.0,
+      "fan_power_minimum_flow_rate_fraction": 0.25,
+      "fan_power_minimum_flow_rate_input_method": "Fraction",
+      "fan_curve": "Multi zone VAV with static pressure reset",
+      "notes": null
+    },
     {
       "name": "VAV_default",
       "type": "VariableVolume",

data/lib/openstudio-standards/standards/deer/data/deer.fans.json

@@ -264,6 +264,18 @@
       "fan_curve": "Multi zone VAV with static pressure reset",
       "notes": null
     },
+    {
+      "name": "PSZ_VAV_System_Fan",
+      "type": "VariableVolume",
+      "pressure_rise": 2.5,
+      "fan_efficiency": 0.54,
+      "motor_efficiency": 0.9,
+      "motor_in_airstream_fraction": 1.0,
+      "fan_power_minimum_flow_rate_fraction": 0.25,
+      "fan_power_minimum_flow_rate_input_method": "Fraction",
+      "fan_curve": "Multi zone VAV with static pressure reset",
+      "notes": null
+    },
     {
       "name": "VAV_default",
       "type": "VariableVolume",

data/lib/openstudio-standards/standards/necb/ECMS/data/heat_pumps.json

@@ -846,7 +846,7 @@
         {
           "name": "NECB2015_ASHP",
           "minimum_capacity": 238840.0,
-          "maximum_capacity": 9999999.0,
+          "maximum_capacity": 9999999999.0,
           "minimum_seasonal_efficiency": null,
           "minimum_full_load_efficiency": 9.5,
           "minimum_iplv": null,

data/lib/openstudio-standards/standards/necb/ECMS/data/heat_pumps_heating.json

@@ -816,7 +816,7 @@
         {
           "name": "NECB2015_ASHP",
           "minimum_capacity": 238840.0,
-          "maximum_capacity": 9999999.0,
+          "maximum_capacity": 9999999999.0,
           "minimum_heating_seasonal_performance_factor": null,
           "minimum_coefficient_of_performance_heating": null,
           "minimum_energy_efficiency_ratio": 9.2,

data/lib/openstudio-standards/standards/necb/ECMS/data/unitary_acs.json

@@ -8,20 +8,20 @@
         {
           "name": "Carrier WeatherExpert",
           "minimum_capacity": 0.0,
-          "maximum_capacity": 19044.8,
-          "minimum_energy_efficiency_ratio": null,
-          "minimum_seasonal_energy_efficiency_ratio": 17.3,
+          "maximum_capacity": 17418.7,
+          "minimum_energy_efficiency_ratio": 12.9,
+          "minimum_seasonal_energy_efficiency_ratio": null,
           "cool_cap_ft": null,
           "cool_cap_fflow": null,
           "cool_eir_ft": null,
           "cool_eir_fflow": null,
           "cool_plf_fplr": null,
-          "notes": "Carrier WeatherExpert 3-5 Nominal Tons average"
+          "notes": "Carrier WeatherExpert 3-5 Nominal Tons units average EIR (capacities in Watts)"
         },
         {
           "name": "Carrier WeatherExpert",
-          "minimum_capacity": 19044.8,
-          "maximum_capacity": 77960.0,
+          "minimum_capacity": 17418.7,
+          "maximum_capacity": 34601.5,
           "minimum_energy_efficiency_ratio": 13.1,
           "minimum_seasonal_energy_efficiency_ratio": null,
           "cool_cap_ft": null,
@@ -29,22 +29,35 @@
           "cool_eir_ft": null,
           "cool_eir_fflow": null,
           "cool_plf_fplr": null,
-          "notes": "Carrier WeatherExpert 6-10 Nominal Tons average"
+          "notes": "Carrier WeatherExpert 6-10 Nominal Tons units average EIR (Capacities in Watts)"
+        },
+        {
+          "name": "Carrier WeatherExpert",
+          "minimum_capacity": 34601.5,
+          "maximum_capacity": 68904.8,
+          "minimum_energy_efficiency_ratio": 12.2,
+          "minimum_seasonal_energy_efficiency_ratio": null,
+          "cool_cap_ft": null,
+          "cool_cap_fflow": null,
+          "cool_eir_ft": null,
+          "cool_eir_fflow": null,
+          "cool_plf_fplr": null,
+          "notes": "Carrier WeatherExpert 12.5-20 Tons units average (Capacities in Watts)"
         },
         {
           "name": "Carrier WeatherExpert",
-          "minimum_capacity": 77960.0,
+          "minimum_capacity": 68904.8,
           "maximum_capacity": 9999999.0,
-          "minimum_energy_efficiency_ratio": 12.0,
+          "minimum_energy_efficiency_ratio": 11.1,
           "minimum_seasonal_energy_efficiency_ratio": null,
           "cool_cap_ft": null,
           "cool_cap_fflow": null,
           "cool_eir_ft": null,
           "cool_eir_fflow": null,
           "cool_plf_fplr": null,
-          "notes": "Carrier WeatherExpert 12.5-23 Tons average"
+          "notes": "Carrier WeatherExpert 23 Ton unit (Capacities in Watts)"
         }
       ]
     }
   }
-}
+}

data/lib/openstudio-standards/standards/necb/ECMS/erv.rb

@@ -1,6 +1,7 @@
 class ECMS
-  # This method will add a skeleton erv to all air loops if requested.
-  def apply_erv_ecm(model:, erv_package: nil)
+  # This method will set the properties of the ERV. Must be run after the standard efficiency is complete as this will overwrite
+  # those values. See data/erv.json to view/add different erv packages available.
+  def apply_erv_ecm_efficiency(model:, erv_package: nil)
     # If erv is nil.. do nothing.
     return if erv_package.nil? || erv_package == 'none' || erv_package == 'NECB_Default'
 
@@ -13,20 +14,17 @@ class ECMS
       raise("ERV package name #{erv_package} does not exist. must be #{valid} /n Stopping.")
     end
 
-    # remove all existing ERVs
-    model.getHeatExchangerAirToAirSensibleAndLatents.each(&:remove) if erv_info['application'] == 'Add_ERVs_To_All_Airloops'
-    # add ervs
-    # Adds default erv to all air_loops. This will be changed in the set efficiency methods.
-    model.getAirLoopHVACs.each { |air_loop| air_loop_hvac_apply_energy_recovery_ventilator(air_loop, nil) } if erv_info['application'] == 'Add_ERVs_To_All_Airloops'
-  end
-
-  # This method will set the properties of the ERV that was added above. Must be run after the standard efficiency is complete as this will overwrite
-  # those values. See data/erv.json to view/add different erv packages.
-  def apply_erv_ecm_efficiency(model:, erv_package: nil)
-    # If erv is nil.. do nothing.
-    return if erv_package.nil? || erv_package == 'none' || erv_package == 'NECB_Default'
+    # add ervs if required
+    model.getAirLoopHVACs.sort.each do |air_loop|
+      if air_loop.airLoopHVACOutdoorAirSystem.is_initialized
+        erv = air_loop.airLoopHVACOutdoorAirSystem.get.components.select{|comp| comp.to_HeatExchangerAirToAirSensibleAndLatent.is_initialized}
+        if (erv.empty? && (erv_info['application'] == 'Add_ERVs_To_All_Airloops'))
+          air_loop_hvac_apply_energy_recovery_ventilator(air_loop, nil)
+        end
+      end
+    end
 
-    # This calls the NECB2011 implementation of the method.
+    # Apply ecm effectiveness values
     model.getHeatExchangerAirToAirSensibleAndLatents.each { |erv| heat_exchanger_air_to_air_sensible_and_latent_apply_effectiveness(erv, erv_package) }
   end
 end

data/lib/openstudio-standards/standards/necb/NECB2011/data/province_map.json

@@ -0,0 +1,17 @@
+{
+  "province_map": {
+    "QC": "Quebec",
+    "NL": "Newfoundland and Labrador",
+    "NS": "Nova Scotia",
+    "PE": "Prince Edward Island",
+    "ON": "Ontario",
+    "MB": "Manitoba",
+    "SK": "Saskatchewan",
+    "AB": "Alberta",
+    "BC": "British Columbia",
+    "YT": "Yukon",
+    "NT": "Northwest Territories",
+    "NB": "New Brunswick",
+    "NU": "Nunavut"
+  }
+}

data/lib/openstudio-standards/standards/necb/NECB2011/hvac_system_3_and_8_multi_speed.rb

@@ -67,12 +67,12 @@ class NECB2011
       return true
     else
       zones.each do |zone|
-        air_loop = add_system_3_and_8_airloop_multi_speed(heating_coil_type, model, system_data, zone)
         add_sys3_and_8_zone_equip(air_loop,
                                   baseboard_type,
                                   hw_loop,
                                   model,
                                   zone)
+        air_loop = add_system_3_and_8_airloop_multi_speed(heating_coil_type, model, system_data, zone)
       end
       return true
     end

data/lib/openstudio-standards/standards/necb/NECB2011/hvac_system_3_and_8_single_speed.rb

@@ -204,8 +204,8 @@ class NECB2011
                                 hw_loop, model,
                                 zone)
     always_on = model.alwaysOnDiscreteSchedule
+    add_zone_baseboards(baseboard_type: baseboard_type, hw_loop: hw_loop, model: model, zone: zone)
     diffuser = OpenStudio::Model::AirTerminalSingleDuctUncontrolled.new(model, always_on)
     air_loop.addBranchForZone(zone, diffuser.to_StraightComponent)
-    add_zone_baseboards(baseboard_type: baseboard_type, hw_loop: hw_loop, model: model, zone: zone)
   end
 end

data/lib/openstudio-standards/standards/necb/NECB2011/hvac_system_4.rb

@@ -143,12 +143,12 @@ class NECB2011
       sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
       # Create a diffuser and attach the zone/diffuser pair to the air loop
       # diffuser = OpenStudio::Model::AirTerminalSingleDuctUncontrolled.new(model,always_on)
-      diffuser = OpenStudio::Model::AirTerminalSingleDuctUncontrolled.new(model, always_on)
-      air_loop.addBranchForZone(zone, diffuser.to_StraightComponent)
       add_zone_baseboards(baseboard_type: baseboard_type,
                           hw_loop: hw_loop,
                           model: model,
                           zone: zone)
+      diffuser = OpenStudio::Model::AirTerminalSingleDuctUncontrolled.new(model, always_on)
+      air_loop.addBranchForZone(zone, diffuser.to_StraightComponent)
       # zone loop
     end
     sys_name_pars = {}

data/lib/openstudio-standards/standards/necb/NECB2011/hvac_system_6.rb

@@ -126,6 +126,12 @@ class NECB2011
             reheat_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
           end
 
+          # Set zone baseboards
+          add_zone_baseboards(model: model,
+                              zone: zone,
+                              baseboard_type: baseboard_type,
+                              hw_loop: hw_loop)
+
           vav_terminal = OpenStudio::Model::AirTerminalSingleDuctVAVReheat.new(model, always_on, reheat_coil)
           air_loop.addBranchForZone(zone, vav_terminal.to_StraightComponent)
           # NECB2011 minimum zone airflow setting
@@ -133,11 +139,6 @@ class NECB2011
           vav_terminal.setMaximumReheatAirTemperature(system_data[:ZoneVAVMaxReheatTemp])
           vav_terminal.setDamperHeatingAction(system_data[:ZoneVAVDamperAction])
 
-          # Set zone baseboards
-          add_zone_baseboards(model: model,
-                              zone: zone,
-                              baseboard_type: baseboard_type,
-                              hw_loop: hw_loop)
         end
         sys_name_pars = {}
         sys_name_pars['sys_hr'] = 'none'