openstudio-standards 0.7.1 → 0.8.0.rc2

data/lib/openstudio-standards/create_typical/space_type_ratios.rb

@@ -285,20 +285,19 @@ module OpenstudioStandards
         hash['Toilet'] = { ratio: 0.0193, space_type_gen: true, default: false }
         hash['Undeveloped'] = { ratio: 0.0835, space_type_gen: false, default: false }
         hash['Xray'] = { ratio: 0.0220, space_type_gen: true, default: false }
-      when 'SuperMarket'
-        # @todo populate ratios for SuperMarket
-        hash['Bakery'] = { ratio: 0.99, space_type_gen: true, default: false }
-        hash['Deli'] = { ratio: 0.99, space_type_gen: true, default: false }
-        hash['DryStorage'] = { ratio: 0.99, space_type_gen: true, default: false }
-        hash['Office'] = { ratio: 0.99, space_type_gen: true, default: false }
-        hash['Produce'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Sales'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Corridor'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Dining'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Elec/MechRoom'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Meeting'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Restroom'] = { ratio: 0.99, space_type_gen: true, default: true }
-        hash['Vestibule'] = { ratio: 0.99, space_type_gen: true, default: true }
+      when 'SuperMarket', 'GroceryStore'
+        hash['Bakery'] = { ratio: 0.05, space_type_gen: true, default: false }
+        hash['Deli'] = { ratio: 0.0537, space_type_gen: true, default: false }
+        hash['DryStorage'] = { ratio: 0.1010, space_type_gen: true, default: false }
+        hash['Office'] = { ratio: 0.0067, space_type_gen: true, default: false }
+        hash['Produce'] = { ratio: 0.1701, space_type_gen: true, default: true }
+        hash['Sales'] = { ratio: 0.5495, space_type_gen: true, default: true }
+        hash['Corridor'] = { ratio: 0.0118, space_type_gen: true, default: true }
+        hash['Dining'] = { ratio: 0.0111, space_type_gen: true, default: true }
+        hash['Elec/MechRoom'] = { ratio: 0.0133, space_type_gen: true, default: true }
+        hash['Meeting'] = { ratio: 0.0111, space_type_gen: true, default: true }
+        hash['Restroom'] = { ratio: 0.0150, space_type_gen: true, default: true }
+        hash['Vestibule'] = { ratio: 0.0067, space_type_gen: true, default: true }
       when 'Laboratory'
         hash['Office'] = { ratio: 0.50, space_type_gen: true, default: true }
         hash['Open lab'] = { ratio: 0.35, space_type_gen: true, default: true }
@@ -384,11 +383,9 @@ module OpenstudioStandards
         hash['FacMaint'] = { ratio: 0.08, space_type_gen: true, default: false }
         hash['DormitoryRoom'] = { ratio: 0.1699, space_type_gen: true, default: false }
       when 'Gro'
-        hash['GrocSales'] = { ratio: 0.8002, space_type_gen: true, default: true }
-        hash['RefWalkInCool'] = { ratio: 0.0312, space_type_gen: true, default: false }
-        hash['OfficeGeneral'] = { ratio: 0.07, space_type_gen: true, default: false }
-        hash['RefFoodPrep'] = { ratio: 0.0253, space_type_gen: true, default: false }
-        hash['RefWalkInFreeze'] = { ratio: 0.0162, space_type_gen: true, default: false }
+        hash['GrocSales'] = { ratio: 0.800, space_type_gen: true, default: true }
+        hash['OfficeGeneral'] = { ratio: 0.070, space_type_gen: true, default: false }
+        hash['RefFoodPrep'] = { ratio: 0.073, space_type_gen: true, default: false }
         hash['IndLoadDock'] = { ratio: 0.057, space_type_gen: true, default: false }
       when 'Hsp'
         hash['HspSurgOutptLab'] = { ratio: 0.2317, space_type_gen: true, default: false }
