openstudio-standards 0.3.0 → 0.3.1.rc1

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

@@ -7,7 +7,6 @@
       ],
       "table": [
         {
-          
           "cooling_type": "AirCooled",
           "subcategory": "Single Package",
           "minimum_capacity": 0.0,
@@ -15,8 +14,8 @@
           "start_date": "9/9/1919",
           "end_date": "2999-09-09T00:00:00+00:00",
           "minimum_heating_seasonal_performance_factor": null,
-          "minimum_coefficient_of_performance_heating": null,
-          "minimum_energy_efficiency_ratio": 8.9,
+          "minimum_coefficient_of_performance_heating": 3.1,
+          "minimum_energy_efficiency_ratio": null,
           "pthp_cop_coefficient_1": null,
           "pthp_cop_coefficient_2": null,
           "heat_cap_ft": "DXHEAT-NECB2011-REF-CAPFT",
@@ -27,7 +26,6 @@
           "notes": "From NECB 2011, Table 5.2.12.1"
         },
         {
-          
           "cooling_type": "AirCooled",
           "subcategory": "Split System",
           "minimum_capacity": 0.0,
@@ -35,8 +33,8 @@
           "start_date": "9/9/1919",
           "end_date": "2999-09-09T00:00:00+00:00",
           "minimum_heating_seasonal_performance_factor": null,
-          "minimum_coefficient_of_performance_heating": null,
-          "minimum_energy_efficiency_ratio": 8.9,
+          "minimum_coefficient_of_performance_heating": 3.1,
+          "minimum_energy_efficiency_ratio": null,
           "pthp_cop_coefficient_1": null,
           "pthp_cop_coefficient_2": null,
           "heat_cap_ft": "DXHEAT-NECB2011-REF-CAPFT",
@@ -47,7 +45,6 @@
           "notes": "From NECB 2011, Table 5.2.12.1"
         },
         {
-          
           "cooling_type": "AirCooled",
           "subcategory": "Single Package",
           "minimum_capacity": 65001.0,
@@ -55,8 +52,8 @@
           "start_date": "9/9/1919",
           "end_date": "2999-09-09T00:00:00+00:00",
           "minimum_heating_seasonal_performance_factor": null,
-          "minimum_coefficient_of_performance_heating": null,
-          "minimum_energy_efficiency_ratio": 9.5,
+          "minimum_coefficient_of_performance_heating": 3.3,
+          "minimum_energy_efficiency_ratio": null,
           "pthp_cop_coefficient_1": null,
           "pthp_cop_coefficient_2": null,
           "heat_cap_ft": "DXHEAT-NECB2011-REF-CAPFT",
@@ -67,7 +64,6 @@
           "notes": "From NECB 2011, Table 5.2.12.1"
         },
         {
-          
           "cooling_type": "AirCooled",
           "subcategory": "Split System",
           "minimum_capacity": 65001.0,
@@ -75,8 +71,8 @@
           "start_date": "9/9/1919",
           "end_date": "2999-09-09T00:00:00+00:00",
           "minimum_heating_seasonal_performance_factor": null,
-          "minimum_coefficient_of_performance_heating": null,
-          "minimum_energy_efficiency_ratio": 9.5,
+          "minimum_coefficient_of_performance_heating": 3.3,
+          "minimum_energy_efficiency_ratio": null,
           "pthp_cop_coefficient_1": null,
           "pthp_cop_coefficient_2": null,
           "heat_cap_ft": "DXHEAT-NECB2011-REF-CAPFT",
@@ -87,7 +83,6 @@
           "notes": "From NECB 2011, Table 5.2.12.1"
         },
         {
-          
           "cooling_type": "AirCooled",
           "subcategory": "Single Package",
           "minimum_capacity": 238841.0,
@@ -95,8 +90,8 @@
           "start_date": "9/9/1919",
           "end_date": "2999-09-09T00:00:00+00:00",
           "minimum_heating_seasonal_performance_factor": null,
-          "minimum_coefficient_of_performance_heating": null,
-          "minimum_energy_efficiency_ratio": 9.2,
+          "minimum_coefficient_of_performance_heating": 3.2,
+          "minimum_energy_efficiency_ratio": null,
           "pthp_cop_coefficient_1": null,
           "pthp_cop_coefficient_2": null,
           "heat_cap_ft": "DXHEAT-NECB2011-REF-CAPFT",
@@ -107,7 +102,6 @@
           "notes": "From NECB 2011, Table 5.2.12.1"
         },
         {
-          
           "cooling_type": "AirCooled",
           "subcategory": "Split System",
           "minimum_capacity": 238841.0,
@@ -115,8 +109,8 @@
           "start_date": "9/9/1919",
           "end_date": "2999-09-09T00:00:00+00:00",
           "minimum_heating_seasonal_performance_factor": null,
-          "minimum_coefficient_of_performance_heating": null,
-          "minimum_energy_efficiency_ratio": 9.2,
+          "minimum_coefficient_of_performance_heating": 3.2,
+          "minimum_energy_efficiency_ratio": null,
           "pthp_cop_coefficient_1": null,
           "pthp_cop_coefficient_2": null,
           "heat_cap_ft": "DXHEAT-NECB2011-REF-CAPFT",

data/lib/openstudio-standards/standards/necb/NECB2011/data/space_type_unit_definitions.txt

@@ -0,0 +1,76 @@
+          "building_type":
+          "space_type":
+          "rgb":
+          "lighting_standard":
+          "lighting_primary_space_type":
+          "lighting_secondary_space_type":
+          "lighting_per_area": W/ft^2
+          "lighting_per_person": W/person
+          "additional_lighting_per_area":
+          "lighting_fraction_to_return_air":
+          "lighting_fraction_radiant":
+          "lighting_fraction_visible":
+          "lighting_fraction_replaceable":
+          "lpd_fraction_linear_fluorescent":
+          "lpd_fraction_compact_fluorescent":
+          "lpd_fraction_high_bay":
+          "lpd_fraction_specialty_lighting":
+          "lpd_fraction_exit_lighting":
+          "lighting_schedule":
+          "compact_fluorescent_lighting_schedule":
+          "high_bay_lighting_schedule":
+          "specialty_lighting_schedule":
+          "exit_lighting_schedule":
+          "target_illuminance_setpoint":
+          "psa_nongeometry_fraction":
+          "ssa_nongeometry_fraction":
+          "ventilation_standard":
+          "ventilation_primary_space_type":
+          "ventilation_secondary_space_type":
+          "ventilation_per_area": cfm/ft^2
+          "ventilation_per_person": cfm/person
+          "ventilation_air_changes": air changes/hour
+          "minimum_total_air_changes":
+          "occupancy_per_area": people/ft^2
+          "occupancy_schedule":
+          "occupancy_activity_schedule":
+          "infiltration_per_exterior_area": cfm/ft^2
+          "infiltration_per_exterior_wall_area": cfm/ft^2
+          "infiltration_air_changes": air changes/hour
+          "infiltration_schedule":
+          "infiltration_schedule_perimeter":
+          "gas_equipment_per_area": Btu/(hr*ft^2)
+          "gas_equipment_fraction_latent":
+          "gas_equipment_fraction_radiant":
+          "gas_equipment_fraction_lost":
+          "gas_equipment_schedule":
+          "electric_equipment_per_area": W/ft^2
+          "electric_equipment_fraction_latent":
+          "electric_equipment_fraction_radiant":
+          "electric_equipment_fraction_lost":
+          "electric_equipment_schedule":
+          "additional_electric_equipment_schedule":
+          "additional_gas_equipment_schedule":
+          "heating_setpoint_schedule":
+          "cooling_setpoint_schedule":
+          "service_water_heating_peak_flow_rate": US Gal/hr
+          "service_water_heating_area": US Gal/(hr*ft^2)
+          "service_water_heating_peak_flow_per_area": US Gal/(hr*ft^2)
+          "service_water_heating_target_temperature": deg. C
+          "service_water_heating_fraction_sensible":
+          "service_water_heating_fraction_latent":
+          "service_water_heating_schedule":
+          "exhaust_per_area": N/A,
+          "exhaust_fan_efficiency": N/A
+          "exhaust_fan_power": N/A
+          "exhaust_fan_pressure_rise": N/A
+          "exhaust_fan_maximum_flow_rate": N/A
+          "exhaust_schedule":
+          "balanced_exhaust_fraction_schedule":
+          "is_residential":
+          "necb_hvac_system_selection_type":
+          "necb_schedule_type":
+          "notes":
+          "ventilation_occupancy_rate_people_per_1000ft2": people/1000 ft^2
+          "ventilation_occupancy_standard":
+          "ventilation_standard_space_type":

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

@@ -96,7 +96,12 @@ class NECB2011
 
       # TODO: other fuel-fired heating coil types? (not available in OpenStudio/E+ - may need to play with efficiency to mimic other fuel types)
 
-      air_to_air_heatpump = OpenStudio::Model::AirLoopHVACUnitaryHeatPumpAirToAirMultiSpeed.new(model, mau_fan, mau_htg_coil, mau_clg_coil, mau_supplemental_htg_coil)
+      # This method will seem like an error in number of args..but this is due to swig voodoo.
+      air_to_air_heatpump = OpenStudio::Model::AirLoopHVACUnitaryHeatPumpAirToAirMultiSpeed.new(model,
+                                                                                                mau_fan,
+                                                                                                mau_htg_coil,
+                                                                                                mau_clg_coil,
+                                                                                                mau_supplemental_htg_coil)
       air_to_air_heatpump.setName("#{zones[0].name} ASHP")
       air_to_air_heatpump.setMinimumOutdoorDryBulbTemperatureforCompressorOperation(system_data[:MinimumOutdoorDryBulbTemperatureforCompressorOperation])
       air_to_air_heatpump.setControllingZoneorThermostatLocation(zones[0])

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

@@ -1,5 +1,7 @@
 class NECB2011
   def add_sys1_unitary_ac_baseboard_heating(model:,
+                                            necb_reference_hp:false,
+                                            necb_reference_hp_supp_fuel:'DefaultFuel',
                                             zones:,
                                             mau_type:,
                                             mau_heating_coil_type:,
@@ -15,6 +17,8 @@ class NECB2011
                                                         hw_loop: hw_loop)
     else
       add_sys1_unitary_ac_baseboard_heating_single_speed(model: model,
+                                                         necb_reference_hp: necb_reference_hp,
+                                                         necb_reference_hp_supp_fuel: necb_reference_hp_supp_fuel,
                                                          zones: zones,
                                                          mau_type: mau_type,
                                                          mau_heating_coil_type: mau_heating_coil_type,
@@ -24,12 +28,13 @@ class NECB2011
   end
 
   def add_sys1_unitary_ac_baseboard_heating_single_speed(model:,
+                                                         necb_reference_hp:false,
+                                                         necb_reference_hp_supp_fuel:'DefaultFuel',
                                                          zones:,
                                                          mau_type:,
                                                          mau_heating_coil_type:,
                                                          baseboard_type:,
                                                          hw_loop:)
-
     # Keep all data and assumptions for both systems on the top here for easy reference.
     system_data = {}
     system_data[:name] = 'Sys_1_Make-up air unit'
@@ -49,7 +54,11 @@ class NECB2011
     system_data[:CentralHeatingDesignSupplyAirTemperature] = 43.0
     system_data[:AllOutdoorAirinCooling] = true
     system_data[:AllOutdoorAirinHeating] = true
-    system_data[:TypeofLoadtoSizeOn] = 'VentilationRequirement'
+    if necb_reference_hp
+      system_data[:TypeofLoadtoSizeOn] = 'Total'
+    else
+      system_data[:TypeofLoadtoSizeOn] = 'VentilationRequirement'
+    end
     system_data[:MinimumSystemAirFlowRatio] = 1.0
     # Zone Sizing data
     system_data[:system_supply_air_temperature] = 20.0
@@ -57,10 +66,12 @@ class NECB2011
     system_data[:ZoneCoolingDesignSupplyAirTemperatureDifference] = 11.0
     system_data[:ZoneCoolingDesignSupplyAirTemperatureInputMethod] = 'TemperatureDifference'
     system_data[:ZoneHeatingDesignSupplyAirTemperatureDifference] = 21.0
+    system_data[:ZoneDXCoolingSizingFactor] = 1.0
+    system_data[:ZoneDXHeatingSizingFactor] = 1.3
     system_data[:ZoneCoolingSizingFactor] = 1.1
     system_data[:ZoneHeatingSizingFactor] = 1.3
 
-    # System Type 1: PTAC with no heating (unitary AC)
+    # System Type 1: PTAC with no heating (unitary AC) 
     # Zone baseboards, electric or hot water depending on argument baseboard_type
     # baseboard_type choices are "Hot Water" or "Electric"
     # PSZ to represent make-up air unit (if present)
@@ -74,6 +85,9 @@ class NECB2011
     # mau_heating_coil_type choices are "Hot Water", "Electric"
     # boiler_fueltype choices match OS choices for Boiler component fuel type, i.e.
     # "NaturalGas","Electricity","PropaneGas","FuelOilNo1","FuelOilNo2","Coal","Diesel","Gasoline","OtherFuel1"
+    
+    # If reference_hp = true, NECB 8.4.4.13 Heat Pump System Type 1: CAV Packaged rooftop heat pump with 
+    # zone baseboard (electric or hot water depending on argument baseboard_type)
 
     # Some system parameters are set after system is set up; by applying method 'apply_hvac_efficiency_standard'
 
@@ -83,23 +97,34 @@ class NECB2011
     # Create MAU
     # TO DO: MAU sizing, characteristics (fan operation schedules, temperature setpoints, outdoor air, etc)
 
+
+
     if mau_type == true
       mau_air_loop = common_air_loop(model: model, system_data: system_data)
-      mau_fan = OpenStudio::Model::FanConstantVolume.new(model, always_on)
+
+      #if reference_hp
+        # AirLoopHVACUnitaryHeatPumpAirToAir needs FanOnOff in order for the fan to turn off during off hours
+      #  mau_fan = OpenStudio::Model::FanOnOff.new(model, always_on)        
+      #else
+        mau_fan = OpenStudio::Model::FanConstantVolume.new(model, always_on)
+      #end
       # MAU Heating type selection.
+      raise("Flag 'necb_reference_hp' is true while 'mau_heating_coil_type' is not set to type DX") if (necb_reference_hp && (mau_heating_coil_type != 'DX'))
       if mau_heating_coil_type == 'Electric' # electric coil
         mau_htg_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
-      end
-
-      if mau_heating_coil_type == 'Hot Water'
+      elsif  mau_heating_coil_type == 'Hot Water'
         mau_htg_coil = OpenStudio::Model::CoilHeatingWater.new(model, always_on)
         hw_loop.addDemandBranchForComponent(mau_htg_coil)
+      elsif mau_heating_coil_type == 'DX'
+        mau_htg_coil = add_onespeed_htg_DX_coil(model, always_on)
+        mau_htg_coil.setName('CoilHeatingDXSingleSpeed_ashp')
       end
 
       # Set up Single Speed DX coil with
       mau_clg_coil = add_onespeed_DX_coil(model, always_on)
       mau_clg_coil.setName('CoilCoolingDXSingleSpeed_dx')
-
+      mau_clg_coil.setName('CoilCoolingDXSingleSpeed_ashp') if necb_reference_hp
+      
       # Set up OA system
       oa_controller = OpenStudio::Model::ControllerOutdoorAir.new(model)
       oa_controller.autosizeMinimumOutdoorAirFlowRate
@@ -113,18 +138,46 @@ class NECB2011
       # Add the components to the air loop
       # in order from closest to zone to furthest from zone
       supply_inlet_node = mau_air_loop.supplyInletNode
-      mau_fan.addToNode(supply_inlet_node)
-      mau_htg_coil.addToNode(supply_inlet_node)
-      mau_clg_coil.addToNode(supply_inlet_node)
-      oa_system.addToNode(supply_inlet_node)
 
+      # Reference HP requires slight changes to default MAU heating
+      #if reference_hp
+        # Create supplemental heating coil based on default regional fuel type
+        #epw = BTAP::Environment::WeatherFile.new(model.weatherFile.get.path.get)
+        #primary_heating_fuel = @standards_data['regional_fuel_use'].detect { |fuel_sources| fuel_sources['state_province_regions'].include?(epw.state_province_region) }['fueltype_set']
+        #if primary_heating_fuel == 'NaturalGas'
+        #  supplemental_htg_coil = OpenStudio::Model::CoilHeatingGas.new(model, always_on)
+        #elsif primary_heating_fuel == 'Electricity' or  primary_heating_fuel == 'FuelOilNo2'
+        #  supplemental_htg_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
+        #else #hot water coils is an option in the future
+        #  raise('Invalid fuel type selected for heat pump supplemental coil')
+        #end
+        #air_to_air_heatpump = OpenStudio::Model::AirLoopHVACUnitaryHeatPumpAirToAir.new(model, always_on, mau_fan, mau_htg_coil, mau_clg_coil, supplemental_htg_coil)
+        #air_to_air_heatpump.setName("#{control_zone.name} ASHP")
+        #air_to_air_heatpump.setControllingZone(control_zone)
+        #air_to_air_heatpump.setSupplyAirFanOperatingModeSchedule(always_on)
+        #air_to_air_heatpump.addToNode(supply_inlet_node)
+      #else
+        mau_fan.addToNode(supply_inlet_node)
+        mau_htg_coil.addToNode(supply_inlet_node)
+        mau_clg_coil.addToNode(supply_inlet_node)
+        
+      #end
+      oa_system.addToNode(supply_inlet_node)
+      
       # Add a setpoint manager to control the supply air temperature
-      sat_sch = OpenStudio::Model::ScheduleRuleset.new(model)
-      sat_sch.setName('Makeup-Air Unit Supply Air Temp')
-      sat_sch.defaultDaySchedule.setName('Makeup Air Unit Supply Air Temp Default')
-      sat_sch.defaultDaySchedule.addValue(OpenStudio::Time.new(0, 24, 0, 0), system_data[:system_supply_air_temperature])
-      setpoint_mgr = OpenStudio::Model::SetpointManagerScheduled.new(model, sat_sch)
-      setpoint_mgr.addToNode(mau_air_loop.supplyOutletNode)
+      if necb_reference_hp
+        setpoint_mgr = OpenStudio::Model::SetpointManagerWarmest.new(model)
+        setpoint_mgr.setMinimumSetpointTemperature(13)
+        setpoint_mgr.setMaximumSetpointTemperature(20)
+        setpoint_mgr.addToNode(mau_air_loop.supplyOutletNode)
+      else
+        sat_sch = OpenStudio::Model::ScheduleRuleset.new(model)
+        sat_sch.setName('Makeup-Air Unit Supply Air Temp')
+        sat_sch.defaultDaySchedule.setName('Makeup Air Unit Supply Air Temp Default')
+        sat_sch.defaultDaySchedule.addValue(OpenStudio::Time.new(0, 24, 0, 0), system_data[:system_supply_air_temperature])
+        setpoint_mgr = OpenStudio::Model::SetpointManagerScheduled.new(model, sat_sch)
+        setpoint_mgr.addToNode(mau_air_loop.supplyOutletNode)
+      end
     end
 
     zones.each do |zone|
@@ -134,8 +187,14 @@ class NECB2011
       sizing_zone.setZoneCoolingDesignSupplyAirTemperatureDifference(system_data[:ZoneCoolingDesignSupplyAirTemperatureDifference])
       sizing_zone.setZoneHeatingDesignSupplyAirTemperatureInputMethod(system_data[:ZoneHeatingDesignSupplyAirTemperatureInputMethod])
       sizing_zone.setZoneHeatingDesignSupplyAirTemperatureDifference(system_data[:ZoneHeatingDesignSupplyAirTemperatureDifference])
-      sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneCoolingSizingFactor])
-      sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
+      # Different sizing factors for reference HP capacity
+      if necb_reference_hp
+        sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneDXCoolingSizingFactor])
+        sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneDXHeatingSizingFactor])
+      else
+        sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneCoolingSizingFactor])
+        sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
+      end
 
       # Create a PTAC for each zone:
       # PTAC DX Cooling with electric heating coil; electric heating coil is always off
