urbanopt-cli 0.2.0.pre6 → 0.2.0

data/example_files/mappers/Baseline.rb

@@ -1,32 +1,32 @@
-#*********************************************************************************
-# URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other 
+# *********************************************************************************
+# URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other
 # contributors. All rights reserved.
-# 
-# Redistribution and use in source and binary forms, with or without modification, 
+#
+# Redistribution and use in source and binary forms, with or without modification,
 # are permitted provided that the following conditions are met:
-# 
-# Redistributions of source code must retain the above copyright notice, this list 
+#
+# Redistributions of source code must retain the above copyright notice, this list
 # of conditions and the following disclaimer.
-# 
-# Redistributions in binary form must reproduce the above copyright notice, this 
-# list of conditions and the following disclaimer in the documentation and/or other 
+#
+# Redistributions in binary form must reproduce the above copyright notice, this
+# list of conditions and the following disclaimer in the documentation and/or other
 # materials provided with the distribution.
-# 
-# Neither the name of the copyright holder nor the names of its contributors may be 
-# used to endorse or promote products derived from this software without specific 
+#
+# Neither the name of the copyright holder nor the names of its contributors may be
+# used to endorse or promote products derived from this software without specific
 # prior written permission.
-# 
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
-# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
-# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
-# IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
-# INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
-# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
-# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
-# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+# IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+# INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 # OF THE POSSIBILITY OF SUCH DAMAGE.
-#*********************************************************************************
+# *********************************************************************************
 
 require 'urbanopt/scenario'
 require 'openstudio/common_measures'
@@ -37,87 +37,258 @@ require 'json'
 module URBANopt
   module Scenario
     class BaselineMapper < SimulationMapperBase
-    
       # class level variables
       @@instance_lock = Mutex.new
       @@osw = nil
       @@geometry = nil
-    
-      def initialize()
-      
+
+      def initialize
         # do initialization of class variables in thread safe way
         @@instance_lock.synchronize do
-          if @@osw.nil? 
+          if @@osw.nil?
 
             # load the OSW for this class
             osw_path = File.join(File.dirname(__FILE__), 'base_workflow.osw')
             File.open(osw_path, 'r') do |file|
               @@osw = JSON.parse(file.read, symbolize_names: true)
             end
-        
+
             # add any paths local to the project
             @@osw[:file_paths] << File.join(File.dirname(__FILE__), '../weather/')
-            
-            # configures OSW with extension gem paths for measures and files, all extension gems must be 
+
+            # configures OSW with extension gem paths for measures and files, all extension gems must be
             # required before this
             @@osw = OpenStudio::Extension.configure_osw(@@osw)
           end
         end
       end
