openstudio-standards 0.2.16 → 0.2.17.rc1

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm.Surface.rb

@@ -0,0 +1,54 @@
+class ASHRAE901PRM < Standard
+  # Adjust the fenestration area to the values specified by the reduction value in a surface
+  #
+  # @param surface [OpenStudio::Model:Surface] openstudio surface object
+  # @param reduction [Float] ratio of adjustments
+  # @param model [OpenStudio::Model::Model] openstudio model
+  # @return [Bool] return true if successful, false if not
+  def surface_adjust_fenestration_in_a_surface(surface, reduction, model)
+    # do nothing for cases when reduction == 1.0
+    if reduction < 1.0
+      surface.subSurfaces.sort.each do |ss|
+        next unless ss.subSurfaceType == 'FixedWindow' || ss.subSurfaceType == 'OperableWindow' || ss.subSurfaceType == 'GlassDoor'
+
+        sub_surface_reduce_area_by_percent_by_shrinking_toward_centroid(ss, reduction)
+      end
+    elsif reduction > 1.0
+      # case increase the window
+      surface_wwr = surface_get_wwr_of_a_surface(surface)
+      if surface_wwr == 0.0
+        # In this case, we are adding fenestration
+        wwr_adjusted = reduction - 1.0
+        # add the value to additional properties in case of readjusting WWR for doors
+        surface.additionalProperties.setFeature('added_wwr', wwr_adjusted)
+      else
+        wwr_adjusted = surface_wwr * reduction
+      end
+      # Save doors to a temp list
+      door_list = []
+      surface.subSurfaces.sort.each do |sub|
+        if sub.subSurfaceType == 'Door'
+          door = {}
+          door['name'] = sub.name.get
+          door['vertices'] = sub.vertices
+          door['construction'] = sub.construction.get
+          door_list << door
+        end
+      end
+      # remove all existing windows and set the window to wall ratio to the calculated new WWR
+      # Remove all sub-surfaces including doors
+      surface.subSurfaces.sort.each(&:remove)
+      # Apply default construction to the subsurface - the standard construction will be applied later.
+      surface.setWindowToWallRatio(wwr_adjusted, 0.6, true)
+      # add door back.
+      unless door_list.empty?
+        door_list.each do |door|
+          os_door = OpenStudio::Model::SubSurface.new(door['vertices'], model)
+          os_door.setName(door['name'])
+          os_door.setConstruction(door['construction'])
+          os_door.setSurface(surface)
+        end
+      end
+    end
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm.ThermalZone.rb

