3. Dymola集成开发环境与工作流

Dymola 的集成开发环境（IDE）围绕“模型—仿真—结果—脚本”这一条主线组织。初学者最容易犯的错误，是把注意力全部放在画图或写方程上，而忽略了环境本身提供的库浏览、仿真配置、结果分析与脚本接口。实际上，一个多物理系统模型能否被高效地建立、复现和验证，很大程度上取决于你是否熟悉这套工作流的每个环节。本节将按实际使用顺序，把界面布局、模型库浏览、文本与图形建模、仿真设置、结果查看、脚本自动化与版本管理基础串成一条可操作的路径。

界面布局：四个核心区域

Dymola 主窗口通常可划分为四个功能区。左侧是包浏览器（Package Browser），以树形结构展示已加载的模型库和用户模型；中部是图形/文本编辑区，同一模型可在图形视图（Diagram）与文本视图（Modelica 代码）之间切换；右侧或下方是变量浏览器与仿真设置区，用于选择待记录变量、设置仿真参数；底部是消息与命令窗口，显示编译、翻译、仿真日志以及可执行的命令。理解这四个区域的分工，是后续所有操作的基础。

需要特别注意的是，Dymola 的“图形视图”和“文本视图”并非两套独立模型，而是同一 Modelica 模型的两种呈现。在图形视图中连线、放置组件，等价于在文本视图中生成对应的实例声明和连接方程。因此，当图形连线出现困难时，直接切到文本视图检查 connect() 语句往往更快。

模型库浏览：从标准库到自建库

Dymola 安装后自带 Modelica 标准库，涵盖 Modelica.Blocks、Modelica.Mechanics、Modelica.Thermal、Modelica.Electrical 等子库。浏览库时，建议先看 package.mo 的层级，再逐层展开到具体组件。例如要建立一个质量—弹簧—阻尼系统，可在 Modelica.Mechanics.Translational 下找到 Mass、Spring、Damper、Fixed 等组件。每个组件都有参数对话框，参数名和单位在文本视图中一目了然。

对于自建库，推荐在 File > New > Package 中创建自己的包，例如 MyLib，再在其中建立子包和模型。这样做的目的是让模型具备可移植的命名空间，便于版本管理和团队共享。库浏览器的右键菜单还提供“另存为”“复制路径”“查看源码”等操作，是排查组件来源的常用入口。

文本与图形建模：两种视图的配合

图形建模适合搭建系统拓扑：从库中拖入组件，用连接线建立物理连接或信号连接。以弹簧—质量—阻尼系统为例，图形视图中依次放置 Fixed、Spring、Mass、Damper，并将 Mass 的 flange_a 与 Spring 的 flange_b 相连，Damper 并联在 Fixed 与 Mass 之间。此时文本视图会自动生成类似下面的结构：

model SpringMassDamper
  Modelica.Mechanics.Translational.Components.Fixed fixed;
  Modelica.Mechanics.Translational.Components.Spring spring(c=1000);
  Modelica.Mechanics.Translational.Components.Mass mass(m=1);
  Modelica.Mechanics.Translational.Components.Damper damper(d=10);
equation
  connect(fixed.flange, spring.flange_a);
  connect(spring.flange_b, mass.flange_a);
  connect(damper.flange_a, fixed.flange);
  connect(damper.flange_b, mass.flange_a);
end SpringMassDamper;

文本建模则适合处理图形难以表达的方程、条件逻辑和自定义组件。例如需要给质量块施加一个阶跃力，可在文本视图中加入 Modelica.Blocks.Sources.Step 并通过 Modelica.Mechanics.Translational.Sources.Force 接入。两种视图的切换不会丢失信息，但修改后必须重新“翻译”（Translate）模型，Dymola 才会检查方程系统的完整性和一致性。

仿真设置与结果查看

仿真前需要在 Simulation > Setup 中设置关键参数。以弹簧—质量—阻尼系统为例，可设置仿真区间 StartTime = 0、StopTime = 10，求解器选择 Dassl，相对容差 1e-6。若系统存在刚性，可改用 Radau IIa 或 Esdirk45a。变量记录在 Output 或 Variable Browser 中勾选，例如记录 mass.s（位移）和 mass.v（速度）。

仿真完成后，结果在 Plot 窗口中显示。判断结果是否合理，可从三个角度入手：一是位移曲线是否在平衡位置附近衰减振荡；二是速度峰值是否与初始条件一致；三是能量是否随时间单调下降（有阻尼时）。若曲线出现剧烈抖动或数值发散，通常需要检查求解器容差、事件处理或连接方程是否存在代数环。

脚本自动化与版本管理基础

当模型数量增多、仿真工况重复时，手工点击效率很低。Dymola 支持通过 .mos 脚本文件批量执行命令。例如，下面的脚本可自动加载库、翻译模型、设置仿真参数并运行：

openModel("MyLib.SpringMassDamper");
translateModel("MyLib.SpringMassDamper");
simulateModel("MyLib.SpringMassDamper", stopTime=10, method="Dassl", tolerance=1e-6, resultFile="smd");
plot({"mass.s", "mass.v"});

脚本可在 Commands 窗口中逐行执行，也可通过 File > Run Script 整体运行。对于参数扫描，可结合 for 循环和 simulateModel 的 resultFile 参数，生成多组结果文件后统一比较。

版本管理方面，Dymola 模型本质上是文本文件（.mo），因此可以直接纳入 Git 等版本控制系统。建议遵循三条基本规则：一是每个模型或包单独提交，提交信息写明变更的物理含义；二是避免提交 .dymosim、.mat 等仿真生成文件，只保留源码和脚本；三是利用分支管理不同设计工况，例如 main 分支保存基准模型，feature/damping-sweep 分支用于阻尼参数扫描。这样，当仿真结果出现异常时，可以快速回溯到具体版本并复现问题。