-      
+
+      def lookup_building_type(building_type, template, footprint_area, number_of_stories)
+        if template.include? 'DEER'
+          case building_type
+          when 'Education'
+            'EPr'
+          when 'Enclosed mall'
+            'RtL'
+          when 'Food sales'
+            'RSD'
+          when 'Food service'
+            'RSD'
+          when 'Inpatient health care'
+            'Nrs'
+          when 'Laboratory'
+            'Hsp'
+          when 'Lodging'
+            'Htl'
+          when 'Mixed use'
+            'ECC'
+          when 'Mobile Home'
+            'DMo'
+          when 'Multifamily (2 to 4 units)'
+            'MFm'
+          when 'Multifamily (5 or more units)'
+            'MFm'
+          when 'Nonrefrigerated warehouse'
+            'SUn'
+          when 'Nursing'
+            'Nrs'
+          when 'Office'
+            if footprint_area
+              if footprint_area.to_f > 100_000
+                'OfL'
+              else
+                'OfS'
+              end
+            else
+              raise 'footprint_area required to map office building type'
+            end
+          when 'Outpatient health care'
+            'Nrs'
+          when 'Public assembly'
+            'Asm'
+          when 'Public order and safety'
+            'Asm'
+          when 'Refrigerated warehouse'
+            'WRf'
+          when 'Religious worship'
+            'Asm'
+          when 'Retail other than mall'
+            'RtS'
+          when 'Service'
+            'MLI'
+          when 'Single-Family'
+            'MFm'
+          when 'Strip shopping mall'
+            'RtL'
+          when 'Vacant'
+            'SUn'
+          else
+            raise "building type #{building_type} cannot be mapped to a DEER building type"
+          end
+
+        else
+          # default: ASHRAE
+          case building_type
+          when 'Education'
+            'SecondarySchool'
+          when 'Enclosed mall'
+            'RetailStripmall'
+          when 'Food sales'
+            'FullServiceRestaurant'
+          when 'Food service'
+            'FullServiceRestaurant'
+          when 'Inpatient health care'
+            'Hospital'
+          when 'Laboratory'
+            'Hospital'
+          when 'Lodging'
+            if number_of_stories
+              if number_of_stories.to_i > 3
+                return 'LargeHotel'
+              else
+                return 'SmallHotel'
+              end
+            end
+            'LargeHotel'
+          when 'Mixed use'
+            'Mixed use'
+          when 'Mobile Home'
+            'MidriseApartment'
+          when 'Multifamily (2 to 4 units)'
+            'MidriseApartment'
+          when 'Multifamily (5 or more units)'
+            'MidriseApartment'
+          when 'Nonrefrigerated warehouse'
+            'Warehouse'
+          when 'Nursing'
+            'Outpatient'
+          when 'Office'
+            if footprint_area
+              value = if footprint_area.to_f < 20_000
+                        'SmallOffice'
+                      elsif footprint_area.to_f > 100_000
+                        'LargeOffice'
+                      else
+                        'MediumOffice'
+                      end
+            else
+              raise 'Floor area required to map office building type'
+            end
+          when 'Outpatient health care'
+            'Outpatient'
+          when 'Public assembly'
+            'MediumOffice'
+          when 'Public order and safety'
+            'MediumOffice'
+          when 'Refrigerated warehouse'
+            'Warehouse'
+          when 'Religious worship'
+            'MediumOffice'
+          when 'Retail other than mall'
+            'RetailStandalone'
+          when 'Service'
+            'MediumOffice'
+          when 'Single-Family'
+            'MidriseApartment'
+          when 'Strip shopping mall'
+            'RetailStripmall'
+          when 'Vacant'
+            'Warehouse'
+          else
+            raise "building type #{building_type} cannot be mapped to an ASHRAE building type"
+          end
+        end
+      end
+
+      def lookup_template_by_year_built(template, year_built)
+        if template.include? 'DEER'
+          if year_built <= 1996
+            'DEER 1985'
+          elsif year_built <= 2003
+            'DEER 1996'
+          elsif year_built <= 2007
+            'DEER 2003'
+          elsif year_built <= 2011
+            'DEER 2007'
+          elsif year_built <= 2014
+            'DEER 2011'
+          elsif year_built <= 2015
+            'DEER 2014'
+          elsif year_built <= 2017
+            'DEER 2015'
+          elsif year_built <= 2020
+            'DEER 2017'
+          else
+            'DEER 2020'
+          end
+        else
+          # ASHRAE
+          if year_built < 1980
+            'DOE Ref Pre-1980'
+          elsif year_built <= 2004
+            'DOE Ref 1980-2004'
+          elsif year_built <= 2007
+            '90.1-2004'
+          elsif year_built <= 2010
+            '90.1-2007'
+          elsif year_built <= 2013
+            '90.1-2010'
+          else
+            '90.1-2013'
+          end
+        end
+      end
+
       def create_osw(scenario, features, feature_names)
-        
         if features.size != 1
-          raise "TestMapper1 currently cannot simulate more than one feature"
+          raise 'TestMapper1 currently cannot simulate more than one feature'
         end
         feature = features[0]
         feature_id = feature.id
-        feature_type = feature.type 
+        feature_type = feature.type
         feature_name = feature.name
-        if feature_names.size == 1
-          feature_name = feature_names[0]
-        end
-        
+        feature_name = feature_names[0] if feature_names.size == 1
+
         # deep clone of @@osw before we configure it
         osw = Marshal.load(Marshal.dump(@@osw))
-        
+
         # now we have the feature, we can look up its properties and set arguments in the OSW
         osw[:name] = feature_name
         osw[:description] = feature_name
-        
+
         if feature_type == 'Building'
 
           # set_run_period
           begin
-            timesteps_per_hour = feature.timesteps_per_hour 
-            if !timesteps_per_hour.empty?
+            timesteps_per_hour = feature.timesteps_per_hour
+            unless timesteps_per_hour.empty?
               OpenStudio::Extension.set_measure_argument(osw, 'set_run_period', 'timesteps_per_hour', timesteps_per_hour)
             end
-          rescue
+          rescue StandardError
           end
           begin
             begin_date = feature.begin_date
