3、Modelica标准库入门：常用模型库（Modelica.Mechanics、Modelica.Electrical等）的使用方法

Modelica语言的核心优势之一在于其丰富的标准库（Modelica Standard Library，MSL），它为用户提供了跨物理领域、经过严格验证的现成模型组件。对于联合仿真工程师而言，掌握标准库的组织结构、核心模型语义以及正确的参数配置方法，是构建复杂多物理系统模型的基础。本章将聚焦于最常用的机械（Mechanics）与电气（Electrical）库，同时兼顾多领域接口（Modelica.Blocks与Modelica.ComplexBlocks），帮助学习者建立从“库浏览”到“模型装配”的完整认知路径。

3.1 Modelica标准库的总体架构与检索方法

核心原理：库的层级结构与继承机制

Modelica标准库采用严格的包（Package）层级组织，每个包对应一个物理域或功能类别。顶层包名即Modelica，其下按领域划分为Mechanics、Electrical、Thermal、Fluid、Blocks等子包。这种设计不仅便于用户按需加载，更重要的是通过继承机制实现了模型复用——例如Modelica.Mechanics.Rotational.Components.Inertia继承自基类Modelica.Mechanics.Rotational.Interfaces.PartialInertia，用户自定义模型时可以直接继承标准库组件并扩展参数。

在联合仿真场景中，标准库的接口定义（Connector）是跨工具协同的关键。每个连接器（如Flange_a、Pin、RealOutput）都包含明确的势变量（Across）与流变量（Through），例如旋转机械中的角度phi与扭矩tau，电气中的电压v与电流i。理解这些变量的物理含义，是正确配置FMU输入输出映射的前提。

判断方法：如何快速定位所需模型

面对庞大的标准库，建议遵循以下检索流程：

1. 确定物理域：首先判断问题属于机械、电气、热还是流体领域，进入对应顶层包。
2. 选择抽象层级：若只需集总参数模型，选择Rotational或Translational；若需考虑三维空间运动，则进入MultiBody。
3. 检查接口类型：确认所需连接器是“功率接口”（如机械法兰、电气引脚）还是“信号接口”（如RealInput）。功率接口用于物理域内连接，信号接口用于跨域控制。
4. 利用搜索功能：在建模工具（如Dymola、OpenModelica）中使用“类搜索”功能，输入关键词如“DC motor”或“PID”，直接定位到Modelica.Electrical.Machines.BasicMachines.DCMachines等具体类。

3.2 Modelica.Mechanics：机械系统建模实战

核心原理：旋转与平移的建模范式

Modelica.Mechanics.Rotational库采用“法兰”（Flange）作为连接器，每个法兰包含两个变量：角度phi（势变量）和扭矩tau（流变量）。这种设计遵循键合图（Bond Graph）思想，使得机械网络与电路网络在数学上具有同构性。例如，转动惯量（Inertia）对应电路中的电容，弹簧（Spring）对应电感，阻尼器（Damper）对应电阻。理解这种类比关系，有助于将电气领域的经验迁移到机械建模中。

对于MultiBody库，情况更为复杂。它使用三维空间中的坐标系变换来描述刚体运动，连接器Frame_a和Frame_b包含位置向量、旋转矩阵以及力和力矩的六维表示。在联合仿真中，MultiBody模型通常需要与控制系统（通过Modelica.Blocks）交互，此时需要借助Modelica.Mechanics.MultiBody.Sensors中的传感器组件，将机械量转换为标准信号输出。

操作流程：构建一个简单的旋转传动系统

以下步骤演示如何从零搭建一个包含电机、惯量、弹簧和负载的旋转系统：

1. 从Modelica.Mechanics.Rotational.Components拖入Inertia（电机转子惯量）、SpringDamper（柔性联轴器）、Inertia（负载惯量）。
2. 从Modelica.Mechanics.Rotational.Sources拖入Torque（输入扭矩源）。
3. 使用Modelica.Mechanics.Rotational.Sensors中的SpeedSensor测量负载转速。
4. 按顺序连接：Torque → Inertia1 → SpringDamper → Inertia2 → SpeedSensor。
5. 设置参数：Inertia1.J=0.01 kg·m²，SpringDamper.c=100 N·m/rad，SpringDamper.d=1 N·m·s/rad，Inertia2.J=0.05 kg·m²。
6. 添加阶跃扭矩信号（从Modelica.Blocks.Sources拖入Step），连接到Torque的输入。

