4、第一个模型：创建简单电阻模型、仿真运行、查看结果

在完成了OpenModelica环境安装与界面熟悉之后，我们正式进入建模实战。本章将带领你从零开始，在OMEdit中创建一个最简单的电阻模型，完成仿真设置并查看仿真结果。这个看似简单的过程，实际上涵盖了Modelica建模的核心工作流：模型创建、参数设置、仿真配置、结果可视化与数据验证。通过这个最小闭环，你将建立起对OpenModelica操作逻辑的整体认知，为后续学习电阻、电容、电感等无源元件建模，乃至更复杂的电路系统仿真打下坚实基础。

上图展示了从模型创建到结果查看的完整工作流。下面我们将按照这个流程，逐步拆解每个环节的具体操作与背后的原理。

4.1 核心原理：Modelica建模的基本范式

在开始操作之前，理解Modelica的建模思想至关重要。与传统的Simulink等基于信号流的建模工具不同，Modelica采用基于方程的面向对象建模范式。这意味着我们不需要手动计算信号的传递方向，而是直接描述物理系统的守恒定律和本构关系。对于电阻模型，其核心物理规律就是欧姆定律：V = I × R，其中V是电压，I是电流，R是电阻值。

在Modelica中，电阻模型被抽象为一个具有两个电气端口的组件。每个端口（Pin）包含两个变量：电压v（势变量）和电流i（流变量）。根据基尔霍夫电压定律和电流定律，系统会自动处理端口之间的连接关系。这种基于物理拓扑的建模方式，使得模型结构与实际电路高度一致，大大提高了建模效率和可读性。

4.2 操作流程：从空白到可仿真的电阻模型

下面我们通过具体步骤，在OMEdit中完成电阻模型的创建。整个过程分为四个阶段，每个阶段都有明确的验证点。

阶段一：创建模型文件

1. 打开OMEdit，点击菜单栏 File → New → Modelica Class，弹出新建模型对话框。
2. 在 Name 输入框中填写 MyResistor，在 Type 下拉菜单中选择 model（模型类型）。
3. 点击 OK 后，OMEdit会打开一个文本编辑器视图，默认生成如下代码框架：

model MyResistor
  // 此处编写模型代码
end MyResistor;

阶段二：编写模型代码

在模型框架中，我们需要添加参数声明、端口定义和方程。完整的电阻模型代码如下：

model MyResistor
  // 参数声明：电阻值，默认100欧姆
  parameter Modelica.SIunits.Resistance R = 100 "电阻值";
  
  // 电气端口定义
  Modelica.Electrical.Analog.Interfaces.PositivePin p "正极";
  Modelica.Electrical.Analog.Interfaces.NegativePin n "负极";
  
  // 内部变量
  Modelica.SIunits.Voltage v "电压降";
  Modelica.SIunits.Current i "电流";
  
equation
  // 电压与端口的关系
  v = p.v - n.v;
  // 电流连续性
  p.i = i;
  n.i = -i;
  // 欧姆定律
  v = R * i;
  
end MyResistor;

这段代码中，parameter关键字声明了一个可调参数R，Modelica.SIunits.Resistance是Modelica标准库中的电阻单位类型。端口p和n分别代表正极和负极，通过connect语句与其他元件相连。方程部分描述了电压、电流和电阻之间的物理关系。

阶段三：仿真设置

模型编写完成后，点击工具栏上的 仿真设置 按钮（齿轮图标），弹出仿真配置对话框。关键设置项如下：

设置项	推荐值	说明
停止时间（Stop Time）	1.0 s	仿真结束时间，对于静态电阻测试1秒足够
容差（Tolerance）	1e-6	数值求解精度，默认值即可
求解器（Solver）	DASSL	默认的变步长隐式求解器，适合刚性系统
输出间隔（Output Interval）	0.01 s	结果采样间隔，影响曲线平滑度

对于这个简单的电阻模型，我们还需要提供一个激励源才能产生可观测的响应。可以在模型中添加一个直流电压源，或者通过外部电路连接。为了简化，我们直接在模型中添加一个恒定电压源：

  Modelica.Electrical.Analog.Sources.ConstantVoltage Vdc(V=10);
  Modelica.Electrical.Analog.Basic.Ground ground;
equation
  connect(Vdc.p, p);
  connect(Vdc.n, n);
  connect(Vdc.n, ground.p);

阶段四：仿真运行与结果查看

点击 仿真运行 按钮（绿色播放图标），OMEdit会编译模型并启动仿真。仿真完成后，会自动打开 Plot View 窗口。在变量浏览器中，展开 MyResistor 节点，双击 v 和 i 变量，即可在绘图区看到电压和电流随时间变化的曲线。

4.3 案例拆解：直流激励下的电阻响应

为了更直观地理解仿真结果，我们设计一个完整的测试案例。假设我们要验证一个100Ω电阻在10V直流电压下的电流是否符合欧姆定律。

案例参数：

• 电阻值：R = 100 Ω
• 直流电压：Vdc = 10 V
• 仿真时间：0 ~ 1 s

预期结果：根据欧姆定律，电流 I = V / R = 10 / 100 = 0.1 A。仿真曲线应该显示：电压从0时刻起稳定在10V，电流稳定在0.1A，没有瞬态过程（因为电阻是静态元件）。

实际操作步骤：

1. 在模型中设置R=100，Vdc=10。
2. 运行仿真，查看结果曲线。
3. 使用绘图区的 测量工具（光标图标），点击曲线上的任意点，读取精确数值。
4. 在变量浏览器中，右键点击变量，选择 Export Data 导出CSV格式数据，用Excel验证。

结果验证：仿真得到的电流值应为0.1A，与理论计算完全一致。如果出现偏差，检查参数设置是否正确，或者模型方程是否有误。

4.4 常见误区与总结复盘

在创建第一个模型的过程中，有几个高频问题需要特别注意：

误区类型	错误表现	正确做法
单位错误	电阻值写成100而不是100.0	使用Modelica.SIunits类型，自动处理单位换算
端口连接错误	正负极接反，导致电流方向异常	遵循电流从正极流入、负极流出的约定
缺少接地	仿真报错"Singular system"	添加Ground元件，提供参考电位
参数未定义	使用未声明的变量	所有变量必须在使用前声明
方程不一致	方程数量多于或少于变量数	检查方程数量是否等于未知变量数量

总结复盘：通过本章的学习，我们完成了第一个可仿真的电阻模型。这个过程中，我们掌握了Modelica建模的基本语法、OMEdit的操作流程、仿真参数的配置方法以及结果验证的技巧。这些技能是后续学习更复杂模型的基础。建议读者自行修改电阻值、电压值，观察结果变化，加深对欧姆定律和仿真流程的理解。