SWHC012 update following 2025 Title 24 codes file update

commercial measures/SWHC012-05 Occupancy Sensor/.modelkit-config

@@ -0,0 +1,24 @@
+
+# Paths are expanded relative to this modelkit-config file.
+
+prototypes-dir = '../../prototypes'
+templates-dir = '../../templates/energyplus/templates'
+weather-dir = '../../weather'
+codes-dir = '../../codes'
+
+max-workers = 12  # Maximum number of simulations to run in parallel
+
+
+[template-compose]
+annotate = true
+indent = "    "
+esc-line = "! "
+dirs = '~\Documents\Modelkit Caboodle\templates\energyplus\templates'  # Must be an absolute path
+
+[energyplus-run]
+engine = 'C:\EnergyPlusV22-2-0'  # Must be an absolute path
+#engine = '/Applications/EnergyPlus-22-2-0'  # Must be an absolute path
+#engine = '/Applications/EnergyPlus-9-2-0'  # Must be an absolute path
+readvars = true
+keep = false
+output-files = "eplusout.err; eplusout.sql; eplustbl.htm; eplusvar.csv"

commercial measures/SWHC012-05 Occupancy Sensor/README.md

@@ -0,0 +1,119 @@
+# SWHC012 Occupancy Sensor, Classroom
+
+This document describes the steps necessary to reproduce simulations and model outputs for this measure.
+
+Prepared by Kelsey Yen and Nicholas Fette (Solaris Technical). 
+Created 2025-10-22, revised 2026-01-03.
+
+## Generating temperature setback schedules
+
+Run the script included in this folder to output Schedule_Primary.csv, Schedule_Relocatable.csv, and Schedule_Secondary.csv.
+
+```
+python schedule.py
+```
+
+The schedules will be referenced by EnergyPlus models via a Schedule:File object.
+
+## Running simulation
+
+Providing a filename via the parameter classroom_class_setpoint_temp_schedule parameter triggers the prototypes to read in a temperature setpoint schedule from file.
+The filename is specified in the hvac-zone template using a relative path to its location in the measure folder.
+If EnergyPlus issues a warning due to the relative path, a user apply a workaround by editing the hvac-zone template to hard-code the folder where schedules are located, for example:
+
+**templates\energyplus\templates\zonehvac\hvac-zone.pxt near line 590**
+
+```
+  Schedule:File,
+	<%=zone_name %> Cooling Setpoint Schedule,  !- Name
+    Temperature,             !- Schedule Type Limits Name
+	C:/DEER-Prototypes-EnergyPlus/commercial measures/SWHC012-05 Occupancy Sensor/<%= setpoint_temp_schedule %>,  !- File Name
+    3,                       !- Column Number
+    1,                       !- Rows to Skip at Top
+    8760,                    !- Number of Hours of Data
+    Comma,                   !- Column Separator
+    No,                      !- Interpolate to Timestep
+    10,                      !- Minutes per Item
+    Yes;                     !- Adjust Schedule for Daylight Savings
+```
+**templates\energyplus\templates\zonehvac\hvac-zone.pxt near line 612**
+
+```
+  Schedule:File,
+	<%=zone_name %> Heating Setpoint Schedule,  !- Name
+    Temperature,             !- Schedule Type Limits Name
+	C:/DEER-Prototypes-EnergyPlus/commercial measures/SWHC012-05 Occupancy Sensor/<%= setpoint_temp_schedule %>,  !- File Name
+    4,                       !- Column Number
+    1,                       !- Rows to Skip at Top
+    8760,                    !- Number of Hours of Data
+    Comma,                   !- Column Separator
+    No,                      !- Interpolate to Timestep
+    10,                      !- Minutes per Item
+    Yes;                     !- Adjust Schedule for Daylight Savings
+```
+
+## Extracting Normalizing Units for Classrooms
+
+Developers applied the measure to only those zones representing
+classrooms, taken to mean where zone_type prefix is `classroom_class`.
+Developers considered area (from zones), cooling capacity (from cooling coils),
+and cooling capacity (from AirLoopHVAC systems) as candidates for normalizing units,
+ultimately choosing cooling capacity from AirLoopHVAC systems.
+
+The total cooling capacity of classroom zones in a given building simulation is
+calculated using a multi-step process to tabulate cooling capacity for
+each system in the model and then filter relevant systems and aggregate
+the capacity of matching systems.
+
+### To reproduce the computations, a user should enter these command line statements:
+
+1. Change directory into the first vintage subfolder and run the data extraction script:
+
+```
+cd "C:/DEER-Prototypes-EnergyPlus/commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex"
+python result2.py -s -t -q ../query_SWHC012_normalizing.txt
+```
+
+At this point, the user should have a new SQLite file `simdata.sqlite` saved by the
+script with tables sim_metadata and sim_tabular, which contains cooling capacity figures for each building instance and system.
+
+2. Continue with the command to reformat sizing data:
+
+```
+cat ../extract_sizing_data_sqlite.sql | sqlite3 simdata.sqlite -csv -header > results-sizing-detail.csv
+```
+
+At this point, the user should have a new file `results-sizing-detail.csv` with
+similar information in plain text / CSV format. If sqlite3 is not installed,
+download a portable executable or execute the query statement using a database preview application.
+
+3. Repeat above steps for each vintage subfolder (Ex, New).
+
+4. Then, continue with commands:
+
+```
+cd "C:/DEER-Prototypes-EnergyPlus/commercial measures/SWHC012-05 Occupancy Sensor"
+python result_filtered.py
+```
+
+The result_filtered script cross-references the result_sizing_detail.csv and coil_list.xlsx in order to filter relevant zones or systems.
+At this point, the user should have a new files "sizing_agg_filtered.csv" in each vintage subfolder.
+
+5. Combine the sizing_agg_filtered files into one CSV file and archive the result among energy model outputs.
+
+The combined sizing_agg_filtered.csv contains the normalizing unit lookup table, which
+can be used for example by pasting into an energy savings calculation workbook.
+
+### Developer Notes
+1. The classroom system names were manually identified by inspection of
+prototype root files and tabulated in the file `coil_list.xlsx` (sheet "Main coils").
+2. Cooling capacity was obtained in bulk using the tabular report fields listed
+in query_SWHC012_normalizing.txt. Based on trial and error, measure developers
+determined that outputs from AirLoopHVAC:UnitarySystem were preferred over
+outputs from individual cooling coils due to ambiguous labeling of total
+cooling capacity in multispeed coils; and that with linked-sizing active, the query
+strings vary slightly between base case and measure case models.
+3. For a convenience, the distinct query file used to collate model usage (`query_SWHC012.txt`)
+may include query strings to gather area or cooling capacity of some classroom zones. 
+These are useful during model testing as a sanity check but are ultimately unused
+in calculating normalizing units, UEC, and UES.

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/cases/EPr&0&cDXGF&Ex&HV_Tech__OccSens.csv