// 关键参数配置示例
Modelica.Mechanics.Rotational.Components.Inertia inertia1(J = 0.01);
Modelica.Mechanics.Rotational.Components.SpringDamper coupling(c = 100, d = 1);
Modelica.Mechanics.Rotational.Components.Inertia inertia2(J = 0.05);
Modelica.Mechanics.Rotational.Sources.Torque torque;
Modelica.Blocks.Sources.Step step(startTime = 0.1, height = 5);

案例拆解：电机-负载系统的联合仿真

某自动化设备厂商需要验证伺服电机与皮带传动机构的动态响应。系统参数：电机转子惯量0.002 kg·m²，皮带轮减速比3:1，负载惯量0.5 kg·m²，皮带刚度5000 N/m，阻尼系数20 N·s/m。初始仿真发现，在阶跃指令下负载端出现持续振荡，且振荡频率与理论计算值偏差约15%。

分析过程：首先检查模型结构，确认减速器（IdealGear）的安装方向是否正确——齿轮比参数ratio定义为输入转速/输出转速，若设置反将导致惯量折算错误。其次，检查弹簧阻尼器的刚度值是否按折算到电机轴侧计算。经计算，皮带刚度折算到电机轴的等效刚度为5000 / (3²) ≈ 555.6 N·m/rad，而模型中直接使用了5000，导致振荡频率偏高。

修正操作：将SpringDamper.c改为555.6，同时将阻尼系数折算为20 / (3²) ≈ 2.22 N·m·s/rad。重新仿真后，振荡频率与理论值偏差降至2%以内，系统响应符合预期。

3.3 Modelica.Electrical：电气与电机建模要点

核心原理：模拟电路与电机模型的统一框架

Modelica.Electrical.Analog库基于基尔霍夫定律，使用Pin连接器表示电路节点。每个Pin包含电压v（势变量）和电流i（流变量），电流方向定义为从p端流入、从n端流出。这种非因果建模方式允许模型自动满足KCL和KVL，无需手动编写节点方程。

对于电机模型，Modelica.Electrical.Machines库提供了从直流电机到异步电机的完整系列。这些模型内部集成了电气子模型（电枢绕组、励磁绕组）和机械子模型（转子惯量、阻尼），并通过Pin连接器与外部电路交互，通过Flange连接器与机械负载交互。这种多域耦合特性使得电机成为联合仿真的典型对象——电气侧由逆变器驱动，机械侧连接负载，控制算法通过信号接口介入。

操作流程：搭建永磁同步电机（PMSM）驱动系统

以Modelica.Electrical.Machines.BasicMachines.SynchronousInductionMachines.SM_PermanentMagnet为例：

1. 从Machines库拖入PMSM模型，设置极对数p=4，永磁磁链Phi_p=0.1 Wb，定子电阻Rs=0.5 Ω，定子电感Ld=Lq=0.005 H。
2. 从Modelica.Electrical.Analog.Sources拖入SineVoltage作为三相电源，设置幅值311V、频率50Hz、相位互差120°。
3. 从Modelica.Mechanics.Rotational.Components拖入Inertia作为负载，设置J=0.01 kg·m²。
4. 连接电机电气端口（plug_p、plug_n）到三相电源，机械法兰（flange）到负载惯量。
5. 添加Modelica.Electrical.Machines.Sensors中的ElectricalPowerSensor和MechanicalPowerSensor，用于监测输入输出功率。

常见误区与复盘

• 忽略参考地：在模拟电路中，必须为每个独立电源回路提供参考地（Ground），否则仿真器无法确定电压，导致奇异矩阵错误。
• 电机参数单位混淆：电感单位是亨利（H），但有些数据手册给出的是毫亨（mH），直接使用会导致电流响应偏差1000倍。
• 忽视热效应：标准库中的电机模型默认是等温的，若需考虑温升对绕组电阻的影响，需要扩展模型或耦合Modelica.Thermal库。

