openstudio-common-measures 0.2.0 → 0.4.0

data/lib/measures/add_ev_load/LICENSE.MD.txt

@@ -0,0 +1,15 @@
+
+
+OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+(1) Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+(2) 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.
+
+(3) Neither the name of the copyright holder nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission from the respective party.
+
+(4) Other than as required in clauses (1) and (2), distributions in any form of modifications or other derivative works may not use the "OpenStudio" trademark, "OS", "os", or any other confusingly similar designation without specific prior written permission from Alliance for Sustainable Energy, LLC.
+
+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, THE UNITED STATES GOVERNMENT, OR ANY 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.

data/lib/measures/{EnableEconomizerControl → add_ev_load}/LICENSE.md

@@ -1,4 +1,4 @@
-OpenStudio(R), Copyright (c) 2008-2020, Alliance for Sustainable Energy, LLC. All rights reserved.
+OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC. All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted 
 provided that the following conditions are met:

data/lib/measures/add_ev_load/README.md

@@ -0,0 +1,34 @@
+---
+title: "ReadMe"
+author: "Amy Allen"
+date: "8/18/2020"
+output: html_document
+---
+
+```{r setup, include=FALSE}
+knitr::opts_chunk$set(echo = TRUE)
+```
+
+
+## Add EV Charging Load
+## Description
+This measure adds an electric vehicle charging load, based on the load profiles developed by Wood et al. (2018), generated to reflect several different potential scenarios for EV charging behavior. The user can configure the magnitude of the load based on the proportion of vehicles at the site that are assumed to be EVs. 
+
+## Modeler Description 
+The raw data used to generate the load profiles is saved in the "Resources" folder. The load that is added is an ExteriorFuelEquipment object. The load profiles generated by Wood et al. (2018) are based on an assumption of a 50% EV penetration rate. 
+
+## Measure Type
+ModelMeasure
+
+## Arguments
+## EV Percent
+Name: EV Percent, Type: Double, Units: Percent , Required: true, Model Dependent: false. This argument is used to scale the load profiles generated by Wood et al. (2018). If not supplied by the user, the value defaults to 1%. 
+
+## Charging Behavior 
+Name: Charging Behavior, Type: Choice (Business as Usual, Free Workplace Charging at Project Site, Free Workplace Charging Throughout Metropolitan Area), Units: None, Required: true, Model Dependent: false. Separate load profiles were generated by Wood et al. (2018) for each of these cases to reflect consumer behavior under differing availability of free EV charging. 
+
+## Charge Station Type
+Name: Charge Station Type, Type: Choice (Home, Typical Work, Typical Public), Units: None, Required: true, Model Dependent: false. This argument is used to select a subset of the profiles developed by Wood et al. (2018), which will be averaged to generate the profile for this particular building, based on its type.
+
+## Charge Delay
+Name: Charge Delay, Type: Choice (Min Delay, Max Delay, Min Power) Units: None, Required: true, Model dependent: false. This argument is used to select a subset of profiles based on those generated by Wood et al. (2018), to reflect different approaches for control of EV charging. "Min delay" refers to a scenario in which the vehicle charging begins as soon as it is plugged in, "Max delay" refers to a control strategy that seeks to have the vehicle charged by the time the driver departs, and no sooner, and "Min power" seeks to minimize the power draw associated with charging. 

data/lib/measures/add_ev_load/measure.rb