@@ -0,0 +1,3 @@
+skip,case_name,sizing_case,:disable_ems,:heat_sizing_factor,:cool_sizing_factor,:main_hvac_type,:main_heat_coil_type,:main_heat_coil_eff,:main_heat_coil_cop,:main_fan_motor_eff,:main_heat_flow_frac,:main_fan_speed,:main_cool_coil_type,:main_cool_coil_cop,:main_dx_comp_speed,:main_atu_reheat_coil_type,:main_atu_reheat_control,:main_fan_rise,:main_dx_type,:main_sat_reset_type,:main_sat_temp_max,:main_design_peak_load,:main_oa_econ_type,:classroom_class_setpoint_temp_schedule
+,NE-HV_Tech-OccSens-cDXGF,NE-HV_Tech-OccSens-cDXGF-NoOccSens,TRUE,1.25,1.15,SZ-CAV,COMBUSTION,0.81,,0.87,1,CONSTANT,DX-AIR,4.11,CONSTANT,NONE,nil,3.877['in H2O'],PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,Schedule_Primary.csv
+,NE-HV_Tech-OccSens-cDXGF-NoOccSens,,TRUE,1.25,1.15,SZ-CAV,COMBUSTION,0.81,,0.87,1,CONSTANT,DX-AIR,4.11,CONSTANT,NONE,nil,3.877['in H2O'],PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/cases/EPr&0&cDXHP&Ex&HV_Tech__OccSens.csv

