| name | w2a-plant-dial |
| description | Dial any-building W2A (post-ExpandObjects) EnergyPlus plant knobs for utility monthly GL14 plus design-day peak. Practice pack: Lakeside/Creekside A04 ladder (E20/SC02/R02/A04), summer_sch_scale, coil COP, equip/lights. Use with SITE_ROOT and vibe22 W2A_PLANT_DIAL / TWIN_DIAL_PLAYBOOK. |
W2A plant dial (GL14 + peak)
Code: vibe_code_apps_22 · Site: SITE_ROOT (alias LAKESIDE_SITE_ROOT)
Spec: vibe22_agent_spec/W2A_PLANT_DIAL.md ·
TWIN_DIAL_PLAYBOOK.md
Practice tutorial: notebooks/lakeside_eplus_gl14_vs_peak285.ipynb
Read with: utility-gl14 · eplus-gl14
(IdealLoads — different physics).
Practice identity: fictional research name Creekside; building id LAKESIDE_ES
/ disk sp_creekside. Other buildings use their own pack champion ids.
Goal
Hold utility monthly GL14 (|NMBE|<5%, CVRMSE<15%) while raising the
design-day simulated peak toward billed peak, without overnight baseload exploding.
Practice dual champion (2026-08-09): A04 — ~287 kW peak, overnight ~144 kW,
GL14 pass (+1.0% / 10.4%), Aug bill err ~+1.7%.
Prior ladder: E20 → SC02 → R02 → A04.
Dial order for new sites: envelope then ops (see TWIN_DIAL_PLAYBOOK); choose
elec-first vs gas-first from monthly ±%.
Correct areas to dial
Mutate expanded IDF via eplus_native/w2a_plant_knobs.py only.
| Dial here | Knob | Why |
|---|
| Coil size | htg_coil_capacity_mult | Morning recovery height |
| Heating COP | htg_coil_cop_mult | Soften peak vs monthly |
| Cooling COP | clg_coil_cop_mult | Summer months |
| Night setback | setback_heat_sp_c | Deep setback |
| Morning run hours | optimum_start_h | Keep long enough for recovery |
| Plug intensity | equip_w_area_mult | When peak≈target but GL14 fails |
| Lighting | lights_w_area_mult | With equip cut |
| Summer school-out | summer_sch_scale | Practice: Jun–Jul only; August in-session |
| Summer HVAC cut | summer_include_hvac | Optional |
Do not dial: fan_avail_use_sch_hvac=True. Dead IdealLoads / pre-expand knobs.
Year-round rated heating COP ≤2.8. Summer-out window that includes the wrong month.
Agent playbook (practice success path → A04)
- Constraint: monthly utility GL14 from
reports/eplus/observed_monthly_utility.csv.
- Shape: design-day peak + overnight hours (site TZ).
- Soften heating COP if peak short — expect NMBE to worsen.
- If peak near target & GL14 fail: cut equip/lights.
- Summer: scale vacation months only; keep in-session months honest; raise cooling COP as needed.
- Champion: nearest dual among GL14 passers with controlled overnight.
- Document; never overwrite IdealLoads
*_best_utility.idf.
Failed patterns (do not repeat)
- Plugs/lights alone to hit peak without COP soft → monthly fail.
- Rated heating COP 2.6–2.8 year-round → peak blows up, NMBE collapses.
- Summer-out Through the wrong end month → monthly CVRMSE fail.
- Claiming monthly GL14 ⇒ DSM GO / interval-shape pass.
Run (practice scripts)
cd C:\Users\ben\Documents\py-bacnet-stacks-playground\vibe_code_apps_22
$env:SITE_ROOT="C:\Users\ben\OneDrive\Desktop\testing\sp_creekside"
$env:PYTHONUNBUFFERED="1"
$env:PYTHONIOENCODING="utf-8"
python -u scripts\eplus_w2a_e20_soft_cop_trim.py
python -u scripts\eplus_w2a_sc02_gl14_recover.py
python -u scripts\eplus_w2a_sc02_aug_in_session.py
Needs expanded base under eplus/campaigns/.../shared/expand/expanded.idf.
Checklist before claiming dual success