@@ -0,0 +1,168 @@
+class ASHRAE901PRM < Standard
+  # @!group ThermalZone
+
+  # Determine the fan power limitation pressure drop adjustment
+  # Per Table 6.5.3.1-2 (90.1-2019)
+  #
+  # @param thermal_zone
+  def thermal_zone_get_fan_power_limitations(thermal_zone, is_energy_recovery_required)
+    fan_pwr_adjustment_in_wc = 0
+    # Get autosized zone design supply air flow rate
+    dsn_zone_air_flow_m3_per_s = thermal_zone.designAirFlowRate.to_f
+    dsn_zone_air_flow_cfm = OpenStudio.convert(dsn_zone_air_flow_m3_per_s, 'm^3/s', 'cfm').get
+
+    # Retrieve credits from zone additional features
+    # Fully ducted return and/or exhaust air systems
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_fully_ducted')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_fully_ducted').to_f
+      adj_in_wc = 0.5 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for fully ducted return and/or exhaust air systems")
+    end
+
+    # Return and/or exhaust airflow control devices
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_return_or_exhaust_flow_control')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_return_or_exhaust_flow_control').to_f
+      adj_in_wc = 0.5 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for return and/or exhaust airflow control devices")
+    end
+
+    # Exhaust filters, scrubbers, or other exhaust treatment
+    if thermal_zone.additionalProperties.hasFeature('fan_power_credit_exhaust_treatment')
+      adj_in_wc = thermal_zone.additionalProperties.getFeatureAsDouble('fan_power_credit_exhaust_treatment').to_f
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for exhaust filters, scrubbers, or other exhaust treatment")
+    end
+
+    # MERV 9 through 12
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_filtration_m9to12')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_filtration_m9to12').to_f
+      adj_in_wc = 0.5 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for particulate Filtration Credit: MERV 9 through 12")
+    end
+
+    # MERV 13 through 15
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_filtration_m13to15')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_filtration_m13to15').to_f
+      adj_in_wc = 0.9 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for particulate Filtration Credit: MERV 13 through 15")
+    end
+
+    # MERV 16 and greater and electronically enhanced filters
+    if thermal_zone.additionalProperties.hasFeature('clean_filter_pressure_drop_for_fan_power_credit_filtration_m16plus')
+      adj_in_wc = thermal_zone.additionalProperties.getFeatureAsDouble('clean_filter_pressure_drop_for_fan_power_credit_filtration_m16plus').to_f
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for particulate Filtration Credit: MERV 16 and greater and electronically enhanced filters")
+    end
+
+    # Carbon and other gas-phase air cleaners
+    if thermal_zone.additionalProperties.hasFeature('fan_power_credit_gas_phase_cleaners')
+      adj_in_wc = thermal_zone.additionalProperties.getFeatureAsDouble('fan_power_credit_gas_phase_cleaners').to_f
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for carbon and other gas-phase air cleaners")
+    end
+
+    # Biosafety cabinet
+    if thermal_zone.additionalProperties.hasFeature('fan_power_credit_biosafety')
+      adj_in_wc = thermal_zone.additionalProperties.getFeatureAsDouble('fan_power_credit_biosafety').to_f
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for biosafety cabinet")
+    end
+
+    # Energy recovery device, other than coil runaround loop
+    if thermal_zone.additionalProperties.hasFeature('fan_power_credit_other_than_coil_runaround')
+      if is_energy_recovery_required
+        adj_in_wc = thermal_zone.additionalProperties.getFeatureAsDouble('fan_power_credit_other_than_coil_runaround').to_f
+        fan_pwr_adjustment_in_wc += adj_in_wc
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for energy recovery device other than coil runaround loop")
+      end
+    end
+
+    # Coil runaround loop
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_coil_runaround')
+      if is_energy_recovery_required
+        mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_coil_runaround').to_f
+        adj_in_wc = 0.6 * 2 * mult # for each stream
+        fan_pwr_adjustment_in_wc += adj_in_wc
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for coil runaround loop")
+      end
+    end
+
+    # Evaporative humidifier/cooler in series with another cooling coil
+    if thermal_zone.additionalProperties.hasFeature('fan_power_credit_evaporative_humidifier_or_cooler')
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', '--Added 0 in wc for evaporative humidifier/cooler in series with another coil as per Table G3.1.2.9 Note 2')
+    end
+
+    # Sound attenuation section (fans serving spoaces with design background noise goals below NC35)
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_sound_attenuation')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_sound_attenuation').to_f
+      adj_in_wc = 0.15 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for sound attenuation section")
+    end
+
+    # Exhaust system serving fume hoods
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_exhaust_serving_fume_hoods')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_exhaust_serving_fume_hoods').to_f
+      adj_in_wc = 0.35 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for exhaust system serving fume hoods")
+    end
+
+    # Laboratory and vivarium exhaust systems in high-rise buildings
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_credit_lab_or_vivarium_highrise_vertical_duct')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_credit_lab_or_vivarium_highrise_vertical_duct').to_f
+      adj_in_wc = 0.35 * mult
+      fan_pwr_adjustment_in_wc += adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Added #{adj_in_wc} in wc for laboratory and vivarium exhaust systems in high-rise buildings")
+    end
+
+    # Deductions
+    # Systems without central cooling device
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_deduction_system_without_central_cooling_device')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_deduction_system_without_central_cooling_device').to_f
+      adj_in_wc = 0.60 * mult
+      fan_pwr_adjustment_in_wc -= adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Removed #{adj_in_wc} in wc for system without central cooling device")
+    end
+
+    # Systems without central heating device
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_deduction_system_without_central_heating_device')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_deduction_system_without_central_heating_device').to_f
+      adj_in_wc = 0.30 * mult
+      fan_pwr_adjustment_in_wc -= adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Removed #{adj_in_wc} in wc for system without central heating device")
+    end
+
+    # Systems with central electric resistance heat
+    if thermal_zone.additionalProperties.hasFeature('has_fan_power_deduction_system_with_central_electric_resistance_heat')
+      mult = thermal_zone.additionalProperties.getFeatureAsDouble('has_fan_power_deduction_system_with_central_electric_resistance_heat').to_f
+      adj_in_wc = 0.20 * mult
+      fan_pwr_adjustment_in_wc -= adj_in_wc
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.AirLoopHVAC', "--Removed #{adj_in_wc} in wc for system with central electric resistance heat")
+    end
+
+    # Convert the pressure drop adjustment to brake horsepower (bhp)
+    # assuming that all supply air passes through all devices
+    return fan_pwr_adjustment_in_wc * dsn_zone_air_flow_cfm / 4131
+  end
+
+  # Identify if zone has district energy for occ_and_fuel_type method
+  # @param themal_zone
+  # @return [string] with applicable DistrictHeating and/or DistrictCooling
+  def thermal_zone_get_zone_fuels_for_occ_and_fuel_type(zone)
+    zone_fuels = ''
+    htg_fuels = zone.heating_fuels
+    if htg_fuels.include?('DistrictHeating')
+      zone_fuels = 'DistrictHeating'
+    end
+    clg_fuels = zone.cooling_fuels
+    if clg_fuels.include?('DistrictCooling')
+      zone_fuels += 'DistrictCooling'
+    end
+    return zone_fuels
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm.ZoneHVACComponent.rb