-            if !feature.begin_date.empty?
-               # check date-only YYYY-MM-DD
+            unless feature.begin_date.empty?
+              # check date-only YYYY-MM-DD
               if feature.begin_date.length > 10
                 feature.begin_date = feature.begin_date[0, 10]
               end
               OpenStudio::Extension.set_measure_argument(osw, 'set_run_period', 'begin_date', begin_date)
             end
-          rescue
+          rescue StandardError
           end
           begin
             end_date = feature.end_date
-            if !feature.end_date.empty?
+            unless feature.end_date.empty?
               # check date-only YYYY-MM-DD
               if feature.end_date.length > 10
                 feature.end_date = feature.end_date[0, 10]
               end
               OpenStudio::Extension.set_measure_argument(osw, 'set_run_period', 'end_date', end_date)
             end
-          rescue
+          rescue StandardError
           end
- 
+
           # convert to hash
           building_hash = feature.to_hash
           # check for detailed model filename
@@ -131,94 +302,10 @@ module URBANopt
 
           # in case detailed model filename is not present
           else
+
             building_type_1 = building_hash[:building_type]
-            case building_type_1
-            when 'Multifamily (5 or more units)'
-              building_type_1 = 'MidriseApartment'
-            when 'Multifamily (2 to 4 units)'
-              building_type_1 = 'MidriseApartment'
-            when 'Single-Family'
-              building_type_1 = 'MidriseApartment'
-            when 'Office'
-              building_type_1 = 'MediumOffice'
-            when 'Outpatient health care'
-              building_type_1 = 'Outpatient'
-            when 'Inpatient health care'
-              building_type_1 = 'Hospital'
-            when 'Lodging'
-              building_type_1 = 'LargeHotel'
-            when 'Food service'
-              building_type_1 = 'FullServiceRestaurant'
-            when 'Strip shopping mall'
-              building_type_1 = 'RetailStripmall'
-            when 'Retail other than mall'
-              building_type_1 = 'RetailStandalone' 
-            when 'Education'
-              building_type_1 = 'SecondarySchool'
-            when 'Nursing'
-              building_type_1 = 'MidriseApartment'  
-            when 'Mixed use'
-              mixed_type_1 = building_hash[:mixed_type_1]
-              mixed_type_2 = building_hash[:mixed_type_2]
-              mixed_type_2_percentage = building_hash[:mixed_type_2_percentage]
-              mixed_type_2_fract_bldg_area = mixed_type_2_percentage*0.01
-                         
-              mixed_type_3 = building_hash[:mixed_type_3]
-              mixed_type_3_percentage = building_hash[:mixed_type_3_percentage]
-              mixed_type_3_fract_bldg_area = mixed_type_3_percentage*0.01
-  
-              mixed_type_4 = building_hash[:mixed_type_4]
-              mixed_type_4_percentage = building_hash[:mixed_type_4_percentage]
-              mixed_type_4_fract_bldg_area = mixed_type_4_percentage*0.01
-  
-              mixed_use_types = []
-              mixed_use_types << mixed_type_1
-              mixed_use_types << mixed_type_2
-              mixed_use_types << mixed_type_3
-              mixed_use_types << mixed_type_4
-  
-              openstudio_mixed_use_types = []
-  
-              mixed_use_types.each do |mixed_use_type|
-  
-                case mixed_use_type
-                when 'Multifamily (5 or more units)'
-                  mixed_use_type = 'MidriseApartment'
-                when 'Multifamily (2 to 4 units)'
-                  mixed_use_type = 'MidriseApartment'
-                when 'Single-Family'
-                  mixed_use_type = 'MidriseApartment'
-                when 'Office'
-                  mixed_use_type = 'MediumOffice'
-                when 'Outpatient health care'
-                  mixed_use_type = 'Outpatient'
-                when 'Inpatient health care'
-                  mixed_use_type = 'Hospital'
-                when 'Lodging'
-                  mixed_use_type = 'LargeHotel'
-                when 'Food service'
-                  mixed_use_type = 'FullServiceRestaurant'
-                when 'Strip shopping mall'
-                  mixed_use_type = 'RetailStripmall'
-                when 'Retail other than mall'
-                  mixed_use_type = 'RetailStandalone' 
-                when 'Education'
-                  mixed_use_type = 'SecondarySchool'
-                when 'Nursing'
-                  mixed_use_type = 'MidriseApartment' 
-                end
-  
-                openstudio_mixed_use_types << mixed_use_type
-              end
-  
-              openstudio_mixed_type_1 = openstudio_mixed_use_types[0]  
-              openstudio_mixed_type_2 = openstudio_mixed_use_types[1]
-              openstudio_mixed_type_3 = openstudio_mixed_use_types[2]
-              openstudio_mixed_type_4 = openstudio_mixed_use_types[3]
-  
-            end
-            footprint_area = building_hash[:footprint_area]
-            floor_height = 10
+
+            # lookup/map building type
             number_of_stories = building_hash[:number_of_stories]
             if building_hash.key?(:number_of_stories_above_ground)
               number_of_stories_above_ground = building_hash[:number_of_stories_above_ground]
