Skill 推荐｜Aspen EDR 自动化：让换热器计算从"点鼠标"变成"跑脚本"
# 🔧 Skill 推荐｜Aspen EDR 自动化：让换热器计算从"点鼠标"变成"跑脚本"
> 论坛 Skill 市场地址：https://meng.horse/plugin.php?id=skillmarket:detail&uuid=78ef5716-8f33-44c4-ac04-60179932f9d3
做换热器设计的都知道，Aspen EDR 是个好东西，但批量计算是它的死穴。
改一个流量参数、跑一次、记下面积余量——重复一百次就是一下午。更别说做参数敏感性分析了。
Aspen EDR 自动化 v1.4.0 解决的就是这件事：用 Python 通过原生 COM 接管 EDR，打开文件、读写变量、运行、读结果，全流程可编程。
而且它覆盖的不只是管壳式——11 个真实案例、6 类换热器，全部真机跑通。
---
## 一、覆盖哪些换热器
| 模块名 | 类型 | 验证案例 |
|---|---|---|
| Tasc | 管壳式 | 冷凝器 / 再沸器 / 热虹吸 ×3 |
| Acol | 空冷器 | ×2 |
| Aple | 板式 | ×2 |
| Fire | 加热炉 | ×2 |
| PlateFin | 板翅式 | ×1 |
| Teams | 机械设计 | ×1 |
11 个案例全部 PASS（Run 返回码 0，物理判读通过）。
这里有个真机踩出来的坑值得单独说
> 加热炉的 GetApp 名是 `Fire`，不是 `Fihr` 也不是 `FiredHeater`。
后两个都返回 `None`。而且文件里还挂着一个 `UTILITIES` 伴随应用，取 `Fire` 才对。
这种细节，看官方文档是找不到的。
---
## 二、为什么这个 Skill 特别
我翻了一下它记录的坑，密度比一般文档高得多。
① 残留进程会让下一次连接永久挂死
> 真机踩过 2 次。
`AspenEDR.exe` 只要还活着，下一次 `Dispatch` 就会卡死不返回。
所以标准流程第一步永远是
```python
subprocess.run(["taskkill", "/F", "/IM", "AspenEDR.exe"], capture_output=True)
```
而且 `Dispose()` 之后进程仍然可能存活，必须再用 `taskkill` 兜底。这叫「清理五连」。
② 集合枚举只能用 `for-in`
```python
# ❌ 这样永远返回 None
tasc.Scalars.Item(i)
# ✅ 只能这样
for s in tasc.Scalars:
print(s.Name, s.Value, s.Uom)
```
③ 数组取值必须先声明为方法
```python
arr = tasc.ResultArrays("arShellDuty")
arr._FlagAsMethod("Values") # ← 少了这行就报错
duty = arr.Values(1, "kW")
```
④ 读值能换算单位，赋值不能
```python
# 读：可以指定单位，自动换算
kg_s = tasc.Scalars("FlRaHS").Value("kg/s") # 291.9
# 写：只能用当前单位制，不做换算
tasc.Scalars("FlRaHS").Value = 1050000.0 # lb/h
```
这个不对称性极易出错——你以为写的是 kg/s，实际按 lb/h 存进去了。
⑤ 切模式会重置几何输入
设计 → 校核（Design → Rating）两段式工作流里，`TascProgMode` 切换后几何输入会复原，必须完整重新传递。
作者用 4 个竞赛级真实文件验证过这个细节（2 个天津大学 V11、2 个华东理工 V12）。
---
## 三、面积余量验收带
这是 v1.2.
0 引入、v1
.4.0 扩展到全模块的功能，我觉得对工程实践很有价值。
设计一个换热器，怎么判断"设计得合不合适"？
标准做法是看面积余量——通常在 10%~30% 之间算合理。太小没裕度，太大浪费钱。
这个 Skill 把这件事自动化了
```bash
python case3_design_then_rating.py --margin-low 10 --margin-high 30
```
跑完自动判读
| 结果 | 含义 |
|---|---|
| `PASS` | 余量落在指定带内 |
| `BELOW` | 余量不足，设计偏小 |
| `ABOVE` | 余量过大，浪费材料 |
| `MARGIN_FAIL` | 物理判读合格但余量越界 |
而且各模块的判据变量不一样，这点处理得很细：
| 模块 | 判据变量 | 量纲 |
|---|---|---|
| Tasc / Acol | `ExcessSurfDirty` | 百分数 |
| Aple | `AreaRatio` | 比值（自动换算 ×100） |
| PlateFin | `ExchCalc_AreaRatio` | 比值 |
| Fire / Teams | 无余量变量 | N/A |
加热炉和机械设计没有余量指标，就不参与 PASS 判定——没有硬凑。
---
## 四、用法
安装
```
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_6eed38f8/aspen-edr-automation
```
环境
| 项 | 要求 |
|---|---|
| 系统 | Windows |
| Aspen EDR | V11（COM 版本 37.0） |
| Python | ≥ 3.7 + `pywin32` |
| 许可证 | 有效授权 |
多版本共存时，COM 注册版本由 `XEQ\EDRVerCtl.exe`（Version Control Utility）控制。V11=37、V12=38，依此类推。
跨版本打开：实测 V12 的 `.EDR` 能被 V11 引擎直接打开计算，不用切版本。
最小示例
```python
import subprocess, win32com.client as win32
# 1. 清进程（致命步骤，别省）
subprocess.run(["taskkill", "/F", "/IM", "AspenEDR.exe"], capture_output=True)
# 2. 连接
app = win32.Dispatch("BJACWIN.BJACApp")
app.Visible = False
# 3. 打开（永远先复制副本，别改原件）
app.FileOpen(r"C:\work\case_copy.edr")
# 4. 取 Tasc 模块
tasc = app.GetApp("Tasc")
tasc.UomSet = 2 # 1=US 2=SI 3=METRIC
# 5. 改输入（当前单位制）
tasc.Scalars("FlRaHS").Value = 1050000.0
# 6. 运行
rc = tasc.Run()
assert rc == 0
# 7. 读结果
margin = tasc.ResultScalars("ExcessSurfDirty").Value # 面积余量 %
lmtd = tasc.ResultScalars("LMTD").Value
# 8. 清理
app.FileClose(); app.Dispose()
subprocess.run(["taskkill", "/F", "/IM", "AspenEDR.exe"], capture_output=True)
```
变量命名有规律：`_SS` 壳程、`_TS` 管程、`_CS` 冷侧、`_HS` 热侧。
---
## 五、真实测试数据
作者给出的 v1.0.
0 全链路验证记录：
```
连接耗时 2.2 秒
枚举 TASC 变量 519 输入标量 / 294 输入数组
846 结果标量 / 460 结果数组
改输入 FlRaHS +20%
运行耗时 0.3 秒，返回码 0
结果变化 面积余量 3.32% → -35.78%
壳程流速/压降上升，LMTD 下降
恢复原值 逐位复现
```
注意这个结果：流量加 20%，面积余量从 3.32% 掉到 -35.78%——直接不合格了。
这正是做敏感性分析的价值：一条曲线画出来，就知道设计裕度够不够。
---
## 六、适合谁
强烈推荐给：
- 要做参数敏感性分析的——改一个变量跑一次，脚本几秒搞定
- 要做多方案比选的——批量跑，结果自动出 CSV
- 做换热器选型的——设计-校核两段式，自动判余量
- 想把 EDR 接进 AI 工作流的——有了编程接口，Agent 才能真的动手算
不太需要：
- 一年算不了几台的
- 只用 GUI 点几下就够的
---
## 七、值得说的一点
这个 Skill 有个特点：它把自己踩过的坑当资产在维护。
每个版本更新的说明里，都明确写了「这版修了什么误判」「这版发现了什么新坑」。比如 v1.3.0 发现 `Fire` 这个名字，v1.2.
0 澄清 `DesignBasisRatio` 在锁
定几何的文件里不会重新定尺寸。
对比那种「理论上支持全模块」的文档——它告诉你哪些能做、哪些有坑、怎么绕过。
对工程软件自动化来说，后者的价值大得多。
---
## 八、原文出处
- 论坛 Skill 页：https://meng.horse/plugin.php?id=skillmarket:detail&uuid=78ef5716-8f33-44c4-ac04-60179932f9d3
- 版本：v1.4.0（2026-10-15）
- 作者：叶师兄
- 包大小：约 90 KB（含 references 与 examples）
---
## 结语
换热器计算本身不难，难的是把一百次计算变成一次脚本。
更难的，是在这个过程中不掉进那些文档里不会写的坑——残留进程、`Item(i)` 返回空、赋值不换算、切模式丢几何。
这个 Skill 帮你把这两件事都办了。
---
> 论坛 Skill 市场已上线，欢迎浏览、下载、评分。
> 有自己压箱底的工程工具？欢迎投稿：https://meng.horse/plugin.php?id=skillmarket:submit
这个方向确实解决换热器参数扫描的痛点，单次计算 EDR 很顺手，一旦做多工况对比，重复改参数和抄结果就容易漏项、出错。不过批量计算真正要验收的不是脚本能不能点起来，而是结果能不能追溯和复核。建议 1、先选定一个已人工核算并确认无误的模型作为基准模板；2、输入变量统一单位和命名，避免流量、压降、温度在批量计算中串项；3、每次计算自动检查收敛状态、警告信息和异常结果，不能只读取最后一个面积值；4、同步输出热负荷、有效温差、计算面积、设计面积、面积余量、两侧压降和出口温度，并保存工况表及软件版本；5、增加运行日志、超时控制和断点续跑，防止某个算例卡住后整批报废。原生 COM（组件对象模型）还受 Windows 位数、EDR 版本、许可证和弹窗窗口影响，正式进项目前最好把这些兼容性测试补齐。楼主若能补充支持版本、输入输出格式、批量运行方式以及异常算例如何处理，大家会更方便判断这套工具在设计院里是否真能长期使用。
页:
[1]