HTRI二次开发教程（13）：与流程模拟软件集成（上）——Xist 直连与文件导入

版本与事实声明

• 版本锚点：当前Xchanger Suite 9.4。
• 证据分级：官方 Xist 页原文"Includesbuilt-in interface to most process simulators and mechanical design software"属[A] 官方一手源；"Xist operates directly with process simulators such asAspen Plus, HYSYS, PRO/II, UNISIM and VMGSim"属[C] 第三方转录（按规范名 PRO/II 表述），正文按"据软件说明"降级表述；导入能力（HTFS / UniSim Heat Exchangers / Aspen EDR）属[A] 官方一手源。
• 直连的具体机制细节未公开（底账 U10），本文只写官方与第三方可确证的定性事实，不推测数据交换实现（DLL/文件/内存）。
• 示例代码中标识符为占位符；数值均为示例性建模，不代表任何标准规定。

一句话结论：HTRI 与流程模拟软件的集成有两条形态——“直连”（官方称 Xist 内置对大多数流程模拟器与机械设计软件的接口，第三方转录列出 Aspen Plus、HYSYS、PRO/II、UniSim、VMGSim）与"文件导入"（官方确证可从 HTFS、Honeywell UniSim Heat Exchangers、Aspen Exchanger Design & Rating 导入输入文件）；做集成前必须先分清"我要的是模拟器内调用 HTRI 引擎，还是把模拟器的换热器数据搬进 HTRI"，这两件事的产品答案完全不同。

〇、本篇要解决的认知问题

• Q1：HTRI 与流程模拟软件的集成有几种形态，为什么必须先分清它们的差别？
• Q2：官方对"直连"到底说了什么，哪些是官方确证、哪些是第三方转录？
• Q3：文件导入能力覆盖哪些来源，导入后要注意什么？
• Q4：官方兼容性页的"计数（10/8/10/3/5）"是什么意思，为什么它比"具体名单"更该被引用？
• Q5：做集成前，脚本层面应该做哪些前置检查？

一、机制解析

1.1 三种"集成"容易混淆

在工程对话里，"HTRI 和 Aspen/HYSYS 集成"往往混着三件不同的事：

1. 模拟器内调用 HTRI 引擎：在流程模拟器里把换热器单元操作交给 HTRI 计算（这是XSimOp的领域，第 14 篇详述）；
2. Xist 直连模拟器：官方称 Xist 内置对多数流程模拟器与机械设计软件的接口，可从模拟器侧取/交换数据；
3. 文件导入：把别的软件导出的换热器输入文件导入 Xchanger Suite。

为什么必须先分清：三者的产品、许可与操作路径完全不同。要"在 Aspen 里用 HTRI 算换热器"，答案是 XSimOp（且目前官方具名的产品是 XSimOp ShellTube，集成于 UniSim Design 与 KBC Petro-SIM）；要"把 Aspen EDR 的换热器数据搬进 Xist"，答案是文件导入；要"从 Xist 侧连模拟器"，答案才是 Xist 的 built-in interface。答错问题，工具就选错了。

1.2 直连：官方说了什么

官方确证 [A]：Xist 页列出的 Features 之一为"Includes built-in interface to most process simulators and mechanical design software"。这句话是定性的——它确认存在内置接口，但没有逐一列举模拟器名单，也没有描述交换机制。

第三方转录 [C]：一份第三方对 HTRI 软件说明的转录写道"Xist operates directly with process simulators such as Aspen Plus, HYSYS, PRO/II, UNISIM and VMGSim"。这类名单在业内广为流传，但我们按证据等级降级表述为"据软件说明"，并建议读者以官方兼容性页与销售确认。

集成的另外两个官方确证点：

• Features 页的"Software can interface with"清单含"process simulators"与"CAPE-OPEN compliant applications"；
• Xist 页明确：“Can beembedded as a unit operation in any process simulator supporting CAPE-OPEN”——这是官方对"在模拟器里用 HTRI"的标准答案（CAPE-OPEN 路径），与 XSimOp 的商业集成路径并列。

1.3 文件导入：官方确证的能力

官方 Features 页原文：“Import of input files from HTFS®(shell-and-tube and plate-fin exchangers),Honeywell’s UniSim® Heat Exchangers(shell-and-tube and plate-fin exchangers), andAspen Exchanger Design & Rating™(shell-and-tube, air-cooled exchangers and plate-fin exchangers) allow modeling within Xchanger Suite.”

Xist 页另有：“Loads input files fromHTFS™, Honeywell UniSim® Shell-Tube Exchanger Modeler, and Aspen Shell & Tube Exchanger™.”

导入后要注意什么（经验法则）：