@@ -0,0 +1,132 @@
+class ASHRAE901PRM < Standard
+  # @!group ZoneHVACComponent
+
+  # Sets the fan power of zone level HVAC equipment
+  # (Fan coils, Unit Heaters, PTACs, PTHPs, VRF Terminals, WSHPs, ERVs)
+  # based on the W/cfm specified in the standard.
+  #
+  # @return [Bool] returns true if successful, false if not
+  def zone_hvac_component_apply_prm_baseline_fan_power(zone_hvac_component)
+    OpenStudio.logFree(OpenStudio::Debug, 'openstudio.ashrae_90_1_prm.ZoneHVACComponent', "Setting fan power for #{zone_hvac_component.name}.")
+
+    # Convert this to the actual class type
+    zone_hvac = if zone_hvac_component.to_ZoneHVACFourPipeFanCoil.is_initialized
+                  zone_hvac_component.to_ZoneHVACFourPipeFanCoil.get
+                elsif zone_hvac_component.to_ZoneHVACUnitHeater.is_initialized
+                  zone_hvac_component.to_ZoneHVACUnitHeater.get
+                elsif zone_hvac_component.to_ZoneHVACPackagedTerminalAirConditioner.is_initialized
+                  zone_hvac_component.to_ZoneHVACPackagedTerminalAirConditioner.get
+                elsif zone_hvac_component.to_ZoneHVACPackagedTerminalHeatPump.is_initialized
+                  zone_hvac_component.to_ZoneHVACPackagedTerminalHeatPump.get
+                elsif zone_hvac_component.to_ZoneHVACTerminalUnitVariableRefrigerantFlow.is_initialized
+                  zone_hvac_component.to_ZoneHVACTerminalUnitVariableRefrigerantFlow.get
+                elsif zone_hvac_component.to_ZoneHVACWaterToAirHeatPump.is_initialized
+                  zone_hvac_component.to_ZoneHVACWaterToAirHeatPump.get
+                elsif zone_hvac_component.to_ZoneHVACEnergyRecoveryVentilator.is_initialized
+                  zone_hvac_component.to_ZoneHVACEnergyRecoveryVentilator.get
+                end
+
+    # Do nothing for other types of zone HVAC equipment
+    return false if zone_hvac.nil?
+
+    # Do nothing if zone hav component isn't assigned to thermal zone
+    return false unless zone_hvac.thermalZone.is_initialized
+
+    # Get baseline system type
+    system_type = zone_hvac.thermalZone.get.additionalProperties.getFeatureAsString('baseline_system_type').get
+
+    # Get non-mechanically cooled flag
+    if zone_hvac.thermalZone.get.additionalProperties.hasFeature('non_mechanically_cooled')
+      nmc_flag = zone_hvac.thermalZone.get.additionalProperties.hasFeature('non_mechanically_cooled')
+    else nmc_flag = false
+    end
+
+    # Get the fan
+    fan = if zone_hvac.supplyAirFan.to_FanConstantVolume.is_initialized
+            zone_hvac.supplyAirFan.to_FanConstantVolume.get
+          elsif zone_hvac.supplyAirFan.to_FanVariableVolume.is_initialized
+            zone_hvac.supplyAirFan.to_FanVariableVolume.get
+          elsif zone_hvac.supplyAirFan.to_FanOnOff.is_initialized
+            zone_hvac.supplyAirFan.to_FanOnOff.get
+          elsif zone_hvac.supplyAirFan.to_FanSystemModel.is_initialized
+            zone_hvac.supplyAirFan.to_FanSystemModel.get
+    end
+
+    if system_type == 'SZ_CV' # System 12, 13
+      # Get design supply air flow rate (whether autosized or hard-sized)
+      dsn_air_flow_m3_per_s = 0
+      dsn_air_flow_cfm = 0
+      if fan.isMaximumFlowRateAutosized
+        dsn_air_flow_m3_per_s = fan.autosizedMaximumFlowRate.get
+      else
+        dsn_air_flow_m3_per_s = fan.maximumFlowRate.get
+      end
+      dsn_air_flow_cfm = OpenStudio.convert(dsn_air_flow_m3_per_s, 'm^3/s', 'cfm').get
+
+      # Determine allowable fan BHP and power
+      allowable_fan_bhp = 0.00094 * dsn_air_flow_cfm + thermal_zone_get_fan_power_limitations(zone_hvac.thermalZone.get, false)
+      fan_apply_standard_minimum_motor_efficiency(fan, allowable_fan_bhp)
+      allowable_power_w = allowable_fan_bhp * 746 / fan.motorEfficiency
+
+      # Modify fan pressure rise to match target fan power
+      fan_adjust_pressure_rise_to_meet_fan_power(fan, allowable_power_w)
+    else # System 1, 2
+      # Determine the W/cfm
+      fan_efficacy_w_per_cfm = 0.0
+      case system_type
+      when 'PTAC', 'PTHP'
+        fan_efficacy_w_per_cfm = 0.3 # System 9, 10
+      when 'Gas_Furnace', 'Electric_Furnace'
+        # Zone heater cannot provide cooling
+        if nmc_flag & !zone_hvac_component.to_ZoneHVACUnitHeater.is_initialized
+          fan_efficacy_w_per_cfm = 0.054
+        else
+          fan_efficacy_w_per_cfm = 0.3
+        end
+      else OpenStudio.logFree(OpenStudio::Error, 'openstudio.ashrae_90_1_prm.ZoneHVACComponent', 'Zone HVAC system fan power lookup missing.')
+      end
+
+      # Convert efficacy to metric
+      fan_efficacy_w_per_m3_per_s = OpenStudio.convert(fan_efficacy_w_per_cfm, 'm^3/s', 'cfm').get
+
+      # Get the maximum flow rate through the fan
+      max_air_flow_rate = nil
+      if fan.autosizedMaximumFlowRate.is_initialized
+        max_air_flow_rate = fan.autosizedMaximumFlowRate.get
+      elsif fan.maximumFlowRate.is_initialized
+        max_air_flow_rate = fan.maximumFlowRate.get
+      end
+      max_air_flow_rate_cfm = OpenStudio.convert(max_air_flow_rate, 'm^3/s', 'ft^3/min').get
+
+      # Set the impeller efficiency
+      fan_change_impeller_efficiency(fan, fan_baseline_impeller_efficiency(fan))
+
+      # Get fan BHP
+      fan_bhp = fan_brake_horsepower(fan)
+
+      # Set the motor efficiency, preserving the impeller efficiency.
+      # For zone HVAC fans, a bhp lookup of 0.5bhp is always used because
+      # they are assumed to represent a series of small fans in reality.
+      fan_apply_standard_minimum_motor_efficiency(fan, fan_bhp)
+
+      # Calculate a new pressure rise to hit the target W/cfm
+      fan_tot_eff = fan.fanEfficiency
+      fan_rise_new_pa = fan_efficacy_w_per_m3_per_s * fan_tot_eff
+      fan.setPressureRise(fan_rise_new_pa)
+
+      # Calculate the newly set efficacy
+      fan_power_new_w = fan_rise_new_pa * max_air_flow_rate / fan_tot_eff
+      fan_efficacy_new_w_per_cfm = fan_power_new_w / max_air_flow_rate_cfm
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.ashrae_90_1_prm.ZoneHVACComponent', "For #{zone_hvac_component.name}: fan efficacy set to #{fan_efficacy_new_w_per_cfm.round(2)} W/cfm.")
+    end
+    return true
+  end
+
+  # Default occupancy fraction threshold for determining if the spaces served by the zone hvac are occupied
+  #
+  # @return [Double] unoccupied threshold
+  def zone_hvac_unoccupied_threshold
+    # Use 10% based on PRM-RM
+    return 0.10
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm.rb