@@ -227,111 +314,182 @@ module URBANopt
               number_of_stories_above_ground = number_of_stories
               number_of_stories_below_ground = 0
             end
-            if building_hash.key?(:system_type)
-              system_type = building_hash[:system_type]
-            else
-              system_type = "Inferred"
+            template = building_hash.key?(:template) ? building_hash[:template] : nil
+            footprint_area = building_hash[:footprint_area]
+
+            mapped_building_type_1 = lookup_building_type(building_type_1, template, footprint_area, number_of_stories)
+
+            # process Mixed Use (for create_bar measure)
+            if building_type_1 == 'Mixed use'
+              # map mixed use types
+              running_fraction = 0
+              mixed_type_1 = building_hash[:mixed_type_1]
+              mixed_type_2 = building_hash.key?(:mixed_type_2) ? building_hash[:mixed_type_2] : nil
+              unless mixed_type_2.nil?
+                mixed_type_2_percentage = building_hash[:mixed_type_2_percentage]
+                mixed_type_2_fract_bldg_area = mixed_type_2_percentage * 0.01
+                running_fraction += mixed_type_2_fract_bldg_area
+              end
+
+              mixed_type_3 = building_hash.key?(:mixed_type_3) ? building_hash[:mixed_type_3] : nil
+              unless mixed_type_3.nil?
+                mixed_type_3_percentage = building_hash[:mixed_type_3_percentage]
+                mixed_type_3_fract_bldg_area = mixed_type_3_percentage * 0.01
+                running_fraction += mixed_type_3_fract_bldg_area
+              end
+
+              mixed_type_4 = building_hash.key?(:mixed_type_4) ? building_hash[:mixed_type_4] : nil
+              unless mixed_type_4.nil?
+                mixed_type_4_percentage = building_hash[:mixed_type_4_percentage]
+                mixed_type_4_fract_bldg_area = mixed_type_4_percentage * 0.01
+                running_fraction += mixed_type_4_fract_bldg_area
+              end
+
+              # potentially calculate from other inputs
+              mixed_type_1_fract_bldg_area = building_hash.key?(:mixed_type_1_percentage) ? building_hash[:mixed_type_1_percentage] : (1 - running_fraction)
+
+              # lookup mixed_use types
+              footprint_1 = footprint_area * mixed_type_1_fract_bldg_area
+              openstudio_mixed_type_1 = lookup_building_type(mixed_type_1, template, footprint_1, number_of_stories)
+              unless mixed_type_2.nil?
+                footprint_2 = footprint_area * mixed_type_2_fract_bldg_area
+                openstudio_mixed_type_2 = lookup_building_type(mixed_type_2, template, footprint_2, number_of_stories)
+              end
+              unless mixed_type_3.nil?
+                footprint_3 = footprint_area * mixed_type_3_fract_bldg_area
+                openstudio_mixed_type_3 = lookup_building_type(mixed_type_3, template, footprint_3, number_of_stories)
+              end
+              unless mixed_type_4.nil?
+                footprint_4 = footprint_area * mixed_type_4_fract_bldg_area
+                openstudio_mixed_type_4 = lookup_building_type(mixed_type_4, template, footprint_4, number_of_stories)
+              end
             end
 
+            floor_height = 10
+            system_type = if building_hash.key?(:system_type)
+                            building_hash[:system_type]
+                          else
+                            'Inferred'
+                          end
+
             def time_mapping(time)
               hour = time.split(':')[0]
               minute = time.split(':')[1]
-              fraction = minute.to_f/60
+              fraction = minute.to_f / 60
               fraction_roundup = fraction.round(2)
               minute_fraction = fraction_roundup.to_s.split('.')[1]
               new_time = [hour, minute_fraction].join('.')
-              return new_time
+              new_time
             end
 
-
             # ChangeBuildingLocation