@@ -150,7 +209,10 @@ class NECB2011
 
       # htg_coil_elec = OpenStudio::Model::CoilHeatingElectric.new(model,always_on)
       zero_outdoor_air = true # flag to set outside air flow to 0.0
-      add_ptac_dx_cooling(model, zone, zero_outdoor_air)
+      # Reference HP system does not use PTAC
+      unless necb_reference_hp
+        add_ptac_dx_cooling(model, zone, zero_outdoor_air)
+      end
 
       # add zone baseboards
       add_zone_baseboards(baseboard_type: baseboard_type,
@@ -159,7 +221,23 @@ class NECB2011
                           zone: zone)
 
       #  # Create a diffuser and attach the zone/diffuser pair to the MAU air loop, if applicable
-      if mau_type == true
+      
+      if necb_reference_hp 
+        # Create CAV RH (RH based on region's default fuel type or user input)
+        if necb_reference_hp_supp_fuel == 'DefaultFuel'
+          epw = BTAP::Environment::WeatherFile.new(model.weatherFile.get.path.get)
+          necb_reference_hp_supp_fuel = @standards_data['regional_fuel_use'].detect { |fuel_sources| fuel_sources['state_province_regions'].include?(epw.state_province_region) }['fueltype_set']
+        end
+        if necb_reference_hp_supp_fuel == 'NaturalGas'
+          rh_coil = OpenStudio::Model::CoilHeatingGas.new(model, always_on)
+        elsif necb_reference_hp_supp_fuel == 'Electricity' or  necb_reference_hp_supp_fuel == 'FuelOilNo2'
+          rh_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
+        else #hot water coils is an option in the future
+          raise('Invalid fuel type selected for heat pump supplemental coil')
+        end
+        cav_rh_terminal = OpenStudio::Model::AirTerminalSingleDuctConstantVolumeReheat.new(model, always_on, rh_coil)
+        mau_air_loop.addBranchForZone(zone, cav_rh_terminal.to_StraightComponent)
+      elsif mau_type == true
         diffuser = OpenStudio::Model::AirTerminalSingleDuctUncontrolled.new(model, always_on)
         mau_air_loop.addBranchForZone(zone, diffuser.to_StraightComponent)
         # components for MAU