@@ -462,9 +459,13 @@ module OpenstudioStandards
         hash['RetailSales'] = { ratio: 0.8, space_type_gen: true, default: true }
         hash['StockRoom'] = { ratio: 0.2, space_type_gen: true, default: false }
       when 'SCn'
-        hash['WarehouseCond'] = { ratio: 1.0, space_type_gen: true, default: true }
+        hash['WarehouseCond'] = { ratio: 0.951, space_type_gen: true, default: true }
+        hash['OfficeGeneral'] = { ratio: 0.049, space_type_gen: true, default: false }
+
       when 'SUn'
-        hash['WarehouseUnCond'] = { ratio: 1.0, space_type_gen: true, default: true }
+        hash['WarehouseUnCond'] = { ratio: 0.951, space_type_gen: true, default: true }
+        hash['OfficeGeneral'] = { ratio: 0.049, space_type_gen: true, default: false }
+
       when 'WRf'
         hash['IndLoadDock'] = { ratio: 0.08, space_type_gen: true, default: false }
         hash['OfficeGeneral'] = { ratio: 0.02, space_type_gen: true, default: false }

data/lib/openstudio-standards/exterior_lighting/create.rb

@@ -0,0 +1,454 @@
+module OpenstudioStandards
+  # The Exterior Lighting module provides methods create, modify, and get information about model exterior lighting
+  module ExteriorLighting
+    # @!group Create
+
+    # create an ExtertiorLights object from inputs
+    #
+    # @param model [OpenStudio::Model::Model] OpenStudio model object
+    # @param name [String] the name of the exterior lights
+    # @param power [Double] the watts value, can be watts or watts per area or length
+    # @param units [String] units for the power, either 'W', 'W/ft' or 'W/ft^2'
+    # @param multiplier [Double] the multiplier for the lighting, representing ft or ft^2
+    # @param schedule [OpenStudio::Model::Schedule] OpenStudio Schedule object. If nil, will default to always on.
+    # @param control_option [String] Options are 'ScheduleNameOnly' and 'AstronomicalClock'.
+    #   'ScheduleNameOnly' will follow the schedule. 'AstronomicalClock' will follow the schedule, but turn off lights when the sun is up.
+    # @return [OpenStudio::Model::ExteriorLights] OpenStudio ExteriorLights object
+    def self.model_create_exterior_lights(model,
+                                          name: nil,
+                                          power: 1.0,
+                                          units: 'W',
+                                          multiplier: 1.0,
+                                          schedule: nil,
+                                          control_option: 'AstronomicalClock')
+      # default name
+      if name.nil?
+        name = "Exterior Lights #{power.round(2)} #{units}"
+      else
+        end_use_category = name
+        name = "#{name} #{power.round(2)} #{units}"
+      end
+
+      # warn if incorrect control option
+      unless OpenStudio::Model::ExteriorLights::validControlOptionValues.include? control_option
+        OpenStudio.logFree(OpenStudio::Warn, 'openstudio.standards.ExteriorLighting', "Invalid control option #{control_option}. Use either ScheduleNameOnly' or 'AstronomicalClock'. Defaulting to 'AstronomicalClock'.")
+        control_option = 'AstronomicalClock'
+      end
+
+      # default schedule
+      schedule = model.alwaysOnDiscreteSchedule if schedule.nil?
+
+      # create exterior light definition
+      exterior_lights_definition = OpenStudio::Model::ExteriorLightsDefinition.new(model)
+      exterior_lights_definition.setName("#{name} Def (#{units})")
+      exterior_lights_definition.setDesignLevel(power)
+
+      # creating exterior lights object
+      exterior_lights = OpenStudio::Model::ExteriorLights.new(exterior_lights_definition, schedule)
+      exterior_lights.setMultiplier(multiplier)
+      exterior_lights.setName(name)
+      exterior_lights.setControlOption(control_option)
+      exterior_lights.setEndUseSubcategory(end_use_category)
+
+      return exterior_lights
+    end
+
+    # Create typical exterior lighting in a model
+    #
+    # @param model [OpenStudio::Model::Model] OpenStudio model object
+    # @param standard [Standard] standard object to use for lighting properties. If set, will override lighting_generation.
+    # @param lighting_generation [String] lighting generation to use for lighting properties. Currently defaulted to a mix of Metal Halide, High Pressure Sodium, and LEDs.
+    # @param lighting_zone [Integer] exterior lighting zone number, 0-4
+    # @param onsite_parking_fraction [Double] onsite parking fraction, 0-1
+    # @param add_base_site_allowance [Boolean] whether to include the base site allowance
+    # @param use_model_for_entries_and_canopies [Boolean] use building geometry for number of entries and canopy size
+    # @param control_option [String] Options are 'ScheduleNameOnly' and 'AstronomicalClock'.
+    #   'ScheduleNameOnly' will follow the schedule. 'AstronomicalClock' will follow the schedule, but turn off lights when the sun is up.
+    # @return [Array<OpenStudio::Model::ExteriorLights>] Array of OpenStudio ExteriorLights object
+    def self.model_create_typical_exterior_lighting(model,
+                                                    standard: nil,
+                                                    lighting_generation: 'default',
+                                                    lighting_zone: 3,
+                                                    onsite_parking_fraction: 1.0,
+                                                    add_base_site_allowance: false,
+                                                    use_model_for_entries_and_canopies: false,
+                                                    control_option: 'AstronomicalClock')
+      exterior_lights = []
+      installed_power = 0.0
+      # get the exterior lighting properties from standard or the lighting_generation
+      if standard.nil?
+        exterior_lighting_properties = OpenstudioStandards::ExteriorLighting.model_get_exterior_lighting_properties(lighting_generation: lighting_generation)
+        lookup_key = lighting_generation
+      else
+        lookup_key = standard.template
+        if ['90.1-2004', '90.1-2007', '90.1-2010', '90.1-2013', '90.1-2016', '90.1-2019 PRM'].include?(lookup_key)
+          exterior_lighting_properties = {}
+        else
+          search_criteria = {
+            'lighting_zone' => lighting_zone
+          }
+          exterior_lighting_properties = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+        end
+      end
+
+      # make sure lighting properties were found
+      if exterior_lighting_properties.nil?
+        OpenStudio.logFree(OpenStudio::Warn, 'openstudio.standards.ExteriorLighting', "Exterior lighting properties not found for #{lookup_key}, ext lighting zone #{lighting_zone}, none will be added to model.")
+        return exterior_lights
+      end
+
+      # get model specific areas to for exterior lighting
+      area_length_count_hash = OpenstudioStandards::ExteriorLighting.model_get_exterior_lighting_sizes(model)
+
+      # create schedules for exterior lighting objects using midnight to 6am setback or shutdown
+      start_setback_shutoff = { hr: 24, min: 0 }
+      end_setback_shutoff = { hr: 6, min: 0 }
+      shuttoff = false
+      setback = false
+
+      if exterior_lighting_properties.has_key?('building_facade_and_landscape_automatic_shut_off')
+        if exterior_lighting_properties['building_facade_and_landscape_automatic_shut_off'] == 1
+          facade_automatic_shut_off = true
+        else
+          facade_automatic_shut_off = false
+        end
+      else
+        search_criteria = {
+          'template' => lookup_key,
+          'lighting_zone' => lighting_zone,
+          'allowance_type' => 'building facades'
+        }
+        exterior_lighting_building_facade_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+        if exterior_lighting_building_facade_req['daylight_off_control'] == 'REQ'
+          facade_automatic_shut_off = true
+        else
+          facade_automatic_shut_off = false
+        end
+      end
+
+      if facade_automatic_shut_off
+        ext_lights_sch_facade_and_landscape = OpenStudio::Model::ScheduleRuleset.new(model)
+        default_day = ext_lights_sch_facade_and_landscape.defaultDaySchedule
+        default_day.addValue(OpenStudio::Time.new(0, end_setback_shutoff[:hr], end_setback_shutoff[:min], 0), 0.0)
+        default_day.addValue(OpenStudio::Time.new(0, start_setback_shutoff[:hr], start_setback_shutoff[:min], 0), 1.0)
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Facade and Landscape exterior lights shut off from #{start_setback_shutoff} to #{end_setback_shutoff}")
+      else
+        ext_lights_sch_facade_and_landscape = model.alwaysOnDiscreteSchedule
+      end
+
+
+      occupancy_setback_reduction = 0.0
+      if exterior_lighting_properties.has_key?('occupancy_setback_reduction')
+        if !exterior_lighting_properties['occupancy_setback_reduction'].nil? && (exterior_lighting_properties['occupancy_setback_reduction'] > 0.0)
+          occupancy_setback_reduction = exterior_lighting_properties['occupancy_setback_reduction']
+        end
+      else
+        unless ['90.1-2004', '90.1-2007', 'DOE Ref Pre-1980', 'DOE Ref 1980-2004', 'DEER 1985', 'DEER 1996', 'DEER 2003', 'DEER 2007', 'DEER Pre-1975'].include?(lookup_key)
+          occupancy_setback_reduction = 0.3
+        end
+      end
+
+      if occupancy_setback_reduction > 0
+        ext_lights_sch_other = OpenStudio::Model::ScheduleRuleset.new(model)
+        setback_value = 1.0 - occupancy_setback_reduction
+        default_day = ext_lights_sch_other.defaultDaySchedule
+        default_day.addValue(OpenStudio::Time.new(0, end_setback_shutoff[:hr], end_setback_shutoff[:min], 0), setback_value)
+        default_day.addValue(OpenStudio::Time.new(0, start_setback_shutoff[:hr], start_setback_shutoff[:min], 0), 1.0)
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Non Facade and Landscape lights reduce by #{occupancy_setback_reduction * 100} % from #{start_setback_shutoff} to #{end_setback_shutoff}")
+      else
+        ext_lights_sch_other = model.alwaysOnDiscreteSchedule
+      end
+
+      # add exterior lights for parking area
+      if !area_length_count_hash[:parking_area_and_drives_area].nil? && area_length_count_hash[:parking_area_and_drives_area] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:parking_area_and_drives_area] * onsite_parking_fraction
+
+        # get power
+        if exterior_lighting_properties.has_key?('parking_areas_and_drives')
+          power = exterior_lighting_properties['parking_areas_and_drives']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'parking lots and drives'
+          }
+          exterior_lighting_parking_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          power = exterior_lighting_parking_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power.round(2)} W/ft^2 of lighting for #{multiplier} ft^2 of parking area.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Parking Areas and Drives',
+                                                                                        power: power,
+                                                                                        units: 'W/ft^2',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add exterior lights for facades
+      if !area_length_count_hash[:building_facades].nil? && area_length_count_hash[:building_facades] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:building_facades]
+
+        # get power
+        if exterior_lighting_properties.has_key?('building_facades')
+          power = exterior_lighting_properties['building_facades']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'building facades',
+            'allowance_unit' => 'W/ft2'
+          }
+          exterior_lighting_facade_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          power = exterior_lighting_facade_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power.round(2)} W/ft^2 of lighting for #{multiplier} ft^2 of building facade area.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Building Facades',
+                                                                                        power: power,
+                                                                                        units: 'W/ft^2',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_facade_and_landscape,
+                                                                                        control_option: control_option)
+        exterior_lights <<  ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add exterior lights for main entries
+      if !area_length_count_hash[:main_entries].nil? && area_length_count_hash[:main_entries] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:main_entries]
+
+        # get power
+        if exterior_lighting_properties.has_key?('main_entries')
+          power = exterior_lighting_properties['main_entries']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'main entries'
+          }
+          exterior_lighting_entries_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          # change of reference for 90.1-2019 and onwards
+          if exterior_lighting_entries_req.nil?
+            search_criteria = {
+              'template' => lookup_key,
+              'lighting_zone' => lighting_zone,
+              'allowance_type' => 'pedestrian and vehicular entrances and exists'
+            }
+            exterior_lighting_entries_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          end
+          power = exterior_lighting_entries_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power.round(2)} W/ft of lighting for #{multiplier} ft of main entry length.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Main Entries',
+                                                                                        power: power,
+                                                                                        units: 'W/ft',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add exterior lights for other doors
+      if !area_length_count_hash[:other_doors].nil? && area_length_count_hash[:other_doors] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:other_doors]
+
+        # get power
+        if exterior_lighting_properties.has_key?('other_doors')
+          power = exterior_lighting_properties['other_doors']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'other doors'
+          }
+          exterior_lighting_doors_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          # change of reference for 90.1-2019 and onwards
+          if exterior_lighting_doors_req.nil?
+            search_criteria = {
+              'template' => lookup_key,
+              'lighting_zone' => lighting_zone,
+              'allowance_type' => 'pedestrian and vehicular entrances and exists'
+            }
+            exterior_lighting_doors_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          end
+          power = exterior_lighting_doors_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power.round(2)} W/ft of lighting for #{multiplier} ft of other doors.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Other Doors',
+                                                                                        power: power,
+                                                                                        units: 'W/ft',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add exterior lights for entry canopies
+      if !area_length_count_hash[:canopy_entry_area].nil? && area_length_count_hash[:canopy_entry_area] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:canopy_entry_area]
+
+        # get power
+        if exterior_lighting_properties.has_key?('entry_canopies')
+          power = exterior_lighting_properties['entry_canopies']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'canopies'
+          }
+          exterior_lighting_canopies_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          # change of reference for 90.1-2010 and onwards
+          if exterior_lighting_parking_req.nil?
+            search_criteria = {
+              'template' => lookup_key,
+              'lighting_zone' => lighting_zone,
+              'allowance_type' => 'entry canopies'
+            }
+            exterior_lighting_canopies_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          end
+          power = exterior_lighting_canopies_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power} W/ft^2 of lighting for #{multiplier} ft^2 of building entry canopies.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Entry Canopies',
+                                                                                        power: power,
+                                                                                        units: 'W/ft^2',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add exterior lights for emergency canopies
+      if !area_length_count_hash[:canopy_emergency_area].nil? && area_length_count_hash[:canopy_emergency_area] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:canopy_emergency_area]
+
+        # get power
+        if exterior_lighting_properties.has_key?('loading_areas_for_emergency_vehicles')
+          power = exterior_lighting_properties['loading_areas_for_emergency_vehicles']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'loading areas for law enforcement, fire, ambulance and other emergency service vehicles (uncovered)'
+          }
+          exterior_lighting_emergency_canopies_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          power = exterior_lighting_emergency_canopies_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power} W/ft^2 of lighting for #{multiplier} ft^2 of building emergency canopies.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Emergency Canopies',
+                                                                                        power: power,
+                                                                                        units: 'W/ft^2',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add exterior lights for drive through windows
+      if !area_length_count_hash[:drive_through_windows].nil? && area_length_count_hash[:drive_through_windows] > 0
+        # lighting values
+        multiplier = area_length_count_hash[:drive_through_windows]
+
+        # get power
+        if exterior_lighting_properties.has_key?('drive_through_windows_and_doors')
+          power = exterior_lighting_properties['drive_through_windows_and_doors']
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'drive-up windows at fast food restaurant'
+          }
+          exterior_lighting_emergency_drive_through_req = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          power = exterior_lighting_emergency_drive_through_req['allowance']
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power} W/drive through window of lighting for #{multiplier} drive through windows.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Drive Through Windows',
+                                                                                        power: power,
+                                                                                        units: 'W/ft^2',
+                                                                                        multiplier: multiplier,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+        installed_power += power * multiplier
+      end
+
+      # add base site allowance
+      if add_base_site_allowance
+        # lighting values
+        if exterior_lighting_properties.has_key?('base_site_allowance_power')
+          if !exterior_lighting_properties['base_site_allowance_power'].nil?
+            power = exterior_lighting_properties['base_site_allowance_power']
+          elsif !exterior_lighting_properties['base_site_allowance_fraction'].nil?
+            power = exterior_lighting_properties['base_site_allowance_fraction'] * installed_power # should be of allowed vs. installed, but hard to calculate
+          else
+            OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', 'Cannot determine target base site allowance power, will set to 0 W.')
+            power = 0.0
+          end
+        else
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'base site allowance'
+          }
+          exterior_lighting_base_allowance = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          power = exterior_lighting_base_allowance['allowance']
+
+          search_criteria = {
+            'template' => lookup_key,
+            'lighting_zone' => lighting_zone,
+            'allowance_type' => 'additional unrestricted allowance'
+          }
+          exterior_lighting_add_base_allowance = standard.standards_lookup_table_first(table_name: 'exterior_lighting', search_criteria: search_criteria)
+          if !exterior_lighting_add_base_allowance.nil?
+            power += exterior_lighting_add_base_allowance['allowance'] * installed_power / 100.0 # should be of allowed vs. installed, but hard to calculate
+          end
+        end
+
+        # create exterior lights
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ExteriorLighting', "Added #{power} W of non landscape tradable exterior lighting. Will follow occupancy setback reduction.")
+        ext_lights = OpenstudioStandards::ExteriorLighting.model_create_exterior_lights(model,
+                                                                                        name: 'Base Site Allowance',
+                                                                                        power: power,
+                                                                                        units: 'W',
+                                                                                        multiplier: 1.0,
+                                                                                        schedule: ext_lights_sch_other,
+                                                                                        control_option: control_option)
+        exterior_lights << ext_lights
+      end
+
+      return exterior_lights
+    end
+  end
+end