3.4 Modelica.Blocks与跨域信号交互

核心原理：信号接口的因果化处理

与物理域连接器（功率接口）不同，Modelica.Blocks库中的连接器是因果化的——信号只能从输出流向输入，没有物理功率约束。这种设计非常适合控制系统建模，因为控制算法本质上是信号处理过程。在联合仿真中，Blocks库充当“翻译官”角色：将物理传感器信号（如转速、电流）转换为标准实数信号，或将控制指令转换为物理源（如电压源、扭矩源）的输入。

操作流程：构建PID闭环控制回路

以电机转速控制为例：

1. 使用Modelica.Blocks.Math.Feedback计算转速误差（给定值-反馈值）。
2. 将误差信号输入Modelica.Blocks.Continuous.PID，设置k=10，Ti=0.5，Td=0.01。
3. PID输出连接到Modelica.Electrical.Analog.Sources.SignalVoltage的信号输入端，将控制信号转换为电压。
4. 从Modelica.Mechanics.Rotational.Sensors.SpeedSensor获取实际转速，转换为反馈信号。

// PID参数整定示例
Modelica.Blocks.Continuous.PID pid(
  k = 10,          // 比例增益
  Ti = 0.5,        // 积分时间常数（秒）
  Td = 0.01,       // 微分时间常数（秒）
  yMax = 300,      // 输出上限
  yMin = -300      // 输出下限
);

案例拆解：多域联合仿真中的信号延迟问题

某团队在Simulink中搭建整车控制器，在Dymola中搭建电机与机械模型，通过FMU进行联合仿真。初始运行时发现，在10kHz通信频率下，系统出现高频振荡。分析日志发现，FMU的通信步长设置为0.1ms，但控制器模型内部使用了固定步长求解器（步长1ms），导致信号混叠。

解决方案：将FMU通信步长调整为1ms（与控制器步长一致），并在控制器输出端添加一阶低通滤波器（截止频率500Hz）以抑制高频噪声。修改后系统稳定，且控制精度满足要求。此案例说明，联合仿真中信号同步策略与滤波器设计同等重要。

3.5 标准库在联合仿真中的高级应用

核心原理：FMU导出与接口映射

将标准库模型导出为FMU时，需要明确哪些变量作为输入、哪些作为输出。对于物理连接器（如Flange、Pin），通常需要将其内部变量（如phi、tau、v、i）映射为FMU的实数输入/输出端口。这一过程在Dymola中通过“FMU Export”向导完成，用户可以选择将连接器变量暴露为端口，也可以使用Modelica.Blocks.Interfaces中的信号端口作为替代。

操作流程：标准库模型的FMU导出步骤

1. 在建模环境中打开目标模型，确保模型可编译且仿真通过。
2. 选择“File → Export → FMU”，选择FMU版本（2.0或3.0）和类型（Model Exchange或Co-Simulation）。
3. 在“Variable Selection”中勾选需要暴露的变量，建议使用信号端口而非物理端口。
4. 设置求解器参数：对于Co-Simulation类型，需指定通信步长和求解器容差。
5. 导出后，在目标工具（如Simulink）中导入FMU，检查端口映射是否正确。

3.6 本章总结与常见误区复盘

通过本章学习，应掌握以下核心能力：能够根据物理域选择正确的标准库子包；理解功率接口与信号接口的本质区别；熟练配置机械库中的惯量、弹簧、阻尼参数；正确搭建电气电路并处理接地问题；利用Blocks库实现跨域控制闭环；以及将标准库模型导出为FMU进行联合仿真。

常见误区归纳如下：

• 混淆功率接口与信号接口：将RealOutput直接连接到Pin会导致单位不匹配，必须通过SignalVoltage或CurrentSensor等转换组件。
• 忽略参数的单位换算：标准库默认使用SI单位制，但工程数据常以非SI单位给出（如rpm、kW），需在参数设置时统一换算。
• 过度依赖默认参数：标准库组件的默认参数仅用于演示，实际工程中必须根据物理对象重新标定。
• 忽视模型验证：在联合仿真前，应先在纯Modelica环境中对标准库模型进行单元测试，确认其行为符合物理规律。