@@ -170,14 +248,23 @@ class NECB2011
       sys_name_pars = {}
       sys_name_pars['sys_hr'] = 'none'
       sys_name_pars['sys_clg'] = 'dx'
+      sys_name_pars['sys_clg'] = 'ashp' if necb_reference_hp
       sys_name_pars['sys_htg'] = mau_heating_coil_type
+      sys_name_pars['sys_htg'] = 'ashp' if necb_reference_hp
       sys_name_pars['sys_sf'] = 'cv'
       sys_name_pars['zone_htg'] = baseboard_type
-      sys_name_pars['zone_clg'] = 'ptac'
+      sys_oa = 'doas'
+      if necb_reference_hp
+        sys_name_pars['zone_clg'] = 'none'
+        sys_oa = 'mixed'
+      else
+        sys_name_pars['zone_clg'] = 'ptac'
+        sys_oa = 'doas'
+      end
       sys_name_pars['sys_rf'] = 'none'
       assign_base_sys_name(mau_air_loop,
                            sys_abbr: 'sys_1',
-                           sys_oa: 'doas',
+                           sys_oa: sys_oa,
                            sys_name_pars: sys_name_pars)
     end
 

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

@@ -150,6 +150,7 @@ class NECB2011
       chw_loop.addDemandBranchForComponent(fc_clg_coil)
 
       # add connections to FPFC.