• 导入的是"输入"，不是"结果"：导入后仍需在 HTRI 里运行，用 HTRI 的方法重算——这正是导入的价值（用 HTRI 方法校核别家设计）；
• 做导入前后的字段核对：跨软件映射难免有"适用数据子集"问题（第 11 篇同款陷阱），导入后逐字段核对几何与工况是否完整；
• 保留导入源文件：导入件是审计链的一环，别只留 HTRI 案例。

1.4 兼容性计数：为什么引用计数而非名单

官方兼容性页给出的不是名单，而是计数：10Physical Properties Packages /8Process Simulation Packages /10Mechanical Design Packages /3Integrated Engineering Packages /5Fan Selection Packages，并说"Contact us for more information about compatible engineering tools"。

为什么引用计数更专业：官网未逐一列举公司与产品名（底账 U5），任何"HTRI 兼容 XX 软件"的完整名单都无法从公开源确证。引用官方计数 + 建议联系销售，比引用一份来源不明的名单更可信。

1.5 前置检查：集成前脚本该做什么

在跑任何集成脚本前，至少确认三件事：

1. 许可覆盖：HTRI 侧与模拟器侧是否都有相应许可（第 02 篇的许可事实登记）；
2. 版本兼容：Xchanger Suite 版本与模拟器版本是否在官方兼容范围内（查官方兼容性页，或问销售）；
3. 物性一致：两边用同一物性数据源吗？Xchanger Suite 安装含VMGThermo物性生成器；若模拟器用另一套物性，换热器热物性可能有差异——这是跨软件结果不一致的头号来源。

1.6 集成叙事的证据纪律

为什么这对你重要：HTRI 与流程模拟软件的集成是行业里"传说最多"的话题之一。引用错一句话，可能让团队选错产品、白搭几个月。

按证据等级处理三类表述：

• [A] 官方一手源，可以直接引用：Xist “Includes built-in interface to most process simulators and mechanical design software”；可从 HTFS / Honeywell UniSim Heat Exchangers / Aspen Exchanger Design & Rating 导入输入文件；“Can be embedded as a unit operation in any process simulator supporting CAPE-OPEN”；兼容性页的分类计数（10/8/10/3/5）。
• [C] 第三方转录，必须降级表述：“Xist operates directly with process simulators such as Aspen Plus, HYSYS, PRO/II, UNISIM and VMGSim”——写作"据软件说明"，并附"以官方兼容性页与销售确认为准"。不要把这句写成"官方支持列表"。
• 未公开、不可断言：直连的具体机制（DLL？文件？内存交换？）、每家模拟器支持的字段范围——一律"以官方文档为准"（底账 U10）。

一条引用纪律：凡涉及"支持/兼容"的表述，必须连"证据等级"和"范围限定"一起给出。只写"HTRI 支持 XX 软件"而不写"据某级来源、且官方未逐一列举"，是行业文档里最常见的误导——它把"定性存在接口"悄悄升级成了"官方点名支持"。

二、完整代码与逐行剖析

代码 13-1：集成前置检查清单（可运行）

# -*- coding: utf-8 -*-""" integration_precheck.py —— HTRI 与流程模拟软件集成的前置检查 用法：python integration_precheck.py 说明：本脚本不连接任何软件，只把你需要确认的事实结构化并校验完整性； 所有版本/名单以官方文档与本机实际为准。 """importjson FACTS={"htri":{"version":"9.4",# 以本机与官方发布说明为准"modules_licensed":["Xist"],# 已授权模块},"simulator":{"name":"未知",# 如 Aspen Plus / HYSYS / PRO/II / UniSim / VMGSim"version":"未知","has_htri_integration":"未知",# yes/no/unknown，查官方兼容性页或问销售},"integration_form":"未知",# direct / file_import / cape_open / xsimop"physical_property":{"htri_source":"VMGThermo",# 官方：安装含 VMGThermo"simulator_source":"未知","same_source":"未知",# yes/no},}ALLOWED={"integration_form":{"direct","file_import","cape_open","xsimop"},"physical_property.same_source":{"yes","no","未知"},}defcheck(facts):probs=[]iffacts["integration_form"]notinALLOWED["integration_form"]:probs.append("integration_form 须明确为 direct/file_import/cape_open/xsimop 之一")iffacts["simulator"]["name"]=="未知":probs.append("未登记模拟器名称")iffacts["simulator"]["has_htri_integration"]=="未知":probs.append("未确认该模拟器是否在官方兼容范围内（查官方兼容性页/问销售）")iffacts["physical_property"]["same_source"]!="yes":probs.append("物性来源不一致或未确认：跨软件结果差异的头号来源")returnprobsdefmain():probs=check(FACTS)print(json.dumps(FACTS,ensure_ascii=False,indent=2))ifprobs:print("\n[待确认项]（未确认前不要进入批量集成）")forpinprobs:print(" - "+p)else:print("\n[OK] 前置检查通过。")print("\n提示：HTRI 与模拟器兼容的具体产品名单以官方兼容性页与销售为准；")print(" 官方兼容性页给出分类计数（10/8/10/3/5），未逐一列举产品名。")if__name__=="__main__":main()

