test_mql

本目录记录从 AMESim 模型 test_mql.ame 迁移到 PythonModels 的当前状态。

模型命名

仓库内模型名：test_mql
Python 系统类：TestMqlSystem
Python 配置解析类：TestMqlConfig
Python 运行入口：PythonModels/scripts/run_test_mql.py

源文件

AMESim 源模型：AmesimModels/test_mql.ame
该 .ame 文件本质是一个 tar 包，内部包含 test_mql_.cir、test_mql_.param、test_mql_.modelinfo、test_mql_.sim 等文件。

当前新增文件

PythonModels/systems/test_mql.py
- 记录 AMESim 组件清单、全局参数、子模型分布、连接拓扑和 AMESim modelinfo 状态数。
- 当前是结构化 Python 迁移骨架，不是完整 AMESim 物理方程复刻。
PythonModels/systems/test_mql_config.py
- 提供 TestMqlConfig.from_amesim_specs()。
- 负责把 AMESim 全局参数和组件参数解析成后续可用的 Python 配置对象。
- test_mql 默认工质已按 AMESim 模型确认设为氦气。
- 已支持常量、全局参数引用、四则运算、括号和 AMESim 风格的 ^ 指数表达式。
- 非数值文本会保留为 None，后续按具体子模型显式处理。
PythonModels/scripts/run_test_mql.py
- 提供独立运行入口。
- 当前输出结构摘要和基础序列，后续逐步接入真实物理方程。
tests/test_test_mql_structural.py
- 保护组件数、连接数、状态数、全局参数和关键子模型计数。
tests/test_test_mql_config.py
- 保护全局参数解析、AMESim 表达式解析、按子模型分组、默认氦气工质和典型组件参数解析。
PythonModels/core/peng_robinson.py
- 提供 Peng-Robinson 状态方程小物性库。
- 当前覆盖压缩因子、摩尔体积、密度和由密度反算压力。
- 已内置 HELIUM_PR，供 test_mql 默认使用。

物性约定

AMESim 模型中 test_mql 使用氦气，Python 侧当前通过 HELIUM_PR 使用 Peng-Robinson 状态方程计算气体压缩因子和密度。当前物性层先覆盖状态方程相关量，完整焓/内能偏差函数后续在接气室能量方程时再补。

当前提取结果

组件数：117
连接数：84
AMESim 连续状态数：132
AMESim 离散状态数：24
全局参数：D1=20、D2=20、D3=14、P0=153、Pdq=1、V=15、cf=0.45

主要 AMESim 子模型分布：

F000: 16
PNPL01: 16
MECMAS21: 10
PNRP17: 8
LSTP00A: 8
PNCH012: 8
PNOR001: 8
PN3NODE2: 8
P4NODE2: 8
PNVO001: 8
STEP0: 8
PNCH023: 4
LMECHN1: 2
FORC: 2
UD00: 2
PNGD00: 1

结果对齐原则

后续 Python 仿真结果必须以 AMESim 为基准做一一对应校验：

组件别名优先沿用 AMESim 原名，例如 pn_brp2_8、pn_c1_8、pn_orifice_18。
子模型族优先沿用 AMESim 子模型名，例如 PNRP17、PNCH012、PNOR001、PNVO001。
输出变量命名要能追溯到 AMESim 的 Data_Path，避免 Python 侧改名后无法对比。
Python 每完成一批物理方程，都应拿 AMESim 导出的 CSV 结果做误差对比。
当前 .ame 包内的 test_mql_.results 是 AMESim 二进制结果文件，暂不作为直接解析基准；建议后续从 AMESim 导出 CSV 结果放到本目录下。
在没有 AMESim CSV 基准前，不能把 Python 输出描述为“已经和 AMESim 几乎一致”，只能说明完成了结构、参数或某类组件方程。

验证方式

python3 -m py_compile PythonModels/core/peng_robinson.py PythonModels/systems/test_mql.py PythonModels/systems/test_mql_config.py PythonModels/scripts/run_test_mql.py
python3 -m PythonModels.scripts.run_test_mql
python3 -m unittest discover -s tests -t .

当前测试覆盖的是结构和配置解析，不代表已经完成 AMESim 物理结果复刻。

后续方向

后续继续补模型时，保持只新增或修改 test_mql 相关代码，不改旧的 testmodel。建议按下面顺序逐步实现真实物理方程：

PNGD00：气体属性。
PNCH023 / PNCH012：固定气室和变容气室。
PNOR001 / PNVO001：固定孔口和可变孔口。
PNL0001 / PNL0002 / PNL0003 / PNL00R：管路阻容连接。
PNRP17 / MECMAS21 / LSTP00A / LMECHN1：气动活塞、机械负载和端止动。

4.3 KiB Raw Blame History