SystemSimulationApp/README.md

SystemSimulationApp

本仓库用于把 Modelica 和 AMESim 系统模型迁移到可运行、可测试、可与原模型结果对比的 Python 仿真平台。

当前模型

• Testmodel：旧 Modelica 迁移模型，已有可运行的 ODE 近似、结果导出和 OpenModelica 对比能力。
• test_mql：当前开发主线，从 AmesimModels/test_mql.ame 迁移到 PythonModels。

test_mql 已完成 112 个气动状态和 20 个机械状态组成的 132 状态总闭包，可以短时积分并按 AMESim Data_Path 生成 comparison 报告。当前工作重点已经从拓扑接入转为数值校准；尚不能宣称 Python 结果与 AMESim 完全一致。

目录

• AmesimModels/：AMESim 源模型及模型级迁移说明。
• PythonModels/core/：状态、网络、介质和求解器基础设施。
• PythonModels/components/：气动、机械及通用组件方程。
• PythonModels/systems/：系统装配、closure、snapshot、端口写回和 RHS。
• PythonModels/reporting/：AMESim 结果读取、schema validation 和误差比较。
• PythonModels/scripts/：仿真与 comparison 命令行入口。
• tests/：组件、闭包、运行入口和回归测试。

运行 test_mql

运行默认的 132 状态短时域 AMESim 对比：

python3 -m PythonModels.scripts.run_test_mql_full_state_comparison

运行全量测试：

python3 -m unittest discover -s tests -t .

详细迁移说明见 AmesimModels/test_mql/README.md，Python 平台说明见 PythonModels/README.md。本机开发恢复记录保存在根目录 STATUS.md；该文件被 .git/info/exclude 忽略，不会随正常提交推送。