openstudio-standards 0.2.12 → 0.2.13.rc3

data/data/standards/export/ashrae_90_1/ashrae_90_1_2013/data/ashrae_90_1_2013.water_heaters.json

@@ -0,0 +1,68 @@
+{
+  "water_heaters": [
+    {
+      "template": "90.1-2013",
+      "fuel_type": "Electricity",
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 40945.99,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "energy_factor_base": 0.97,
+      "energy_factor_volume_derate": 0.00132,
+      "standby_loss_base": null,
+      "standby_loss_capacity_allowance": null,
+      "standby_loss_volume_allowance": null,
+      "hourly_loss_base": null,
+      "hourly_loss_volume_allowance": null,
+      "thermal_efficiency": null
+    },
+    {
+      "template": "90.1-2013",
+      "fuel_type": "Electricity",
+      "minimum_capacity": 40946.0,
+      "maximum_capacity": 99999999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "energy_factor_base": null,
+      "energy_factor_volume_derate": null,
+      "standby_loss_base": 20.0,
+      "standby_loss_capacity_allowance": null,
+      "standby_loss_volume_allowance": 35.0,
+      "hourly_loss_base": null,
+      "hourly_loss_volume_allowance": null,
+      "thermal_efficiency": null
+    },
+    {
+      "template": "90.1-2013",
+      "fuel_type": "NaturalGas",
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 74999.99,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "energy_factor_base": 0.67,
+      "energy_factor_volume_derate": 0.0019,
+      "standby_loss_base": null,
+      "standby_loss_capacity_allowance": null,
+      "standby_loss_volume_allowance": null,
+      "hourly_loss_base": null,
+      "hourly_loss_volume_allowance": null,
+      "thermal_efficiency": null
+    },
+    {
+      "template": "90.1-2013",
+      "fuel_type": "NaturalGas",
+      "minimum_capacity": 75000.0,
+      "maximum_capacity": 99999999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "energy_factor_base": null,
+      "energy_factor_volume_derate": null,
+      "standby_loss_base": null,
+      "standby_loss_capacity_allowance": 800.0,
+      "standby_loss_volume_allowance": 110.0,
+      "hourly_loss_base": null,
+      "hourly_loss_volume_allowance": null,
+      "thermal_efficiency": 0.8
+    }
+  ]
+}

data/data/standards/export/ashrae_90_1/ashrae_90_1_2013/data/ashrae_90_1_2013.water_source_heat_pumps.json

@@ -0,0 +1,28 @@
+{
+  "water_source_heat_pumps": [
+    {
+      "template": "90.1-2013",
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 16999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 12.2
+    },
+    {
+      "template": "90.1-2013",
+      "minimum_capacity": 17000.0,
+      "maximum_capacity": 64999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 13.0
+    },
+    {
+      "template": "90.1-2013",
+      "minimum_capacity": 65000.0,
+      "maximum_capacity": 134999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 13.0
+    }
+  ]
+}

data/data/standards/export/ashrae_90_1/ashrae_90_1_2013/data/ashrae_90_1_2013.water_source_heat_pumps_heating.json

@@ -0,0 +1,12 @@
+{
+  "water_source_heat_pumps_heating": [
+    {
+      "template": "90.1-2013",
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 9999999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_coefficient_of_performance_heating": 4.2
+    }
+  ]
+}

data/data/standards/manage_OpenStudio_Standards.rb

@@ -275,10 +275,78 @@ def download_google_spreadsheets(spreadsheet_titles)
       download_xlsx_spreadsheet(client, file, "#{File.dirname(__FILE__)}/#{file.title}.xlsx")
     end
   end
+end
 