data/lib/openstudio-standards/exterior_lighting/data/entryways.csv

@@ -0,0 +1,52 @@
+building_type,rollup_doors_per_10000_ft2,entrance_doors_per_10000_ft2,other_doors_per_10000_ft2,entrance_canopies,emergency_canopies,canopy_size,floor_area_per_drive_through_window,notes
+SmallOffice,0.47,2,2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+MediumOffice,0.13,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+LargeOffice,0,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Retail,1.84,1,2.93,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+StripMall,0.05,6,6.6,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+PrimarySchool,0.07,2,3.3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+SecondarySchool,0.1,2,2.45,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Outpatient,0.1,1,5.19,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Hospital,0.03,2,3.8,,1,720,,"No source for canopy size, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate canopy lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+SmallHotel,0,2,28.91,1,,720,,"SmallHotel appears to have exterior entries for all units, No source for canopy size, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate canopy lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+LargeHotel,0,2,2.27,1,,1620,,"No source for canopy size, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate canopy lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+Warehouse,3.67,1,2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+QuickServiceRestaurant,0,2,1,,,,2500,"No source for drive through count, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate drive through lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+FullServiceRestaurant,0,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+MidriseApartment,0,1,1.13,,,,,"Midrise not in table 4.18, using half of values from LargeHotel."
+HighriseApartment,0,1,1.13,,,,,"Highrise not in table 4.18, using half of values from LargeHotel."
+SuperMarket,1.84,1,2.93,,,,,"SuperMarket not in table 4.18, using values from RetailStandAlone. Consistant with SuperMarket parking area used in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock report."
+Courthouse,0,1,3,,,,,match MediumOffice
+College,0,2,2.45,,,,,match SecondarySchool
+Laboratory,0,2,2.45,,,,,match SecondarySchool
+SmallDataCenterLowITE,0,1,3,,,,,match MediumOffice
+SmallDataCenterHighITE,0,1,3,,,,,match MediumOffice
+LargeDataCenterLowITE,0,1,3,,,,,match MediumOffice
+LargeDataCenterHighITE,0,1,3,,,,,match MediumOffice
+SmallOfficeDetailed,0.47,2,2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+MediumOfficeDetailed,0.13,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+LargeOfficeDetailed,0,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Asm,0.1,2,2.45,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+ECC,0.1,2,2.45,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+EPr,0.07,2,3.3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+ERC,0,1,0,,,,,Relocatable classrooms typically have 1 door based on engineering judgement
+ESe,0.1,2,2.45,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+EUn,0.1,2,2.45,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Gro,1.84,1,2.93,,,,,"SuperMarket not in table 4.18, using values from RetailStandAlone. Consistant with SuperMarket parking area used in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock report."
+Hsp,0.03,0.67,3.8,,1,720,,"No source for canopy size, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate canopy lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+Htl,0,0.67,2.27,1,,1620,,"No source for canopy size, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate canopy lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+MBT,3.67,1,2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+MFm,0,1,1.13,,,,,"Midrise not in table 4.18, using half of values from LargeHotel."
+MLI,3.67,1,2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Mtl,0,2,28.91,,,,,"Assuming no canopy; this is different from the DOE SmallHotel prototype. The DOE SmallHotel appears to have exterior entries for all units, No source for canopy size, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate canopy lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+Nrs,0,1,1.13,,,,,"Nursing home not in table 4.18, using half of values from LargeHotel."
+OfL,0,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+OfS,0.47,2,2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+RFF,0,2,1,,,,2500,"No source for drive through count, Table 5.41. Exterior Lighting Savings Summary for Addendum 90.1-07i doesn't indicate drive through lighting. Section 5.4.2 Exterior Lights in U.S. Department of Energy Commercial Reference Building Models of the National Building Stock shows their use."
+RSD,0,1,3,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+Rt3,1.84,1,2.93,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+RtL,1.84,1,2.93,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+RtS,0.05,6,6.6,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+SCn,3.67,0.2,0.2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+SUn,3.67,0.2,0.2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010
+WRf,3.67,0.2,0.2,,,,,Based on Table 4.18 Number of Doors by Door Type from Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010