+      # This method will seem like an error in number of args..but this is due to swig voodoo.
       zone_fc = OpenStudio::Model::ZoneHVACFourPipeFanCoil.new(model, always_on, fc_fan, fc_clg_coil, fc_htg_coil)
       zone_fc.addToThermalZone(zone)
 

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
@@ -150,12 +150,14 @@ class NECB2011
     supply_inlet_node = air_loop.supplyInletNode
 
     if (heating_coil_type == 'Gas') || (heating_coil_type == 'Electric')
+      # This method will seem like an error in number of args..but this is due to swig voodoo.
       air_to_air_heatpump = OpenStudio::Model::AirLoopHVACUnitaryHeatPumpAirToAirMultiSpeed.new(model, fan, htg_coil, clg_coil, supplemental_htg_coil)
       air_to_air_heatpump.setControllingZoneorThermostatLocation(control_zone)
       air_to_air_heatpump.setNumberofSpeedsforHeating(1)
       air_to_air_heatpump.setNumberofSpeedsforCooling(2)
       air_to_air_heatpump.setMinimumOutdoorDryBulbTemperatureforCompressorOperation(system_data[:MinimumOutdoorDryBulbTemperatureforCompressorOperation])
     elsif heating_coil_type == 'DX'
+      # This method will seem like an error in number of args..but this is due to swig voodoo.
       air_to_air_heatpump = OpenStudio::Model::AirLoopHVACUnitaryHeatPumpAirToAir.new(model, always_on, fan, htg_coil, clg_coil, supplemental_htg_coil)
       air_to_air_heatpump.setControllingZone(zone)
     end

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