@@ -0,0 +1,239 @@
+require 'csv'
+
+# This abstract class holds methods that many versions of ASHRAE 90.1 share.
+# If a method in this class is redefined by a subclass,
+# the implementation in the subclass is used.
+# @abstract
+class ASHRAE901PRM < Standard
+  def initialize
+    load_standards_database
+  end
+
+  def load_standards_database(data_directories = [])
+    super([__dir__] + data_directories)
+  end
+
+  # Convert user data csv files to json format and save to project folder
+  # Method will create the json_folder in the project_path
+  # @author Doug Maddox, PNNL
+  # @param user_data_folder [string] path to folder containing csv files
+  # @param project_folder [string] path to project folder
+  # @return [string] path to json files
+  def convert_userdata_csv_to_json(user_data_path, project_path)
+    # Get list of possible files from lib\openstudio-standards\standards\ashrae_90_1_prm\userdata_csv
+    stds_dir = __dir__
+    src_csv_dir = "#{stds_dir}/userdata_csv/*.csv"
+    json_objs = {}
+    Dir.glob(src_csv_dir) do |csv_full_name|
+      json_rows = []
+      csv_file_name = File.basename(csv_full_name, File.extname(csv_full_name))
+      json_objs[csv_file_name] = json_rows
+    end
+
+    # Read all valid files in user_data_folder and load into json array
+    unless user_data_path == ''
+      user_data_validation_outcome = true
+      Dir.glob("#{user_data_path}/*.csv") do |csv_full_name|
+        csv_file_name = File.basename(csv_full_name, File.extname(csv_full_name))
+        if json_objs.key?(csv_file_name)
+          # Load csv file into array of hashes
+          json_rows = CSV.foreach(csv_full_name, headers: true).map { |row| user_data_preprocessor(row) }
+          next if json_rows.empty?
+
+          # validate the user_data in json_rows
+          unless user_data_validation(csv_file_name, json_rows)
+            user_data_validation_outcome = false
+          end
+
+          # remove file extension
+          file_name = File.basename(csv_full_name, File.extname(csv_full_name))
+          json_objs[file_name] = json_rows
+        end
+      end
+      unless user_data_validation_outcome
+        terminate_prm_write_log('Error found in the user data. Check output log to see detail error messages', project_path, false)
+      end
+    end
+
+    # Make folder for json files; remove pre-existing first, if needed
+    json_path = "#{project_path}/user_data_json"
+    if !Dir.exist?(json_path)
+      Dir.mkdir(json_path)
+    else
+      FileUtils.rm_rf(json_path)
+      Dir.mkdir(json_path)
+    end
+
+    # Write all json files
+    json_objs.each do |file_name, json_rows|
+      json_obj = {}
+      json_obj[file_name] = json_rows
+      json_path_file = "#{json_path}/#{file_name}.json"
+      File.open(json_path_file, 'w:UTF-8') do |file|
+        file << JSON.pretty_generate(json_obj)
+      end
+    end
+
+    return json_path
+  end
+
+  # Load user data from project folder into standards database data structure
+  # Each user data object type is a new item in the @standards_data hash
+  # @author Doug Maddox, PNNL
+  # @param json_path [string] path to folder containing json files
+  def load_userdata_to_standards_database(json_path)
+    files = Dir.glob("#{json_path}/*.json").select { |e| File.file? e }
+    files.each do |file|
+      data = JSON.parse(File.read(file))
+      data.each_pair do |key, objs|
+        # Override the template in inherited files to match the instantiated template
+        if @standards_data[key].nil?
+          OpenStudio.logFree(OpenStudio::Debug, 'openstudio.standards.standard', "Adding #{key} from #{File.basename(file)}")
+        else
+          OpenStudio.logFree(OpenStudio::Debug, 'openstudio.standards.standard', "Overriding #{key} with #{File.basename(file)}")
+        end
+        @standards_data[key] = objs
+      end
+    end
+  end
+
+  # Perform user data preprocessing
+  # @param [CSV::ROW] row 2D array for each row.
+  def user_data_preprocessor(row)
+    new_array = []
+
+    # Strip the strings in the value
+    row.each do |sub_array|
+      new_array << sub_array.collect { |e| e ? e.strip : e }
+    end
+    # TODO: Future expansion can added to here.
+    # Convert the 2d array to hash
+    return new_array.to_h
+  end
+
+  # Perform user data validation
+
+  # @param object_name [String] name of user data csv file to check
+  # @param user_data [Hash] hash of data from user data csv file
+
+  # @return [Boolean] true if data is valid, false if error found
+  def user_data_validation(object_name, user_data)
+    # 1. Check user_spacetype and user_space LPD total % = 1.0
+    case object_name
+    when 'userdata_space', 'userdata_spacetype'
+      return check_userdata_space_and_spacetype(object_name, user_data)
+    when 'user_electric_equipment'
+      return check_userdata_electric_equipment(object_name, user_data)
+    else
+      return true
+    end
+  end
+
+  # Check for incorrect data in electric equipment user data
+
+  # @param object_name [String] name of user data csv file to check
+  # @param user_data [Hash] hash of data from user data csv file
+
+  # @return [Boolean] true if data is valid, false if error found
+  def check_userdata_electric_equipment(object_name, user_data)
+    userdata_valid = true
+    user_data.each do |electric_row|
+      if electric_row['motor_horsepower'].nil? || electric_row['motor_efficiency'].nil? || electric_row['motor_is_exempt'].nil?
+        unless electric_row['motor_horsepower'].nil? && electric_row['motor_efficiency'].nil? && electric_row['motor_is_exempt'].nil?
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: One or more motor data are not available for electric equipment #{electric_row['name']}. motor_horsepower: #{electric_row['motor_horsepower']}; motor_efficiency: #{electric_row['motor_efficiency']}; motor_is_exempt: #{electric_row['motor_is_exempt']}")
+        end
+      else
+        # check for data type
+        if electric_row['motor_horsepower'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Motor #{electric_row['name']}'s horsepower data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['motor_efficiency'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Motor #{electric_row['name']}'s efficiency data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['motor_is_exempt'].casecmp?('yes') || electric_row['motor_is_exempt'].casecmp?('no')
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Motor #{electric_row['name']} is exempt data should be either Yes or No. But get data #{electric_row['motor_is_exempt']}")
+        end
+      end
+      # We may need to do the same for refrigeration and elevator?
+      # Check elevator
+      if electric_row['elevator_weight_of_car'].nil? || electric_row['elevator_rated_load'].nil? || electric_row['elevator_counter_weight_of_car'].nil? || electric_row['elevator_speed_of_car'].nil? || electric_row['elevator_number_of_stories'].nil?
+        if electric_row['elevator_weight_of_car'].nil? && electric_row['elevator_rated_load'].nil? && electric_row['elevator_counter_weight_of_car'].nil? && electric_row['elevator_speed_of_car'].nil? && electric_row['elevator_number_of_stories'].nil?
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: One or more elevator data is not available for electric equipment #{electric_row['name']}. elevator_weight_of_car: #{electric_row['elevator_weight_of_car']}; elevator_rated_load: #{electric_row['elevator_rated_load']}; elevator_counter_weight_of_car: #{electric_row['elevator_counter_weight_of_car']}; elevator_speed_of_car: #{electric_row['elevator_speed_of_car']}; elevator_number_of_stories: #{electric_row['elevator_number_of_stories']}")
+        end
+      else
+        # check for data type
+        if electric_row['elevator_weight_of_car'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Elevator #{electric_row['name']}'s weight of car data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['elevator_rated_load'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Elevator #{electric_row['name']}'s rated load data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['elevator_counter_weight_of_car'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Elevator #{electric_row['name']}'s counter weight of car data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['elevator_speed_of_car'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Elevator #{electric_row['name']}'s speed of car data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['elevator_number_of_stories'].to_i > 1
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Elevator #{electric_row['name']}'s serves number of stories data is either smaller or equal to 1 or unavailable. Check the inputs.")
+        end
+      end
+      # Check refrigeration
+      if electric_row['refrigeration_equipment_class'].nil? || electric_row['refrigeration_equipment_volume'].nil? || electric_row['refrigeration_equipment_total_display_area'].nil?
+        if electric_row['refrigeration_equipment_class'].nil? && electric_row['refrigeration_equipment_volume'].nil? && electric_row['refrigeration_equipment_total_display_area'].nil?
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: One or more refrigeration data is not available for electric equipment #{electric_row['name']}. refrigeration_equipment_class: #{electric_row['refrigeration_equipment_class']}; refrigeration_equipment_volume: #{electric_row['refrigeration_equipment_volume']}; refrigeration_equipment_total_display_area: #{electric_row['refrigeration_equipment_total_display_area']}")
+        end
+      else
+        # Check data type
+        # The equipment class shall be verified at the implementation level
+        if electric_row['refrigeration_equipment_volume'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Refrigeration #{electric_row['name']}'s equipment volume data is either 0.0 or unavailable. Check the inputs.")
+        end
+        if electric_row['refrigeration_equipment_total_display_area'].to_f == 0.0
+          userdata_valid = false
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data: #{object_name}: Refrigeration #{electric_row['name']}'s total display area data is either 0.0 or unavailable. Check the inputs.")
+        end
+      end
+    end
+    return userdata_valid
+  end
+
+  # Check for incorrect data in space and spacetype user data
+
+  # @param object_name [String] name of user data csv file to check
+  # @param user_data [Hash] hash of data from user data csv file
+
+  # @return [Boolean] true if data is valid, false if error found
+  def check_userdata_space_and_spacetype(object_name, user_data)
+    userdata_valid = true
+    user_data.each do |lpd_row|
+      unless lpd_row['num_std_ltg_types'].to_i == 0
+        num_ltg_type = lpd_row['num_std_ltg_types'].to_i
+        total_ltg_percent = 0.0
+        std_ltg_index = 0
+        while std_ltg_index < num_ltg_type
+          frac_key = format('std_ltg_type_frac%02d', (std_ltg_index + 1))
+          total_ltg_percent += lpd_row[frac_key].to_f
+          std_ltg_index += 1
+        end
+        if (total_ltg_percent - 1.0).abs > 0.01
+          OpenStudio.logFree(OpenStudio::Error, 'User Data Error', "User data #{object_name}: The fraction of user defined lighting types in Space/SpaceType: #{lpd_row['name']} does not add up to 1.0. The calculated fraction is #{total_ltg_percent}.")
+          userdata_valid = false
+        end
+      end
+    end
+    return userdata_valid
+  end
+end