-            # set skip measure to false change building location
+            # set skip to false for change building location
             OpenStudio::Extension.set_measure_argument(osw, 'ChangeBuildingLocation', '__SKIP__', false)
 
             # cec climate zone takes precedence
             cec_found = false
             begin
               cec_climate_zone = feature.cec_climate_zone
-              if !cec_climate_zone.empty?
-                cec_climate_zone = "T24-CEC" + cec_climate_zone
+              unless cec_climate_zone.empty?
+                cec_climate_zone = 'T24-CEC' + cec_climate_zone
                 OpenStudio::Extension.set_measure_argument(osw, 'ChangeBuildingLocation', 'climate_zone', cec_climate_zone)
                 cec_found = true
               end
-            rescue
+            rescue StandardError
             end
-            if !cec_found
+            unless cec_found
               begin
                 climate_zone = feature.climate_zone
-                if !climate_zone.empty?
-                  climate_zone = "ASHRAE 169-2013-" + climate_zone
+                unless climate_zone.empty?
+                  climate_zone = 'ASHRAE 169-2013-' + climate_zone
                   OpenStudio::Extension.set_measure_argument(osw, 'ChangeBuildingLocation', 'climate_zone', climate_zone)
                end
-              rescue
+              rescue StandardError
               end
             end
 
-          begin
-            weather_filename = feature.weather_filename
-            if !feature.weather_filename.empty?
-              OpenStudio::Extension.set_measure_argument(osw, 'ChangeBuildingLocation', 'weather_file_name', weather_filename)
+            # set weather file
+            begin
+              weather_filename = feature.weather_filename
+              if !feature.weather_filename.nil? && !feature.weather_filename.empty?
+                OpenStudio::Extension.set_measure_argument(osw, 'ChangeBuildingLocation', 'weather_file_name', weather_filename)
+                puts "Setting weather_file_name to #{weather_filename} as specified in the FeatureFile"
+              end
+            rescue StandardError
+              puts 'No weather_file specified on feature'
+              epw_file_path = Dir.glob(File.join(File.dirname(__FILE__), '../weather/*.epw'))[0]
+              if !epw_file_path.nil? && !epw_file_path.empty?
+                epw_file_name = File.basename(epw_file_path)
+                OpenStudio::Extension.set_measure_argument(osw, 'ChangeBuildingLocation', 'weather_file_name', epw_file_name)
+                puts "Setting weather_file_name to first epw file found in the weather folder: #{epw_file_name}"
+              else
+                puts 'NO WEATHER FILES SPECIFIED...SIMULATIONS MAY FAIL'
+              end
             end
-          rescue
-          end 
 
-            #set weekday start time
+            # set weekday start time
             begin
               weekday_start_time = feature.weekday_start_time
-              if !feature.weekday_start_time.empty?
+              unless feature.weekday_start_time.empty?
                 new_weekday_start_time = time_mapping(weekday_start_time)
                 OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'wkdy_op_hrs_start_time', new_weekday_start_time, 'create_typical_building_from_model 1')
               end
-            rescue
+            rescue StandardError
             end
 
             # set weekday duration
             begin
               weekday_duration = feature.weekday_duration
-              if !feature.weekday_duration.empty?
+              unless feature.weekday_duration.empty?
                 new_weekday_duration = time_mapping(weekday_duration)
                 OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'wkdy_op_hrs_duration', new_weekday_duration, 'create_typical_building_from_model 1')
               end
-            rescue
+            rescue StandardError
             end
-            
+
             # set weekend start time
             begin
               weekend_start_time = feature.weekend_start_time
-              if !feature.weekend_start_time.empty?
+              unless feature.weekend_start_time.empty?
                 new_weekend_start_time = time_mapping(weekend_start_time)
                 OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'wknd_op_hrs_start_time', new_weekend_start_time, 'create_typical_building_from_model 1')
               end
-            rescue
+            rescue StandardError
             end
-            
+
             # set weekend duration
             begin
               weekend_duration = feature.weekend_duration
-              if !feature.weekend_duration.empty?
+              unless feature.weekend_duration.empty?
                 new_weekend_duration = time_mapping(weekend_duration)
                 OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'wknd_op_hrs_duration', new_weekend_duration, 'create_typical_building_from_model 1')
               end
-            rescue
+            rescue StandardError
             end
 
             # template
             begin
+              new_template = nil
               template = feature.template