@@ -1,5 +1,7 @@
 class NECB2011
   def add_sys3and8_single_zone_packaged_rooftop_unit_with_baseboard_heating(model:,
+                                                                            necb_reference_hp:false,
+                                                                            necb_reference_hp_supp_fuel:'DefaultFuel',
                                                                             zones:,
                                                                             heating_coil_type:,
                                                                             baseboard_type:,
@@ -15,17 +17,22 @@ class NECB2011
                                                                                         new_auto_zoner: new_auto_zoner)
     else
       add_sys3and8_single_zone_packaged_rooftop_unit_with_baseboard_heating_single_speed(model: model,
+                                                                                         necb_reference_hp: necb_reference_hp,
+                                                                                         necb_reference_hp_supp_fuel: necb_reference_hp_supp_fuel,
                                                                                          zones: zones,
                                                                                          heating_coil_type: heating_coil_type,
                                                                                          baseboard_type: baseboard_type,
                                                                                          hw_loop: hw_loop,
                                                                                          new_auto_zoner: new_auto_zoner)
+
     end
   end
 
   # Some tests still require a simple way to set up a system without sizing.. so we are keeping the auto_zoner flag for this  method.
   #
   def add_sys3and8_single_zone_packaged_rooftop_unit_with_baseboard_heating_single_speed(model:,
+                                                                                         necb_reference_hp:false,
+                                                                                         necb_reference_hp_supp_fuel:'DefaultFuel',
                                                                                          zones:,
                                                                                          heating_coil_type:,
                                                                                          baseboard_type:,
@@ -65,7 +72,6 @@ class NECB2011
     system_data[:ZoneCoolingSizingFactor] = 1.1
     system_data[:ZoneHeatingSizingFactor] = 1.3
     system_data[:MinimumOutdoorDryBulbTemperatureforCompressorOperation] = -10.0
-
     if new_auto_zoner == true
       # Create system airloop
 
@@ -73,7 +79,9 @@ class NECB2011
       air_loop = add_system_3_and_8_airloop(heating_coil_type,
                                             model,
                                             system_data,
-                                            determine_control_zone(zones))
+                                            determine_control_zone(zones),
+                                            necb_reference_hp: necb_reference_hp,
+                                            necb_reference_hp_supp_fuel: necb_reference_hp_supp_fuel)
       # Add Zone equipment
       zones.each do |zone| # Zone sizing temperature difference
         sizing_zone = zone.sizingZone