@@ -0,0 +1,331 @@
+# see the URL below for information on how to write OpenStudio measures
+# http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/
+# *******************************************************************************
+# OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC.
+# All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# (1) Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# (2) 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.
+#
+# (3) Neither the name of the copyright holder nor the names of any contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission from the respective party.
+#
+# (4) Other than as required in clauses (1) and (2), distributions in any form
+# of modifications or other derivative works may not use the "OpenStudio"
+# trademark, "OS", "os", or any other confusingly similar designation without
+# specific prior written permission from Alliance for Sustainable Energy, LLC.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY 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(S), ANY CONTRIBUTORS, THE
+# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
+# THEIR EMPLOYEES, 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 'csv'
+require 'matrix'
+# start the measure
+class AddEVLoad < OpenStudio::Measure::ModelMeasure
+  # human readable name
+  def name
+    return 'Add_EV_Load'
+  end
+
+  # human readable description
+  def description
+    return 'This measure adds a load associated with charging of electric vehicles (EVs) to a building in URBANopt. EV load profiles were generated in EVI-Pro for specific building types. This measure allows running of customized load profiles for buildings in the Pena Station Next project, and also for generating typical charging load profiles based on the location type (home, public, or office).'
+  end
+
+  # human readable description of modeling approach
+  def modeler_description
+    return 'This measure adds an EV charging load to a building model. Load profiles for EV charging were generated in EVI-Pro. Different options are available for charging control type and charging behavior.'
+  end
+
+  # Note: If a DC Fast Charger at the PSN site is the intended option, the charging behavior and control choices are ignored. Thus far, there is one load profile for a DC fast charger; not different ones for different bldgs.
+  # define the arguments that the user will input
+  def arguments(model)
+    args = OpenStudio::Measure::OSArgumentVector.new
+
+    # Make an argument for the charging flexibility options (workplace charging only).
+    charge_delay_chs = OpenStudio::StringVector.new
+    charge_delay_chs << 'Max Delay'
+    charge_delay_chs << 'Min Delay'
+    charge_delay_chs << 'Min Power'
+
+    delay_type = OpenStudio::Measure::OSArgument.makeChoiceArgument('delay_type', charge_delay_chs, true)
+    delay_type.setDisplayName('Charging Flexibility Option')
+    delay_type.setDefaultValue('Min Delay')
+    delay_type.setDescription('Represents charging flexibility scenarios applied to workplace charging. Min Delay indicates EVs begin charging immediately upon arriving at work, Max Delay indicates EVs are plugged in immediately but do not begin charging until necessary and Min Power indicates EVs are charged at minimum rate over the parking event.')
+    args << delay_type
+
+    # Make an argument for the consumer charging behavior parameter.
+    consumer_charge_chs = OpenStudio::StringVector.new
+    consumer_charge_chs << 'Business as Usual'
+    consumer_charge_chs << 'Free Workplace Charging at Project Site'
+    consumer_charge_chs << 'Free Workplace Charging Across Metro Area'
+
+    charge_behavior = OpenStudio::Measure::OSArgument.makeChoiceArgument('charge_behavior', consumer_charge_chs, true)
+    charge_behavior.setDisplayName('Consumer Charging Behavior')
+    charge_behavior.setDefaultValue('Business as Usual')
+    charge_behavior.setDescription('Describes different scenarios of EV Charging. Business as Usual represents home dominant charging behavior where the majority of the electrical energy consumed by EV charging is during evening hours and overnight. Free Workplace Charging at Project Site indicates that the peak power draw from EV charging on weekdays occurs during morning hours, due to EV charging at workplaces. Overnight residential charging remains a significant share of the total electricity use for EV charging. Free Workplace Charging Across Metro Area reduces the Home EV charging relative to the Free Workplace Charging at Project Site scenario, for people who work elsewhere and can charge their vehicles for free at those workplaces.')
+    args << charge_behavior
+
+    # Make a vector for the charging station type argument.
+    chg_station_type_chs = OpenStudio::StringVector.new
+    chg_station_type_chs << 'Typical Home'
+    chg_station_type_chs << 'Typical Public'
+    chg_station_type_chs << 'Typical Work'
+
+    # Make an argument for charging station type.
+    chg_station_type = OpenStudio::Measure::OSArgument.makeChoiceArgument('chg_station_type', chg_station_type_chs, true)
+    chg_station_type.setDisplayName('Charging Station Type')
+    chg_station_type.setDefaultValue('Typical Public')
+    args << chg_station_type
+
+    # Make an argument for the % of vehicles parked at the building that are EVs.
+    ev_percent = OpenStudio::Measure::OSArgument.makeDoubleArgument('ev_percent', true)
+    ev_percent.setDisplayName('Percent of Vehicles Parked at Building That Are EVs')
+    ev_percent.setDefaultValue(1.0)
+    ev_percent.setDescription('Denotes percentage of vehicles between 0 to 100 that are electric on site.')
+    args << ev_percent
+
+    return args
+  end
+
+  # define what happens when the measure is run
+  def run(model, runner, user_arguments)
+    super(model, runner, user_arguments)
+
+    # Assign the user arguments to variables.
+    delay_type = runner.getStringArgumentValue('delay_type', user_arguments)
+    charge_behavior = runner.getStringArgumentValue('charge_behavior', user_arguments)
+    chg_station_type = runner.getStringArgumentValue('chg_station_type', user_arguments)
+    ev_percent = runner.getDoubleArgumentValue('ev_percent', user_arguments)
+
+    # use the built-in error checking
+    if !runner.validateUserArguments(arguments(model), user_arguments)
+      return false
+    end
+
+    if ev_percent < 0 || ev_percent > 100
+      runner.registerError('Percent of vehicles on site that are electric is outside of acceptable bounds. Please choose a value between 0 and 100.')
+      return false
+    end
+
+    # Set file name based on arguments selected and then choose the DOW within schedule selection.
+    # Set key based on user-selected charging behavior.
+    if charge_behavior == 'Business as Usual'
+      charge_key = 1
+      runner.registerInfo("charge key = #{charge_key}")
+    elsif charge_behavior == 'Free Workplace Charging at Project Site'
+      charge_key = 2
+      runner.registerInfo("charge key = #{charge_key}")
+    else
+      charge_key = 3
+      runner.registerInfo("charge key = #{charge_key}")
+    end
+
+    # Set key based on user-selected charging flexibility.
+    if delay_type == 'Min Delay'
+      flex_key = 1
+      runner.registerInfo("flex key = #{flex_key}")
+    elsif delay_type == 'Max Delay'
+      flex_key = 2
+      runner.registerInfo("flex key = #{flex_key}")
+    else
+      flex_key = 3
+      runner.registerInfo("flex key = #{flex_key}")
+    end
+
+    file_path = "#{__dir__}/resources/"
+
+    # Sets key based on charging station type, for general charging load profiles. Will use this to average columns appropriately.
+    if chg_station_type == 'Typical Home'
+      chg_station_key = 1
+      runner.registerInfo("charge station key = #{chg_station_key}")
+    elsif chg_station_type == 'Typical Work'
+      chg_station_key = 2
+      runner.registerInfo("charge station key = #{chg_station_key}")
+    elsif chg_station_type == 'Typical Public'
+      chg_station_key = 3
+      runner.registerInfo("charge station key = #{chg_station_key}")
+    end
+
+    # Creating a schedule:ruleset
+    ev_sch = OpenStudio::Model::ScheduleRuleset.new(model)
+    ev_sch.setName('EV Charging Power Draw')
+
+    # Create a schedule:ruleset for DC fast charging.
+    ev_sch_fast = OpenStudio::Model::ScheduleRuleset.new(model)
+    ev_sch_fast.setName('EV DC Fast Charging Power Draw')
+
+    # Create arrays of desired values
+    public_indices = [0, 1, 2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 52, 53, 54, 57, 58, 60, 61, 62, 63, 64, 65, 81, 99, 100, 102]
+    work_indices = [7, 19, 20, 27, 28, 29, 30, 31, 32, 36, 37, 42, 43, 44, 46, 50, 51, 55, 69, 70, 71, 86, 88, 91, 92, 93]
+    home_indices = [15, 16, 17, 18, 21, 22, 23, 24, 25, 26, 33, 34, 35, 38, 39, 40, 41, 45, 47, 48, 49, 56, 59, 66, 67, 68, 72, 73, 74, 75, 76, 77, 78, 79, 80, 82, 83, 84, 85, 85, 87, 89, 90, 94, 95, 96, 97, 98, 101]
+
+    # The load profiles referenced were generated based on an assumption of 50% of passenger vehicles being EVs.
+    assumed_percent = 50
+
+    # Read in the three necessary files, for the typical PSN case (all PSN bldgs, including fast chargers).
+    # Read in wkday load profiles.
+    dow_key = 1
+    file_name = "chg#{charge_key}_dow#{dow_key}_flex#{flex_key}.csv"
+    wkday_load = CSV.read("#{file_path}/#{file_name}", headers: false, converters: :all)
+    wkday_load = wkday_load.to_a # Convert to an array.
+    wkday_load = wkday_load.transpose
+    # Read in Saturday load profiles.
+    dow_key = 2
+    file_name = "chg#{charge_key}_dow#{dow_key}_flex#{flex_key}.csv"
+    sat_load = CSV.read("#{file_path}/#{file_name}", headers: false, converters: :all)
+    sat_load = sat_load.to_a # Convert to an array.
+    sat_load = sat_load.transpose
+    # Read in Sunday load profiles.
+    dow_key = 3
+    file_name = "chg#{charge_key}_dow#{dow_key}_flex#{flex_key}.csv"
+    sun_load = CSV.read("#{file_path}/#{file_name}", headers: false, converters: :all)
+    sun_load = sun_load.to_a # Convert to an array.
+    sun_load = sun_load.transpose
+
+    # For non-PSN analysis, select which load profile is needed based on the charging station key.
+
+    if chg_station_key == 1
+      indices = home_indices
+    elsif chg_station_key == 2
+      indices = work_indices
+    elsif chg_station_key == 3
+      indices = public_indices
+    end
+
+    # Popualte the average weekday load for non PSN case. The load profiles used in this case are averaged based on the selected charging station type,(given the selected charging flexibility option and charging behavior option), and scaled for the percent of vehicles that are EVs.
+    if chg_station_type != 'Pena Station Next Analysis' && chg_station_type != 'Pena Station Next Analysis--DC Fast Charger'
+      wkday_load_sel = wkday_load.values_at(*indices)
+      avg_load_wkday = []
+      wkday_load_sel = wkday_load_sel.transpose
+      for i in 0..wkday_load[0].length - 1
+        avg_load_wkday[i] = (wkday_load_sel[i].reduce(0, :+) / wkday_load_sel[i].length) * ev_percent / assumed_percent # Scale profiles generated from 50% EV scenario by % of vehicles that are EVs.
+      end
+
+      wkday_max_load = avg_load_wkday.max
+
+      # Populate the average Saturday load.
+      sat_load_sel = sat_load.values_at(*indices)
+      avg_load_sat = []
+      sat_load_sel = sat_load_sel.transpose
+      for i in 0..sat_load[0].length - 1
+        avg_load_sat[i] = (sat_load_sel[i].reduce(0, :+) / sat_load_sel[i].length) * ev_percent / assumed_percent # Scale profiles generated from 50% EV scenario by % of vehicles that are EVs.
+      end
+
+      sat_max_load = avg_load_sat.max
+
+      # Populate the average Sunday load.
+      sun_load_sel = sun_load.values_at(*indices)
+      avg_load_sun = []
+      sun_load_sel = sun_load_sel.transpose
+      for i in 0..sun_load[0].length - 1
+        avg_load_sun[i] = (sun_load_sel[i].reduce(0, :+) / sun_load_sel[i].length) * ev_percent / assumed_percent # Scale profiles generated from 50% EV scenario by % of vehicles that are EVs.
+      end
+
+      sun_max_load = avg_load_sun.max
+
+      # Calculate the overall maximum load
+      max_load = [wkday_max_load, sat_max_load, sun_max_load].max
+
+      # Normalize each load profile based on the overall maximum load.
+
+      avg_load_wkday_norm = avg_load_wkday.map { |value| value / max_load }
+      avg_load_sat_norm = avg_load_sat.map { |value| value / max_load }
+      avg_load_sun_norm = avg_load_sun.map { |value| value / max_load }
+
+    end
+
+    # Create schedules for regular EV charging.
+    # Uses Sunday schedule for winter design day.
+    if chg_station_type != 'Pena Station Next Analysis--DC Fast Charger'
+      ev_sch_winter = OpenStudio::Model::ScheduleDay.new(model)
+      ev_sch.setWinterDesignDaySchedule(ev_sch_winter)
+      ev_sch.winterDesignDaySchedule.setName('EV Charging Winter Design Day')
+      # Loop through all the values and add to schedule
+      avg_load_sun_norm.each_with_index do |value, i| # Reading in the data from the array created from the csv file, with the values normalized to maximum power draw.
+        time = OpenStudio::Time.new(0, 0, (i + 1) * 15, 0) # OpenStudio::Time.new(day,hr of day, minute of hr, seconds of hr?)
+        ev_sch.winterDesignDaySchedule.addValue(time, value)
+      end
+      runner.registerInfo(" WDD schedule = #{avg_load_wkday_norm}")
+      # ...repeat for all 24 hrs (or whatever granularity)
+
+      # Summer design day. Uses weekday schedule for summer design day.
+      ev_sch_summer = OpenStudio::Model::ScheduleDay.new(model)
+      ev_sch.setSummerDesignDaySchedule(ev_sch_summer)
+      ev_sch.summerDesignDaySchedule.setName('EV Charging Summer Design Day')
+      # Loop through all the values and add to schedule
+      avg_load_wkday_norm.each_with_index do |value, i|
+        time = OpenStudio::Time.new(0, 0, (i + 1) * 15, 0) # OpenStudio::Time.new(day,hr of day, minute of hr, seconds of hr?)
+        ev_sch.summerDesignDaySchedule.addValue(time, value)
+      end
+
+      # Default day (use this for weekdays)
+      ev_sch.defaultDaySchedule.setName('EV Charging Default')
+      # Loop through all the values and add to schedule
+      avg_load_wkday_norm.each_with_index do |value, i|
+        time = OpenStudio::Time.new(0, 0, (i + 1) * 15, 0) # OpenStudio::Time.new(day,hr of day, minute of hr, seconds of hr?)
+        ev_sch.defaultDaySchedule.addValue(time, value)
+      end
+
+      # Saturday
+      ev_sch_sat_rule = OpenStudio::Model::ScheduleRule.new(ev_sch)
+      ev_sch_sat_rule.setName('ev_sch_sat_rule')
+      ev_sch_sat_rule.setApplySaturday(true)
+      ev_sch_sat = ev_sch_sat_rule.daySchedule
+      ev_sch_sat.setName('EV Charging Sat')
+      # Loop through all the values and add to schedule
+      avg_load_sat_norm.each_with_index do |value, i|
+        time = OpenStudio::Time.new(0, 0, (i + 1) * 15, 0) # OpenStudio::Time.new(day,hr of day, minute of hr, seconds of hr?)
+        ev_sch_sat.addValue(time, value)
+      end
+
+      # Sunday
+      ev_sch_sun_rule = OpenStudio::Model::ScheduleRule.new(ev_sch)
+      ev_sch_sun_rule.setName('ev_sch_sun_rule')
+      ev_sch_sun_rule.setApplySunday(true)
+      ev_sch_sun = ev_sch_sun_rule.daySchedule
+      ev_sch_sun.setName('EV Charging Sun')
+      # Loop through all the values and add to schedule
+      avg_load_sun_norm.each_with_index do |value, i|
+        time = OpenStudio::Time.new(0, 0, (i + 1) * 15, 0)
+        ev_sch_sun.addValue(time, value)
+      end
+    end
+
+    if chg_station_type != 'Pena Station Next Analysis--DC Fast Charger'
+
+      # Adding an EV charger definition and instance for the regular EV charging.
+      ev_charger_def = OpenStudio::Model::ExteriorFuelEquipmentDefinition.new(model)
+      ev_charger_level = max_load * 1000 # Converting from kW to watts
+      ev_charger_def.setName("#{ev_charger_level} w EV Charging Definition")
+      ev_charger_def.setDesignLevel(ev_charger_level)
+
+      # creating EV charger object for the regular EV charging.
+      ev_charger = OpenStudio::Model::ExteriorFuelEquipment.new(ev_charger_def, ev_sch)
+      ev_charger.setName("#{ev_charger_level} w EV Charger")
+      ev_charger.setFuelType('Electricity')
+      ev_charger.setEndUseSubcategory('Electric Vehicles')
+      runner.registerInfo("multiplier (kW) = #{max_load}}")
+    end
+    return true
+  end
+end
+# register the measure to be used by the application
+AddEVLoad.new.registerWithApplication