-              if !feature.template.empty?
-                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'template', template)
-                OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'template', feature.template, 'create_typical_building_from_model 1')
-                OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'template', feature.template, 'create_typical_building_from_model 2')
+
+              # can we override template with year_built info? (keeping same template family)
+              if building_hash.key?(:year_built) && !building_hash[:year_built].nil? && !feature.template.empty?
+                new_template = lookup_template_by_year_built(template, year_built)
+              elsif !feature.template.empty?
+                new_template = template
+              end
+
+              if new_template
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'template', new_template)
+                OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'template', new_template, 'create_typical_building_from_model 1')
+                OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'template', new_template, 'create_typical_building_from_model 2')
               end
-            rescue
+            rescue StandardError
             end
-            
+
             # TODO: surface_elevation has no current mapping
             # TODO: tariff_filename has no current mapping
-            
+
             # create a bar building, will have spaces tagged with individual space types given the
             # input building types
             # set skip measure to false
@@ -341,24 +499,24 @@ module URBANopt
             OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'num_stories_above_grade', number_of_stories_above_ground)
             OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'num_stories_below_grade', number_of_stories_below_ground)
 
-            OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_a', building_type_1)
+            OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_a', mapped_building_type_1)
 
             if building_type_1 == 'Mixed use'
 
               OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_a', openstudio_mixed_type_1)
-              
-              OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_b', openstudio_mixed_type_2)
-              
-              OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_b_fract_bldg_area', mixed_type_2_fract_bldg_area)
-                        
-              OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_c', openstudio_mixed_type_3)
-              
-              OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_c_fract_bldg_area', mixed_type_3_fract_bldg_area)
-              
-              OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_d', openstudio_mixed_type_4)
-              
-              OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_d_fract_bldg_area', mixed_type_4_fract_bldg_area)      
-            
+
+              unless mixed_type_2.nil?
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_b', openstudio_mixed_type_2)
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_b_fract_bldg_area', mixed_type_2_fract_bldg_area)
+              end
+              unless mixed_type_3.nil?
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_c', openstudio_mixed_type_3)
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_c_fract_bldg_area', mixed_type_3_fract_bldg_area)
+              end
+              unless mixed_type_4.nil?
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_d', openstudio_mixed_type_4)
+                OpenStudio::Extension.set_measure_argument(osw, 'create_bar_from_building_type_ratios', 'bldg_type_d_fract_bldg_area', mixed_type_4_fract_bldg_area)
+              end
             end
 
             # calling create typical building the first time will create space types
@@ -366,32 +524,30 @@ module URBANopt
             OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'add_hvac', false, 'create_typical_building_from_model 1')
 
             # create a blended space type for each story
-            OpenStudio::Extension.set_measure_argument(osw, 
-              'blended_space_type_from_model', '__SKIP__', false)
-            OpenStudio::Extension.set_measure_argument(osw, 
-            'blended_space_type_from_model', 'blend_method', 'Building Story')
+            OpenStudio::Extension.set_measure_argument(osw,
+                                                       'blended_space_type_from_model', '__SKIP__', false)
+            OpenStudio::Extension.set_measure_argument(osw,
+                                                       'blended_space_type_from_model', 'blend_method', 'Building Story')
 
             # create geometry for the desired feature, this will reuse blended space types in the model for each story and remove the bar geometry
             OpenStudio::Extension.set_measure_argument(osw, 'urban_geometry_creation', '__SKIP__', false)
             OpenStudio::Extension.set_measure_argument(osw, 'urban_geometry_creation', 'geojson_file', scenario.feature_file.path)
             OpenStudio::Extension.set_measure_argument(osw, 'urban_geometry_creation', 'feature_id', feature_id)
             OpenStudio::Extension.set_measure_argument(osw, 'urban_geometry_creation', 'surrounding_buildings', 'ShadingOnly')
-                          
+
             # call create typical building a second time, do not touch space types, only add hvac
             OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', '__SKIP__', false)
             OpenStudio::Extension.set_measure_argument(osw, 'create_typical_building_from_model', 'system_type', system_type, 'create_typical_building_from_model 2')
           end
 
-
           # call the default feature reporting measure
           OpenStudio::Extension.set_measure_argument(osw, 'default_feature_reports', 'feature_id', feature_id)
           OpenStudio::Extension.set_measure_argument(osw, 'default_feature_reports', 'feature_name', feature_name)
           OpenStudio::Extension.set_measure_argument(osw, 'default_feature_reports', 'feature_type', feature_type)
-        end 
-
-        return osw
-      end 
-      
-    end #BaselineMapper
-  end #Scenario
-end #URBANopt
+        end
+
+        osw
+      end
+    end # BaselineMapper
+  end # Scenario
+end # URBANopt