@@ -81,17 +89,23 @@ class NECB2011
         sizing_zone.setZoneCoolingDesignSupplyAirTemperatureDifference(system_data[:ZoneCoolingDesignSupplyAirTemperatureDifference])
         sizing_zone.setZoneHeatingDesignSupplyAirTemperatureInputMethod(system_data[:ZoneHeatingDesignSupplyAirTemperatureInputMethod])
         sizing_zone.setZoneHeatingDesignSupplyAirTemperatureDifference(system_data[:ZoneHeatingDesignSupplyAirTemperatureDifference])
-        sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneCoolingSizingFactor])
-        sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
+        if necb_reference_hp
+          sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneDXCoolingSizingFactor])
+          sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneDXHeatingSizingFactor])
+        else
+          sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneCoolingSizingFactor])
+          sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
+        end
         add_sys3_and_8_zone_equip(air_loop,
                                   baseboard_type,
                                   hw_loop,
                                   model,
                                   zone)
+
       end
     else
       zones.each do |zone|
-        air_loop = add_system_3_and_8_airloop(heating_coil_type, model, system_data, zone)
+        air_loop = add_system_3_and_8_airloop(heating_coil_type, model, system_data, zone, necb_reference_hp: necb_reference_hp, necb_reference_hp_supp_fuel: necb_reference_hp_supp_fuel)
         add_sys3_and_8_zone_equip(air_loop,
                                   baseboard_type,
                                   hw_loop,
@@ -102,7 +116,9 @@ class NECB2011
     sys_name_pars = {}
     sys_name_pars['sys_hr'] = 'none'
     sys_name_pars['sys_clg'] = 'dx'
+    sys_name_pars['sys_clg'] = 'ashp' if necb_reference_hp
     sys_name_pars['sys_htg'] = heating_coil_type
+    sys_name_pars['sys_htg'] = 'ashp' if necb_reference_hp
     sys_name_pars['sys_sf'] = 'cv'
     sys_name_pars['zone_htg'] = baseboard_type
     sys_name_pars['zone_clg'] = 'none'
@@ -114,7 +130,7 @@ class NECB2011
     return true
   end
 
-  def add_system_3_and_8_airloop(heating_coil_type, model, system_data, control_zone)
+  def add_system_3_and_8_airloop(heating_coil_type, model, system_data, control_zone, necb_reference_hp:false, necb_reference_hp_supp_fuel:'DefaultFuel')
     # System Type 3: PSZ-AC
     # This measure creates:
     # -a constant volume packaged single-zone A/C unit
@@ -136,20 +152,40 @@ class NECB2011
     sizing_zone.setZoneCoolingDesignSupplyAirTemperatureDifference(system_data[:ZoneCoolingDesignSupplyAirTemperatureDifference])
     sizing_zone.setZoneHeatingDesignSupplyAirTemperatureInputMethod(system_data[:ZoneHeatingDesignSupplyAirTemperatureInputMethod])
     sizing_zone.setZoneHeatingDesignSupplyAirTemperatureDifference(system_data[:ZoneHeatingDesignSupplyAirTemperatureDifference])
-    sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneCoolingSizingFactor])
-    sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
+    if necb_reference_hp
+      sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneDXCoolingSizingFactor])
+      sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneDXHeatingSizingFactor])
+    else
+      sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneCoolingSizingFactor])
+      sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneHeatingSizingFactor])
+    end
 