data/lib/measures/add_ev_load/measure.xml

@@ -0,0 +1,348 @@
+<?xml version="1.0"?>
+<measure>
+  <schema_version>3.0</schema_version>
+  <name>add_ev_load</name>
+  <uid>a23e0493-7357-48ca-b089-4d902efd6b50</uid>
+  <version_id>90476d7d-d880-4ce4-ada0-5dad10a82954</version_id>
+  <version_modified>20210406T224047Z</version_modified>
+  <xml_checksum>9A202986</xml_checksum>
+  <class_name>AddEVLoad</class_name>
+  <display_name>Add_EV_Load</display_name>
+  <description>This measure adds a load associated with charging of electric vehicles (EVs) to a building in URBANopt. EV load profiles were generated in EVI-Pro for specific building types. This measure allows running of customized load profiles for buildings in the Pena Station Next project, and also for generating typical charging load profiles based on the location type (home, public, or office).</description>
+  <modeler_description>This measure adds an EV charging load to a building model. Load profiles for EV charging were generated in EVI-Pro. Different options are available for charging control type and charging behavior.</modeler_description>
+  <arguments>
+    <argument>
+      <name>delay_type</name>
+      <display_name>Charging Flexibility Option</display_name>
+      <description>Represents charging flexibility scenarios applied to workplace charging. Min Delay indicates EVs begin charging immediately upon arriving at work, Max Delay indicates EVs are plugged in immediately but do not begin charging until necessary and Min Power indicates EVs are charged at minimum rate over the parking event.</description>
+      <type>Choice</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>Min Delay</default_value>
+      <choices>
+        <choice>
+          <value>Max Delay</value>
+          <display_name>Max Delay</display_name>
+        </choice>
+        <choice>
+          <value>Min Delay</value>
+          <display_name>Min Delay</display_name>
+        </choice>
+        <choice>
+          <value>Min Power</value>
+          <display_name>Min Power</display_name>
+        </choice>
+      </choices>
+    </argument>
+    <argument>
+      <name>charge_behavior</name>
+      <display_name>Consumer Charging Behavior</display_name>
+      <description>Describes different scenarios of EV Charging. Business as Usual represents home dominant charging behavior where the majority of the electrical energy consumed by EV charging is during evening hours and overnight. Free Workplace Charging at Project Site indicates that the peak power draw from EV charging on weekdays occurs during morning hours, due to EV charging at workplaces. Overnight residential charging remains a significant share of the total electricity use for EV charging. Free Workplace Charging Across Metro Area reduces the Home EV charging relative to the Free Workplace Charging at Project Site scenario, for people who work elsewhere and can charge their vehicles for free at those workplaces.</description>
+      <type>Choice</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>Business as Usual</default_value>
+      <choices>
+        <choice>
+          <value>Business as Usual</value>
+          <display_name>Business as Usual</display_name>
+        </choice>
+        <choice>
+          <value>Free Workplace Charging at Project Site</value>
+          <display_name>Free Workplace Charging at Project Site</display_name>
+        </choice>
+        <choice>
+          <value>Free Workplace Charging Across Metro Area</value>
+          <display_name>Free Workplace Charging Across Metro Area</display_name>
+        </choice>
+      </choices>
+    </argument>
+    <argument>
+      <name>chg_station_type</name>
+      <display_name>Charging Station Type</display_name>
+      <type>Choice</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>Typical Public</default_value>
+      <choices>
+        <choice>
+          <value>Typical Home</value>
+          <display_name>Typical Home</display_name>
+        </choice>
+        <choice>
+          <value>Typical Public</value>
+          <display_name>Typical Public</display_name>
+        </choice>
+        <choice>
+          <value>Typical Work</value>
+          <display_name>Typical Work</display_name>
+        </choice>
+      </choices>
+    </argument>
+    <argument>
+      <name>ev_percent</name>
+      <display_name>Percent of Vehicles Parked at Building That Are EVs</display_name>
+      <description>Denotes percentage of vehicles between 0 to 100 that are electric on site.</description>
+      <type>Double</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>1</default_value>
+    </argument>
+  </arguments>
+  <outputs />
+  <provenances />
+  <tags>
+    <tag>Equipment.Electric Equipment</tag>
+  </tags>
+  <attributes>
+    <attribute>
+      <name>Measure Type</name>
+      <value>ModelMeasure</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Apply Measure Now</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>OpenStudio Application</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Parametric Analysis Tool</value>
+      <datatype>string</datatype>
+    </attribute>
+  </attributes>
+  <files>
+    <file>
+      <filename>example_model.osm</filename>
+      <filetype>osm</filetype>
+      <usage_type>test</usage_type>
+      <checksum>E925F127</checksum>
+    </file>
+    <file>
+      <filename>README.md</filename>
+      <filetype>md</filetype>
+      <usage_type>readme</usage_type>
+      <checksum>2293F4B3</checksum>
+    </file>
+    <file>
+      <filename>LICENSE.md</filename>
+      <filetype>md</filetype>
+      <usage_type>license</usage_type>
+      <checksum>A21A3ED2</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow1_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>E4226271</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow1_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>095F9B11</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow1_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>281396E7</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow2_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>A8ADE89D</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow2_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>652B2384</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow2_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>E8B3CD2E</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow3_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>1F70FC21</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow3_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>0DDD87E6</checksum>
+    </file>
+    <file>
+      <filename>chg1_dow3_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>84CDFFBD</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow1_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>A306400A</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow1_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>AFB3651D</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow1_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>21A2185D</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow2_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>27A849F5</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow2_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>32FB80C2</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow2_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>AE95D12E</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow3_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>FAB49B7C</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow3_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>16D26DC4</checksum>
+    </file>
+    <file>
+      <filename>chg2_dow3_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>8D4C6E34</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow1_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>6FBBFD27</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow1_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>CDF99F52</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow1_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>A91801BC</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow2_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>6F8774B1</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow2_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>BF7C5780</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow2_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>FC3473AB</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow3_flex1.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>970B9AC7</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow3_flex2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>A5B5B479</checksum>
+    </file>
+    <file>
+      <filename>chg3_dow3_flex3.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>429C9B64</checksum>
+    </file>
+    <file>
+      <filename>fast_charge_15min_Saturday.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>6813FABB</checksum>
+    </file>
+    <file>
+      <filename>fast_charge_15min_Sunday.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>A604B427</checksum>
+    </file>
+    <file>
+      <filename>fast_charge_15min_Weekday.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>114F9EA1</checksum>
+    </file>
+    <file>
+      <filename>PSN_BuildingKey.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>153D4BBA</checksum>
+    </file>
+    <file>
+      <filename>PSN_BuildingKey_v2.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>1000C8E8</checksum>
+    </file>
+    <file>
+      <filename>add_ev_load_test.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>test</usage_type>
+      <checksum>5E255354</checksum>
+    </file>
+    <file>
+      <version>
+        <software_program>OpenStudio</software_program>
+        <identifier>2.5.1</identifier>
+        <min_compatible>2.5.1</min_compatible>
+      </version>
+      <filename>measure.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>script</usage_type>
+      <checksum>93A1C055</checksum>
+    </file>
+  </files>
+</measure>