@@ -0,0 +1,3 @@
+skip,case_name,sizing_case,:disable_ems,:heat_sizing_factor,:cool_sizing_factor,:main_hvac_type,:main_atu_reheat_coil_type,:main_atu_reheat_control,:main_fan_rise,:main_heat_coil_type,:main_heat_coil_eff,:main_heat_coil_cop,:main_cool_coil_type,:main_dx_type,:main_sat_reset_type,:main_sat_temp_max,:main_design_peak_load,:main_oa_econ_type,:main_cool_coil_cop,:main_dx_comp_speed,:main_fan_speed,:main_fan_motor_eff,:classroom_class_setpoint_temp_schedule
+,NE-HV_Tech-OccSens-cDXHP,NE-HV_Tech-OccSens-cDXHP-NoOccSens,TRUE,1.25,1.15,SZ-CAV,NONE,nil,3.877['in H2O'],DX-AIR,3.2,,DX-AIR,PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,4.13,CONSTANT,CONSTANT,0.87,Schedule_Primary.csv
+,NE-HV_Tech-OccSens-cDXHP-NoOccSens,,TRUE,1.25,1.15,SZ-CAV,NONE,nil,3.877['in H2O'],DX-AIR,3.2,,DX-AIR,PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,4.13,CONSTANT,CONSTANT,0.87,

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/cases/ERC&0&cDXGF&Ex&HV_Tech__OccSens.csv

@@ -0,0 +1,3 @@
+skip,case_name,sizing_case,:disable_ems,:heat_sizing_factor,:cool_sizing_factor,:main_hvac_type,:main_heat_coil_type,:main_heat_coil_eff,:main_heat_coil_cop,:main_fan_motor_eff,:main_heat_flow_frac,:main_fan_speed,:main_cool_coil_type,:main_cool_coil_cop,:main_dx_comp_speed,:main_atu_reheat_coil_type,:main_atu_reheat_control,:main_fan_rise,:main_dx_type,:main_sat_reset_type,:main_sat_temp_max,:main_design_peak_load,:main_oa_econ_type,:classroom_class_setpoint_temp_schedule
+,NE-HV_Tech-OccSens-cDXGF,NE-HV_Tech-OccSens-cDXGF-NoOccSens,TRUE,1.25,1.15,SZ-CAV,COMBUSTION,0.81,,0.87,1,CONSTANT,DX-AIR,4.11,CONSTANT,NONE,nil,3.877['in H2O'],PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,Schedule_Relocatable.csv
+,NE-HV_Tech-OccSens-cDXGF-NoOccSens,,TRUE,1.25,1.15,SZ-CAV,COMBUSTION,0.81,,0.87,1,CONSTANT,DX-AIR,4.11,CONSTANT,NONE,nil,3.877['in H2O'],PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/cases/ERC&0&cDXHP&Ex&HV_Tech__OccSens.csv

@@ -0,0 +1,3 @@
+skip,case_name,sizing_case,:disable_ems,:heat_sizing_factor,:cool_sizing_factor,:main_hvac_type,:main_atu_reheat_coil_type,:main_atu_reheat_control,:main_fan_rise,:main_heat_coil_type,:main_heat_coil_eff,:main_heat_coil_cop,:main_cool_coil_type,:main_dx_type,:main_sat_reset_type,:main_sat_temp_max,:main_design_peak_load,:main_oa_econ_type,:main_cool_coil_cop,:main_dx_comp_speed,:main_fan_speed,:main_fan_motor_eff,:classroom_class_setpoint_temp_schedule
+,NE-HV_Tech-OccSens-cDXHP,NE-HV_Tech-OccSens-cDXHP-NoOccSens,TRUE,1.25,1.15,SZ-CAV,NONE,nil,3.877['in H2O'],DX-AIR,3.2,,DX-AIR,PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,4.13,CONSTANT,CONSTANT,0.87,Schedule_Relocatable.csv
+,NE-HV_Tech-OccSens-cDXHP-NoOccSens,,TRUE,1.25,1.15,SZ-CAV,NONE,nil,3.877['in H2O'],DX-AIR,3.2,,DX-AIR,PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,4.13,CONSTANT,CONSTANT,0.87,

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/cases/ESe&0&cDXGF&Ex&HV_Tech__OccSens.csv

@@ -0,0 +1,3 @@
+skip,case_name,sizing_case,:disable_ems,:heat_sizing_factor,:cool_sizing_factor,:main_hvac_type,:main_heat_coil_type,:main_heat_coil_eff,:main_heat_coil_cop,:main_fan_motor_eff,:main_heat_flow_frac,:main_fan_speed,:main_cool_coil_type,:main_cool_coil_cop,:main_dx_comp_speed,:main_atu_reheat_coil_type,:main_atu_reheat_control,:main_fan_rise,:main_dx_type,:main_sat_reset_type,:main_sat_temp_max,:main_design_peak_load,:main_oa_econ_type,:classroom_class_setpoint_temp_schedule
+,NE-HV_Tech-OccSens-cDXGF,NE-HV_Tech-OccSens-cDXGF-NoOccSens,TRUE,1.25,1.15,SZ-CAV,COMBUSTION,0.81,,0.87,1,CONSTANT,DX-AIR,4.11,CONSTANT,NONE,nil,3.877['in H2O'],PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,Schedule_Secondary.csv
+,NE-HV_Tech-OccSens-cDXGF-NoOccSens,,TRUE,1.25,1.15,SZ-CAV,COMBUSTION,0.81,,0.87,1,CONSTANT,DX-AIR,4.11,CONSTANT,NONE,nil,3.877['in H2O'],PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/cases/ESe&0&cDXHP&Ex&HV_Tech__OccSens.csv