-    fan = OpenStudio::Model::FanConstantVolume.new(model, always_on)
+    if necb_reference_hp
+      #AirLoopHVACUnitaryHeatPumpAirToAir needs FanOnOff in order for the fan to turn off during off hours
+      fan = OpenStudio::Model::FanOnOff.new(model, always_on)
+    else      
+      fan = OpenStudio::Model::FanConstantVolume.new(model, always_on)
+    end
 
+    # Set up DX coil 
+    if necb_reference_hp #NECB curve characteristics
+      clg_coil = add_onespeed_DX_coil(model, always_on)
+      clg_coil.setName('CoilCoolingDXSingleSpeed_ashp')
+    else
+      clg_coil = OpenStudio::Model::CoilCoolingDXSingleSpeed.new(model) #sets default OS curve (but will be replaced with NECB curves later)
+      clg_coil.setName('CoilCoolingDXSingleSpeed_dx')
+    end
+
+    raise("Flag 'necb_reference_hp' is set to true while parameter 'heating_coil_type' is not set to DX") if (necb_reference_hp && (heating_coil_type != 'DX'))
     case heating_coil_type
     when 'Electric' # electric coil
       htg_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
     when 'Gas'
       htg_coil = OpenStudio::Model::CoilHeatingGas.new(model, always_on)
     when 'DX'
