Electric Vehicles

.github/workflows/config.yml

@@ -162,7 +162,7 @@ jobs:
 
       - name: Run buildstockbatch
         run: |
-          pip install git+https://github.com/NREL/buildstockbatch.git@develop
+          pip install git+https://github.com/NREL/buildstockbatch.git@ev_output
 
           buildstock_local project_national/national_baseline.yml
           buildstock_local project_testing/testing_baseline.yml

docs/technical_development_guide/source/workflow_outputs/csv_tables/characteristics.csv

@@ -39,7 +39,6 @@ build_existing_model.doors,:ref:`doors`
 build_existing_model.duct_leakage_and_insulation,:ref:`duct_leakage_and_insulation`
 build_existing_model.duct_location,:ref:`duct_location`
 build_existing_model.eaves,:ref:`eaves`
-build_existing_model.electric_vehicle,:ref:`electric_vehicle`
 build_existing_model.energystar_climate_zone_2023,:ref:`energystar_climate_zone_2023`
 build_existing_model.federal_poverty_level,:ref:`federal_poverty_level`
 build_existing_model.generation_and_emissions_assessment_region,:ref:`generation_and_emissions_assessment_region`

docs/technical_development_guide/source/workflow_outputs/csv_tables/other_outputs.csv

@@ -1,4 +1,10 @@
 Input Name,Input Description
+build_existing_model.electric_vehicle_battery, The type of battery used by EV
+build_existing_model.electric_vehicle_charge_at_home, Percentage of EV charging that occurs at home
+build_existing_model.electric_vehicle_charger, The type of charger used by EV
+build_existing_model.electric_vehicle_miles_traveled, Annual miles traveled by EV
+build_existing_model.electric_vehicle_outlet_access, The type of outlet access available for EV
+build_existing_model.electric_vehicle_ownership, Whether the EV is present or not
 building_id,The building unit number (between 1 and the number of samples).
 job_id,The unique identifier of the job/processor.
 started_at,Simulation start time.

docs/technical_development_guide/source/workflow_outputs/csv_tables/other_timeseries.csv

@@ -39,3 +39,7 @@ Zone People Occupant Count: Conditioned Space,zone_people_occupant_count__condit
 ,schedules_plug_loads_tv,frac,Television plug load energy use schedule.
 ,schedules_power_outage,,Unavailable period.
 ,schedules_vacancy,,Unavailable period.
+,schedules_ev_battery_charging,frac,Electric vehicle battery charging schedule
+,schedules_ev_battery_discharging,frac,Electric vehicle battery discharging schedule
+,schedules_ev_occupant,frac,Occupancy schedule of the electric vehicle driving occupant
+,schedules_present_occupants,binary,Binary representation of the occupancy of all occupants. Occupancy status of occupant n = schedules_present_occupants & (1 << n)

docs/technical_development_guide/source/workflow_outputs/csv_tables/simulation_outputs.csv

@@ -163,3 +163,4 @@ report_simulation_output.peak_load_heating_delivered_k_btu_hr,kBtu/hr,,,,Include
 report_simulation_output.resilience_battery_hr,hr,Resilience: Battery,resilience__battery__hr,hr,Average length of time the battery state of charge can meet the electric load
 report_simulation_output.unmet_hours_cooling_hr,hr,Unmet Hours: Cooling,unmet_hours__cooling__hr,hr,Number of hours where the cooling setpoint is not maintained.
 report_simulation_output.unmet_hours_heating_hr,hr,Unmet Hours: Heating,unmet_hours__heating__hr,hr,Number of hours where the heating setpoint is not maintained.
+report_simulation_output.unmet_hours_driving_hr,,Unmet Hours: Driving,unmet_hours__driving__hr,hour,Number of hours the electric vehicle was attempted to be driven when SOC was at minimum level

measures/ResStockArguments/measure.rb

@@ -235,12 +235,6 @@ def arguments(model)
     arg.setDefaultValue(0.0)
     args << arg
 
-    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('misc_plug_loads_vehicle_2_usage_multiplier', true)
-    arg.setDisplayName('Plug Loads: Vehicle Usage Multiplier 2')
-    arg.setDescription('Additional multiplier on the electric vehicle energy usage that can reflect, e.g., high/low usage occupants.')
-    arg.setDefaultValue(0.0)
-    args << arg
-
     arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('hvac_control_heating_weekday_setpoint_temp', true)
     arg.setDisplayName('Heating Setpoint: Weekday Temperature')
     arg.setDescription('Specify the weekday heating setpoint temperature.')
@@ -404,6 +398,18 @@ def arguments(model)
     arg.setDescription('Whether the heat pump uses the existing system as backup.')
     args << arg
 
+    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('ev_average_mph', false)
+    arg.setDisplayName('Electric Vehicle: Average Miles Per Hour')
+    arg.setDescription('The average miles/hour driven by the vehicle.')
+    arg.setUnits('hours')
+    args << arg
+
+    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('ev_efficiency_percent_increase', false)
+    arg.setDisplayName('Electric Vehicle: Efficiency Improvement')
+    arg.setDescription('The increase (%) in efficiency of the electric vehicle.')
+    arg.setUnits('hours')
+    args << arg
+
     return args
   end
 
@@ -496,7 +502,7 @@ def run(model, runner, user_arguments)
     args[:misc_plug_loads_television_usage_multiplier] = args[:misc_plug_loads_television_usage_multiplier] * args[:misc_plug_loads_television_2_usage_multiplier]
     args[:misc_plug_loads_other_usage_multiplier] = args[:misc_plug_loads_other_usage_multiplier] * args[:misc_plug_loads_other_2_usage_multiplier]
     args[:misc_plug_loads_well_pump_usage_multiplier] = args[:misc_plug_loads_well_pump_usage_multiplier] * args[:misc_plug_loads_well_pump_2_usage_multiplier]
-    args[:misc_plug_loads_vehicle_usage_multiplier] = args[:misc_plug_loads_vehicle_usage_multiplier] * args[:misc_plug_loads_vehicle_2_usage_multiplier]
+    args[:misc_plug_loads_vehicle_present] = false
 
     # PV
     if args[:pv_system_present]
@@ -848,6 +854,20 @@ def run(model, runner, user_arguments)
     end
     args[:rim_joist_assembly_r] = rim_joist_assembly_r
 
+    # Vehicle arguments
+    if (not args[:ev_miles_per_year].nil?) && (not args[:ev_fraction_charged_home].nil?)
+      args[:ev_miles_per_year] = args[:ev_miles_per_year] * args[:ev_fraction_charged_home]
+    end
+    if (not args[:ev_miles_per_year].nil?) && (not args[:ev_average_mph].nil?)
+      hours_per_year = args[:ev_miles_per_year] / args[:ev_average_mph]
+      args[:ev_hours_per_week] = (hours_per_year / UnitConversions.convert(1, 'yr', 'day')) * 7
+    end
+
+    if not args[:ev_efficiency_percent_increase].nil?
+      # Adjust efficiency (in kWh/mile) to reflect a percentage improvement in efficiency.
+      args[:ev_energy_efficiency] = args[:ev_energy_efficiency] / (1 + args[:ev_efficiency_percent_increase])
+    end
+
     args.each do |arg_name, arg_value|
       if args_to_delete.include?(arg_name) || (arg_value == Constants::Auto)
         arg_value = '' # don't assign these to BuildResidentialHPXML or BuildResidentialScheduleFile