+def exclusion_list
+  file_path = "#{__dir__}/exclude_list.csv"
+  csv_file = CSV.read(file_path, headers:true)
+  csv_data = csv_file.map {|row| row.to_hash}
+  exclusion_array = { "os_stds" => { "worksheets" => [], "columns" => [] },
+                      "data_lib" => { "worksheets" => [], "columns" => [] } }
+  csv_file.each do |row|
+    if row['columns'] == 'all'
+      exclusion_array['os_stds']['worksheets'] << row['worksheet'] if row['exclude_from_os_stds'] == 'TRUE'
+      exclusion_array['data_lib']['worksheets'] << row['worksheet'] if row['exclude_from_data_lib'] == 'TRUE'
+    else
+      exclusion_array['os_stds']['columns'] << row['columns'] if row['exclude_from_os_stds'] == 'TRUE'
+      exclusion_array['data_lib']['columns'] << row['columns'] if row['exclude_from_data_lib'] == 'TRUE'
+    end
+  end
+  return exclusion_array
 end
 
-def export_spreadsheet_to_json(spreadsheet_titles)
+def parse_units(unit)
+  # useless_units = [nil, 'fraction', '%', 'COP_68F', 'COP_47F', '%/gal', 'Btu/hr/Btu/hr', 'Btu/hr/gal', 'BTU/hr/ft', 'W/BTU/h']
+  units_to_skip = [nil, 'fraction', '%', 'EER', '>23m^2', '>84m^2', '<23m^2', '<84m^2']
+  unit_parsed = nil
+  if not units_to_skip.include?(unit)
+    if unit == '%/gal'
+      unit = '1/gal'
+    end
+    unit_parsed = OpenStudio.createUnit(unit)
+    if unit_parsed.empty?
+      unit_parsed = "Not recognized by OpenStudio"
+    else
+      unit_parsed = unit_parsed.get()
+    end
+  end
+  return unit_parsed
+end
+
+# Exports spreadsheet data to data jsons, nested by the standards templates
+#
+# @param spreadsheet_titles
+# @param dataset_type [String] valid choices are 'os_stds' or 'data_lib'
+#   'os_stds' updates json files in openstudio standards, while 'data_lib' exports 90.1 jsons for the data library
+def export_spreadsheet_to_json(spreadsheet_titles, dataset_type: 'os_stds')
+  if dataset_type == 'data_lib'
+    standards_dir = File.expand_path("#{__dir__}/../../data/standards/export")
+    skip_list = exclusion_list['data_lib']
+    skip_list['templates'] = ['DOE Ref Pre-1980',
+                              'DOE Ref 1980-2004',
+                              'NREL ZNE Ready 2017',
+                              'ZE AEDG Multifamily',
+                              'OEESC 2014',
+                              'ICC IECC 2015',
+                              'ECBC 2017',
+                              '189.1-2009']
+  else
+    standards_dir = File.expand_path("#{__dir__}/../../lib/openstudio-standards/standards")
+    skip_list = exclusion_list['os_stds']
+    skip_list['templates'] = []
+  end
+  worksheets_to_skip = skip_list['worksheets']
+  cols_to_skip = skip_list['columns']
+  templates_to_skip = skip_list['templates']
+
+  # List of columns that are boolean
+  # (rubyXL returns 0 or 1, will translate to true/false)
+  bool_cols = []
+  bool_cols << 'hx'
+  bool_cols << 'data_center'
+  bool_cols << 'under_8000_hours'
+  bool_cols << 'u_value_includes_interior_film_coefficient'
+  bool_cols << 'u_value_includes_exterior_film_coefficient'
 
   warnings = []
   duplicate_data = []
@@ -294,46 +362,10 @@ def export_spreadsheet_to_json(spreadsheet_titles)
 
     puts "Parsing #{xlsx_path}"
 