逐行剖析：

• integration_form用四值枚举（direct/file_import/cape_open/xsimop）：强制使用者先分清自己要做哪种集成（1.1 节的结论代码化），避免"混着做"。
• 物性来源单列并默认触发告警：VMGThermo 是官方安装含的物性生成器（[A]），若模拟器用另一套物性，跨软件结果会有系统性差异——把它当成一等公民检查项。
• "未确认该模拟器是否在官方兼容范围内"作为待确认项：不擅自列举兼容名单（底账 U5），把不确定性显式留在产物里。
• 打印提示明确"官方给计数、未逐一列举"：让使用者自己去找官方源，而不是从教程里抄名单。
• 纯标准库、可运行：任何机器能跑，先把"事实登记表"填对，再谈集成。

代码 13-2：导入件的前后字段核对

# -*- coding: utf-8 -*-""" import_check.py —— 导入件字段核对（适用于 UniSim/Aspen EDR/HTFS 导入） 用法：python import_check.py "exported_datasheet.csv" 说明：导入前，把来源软件导出的换热器数据表登录成"期望字段"， 导入后在 HTRI 案例里逐字段核对是否完整（子集传递陷阱）。 """importsysimportcsv# 期望字段（来源软件数据表里的关键项）——按你实际导入件填写EXPECT_KEYS=["shell_id","tube_od","tube_wall","tube_length","tube_pitch","tube_passes","baffle_spacing","duty","shell_side_inlet_T","tube_side_inlet_T",]defread_datasheet(path):"""读来源数据表；列名按你实际格式适配。"""data={}withopen(path,encoding="utf-8-sig")asf:forrincsv.DictReader(f):# 假设两列：参数名 / 值（按实际格式调整）data[r.get("parameter","").strip()]=r.get("value","")returndatadefmain():iflen(sys.argv)<2:print('用法：python import_check.py "exported_datasheet.csv"')returnsrc=read_datasheet(sys.argv[1])missing=[kforkinEXPECT_KEYSifknotinsrcorsrc[k]==""]print(f"来源数据表字段数：{len(src)}；期望字段数：{len(EXPECT_KEYS)}")ifmissing:print("导入前即缺失/为空的字段（需在来源侧补全）：")forkinmissing:print(" [缺] "+k)else:print("[OK] 期望字段在来源数据表中齐全。")print("\n下一步：导入 HTRI 后，用第 11 篇的跨模块核对思路逐字段复核导入结果，")print(" 不要假定'导入成功=字段完整'（跨软件传的是适用子集）。")if__name__=="__main__":main()

逐行剖析：

• 把"跨软件字段子集陷阱"提前到导入前：先在来源数据表里核对期望字段是否齐全，避免"导入后才发现关键几何缺失"。
• EXPECT_KEYS只列关键项（壳径、管径、管长、管间距、管程、折流板间距、热负荷、两侧进口温度）——按"缺了就不能算"的原则选，不求多。
• 提示指向第 11 篇的跨模块核对思路：导入后仍要复核，因为导入成功 ≠ 字段完整。
• 产物是"缺失清单"而非"成功报告"：工程脚本应优先暴露问题而非宣布胜利。

三、常见报错与排查

报错 3-1：以为"装 XSimOp 就能在 Aspen Plus 里用 HTRI"。
现象：在 Aspen Plus 里找不到 HTRI 单元操作。根因：官方具名的 XSimOp 首个产品XSimOp ShellTube集成于Honeywell UniSim Design Suite 与 KBC Petro-SIM；其它模拟器"will be considered in the future"。解法：确认目标模拟器是否在 XSimOp 官方支持范围内；若不在，改用 CAPE-OPEN 路径（Xist 可嵌入支持 CAPE-OPEN 的模拟器）或文件导入。

报错 3-2：导入后某些几何字段为空。
现象：案例跑不起来或缺关键几何。根因：导入的是"适用子集"，来源数据表本身缺字段或映射不覆盖。解法：用代码 13-2 在导入前核对；导入后用跨模块核对法复核；缺失项在 HTRI 侧补录。

报错 3-3：同一换热器，HTRI 与模拟器算出的传热系数差别较大。
现象：两边结果系统性偏差。根因：物性问题（两边用不同物性源：HTRI 侧通常是 VMGThermo）或方法差异（HTRI 用自有传热/压降关联式）。解法：先统一物性来源再比较；明确差异来自方法而非 bug；把差异本身作为设计裕量的考量项。

报错 3-4：拿一份"网上流传的 HTRI 兼容软件名单"当依据。
现象：按名单选了某软件，结果官方无对应集成。根因：官方兼容性页未逐一列举产品名（只给分类计数 10/8/10/3/5），流传名单多为二手且可能过期。解法：以官方兼容性页 + 销售确认为准；引用时只引官方计数，不引未验证名单。

