【第三篇 实操篇】Demo运行、数据准备与参数配置全景

导读：理解了算法原理后，如何亲自动手跑起来？真实项目中我们需要准备哪些数据？配置文件里的几十个参数分别控制什么？本文手把手带你完成从数据准备、参数配置、命令行运行到结果可视化的完整实操闭环。

1. 运行环境与零依赖设计

快速验证环境

2. 输入时序数据准备（load.csv）

2.1 标准 CSV 格式规范

2.2 样例数据片段（24 小时日前负荷）

3. 全局配置文件深度解析（config/default.json）

板块 1：冷水机组列表（chillers）

• capacity_kw：单台主机额定冷量（kW）；

• min_plr / max_plr：允许的安全负载率区间（例如 15%~100%），低于 min_plr 的组合会被 Dispatch 层判定为喘振而剔除；

• cop_multiplier：机组老化衰减系数（若该机结垢严重效率下降 5%，可设为 0.95）。

板块 2：主机调度与保护约束（chiller_scheduling）

• min_on_hours / min_off_hours：压缩机单次启停后的强制闭锁时长（小时）；

• initial_on：第 0 时段开始前各机是否处于开机状态；

• initial_state_hours：初始状态已连续保持的时长（用于判定进入第 1 时段时是否允许立刻切机）；

• runtime_hours：现场 SCADA 读取的设备历史累计运行时长；

• prefer_shorter_runtime：是否开启“零能耗代价”的设备磨损均衡；

• terminal_policy：计划末尾策略（require_complete 要求规划结束时无未到期闭锁，carry_over 允许未到期闭锁传递给下个日前规划）。

板块 3：遗传算法与物理边界（optimization）

• max_temperature_step_c：相邻时段控制温度最大允许变化幅度（默认 1.5℃，防止水温剧变冲击系统）；

• bounds：各水路供回水温度与逼近度物理上下限。

4. 命令行实操与实验复现

操作 1：默认基准运行

• 行为：使用 examples/load.csv 负荷和默认配置执行优化，全流程耗时约 3.5 秒。

操作 2：指定自定义负荷与输出目录

操作 3：传入设备历史累计运行小时（测试磨损均衡）

• 效果：程序会识别 3# 主机（历史仅 450h）累计最短，在同等能耗的候选方案中优先启用 3# 机，而将 1# 机（1200h）排后。

5. 优化产物解读与分析

1. schedule.csv —— 下发控制策略表

• chw_supply_c：冷冻供水设定值（℃）

• cw_supply_c：冷却供水设定值（℃）

• chiller_on：各冷机的开停布尔列表（如 [true, true, false, false]）

• chiller_load_kw：各冷机承担的冷量

• chw_pump_frequency_hz / cw_pump_frequency_hz：水泵变频频率

• tower_frequency_hz：冷却塔风机变频频率

2. result.json —— 综合指标与末态快照

• 核心能效指标：全站制冷系统综合能效比 $\text{SCOP} = \frac{50384.51}{7570.64} = 6.655$；

• terminal_chiller_state：可直接作为下一个周期日前规划的初始状态输入。