@@ -0,0 +1,3 @@
+skip,case_name,sizing_case,:disable_ems,:heat_sizing_factor,:cool_sizing_factor,:main_hvac_type,:main_atu_reheat_coil_type,:main_atu_reheat_control,:main_fan_rise,:main_heat_coil_type,:main_heat_coil_eff,:main_heat_coil_cop,:main_cool_coil_type,:main_dx_type,:main_sat_reset_type,:main_sat_temp_max,:main_design_peak_load,:main_oa_econ_type,:main_cool_coil_cop,:main_dx_comp_speed,:main_fan_speed,:main_fan_motor_eff,:classroom_class_setpoint_temp_schedule
+,NE-HV_Tech-OccSens-cDXHP,NE-HV_Tech-OccSens-cDXHP-NoOccSens,TRUE,1.25,1.15,SZ-CAV,NONE,nil,3.877['in H2O'],DX-AIR,3.2,,DX-AIR,PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,4.13,CONSTANT,CONSTANT,0.87,Schedule_Secondary.csv
+,NE-HV_Tech-OccSens-cDXHP-NoOccSens,,TRUE,1.25,1.15,SZ-CAV,NONE,nil,3.877['in H2O'],DX-AIR,3.2,,DX-AIR,PNNL,FLOATING,95['F'],NONCOINCIDENT,FIXED-DRY-BULB,4.13,CONSTANT,CONSTANT,0.87,

commercial measures/SWHC012-05 Occupancy Sensor/SWHC012-05 Occupancy Sensor_Ex/climates.csv

@@ -0,0 +1,17 @@
+skip,climate,weather_file,climate_zone,codes_file
+,CZ01,CA_EUREKA_725940S_CZ2022.epw,1,T24_weight_averaged_ex.csv
+,CZ02,CA_NAPA-CO_724955S_CZ2022.epw,2,T24_weight_averaged_ex.csv
+,CZ03,CA_OAKLAND-METRO-AP_724930S_CZ2022.epw,3,T24_weight_averaged_ex.csv
+,CZ04,CA_SAN-JOSE-IAP_724945S_CZ2022.epw,4,T24_weight_averaged_ex.csv
+,CZ05,CA_SANTA-MARIA-PUBLIC-AP_723940S_CZ2022.epw,5,T24_weight_averaged_ex.csv
+,CZ06,CA_LOS-ANGELES-IAP_722950S_CZ2022.epw,6,T24_weight_averaged_ex.csv
+,CZ07,CA_SAN-DIEGO-LINDBERGH-FLD_722900S_CZ2022.epw,7,T24_weight_averaged_ex.csv
+,CZ08,CA_LONG-BEACH-DAUGHERTY-FLD_722970S_CZ2022.epw,8,T24_weight_averaged_ex.csv
+,CZ09,CA_LOS-ANGELES-DOWNTOWN-USC_722874S_CZ2022.epw,9,T24_weight_averaged_ex.csv
+,CZ10,CA_RIVERSIDE-MUNI_722869S_CZ2022.epw,10,T24_weight_averaged_ex.csv
+,CZ11,CA_RED-BLUFF-MUNI-AP_725910S_CZ2022.epw,11,T24_weight_averaged_ex.csv
+,CZ12,CA_STOCKTON-METRO-AP_724920S_CZ2022.epw,12,T24_weight_averaged_ex.csv
+,CZ13,CA_FRESNO-YOSEMITE-IAP_723890S_CZ2022.epw,13,T24_weight_averaged_ex.csv
+,CZ14,CA_DAGGETT-BARSTOW-AP_723815S_CZ2022.epw,14,T24_weight_averaged_ex.csv
+,CZ15,CA_EL-CENTRO-NAF_722810S_CZ2022.epw,15,T24_weight_averaged_ex.csv
+,CZ16,CA_BISHOP-AP_724800S_CZ2022.epw,16,T24_weight_averaged_ex.csv