-    # List of worksheets to skip
-    worksheets_to_skip = []
-    worksheets_to_skip << 'templates'
-    worksheets_to_skip << 'standards'
-    worksheets_to_skip << 'ventilation'
-    worksheets_to_skip << 'occupancy'
-    worksheets_to_skip << 'interior_lighting'
-    worksheets_to_skip << 'lookups'
-    worksheets_to_skip << 'sheetmap'
-    worksheets_to_skip << 'deer_lighting_fractions'
-    worksheets_to_skip << 'window_types_and_weights'
-
-    # List of columns to skip
-    cols_to_skip = []
-    cols_to_skip << 'lookup'
-    cols_to_skip << 'lookupcolumn'
-    cols_to_skip << 'vlookupcolumn'
-    cols_to_skip << 'osm_lighting_per_person'
-    cols_to_skip << 'osm_lighting_per_area'
-    cols_to_skip << 'lighting_per_length'
-    cols_to_skip << 'exhaust_per_unit'
-    cols_to_skip << 'exhaust_fan_power_per_area'
-    cols_to_skip << 'occupancy_standard'
-    cols_to_skip << 'occupancy_primary_space_type'
-    cols_to_skip << 'occupancy_secondary_space_type'
-
-    # List of columns that are boolean
-    # (rubyXL returns 0 or 1, will translate to true/false)
-    bool_cols = []
-    bool_cols << 'hx'
-    bool_cols << 'data_center'
-    bool_cols << 'under_8000_hours'
-    bool_cols << 'u_value_includes_interior_film_coefficient'
-    bool_cols << 'u_value_includes_exterior_film_coefficient'
-
     # Open workbook
     workbook = RubyXL::Parser.parse(xlsx_path)
 
     # Find all the template directories that match the search criteria embedded in the spreadsheet title
-    standards_dir = File.expand_path("#{__dir__}/../../lib/openstudio-standards/standards")
     dirs = spreadsheet_title.gsub('OpenStudio_Standards-', '').gsub(/\(\w*\)/, '').split('-')
     new_dirs = []
     dirs.each { |d| d == 'ALL' ? new_dirs << '*' : new_dirs << "*#{d}*" }
@@ -347,6 +379,10 @@ def export_spreadsheet_to_json(spreadsheet_titles)
     # Export each tab to a hash, where the key is the sheet name
     # and the value is an array of objects
     standards_data = {}
+    list_of_sheets = []
+    list_of_names = []
+    list_of_units = []
+    list_of_OS_okay_units = []
     workbook.worksheets.each do |worksheet|
       sheet_name = worksheet.sheet_name.snake_case
 
@@ -375,10 +411,16 @@ def export_spreadsheet_to_json(spreadsheet_titles)
         header = {}
         header["name"] = header_string.gsub(/\(.*\)/, '').strip.snake_case
         header_unit_parens = header_string.scan(/\(.*\)/)[0]
+        list_of_sheets << sheet_name
+        list_of_names << header_string.gsub(/\(.*\)/, '').strip.snake_case
         if header_unit_parens.nil?
           header["units"] = nil
+          list_of_units << nil
+          list_of_OS_okay_units << nil
         else
           header["units"] = header_unit_parens.gsub(/\(|\)/, '').strip
+          list_of_units << header_unit_parens.gsub(/\(|\)/, '').strip
+          list_of_OS_okay_units << parse_units(header_unit_parens.gsub(/\(|\)/, '').strip)
         end
         headers << header
       end
@@ -521,6 +563,13 @@ def export_spreadsheet_to_json(spreadsheet_titles)
       standards_data[sheet_name] = objs
     end
 
+
+    filename_out = spreadsheet_title.gsub(/[()]/, '')
+    # CSV.open("metadata.csv", "wb") {|csv| headers.to_a.each {|elem| csv << elem} }
+    # list_metadata = [list_of_sheets, list_of_names, list_of_units, list_of_OS_okay_units].transpose
+    list_metadata = [list_of_sheets, list_of_names, list_of_units].transpose
+    list_metadata.insert(0, ['Sheet', 'Name', 'Unit']) # [1, 2, 2.5, 3, 4]
+    File.write("data/standards/metadata_units_#{filename_out}.csv", list_metadata.map(&:to_csv).join)
     # Check for duplicate data in space_types_* sheets
     standards_data.each_pair do |sheet_name, objs|
       skip_duplicate_check = []
@@ -596,6 +645,7 @@ def export_spreadsheet_to_json(spreadsheet_titles)
         # Write out a file for each template with the objects for that template.
         templates_to_objects.each_pair do |template, objs|
           next if template == 'Any'