-      htg_coil = OpenStudio::Model::CoilHeatingDXSingleSpeed.new(model)
-      supplemental_htg_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
-      htg_coil.setMinimumOutdoorDryBulbTemperatureforCompressorOperation(system_data[:MinimumOutdoorDryBulbTemperatureforCompressorOperation])
+      #create main DX heating coil
+      htg_coil = add_onespeed_htg_DX_coil(model, always_on)
+      htg_coil.setName('CoilHeatingDXSingleSpeed_ashp')
       sizing_zone.setZoneHeatingSizingFactor(system_data[:ZoneDXHeatingSizingFactor])
       sizing_zone.setZoneCoolingSizingFactor(system_data[:ZoneDXCoolingSizingFactor])
     else
@@ -158,9 +194,7 @@ class NECB2011
 
     # TO DO: other fuel-fired heating coil types? (not available in OpenStudio/E+ - may need to play with efficiency to mimic other fuel types)
 
-    # Set up DX coil with NECB performance curve characteristics;
-    clg_coil = OpenStudio::Model::CoilCoolingDXSingleSpeed.new(model)
-    clg_coil.setName('CoilCoolingDXSingleSpeed_dx')
+
 
     # oa_controller
     oa_controller = OpenStudio::Model::ControllerOutdoorAir.new(model)
@@ -176,7 +210,21 @@ class NECB2011
     # Add the components to the air loop
     # in order from closest to zone to furthest from zone
     supply_inlet_node = air_loop.supplyInletNode
-    if heating_coil_type == 'DX'
+    if necb_reference_hp
+
+      #create supplemental heating coil based on default regional fuel type
+      if necb_reference_hp_supp_fuel == 'DefaultFuel'
+        epw = BTAP::Environment::WeatherFile.new(model.weatherFile.get.path.get)
+        necb_reference_hp_supp_fuel = @standards_data['regional_fuel_use'].detect { |fuel_sources| fuel_sources['state_province_regions'].include?(epw.state_province_region) }['fueltype_set']
+      end
+      if necb_reference_hp_supp_fuel == 'NaturalGas'
+        supplemental_htg_coil = OpenStudio::Model::CoilHeatingGas.new(model, always_on)
+      elsif necb_reference_hp_supp_fuel == 'Electricity' or  necb_reference_hp_supp_fuel == 'FuelOilNo2'
+        supplemental_htg_coil = OpenStudio::Model::CoilHeatingElectric.new(model, always_on)
+      else #hot water coils is an option in the future
+        raise('Invalid fuel type selected for heat pump supplemental coil')
+      end
+      # This method will seem like an error in number of args..but this is due to swig voodoo.
       air_to_air_heatpump = OpenStudio::Model::AirLoopHVACUnitaryHeatPumpAirToAir.new(model, always_on, fan, htg_coil, clg_coil, supplemental_htg_coil)
       air_to_air_heatpump.setName("#{control_zone.name} ASHP")
       air_to_air_heatpump.setControllingZone(control_zone)