data/lib/openstudio-standards/exterior_lighting/data/parking.csv

@@ -0,0 +1,54 @@
+building_type,building_area_per_spot,units_per_spot,students_per_spot,beds_per_spot,parking_area_per_spot
+SmallOffice,250,,,,405
+MediumOffice,250,,,,405
+LargeOffice,620,,,,405
+Retail,285.7,,,,405
+StripMall,215,,,,405
+PrimarySchool,,,17,,405
+SecondarySchool,,,8,,405
+Outpatient,200,,,,405
+Hospital,,,,0.83,405
+SmallHotel,,1,,,405
+LargeHotel,,1,,,405
+Warehouse,1000,,,,405
+QuickServiceRestaurant,100,,,,405
+FullServiceRestaurant,100,,,,405
+MidriseApartment,,0.45,,,405
+HighriseApartment,,0.45,,,405
+SuperMarket,285.7,,,,405
+Parking surface,,,,,405
+Parking garage,,,,,486
+SmallDataCenterLowITE,0,,,,405
+SmallDataCenterHighITE,0,,,,405
+LargeDataCenterLowITE,0,,,,405
+LargeDataCenterHighITE,0,,,,405
+SmallOfficeDetailed,250,,,,405
+MediumOfficeDetailed,250,,,,405
+LargeOfficeDetailed,620,,,,405
+Courthouse,250,,,,405
+College,250,,,,405
+Laboratory,250,,,,405
+Asm,285.7,,,,405
+ECC,,,8,,405
+EPr,,,17,,405
+ERC,,,8,,405
+ESe,,,8,,405
+EUn,,,30,,405
+Gro,285.7,,,,405
+Hsp,,,,0.83,405
+Htl,,1,,,405
+MBT,1000,,,,405
+MFm,,0.45,,,405
+MLI,1000,,,,405
+Mtl,,1,,,405
+Nrs,,1,,,405
+OfL,250,,,,405
+OfS,250,,,,405
+RFF,100,,,,405
+RSD,100,,,,405
+Rt3,285.7,,,,405
+RtL,285.7,,,,405
+RtS,285.7,,,,405
+SCn,1000,,,,405
+SUn,1000,,,,405
+WRf,1000,,,,405