+          next if templates_to_skip.include?(template)
           template_dir_name = standard_directory_name_from_template(template)
           # Sort the objects
           sorted_objs = {sheet_name => objs}.sort_by_key_updated(true) {|x, y| x.to_s <=> y.to_s}

data/data/standards/metadata_units_OpenStudio_Standards-ashrae_90_1-ALL-comstockspace_types.csv

@@ -0,0 +1,236 @@
+Sheet,Name,Unit
+exterior_lighting,exterior_lighting_zone_number,
+exterior_lighting,exterior_lighting_zone_name,
+exterior_lighting,template,
+exterior_lighting,control_option,
+exterior_lighting,building_facade_and_landscape_automatic_shut_off,
+exterior_lighting,occupancy_setback_reduction,fraction
+exterior_lighting,base_site_allowance_power,W
+exterior_lighting,base_site_allowance_fraction,fraction
+exterior_lighting,parking_areas_and_drives,W/ft^2
+exterior_lighting,walkways_less_than_10ft_wide,W/ft
+exterior_lighting,walkways_10ft_wide_or_greater,W/ft^2
+exterior_lighting,stairways,W/ft^2
+exterior_lighting,pedestrian_tunnels,W/ft^2
+exterior_lighting,landscaping,W/ft^2
+exterior_lighting,main_entries,W/ft
+exterior_lighting,other_doors,W/ft
+exterior_lighting,entry_canopies,W/ft^2
+exterior_lighting,loading_docks,W/ft^2
+exterior_lighting,sales_canopies,W/ft^2
+exterior_lighting,outdoor_sales_open_areas,W/ft^2
+exterior_lighting,outdoor_sales_street_frontage_for_vehicle_sales,W/ft
+exterior_lighting,building_facades,W/ft^2
+exterior_lighting,building_facades_alt_perim,W/ft
+exterior_lighting,automated_teller_machines_per_location,W
+exterior_lighting,automated_teller_machines_per_machine,W
+exterior_lighting,entries_and_gates,W/ft^2
+exterior_lighting,loading_areas_for_emergency_vehicles,W/ft^2
+exterior_lighting,drive_through_windows_and_doors,W
+exterior_lighting,parking_near_24_hour_entrances,W
+exterior_lighting,roadway_parking,W
+exterior_lighting,notes,
+schedules,name,
+schedules,category,
+schedules,units,
+schedules,day_types,
+schedules,start_date,
+schedules,end_date,
+schedules,type,
+schedules,hr_1,
+schedules,hr_2,
+schedules,hr_3,
+schedules,hr_4,
+schedules,hr_5,
+schedules,hr_6,
+schedules,hr_7,
+schedules,hr_8,
+schedules,hr_9,
+schedules,hr_10,
+schedules,hr_11,
+schedules,hr_12,
+schedules,hr_13,
+schedules,hr_14,
+schedules,hr_15,
+schedules,hr_16,
+schedules,hr_17,
+schedules,hr_18,
+schedules,hr_19,
+schedules,hr_20,
+schedules,hr_21,
+schedules,hr_22,
+schedules,hr_23,
+schedules,hr_24,
+schedules,notes,
+space_types_lighting,template,
+space_types_lighting,building_type,
+space_types_lighting,space_type,
+space_types_lighting,lighting_standard,
+space_types_lighting,lighting_primary_space_type,
+space_types_lighting,lighting_secondary_space_type,
+space_types_lighting,lighting_per_area,W/ft^2
+space_types_lighting,lighting_per_person,W/person
+space_types_lighting,lighting_per_length,W/ft
+space_types_lighting,additional_lighting_per_area,W/ft^2
+space_types_lighting,lighting_fraction_to_return_air,
+space_types_lighting,lighting_fraction_radiant,
+space_types_lighting,lighting_fraction_visible,
+space_types_lighting,lighting_fraction_replaceable,
+space_types_lighting,lpd_fraction_linear_fluorescent,
+space_types_lighting,lpd_fraction_compact_fluorescent,
+space_types_lighting,lpd_fraction_high_bay,
+space_types_lighting,lpd_fraction_specialty_lighting,
+space_types_lighting,lpd_fraction_exit_lighting,
+space_types_lighting,lighting_schedule,
+space_types_lighting,compact_fluorescent_lighting_schedule,
+space_types_lighting,high_bay_lighting_schedule,
+space_types_lighting,specialty_lighting_schedule,
+space_types_lighting,exit_lighting_schedule,
+space_types_lighting,target_illuminance_setpoint,Lux
+space_types_lighting,psa_nongeometry_fraction,
+space_types_lighting,ssa_nongeometry_fraction,
+space_types_lighting,lookup,
+space_types_lighting,notes,
+space_types_equipment,template,
+space_types_equipment,building_type,
+space_types_equipment,space_type,
+space_types_equipment,gas_equipment_per_area,Btu/hr*ft^2
+space_types_equipment,gas_equipment_fraction_latent,
+space_types_equipment,gas_equipment_fraction_radiant,
+space_types_equipment,gas_equipment_fraction_lost,
+space_types_equipment,gas_equipment_schedule,
+space_types_equipment,electric_equipment_per_area,W/ft^2
+space_types_equipment,electric_equipment_fraction_latent,
+space_types_equipment,electric_equipment_fraction_radiant,
+space_types_equipment,electric_equipment_fraction_lost,
+space_types_equipment,electric_equipment_schedule,
+space_types_equipment,additional_electric_equipment_schedule,
+space_types_equipment,additional_gas_equipment_schedule,
+space_types_equipment,notes,
+space_types_occupancy,template,
+space_types_occupancy,building_type,
+space_types_occupancy,space_type,
+space_types_occupancy,occupancy_standard,
+space_types_occupancy,occupancy_primary_space_type,
+space_types_occupancy,occupancy_secondary_space_type,
+space_types_occupancy,occupancy_per_area,people/1000 ft^2
+space_types_occupancy,occupancy_schedule,
+space_types_occupancy,occupancy_activity_schedule,
+space_types_occupancy,is_residential,
+space_types_occupancy,lookup,
+space_types_occupancy,notes,
+space_types_ventilation,template,
+space_types_ventilation,building_type,
+space_types_ventilation,space_type,
+space_types_ventilation,ventilation_standard,
+space_types_ventilation,ventilation_primary_space_type,
+space_types_ventilation,ventilation_secondary_space_type,
+space_types_ventilation,ventilation_per_area,ft^3/min*ft^2
+space_types_ventilation,ventilation_per_person,ft^3/min*person
+space_types_ventilation,ventilation_air_changes,ach
+space_types_ventilation,minimum_total_air_changes,ach
+space_types_ventilation,lookup,
+space_types_ventilation,notes,
+space_types_infiltration,template,
+space_types_infiltration,building_type,
+space_types_infiltration,space_type,
+space_types_infiltration,infiltration_per_exterior_area,ft^3/min*ft^2 ext
+space_types_infiltration,infiltration_per_exterior_wall_area,ft^3/min*ft^2 ext
+space_types_infiltration,infiltration_air_changes,ach
+space_types_infiltration,infiltration_schedule,
+space_types_infiltration,infiltration_schedule_perimeter,
+space_types_thermostats,template,
+space_types_thermostats,building_type,
+space_types_thermostats,space_type,
+space_types_thermostats,heating_setpoint_schedule,
+space_types_thermostats,cooling_setpoint_schedule,
+space_types_swh,template,
+space_types_swh,building_type,
+space_types_swh,space_type,
+space_types_swh,service_water_heating_peak_flow_rate,gal/h
+space_types_swh,service_water_heating_area,ft^2
+space_types_swh,service_water_heating_peak_flow_per_area,gal/h*ft^2
+space_types_swh,service_water_heating_system_type,
+space_types_swh,booster_water_heater_fraction,
+space_types_swh,service_water_heating_target_temperature,F
+space_types_swh,booster_water_heating_target_temperature,F
+space_types_swh,service_water_heating_fraction_sensible,
+space_types_swh,service_water_heating_fraction_latent,
+space_types_swh,service_water_heating_schedule,
+space_types_exhaust,template,
+space_types_exhaust,building_type,
+space_types_exhaust,space_type,
+space_types_exhaust,exhaust_per_area,cfm/ft2
+space_types_exhaust,exhaust_per_unit,cfm
+space_types_exhaust,exhaust_fan_power_per_area,W/ft^2
+space_types_exhaust,exhaust_fan_efficiency,
+space_types_exhaust,exhaust_fan_power,W
+space_types_exhaust,exhaust_fan_pressure_rise,Pa
+space_types_exhaust,exhaust_fan_maximum_flow_rate,cfm
+space_types_exhaust,exhaust_availability_schedule,
+space_types_exhaust,exhaust_flow_fraction_schedule,
+space_types_exhaust,balanced_exhaust_fraction_schedule,
+space_types_rendering_color,template,
+space_types_rendering_color,building_type,
+space_types_rendering_color,space_type,
+space_types_rendering_color,rgb,
+refrigeration_system_lineup,template,
+refrigeration_system_lineup,building_type,
+refrigeration_system_lineup,size_category,
+refrigeration_system_lineup,system_type,
+refrigeration_system_lineup,number_of_display_cases,
+refrigeration_system_lineup,number_of_walkins,
+refrigeration_system_lineup,case_type_1,
+refrigeration_system_lineup,case_type_2,
+refrigeration_system_lineup,case_type_3,
+refrigeration_system_lineup,case_type_4,
+refrigeration_system_lineup,case_type_5,
+refrigeration_system_lineup,case_type_6,
+refrigeration_system_lineup,case_type_7,
+refrigeration_system_lineup,case_type_8,
+refrigeration_system_lineup,case_type_9,
+refrigeration_system_lineup,case_type_10,
+refrigeration_system_lineup,case_type_11,
+refrigeration_system_lineup,case_type_12,
+refrigeration_system_lineup,case_type_13,
+refrigeration_system_lineup,case_type_14,
+refrigeration_system_lineup,walkin_type_1,
+refrigeration_system_lineup,walkin_type_2,
+refrigeration_system_lineup,walkin_type_3,
+refrigeration_system_lineup,walkin_type_4,
+refrigeration_system_lineup,walkin_type_5,
+refrigeration_system_lineup,walkin_type_6,
+refrigeration_system_lineup,walkin_type_7,
+refrigeration_system_lineup,walkin_type_8,
+refrigeration_system_lineup,compressor_name,
+refrigerated_cases,template,
+refrigerated_cases,size_category,
+refrigerated_cases,case_type,
+refrigerated_cases,case_category,
+refrigerated_cases,case_model,
+refrigerated_cases,ft_tube_per_ft_case,
+refrigerated_cases,latent_heat_ratio,
+refrigerated_cases,rated_runtime_fraction,
+refrigerated_cases,case_length,
+refrigerated_cases,case_temp,
+refrigerated_cases,cooling_capacity_per_length,
+refrigerated_cases,evap_fan_power_per_length,
+refrigerated_cases,evap_temp,
+refrigerated_cases,lighting_per_ft,
+refrigerated_cases,fraction_of_lighting_energy_to_case,
+refrigerated_cases,latent_case_credit_curve_name,
+refrigerated_cases,defrost_power_per_length,
+refrigerated_cases,defrost_type,
+refrigerated_cases,defrost_correction_type,
+refrigerated_cases,defrost_correction_curve_name,
+refrigerated_cases,anti_sweat_power,
+refrigerated_cases,minimum_anti_sweat_heater_power_per_unit_length,
+refrigerated_cases,anti_sweat_heater_control,
+refrigerated_cases,fractionofantisweatheaterenergytocase,
+refrigerated_cases,restocking_schedule,
+refrigerated_cases,lighting_schedule,
+refrigerated_cases,minutes_defrost,
+refrigerated_cases,defrost_per_day,
+refrigerated_cases,minutes_dripdown,
+refrigerated_cases,dripdown_per_day,
+refrigerated_cases,notes,