Reference
EnergyPlus 速查表
动手时翻这一页：命令、文件后缀、版本对应、文件从哪来。可打印贴墙。
一、版本基线（2026-07 核实）
| 组件 | 现行最新 | 发布日期 | 备注 |
|---|
| EnergyPlus | v26.1.0 | 2026-03-31 | 方案文档写的是 v25.2.0（2025-11），已非最新 |
| pyenergyplus-lbnl (PyPI) | 26.1.0 | 2026-04-13 | 可直接 pip 装的 pyenergyplus |
| Sinergym | 3.12.2 | 2026-07-21 | 要求 Python ≥ 3.12；方案钉的 4bb1b3f 是旧快照 |
| eppy | 0.5.69 | 2026-01 | 要求 Python ≥ 3.9 |
| OpenStudio SDK | 3.11.0 | 2026-01-15 | 与 EnergyPlus 版本一一配对，见矩阵 |
| OpenStudio Application | 1.11.1 | 2026-06-17 | 图形 App |
| DreamerV3-torch | commit 6ef8646 | — | 方案选型 |
二、文件后缀速查
| 后缀 | 是什么 | 方向 |
|---|
.idf | 建筑简历（纯文本） | 输入 |
.idd | 对象/字段字典（Energy+.idd） | 输入（随安装） |
.epJSON | IDF 的 JSON 形式 | 输入（可选） |
.epw | 一整年典型气象（TMY） | 输入 |
eplusout.sql | 结构化 sqlite 输出（首选） | 输出 |
eplusout.eso → .csv | 逐时变量输出 | 输出 |
eplusout.mtr | 计量表输出 | 输出 |
eplustbl.htm | 月度/分箱报表 | 输出 |
eplusout.eio / .rdd / .mdd | 额外结果 / 可用变量 / 可用计量 | 输出（调试） |
三、常用命令
# 跑一年仿真（IDF + EPW）
energyplus -w weather.epw -r example.idf
# 或用 Python 直接驱动（pyenergyplus）
python -c "from pyenergyplus.api import EnergyPlusAPI; EnergyPlusAPI().run_energyplus(['-w','weather.epw','-r','example.idf'])"
# 装关键库
pip install pyenergyplus-lbnl # pyenergyplus（替代手动配 PYTHONPATH）
pip install sinergym # 需 Python ≥ 3.12
pip install eppy # 改 IDF
四、IDF 从哪来（方案 §2.2.3 四条路径）
| 路径 | 工具 | 精度 | PoC 用？ |
|---|
| A. BIM 高精度 | Revit→IFC→IfcOpenShell→eppy | 高 | 是（推荐） |
| B. 示例改 | EnergyPlus 示例 IDF + eppy 批改 | 中 | 是 |
| C. 内置数据集 | CityLearn 内置 | 低 | 仅算法验证 |
| 图形化建模 | OpenStudio App | 高 | 路径 A/B 的建模环节 |
五、EMS 三角色 ↔ RL 三要素
| EMS | 读/写 | RL 对应 | 对应 Pivot 字段例 |
|---|
| Sensor | 读 | 观测 s_t | 室温、水温、CO₂、室外温 |
| Actuator | 写 | 动作 a_t | 冷机功率、水泵频率、AHU 风量 |
| meter | 读 | 奖励 r_t | 耗电量（yggl）、COP |
六、关键文档入口
七、时间步判断（为何 10 分钟够用）
- 房间步常用 6 步/小时 = 10 分钟（用户设定，
Timestep 对象）。
- HVAC 热惯性时间常数 = 15–60 分钟；10 分钟采样能捕捉室温慢变化。
- → 方案复用现有 10 分钟
iot_data 做训练数据，不必新建高频采集。
速查表漏了什么？如果你在装环境/读方案时反复查同一个东西，告诉我，我加进来。