报错 3-5：模拟器版本升级后集成失效。
现象：升级模拟器后原来能用的接口不通了。根因：版本兼容关系变化。解法：集成前把"版本兼容"列为前置检查项（代码 13-1）；升级任一侧后重跑前置检查。

四、动手练习

• 练习 1（分清形态）：写下你手上一个具体需求（如"把 Aspen EDR 的换热器搬进 Xist 校核"），并判定它属 direct / file_import / cape_open / xsimop 中的哪一种。判定：能明确说出所选形态及理由；若需求是"在模拟器里用 HTRI 算"，答案为 CAPE-OPEN 或 XSimOp。
• 练习 2（前置检查）：填写并运行代码 13-1。判定：无"[待确认项]"输出，或能解释每一待确认项的确认途径（官方兼容性页/销售）。
• 练习 3（官方计数引用）：打开官方兼容性页，抄录五个分类的计数。判定：列出 10/8/10/3/5 五项，并注明"官方未逐一列举产品名"。
• 练习 4（导入核对）：对一份来源数据表运行代码 13-2。判定：输出"来源数据表字段数"与"期望字段数"，并给出缺失清单（若齐全则打印 [OK]）。

五、小结与下一篇预告

本篇把"HTRI 与流程模拟软件集成"拆成三种形态并明确证据等级：官方确证Xist 有内置模拟器接口、可从 HTFS/UniSim Heat Exchangers/Aspen EDR 导入、可作 CAPE-OPEN 单元操作嵌入；第三方转录（降级表述）列出 Aspen Plus/HYSYS/PRO/II/UniSim/VMGSim；兼容性只信官方计数（10/8/10/3/5），不信流传名单。并确立一条工程纪律：跨软件结果差异的头号来源是物性来源不一致（HTRI 侧通常 VMGThermo）。

第 14 篇《与流程模拟软件集成（下）》：我们深入"在模拟器里用 HTRI"的正统路径——XSimOp ShellTube（已集成 UniSim Design 与 KBC Petro-SIM，数据共享免重复录入）与 CAPE-OPEN 单元操作，并给出"流程模拟器内 HTRI vs 外部 Automation Server"的分工矩阵。

本篇认知问题回显（FAQ）

Q1：HTRI 与流程模拟软件的集成有几种形态？
A：三种需要分清：一是模拟器内调用 HTRI 引擎（XSimOp 或 CAPE-OPEN 单元操作）；二是 Xist 直连模拟器（官方称 Xist 内置对大多数流程模拟器与机械设计软件的接口）；三是文件导入（从 HTFS、Honeywell UniSim Heat Exchangers、Aspen Exchanger Design & Rating 导入输入文件）。三者产品、许可与操作路径不同，选错形态就等于选错工具。

Q2：官方对"直连"到底说了什么，哪些是官方确证？
A：官方确证 [A] 的是 Xist 页的"Includes built-in interface to most process simulators and mechanical design software"，以及 Features 页把 process simulators 与 CAPE-OPEN compliant applications 列入可接口对象、Xist 可"embedded as a unit operation in any process simulator supporting CAPE-OPEN"。第三方转录 [C]（降级表述）才出现"Aspen Plus、HYSYS、PRO/II、UNISIM 与 VMGSim"这份名单；直连的具体机制细节未公开。

Q3：文件导入覆盖哪些来源，导入后要注意什么？
A：官方确证可导入 HTFS（管壳式与板翅）、Honeywell UniSim Heat Exchangers（管壳式与板翅）、Aspen Exchanger Design & Rating（管壳式、空冷、板翅）的输入文件。注意三点：导入的是输入而非结果（导入后仍要用 HTRI 方法重算）；要逐字段核对完整性（跨软件传的是适用子集）；保留导入源文件以形成审计链。

Q4：官方兼容性页的计数（10/8/10/3/5）是什么意思？
A：指官方按类别给出的兼容软件包数量——10 个物性包、8 个流程模拟包、10 个机械设计包、3 个集成工程包、5 个风机选型包，并提示"联系销售了解更多"。官网未逐一列举公司与产品名，因此引用计数比引用一份来源不明的"兼容名单"更可信；具体兼容性应向官方确认。

Q5：做集成前脚本应做哪些前置检查？
A：三件事：许可覆盖（HTRI 侧与模拟器侧是否都有相应许可）；版本兼容（Xchanger Suite 与模拟器版本是否在官方兼容范围内）；物性一致（两边是否用同一物性源，HTRI 安装含 VMGThermo，若不一致会产生系统性差异——这是跨软件结果不一致的头号来源）。把这些事实结构化登记并校验完整性，再进入批量集成。