MATLAB Simulink电力系统建模与仿真：单机无穷大系统实战与避坑指南

简介：一份整理自于群教授《MATLAB_Simulink电力系统建模与仿真》的学习资料，面向电力系统从业者、工程师与科研人员，帮助读者系统掌握基于MATLAB/Simulink的建模与仿真方法。内容从MATLAB基本语法、数据类型与控制结构讲起，逐步过渡到Simulink图形化建模界面与工作流程；随后深入电力系统核心元件如发电机、变压器、线路、负荷的模块配置与参数设置，并讲解同步发电机励磁控制、系统频率调整等动态过程的建模方法。教程还覆盖仿真时间步长、初始条件设置、结果分析与可视化，以及电网故障分析、新能源并网等实际案例，可用于课程学习、课题研究或工程验证。压缩包为zip格式，整体大小约24.93MB，属于教程文档类资料，便于按章节翻阅。目前已有4803人学习下载，适合初学者系统入门，也为中高级研究者提供参考。

1. 电力系统建模与仿真，为什么我劝你先别绕开 Simulink

电力系统建模与仿真，很多人一上手就想着纯写 M 脚本，把发电机、变压器和线路的微分方程组自己排一遍，结果被数值稳定性问题按在地上反复摩擦。标题里的“于群 MATLAB_Simulink电力系统建模与仿真”，对应的是 MATLAB 文档体系里 Simulink / Simscape Electrical 这条完整链路：你不是从零写求解器，而是把元件模型拖进画布、填对参数、设好求解器，然后让波形替你说话。这套方法特别适合三类人：刚进电力系统方向的硕博生，需要快速验证控制或保护策略的工程师，以及想把“建模过程”本身留成可追溯 matlab 文档的团队。它解决的痛点很直接——让拓扑可见、参数可查、运行可持续改。

2. 把 MATLAB 文档当成地图：Simulink 电力系统建模的选型与初始化

动手建模型之前，先记住一个原则：Simulink 建模最大的资产不是画布上的线，而是 MATLAB 文档里那套“每个模块、每个参数都有据可查”的体系。很多人对着模型改半天，转发给同事却连“这个参数为什么设 0.1”都讲不清，原因就是一开始把文档扔到一边。于群这套资料的真实价值，恰恰是把“查文档、改参数、看波形”串成一条可以反复走的流程。下面从选型、环境检查和文档用法三个层面展开。

2.1 为什么选 Simulink 而不是纯 M 脚本：模型本身就是文档

纯 M 脚本建模不是不能做，而是维护成本太高。电力系统暂态仿真至少包含同步电机、变压器磁路、线路分布参数、断路器动作和故障模块，每个对象都要自己搭方程，光三相坐标变换和相序网络就要处理半天。Simulink 的 Specialized Power Systems 库（旧称 SimPowerSystems）把这一层封装好了：同步电机模块内部实现了 Park 方程和机械运动方程，三相变压器建模时自动处理联结组别和漏抗，线路支持 PI 模型和分布参数模型。你要做的不是重新推导公式，而是选择与实际电网一致的元件模型。

更重要的是“模型即可执行文档”。把一个持续改进的 Simulink 模型放到团队环境里，别人看拓扑结构就能理解方案；再配合 MATLAB 文档中的模块参数页，每个参数都能回溯到官方定义。相比 M 脚本只能用注释和变量名提示，Simulink 的图形化表达更适合电力系统这样多端口、多耦合的仿真对象。后续做故障分析、保护整定或控制器验证，模型的复用性都会比脚本高很多。

这就是我为什么一上来就强调选型：先想清楚用什么建模，再看怎么建。Simulink 特别适合“既要能出波形，又要方便给别人讲清楚”的场景；如果你只是做一个纯算法推导、不涉及元件交互的课题，那反而没必要拖出 Simulink，M 脚本更快。可惜多数电力系统题目都绕不开电磁暂态和机械暂态的耦合，所以 Simulink 才是多数人的第一选择。等到了多机系统、微网或交直流混合电网阶段，你会发现团队协作时大家认的也是 Simulink 模型，而不是一堆散落的 m 文件。

2.2 用命令行把工具箱和环境检查清楚：少进一个黑匣子

建模前先别急着拖模块，先回答三个问题：Simulink 装了吗？Simscape Electrical 装了吗？授权里有没有 Simscape Electrical 的 License？这三个问题的答案直接决定后面能做多少事。很多人在命令行里敲了sim，才看到一连串 toolbox missing，那才是真翻车。与其到时候后悔，不如一开始就把环境查清楚。

常见做法是打开 MATLAB，先敲这一段：

% 检查三个最关键的环境项 ver('Simulink') % 输出 Simulink 版本信息 ver('Simscape') % 输出 Simscape 基础库版本 license('test', 'Simscape_Electrical') % 有授权返回 1，没有返回 0

逻辑很简单：ver是 MATLAB 查已安装工具箱的函数，license是查许可状态的函数。第二行里的Simscape是基础库，第三行的Simscape_Electrical是电力系统专业库，注意这个工具箱在不同版本的 MATLAB 文档里也可能写成 “Simscape Electrical Toolbox”。如果帮助文档里搜“电力系统”，老资料叫 SimPowerSystems，新资料叫 Specialized Power Systems，路径其实指向同一个地方，别被名字绕晕。

如果你的环境没有Simscape_Electrical，后面所有电源、电机、变压器模块都拉不出来。这里有一条判断依据：powerlib这个函数能直接打开专用元件库，如果它能运行，说明环境基本就位；如果它报“库不存在”，多半是缺少工具箱，回到 MATLAB 安装器里补装并重新激活即可。补装的时候注意，MATLAB 安装器里不同工具箱的勾选是独立的，光装了 MATLAB 主包不等于装了 Simscape，这一步很容易被忽略。

除了环境检查，我一般还会打开 MATLAB 文档首页，把 “Simscape Electrical Toolbox 功能列表” 扫一遍。文档里的库分类列表就是最好的索引：Machines（电机）、Elements（RLC 元件）、Power Electronics（电力电子）、Sources（电源）、Measurements（测量）等。你要找的发电机和变压器分布在 Machines 和 Elements 下，故障模块则在 Circuit Breakers 一类。先浏览这个列表，等建模型时就能少走弯路。这个功能列表比任何入门教程都准确，因为它随版本实时更新，比我记忆中的库路径可靠得多。

提示：R202x 之后，“SimPowerSystems”这个名字在新文档里基本不再出现，统一走 Simscape Electrical 的 Specialized Power Systems。搜索资料时优先搜“Specialized Power Systems”，否则容易查到十年前的老界面，对不上号。

2.3 最快路径：先改官方示例，再自己搭模型

环境检查完，不要从一个空白模型开始硬建。MATLAB 文档里有一个很实用的习惯：每个模块页都带 “Examples”，每个示例模型都可以下载并打开，修改参数，存成自己的模型。我自己的流程是：先找到最接近需求的官方示例，另存为项目文件，然后一层层拆掉不要的部分，保留电机、变压器和线路，再替换成自己的参数。

具体执行可以用命令行，也可以纯操作 GUI：

% 打开电力系统专用元件库，并在浏览器中查三相故障模块 powerlib doc('simscape/three-phase-fault') % 若路径报错，直接在文档搜索框输入 three phase fault

这两行命令的作用是：powerlib打开可视化库，方便手动查看模块；doc打开的是模块的官方帮助页。官方帮助页里通常包含参数定义、数学描述和至少一个可复制的例子，这是新手最容易忽略的 matlab 文档入口。很多模块的 mask 参数（也就是双击模块后那一堆输入框）在帮助页里有逐项解释，远比在论坛里搜零散的中文回答靠谱。

在“先抄后改”的阶段，注意一个细节：官方示例往往依赖某些回调脚本（InitFcn）或基础工作区变量，另存到新文件夹后，要把这些依赖一起带走，或者在模型回调里用edit查看脚本内容。如果漏了这一步，模型在新目录下打开会报 “Undefined variable”，然后你就开始了一场和黑匣子的战斗。我一般会在模型属性里查看 “Callbacks” 中每一行，确认没有隐藏的初始化代码再继续改。更稳妥的做法是直接搜索evalin('base', ...)这类调用，凡是出现了，就要么把变量搬进模型工作区，要么把脚本作为模型的一个初始化文件放进同一目录。

这一章的最终目的，是让你建立起“Simulink 模型 + matlab 文档 + 示例代码”三位一体的工作习惯。选型要落在 Simulink 上，环境要确认到工具箱级别，建模要先从官方示例入手。有了这个地基，下一章搭出来的单机无穷大系统才不是空中楼阁。

3. 搭一个单机无穷大系统：Simulink 电力系统建模仿真的最小闭环

先从结论说起：我不建议你上来就搭三机九节点或 IEEE 39 节点系统。电力系统建模与仿真的第一道坎是“看懂一个简单系统的全部环节”，单机无穷大系统刚好覆盖同步电机、变压器、输电线路、无穷大母线、短路故障五个要素，而且发散时你只有少数几个怀疑点，不会像大系统那样无从下手。把这一步跑通，后面再扩展到多机系统才有底。

3.1 为什么单机无穷大系统是最合适的起步对象

单机无穷大系统（Single Machine Infinite Bus，SMIB）本质上是一个理想化概念：一台同步发电机经变压器和线路接到一个容量远大于单机的电网，母线电压和频率被视为恒定。它不会出现在真实电网里，但在仿真里是验证电机模型、励磁控制和暂态稳定性的最小单元。很多教科书、包括于群那套电力系统建模与仿真资料中，第一步都是这个东西，因为你能直观看到故障前、故障中、故障切除后的电流变化和电压跌落。

具体到 Simulink 建模，SMIB 需要四类元件：同步电机的机械和电气接口，双绕组变压器，线路等值电路，以及代表电网的无穷大母线。你在元件库里选机型时，常看到Synchronous Machine pu Standard，它内部包含阻尼绕组、励磁绕组和机械运动方程；变压器选Three-Phase Transformer (Two Windings)；线路选Three-Phase PI Section Line或Distributed Parameters Line。少数情况下还要加Three-Phase V-I Measurement和Three-Phase Fault来完成测量和故障注入。

为什么要用无穷大母线而不是直接接一个电压源？因为无穷大母线不仅提供额定电压，还隐式地提供一个短路容量足够大的戴维南等值电源。你若只用理想电压源，忽略短路容量，故障时节点电压会被源拉死，波形看起来完全不对。Simulink 里的Three-Phase Source模块可以设置短路容量，设成无穷大时短路容量一般比发电机容量高 10 倍以上，算是一个简单的工程经验。同步电机的内部参数中，惯性常数和电抗是后续稳定分析的重点，第一次建模型不用改得太精细，等你要复现功角摇摆曲线时再逐个调。

3.2 元件摆放与接线顺序：一个可以抄的模型拓扑

下面这套顺序是我自己在空白模型上操作的常规套路，你可以直接照抄，也可以根据手头参数调整。新建一个 Simulink 模型，按下面顺序逐步添加元件，每加一个就先双击查看 mask 参数，避免后面连线时找不到端口。

第一步，放 Powergui。没有 Powergui，Specialized Power Systems 里的电机、变压器可能启动不了初始化。Powergui 在库路径Simscape / Electrical / Specialized Power Systems / Powergui下；也可以直接在命令窗口执行powerlib，然后从库窗口把 Powergui 拖入模型。

第二步，放同步电机。选Synchronous Machine pu Standard，设置额定视在功率200e6（单位 VA），额定线电压10e3（单位 V），频率 50Hz。如果你是验证保护或稳定，不用把内部电抗改到特别精确，先使用默认的标幺值参数；后面要细调时再看X_d、X'_d、T'等参数。真正要改的往往是“机械输入”和“电气接口”的类型。

第三步，放变压器。使用Three-Phase Transformer (Two Windings)，把一次侧接到电机端口，二次侧接到线路。联结组别建议用 Yn-D，也就是一次侧星形带中性点、二次侧三角形。这样后续做单相接地故障时，零序电流有流通路径；如果两侧都用星形不接地，单相短路故障根本仿不像。这是一个经常被忽略的坑，先记下来。

第四步，放线路。先用Three-Phase PI Section Line简化为一段集中参数线路，长度给 100km，正序电阻和电感用默认典型值。分布式参数线路更适合长距离分析，但对初学来说 PI 模型更容易理解，波形也更容易检查。线路模块的“频变参数”选项在电力系统暂态中会更准确，但仿真速度会明显变慢，初学阶段先不要开。

第五步，放无穷大母线。用Three-Phase Source，电压等级与变压器二次侧一致，频率 50Hz，短路容量设为10e9VA，也就是 10GVA 左右。如果母线电压等级需要 110kV，那变压器的二次侧和线路参数也要同步改成 110kV 等级，别让一次侧 10kV 的发电机和 110kV 母线直接相连。

第六步，放测量与故障。Three-Phase V-I Measurement可以串在线路和母线之间；Three-Phase Fault放在测量点之后，设置切换时间[0.2 0.3]，表示 0.2 秒发生短路、0.3 秒被断路器切除。

如果你习惯用脚本控制流程，可以用下面这段把 Powergui 放进去：

% 新建一个测试模型并添加 Powergui 块（库路径以本机 powerlib 为准） mdl = 'smib_demo'; new_system(mdl); add_block('simscape/Electrical/Specialized Power Systems/Powergui', [mdl '/Powergui']); open_system(mdl);

这段脚本里new_system创建空白模型，add_block的源路径以你本机库为准——如果你的版本里路径分层有差异，先运行powerlib找到 Powergui 的完整路径再替换。用脚本建立模型的好处是可控和可重现，这也是 matlab 文档里推广的一种做法：把“手工点击”变成“代码记录”，以后换机器、换版本，重跑脚本就能得到同一套模型骨架。

3.3 Powergui 与第一个波形：仿真前要放好的三个关键参数

所有元件都拖进来之后，不是直接点绿色运行按钮就能看到漂亮波形。第一次跑 SMIB，我先调三个地方：Powergui 的仿真类型、同步电机的初始条件、故障模块的切换时间。

第一，Powergui 里选择Continuous仿真类型，并在通用参数里把系统频率设为 50Hz。Specialized Power Systems 很多模块依赖这个频率计算感抗和容抗，如果你默认是 60Hz，而线路参数按 50Hz 输入，波形会出现频率偏移，初看很难定位。

第二，同步电机的稳态初始条件必须初始化。在 Powergui 里打开Machines Initialization工具，输入发电机的有功、无功和机端电压，再让工具自动计算初始状态值。这一步不做，仿真从头开始就以非稳态为起点，电压和电流会跳变，甚至直接 NaN。很多人第一次建电机模型就栽在这里，后面排查半天才发现是初始化问题。

第三，故障模块的触发时间。Three-Phase Fault的切换时间参数写成[0.2 0.3]，也可以写作0.2 0.3。不要设置成[0.2 inf]，因为无穷大表示故障永远不清除，你看到的只是永久性短路的暂态，而不是完整的“故障→切除→恢复”过程。

下面是一段可以直接跑的参数和仿真脚本：

% 设置模型级参数并运行仿真 set_param('smib_demo/Powergui', 'SimulationMode', 'continuous', 'Freq', '50'); set_param('smib_demo/Three-Phase Fault', 'SwitchingTimes', '0.2 0.3'); % 参数名以当期文档为准 simOut = sim('smib_demo', 'StopTime', '1.0');

代码里set_param第一行把 Powergui 的仿真模式设为连续，并锁定 50Hz；第二行设置故障块的切换时间；sim命令启动仿真并返回输出对象。你需要在测量模块上右键，把 “Voltage” 和 “Current” 信号标记为 Log Selected Signals，才能让simOut里真正带出波形数据。StopTime设为 1 秒，意思是仿真窗口覆盖故障前 0.2 秒、故障中 0.1 秒和切除后的恢复过程，既能看到暂态峰值，也不至于跑得太慢。

如果打开 Scope 直接看波形，注意观察三个特征：故障发生瞬间电流是否抬升，故障切除后电压是否恢复，恢复过程中是否存在衰减振荡。这三个特征验证模型没建错，后面再做控制策略或保护整定才有意义。第一次建模型，请先把故障块断开，先跑一个无故障稳态，确认电压电流都是正弦再切入故障。这个习惯能省下大量排查时间。

4. 常见问题排查：步长、外部模式与参数设置踩坑记录

这部分是这套建模资料里我认为最值钱的内容。很多人问“为什么我的模型跑出来全是 NaN”，基本都不是模型原理错了，而是求解器、外部模式或故障设置里某一个细节没配对。下面按排查频率给出四组说明和五条踩坑记录。

4.1 求解器选择与步长：为什么我的仿真一开始就 NaN

Simulink 默认求解器是 ode45，属于显式 Runge-Kutta 方法，适合一般连续系统。但电力系统暂态仿真带有明显的刚性特征：电磁暂态时间常数在毫秒级，机电暂态时间常数在数十毫秒到秒级，比值相差很大。此时 ode45 为了稳定会不断把步长压到很小，仿真卡顿且容易在刚性点附近发散，导致刚开始就跑 NaN。这不是模型错了，而是求解器不适合。

我一般把电力系统仿真首选ode23t或ode15s。ode23t适合中等刚性的问题，在 50Hz 电力系统暂态里表现稳定；ode15s适合刚性更强、且对阶数要求不高的场景。两者的共同点是隐式求解，可以用相对大的步长保持数值稳定，代价是单步计算稍慢，但在整体效率上明显优于显式求解器。

模型配置建议用代码固定：

% 固定求解器与最大步长，防止其他人乱改 cs = getActiveConfigSet('smib_demo'); set_param(cs, 'Solver', 'ode23t'); % 中等刚性首选 set_param(cs, 'MaxStep', '1e-3'); % 限制最大步长，保证采样精度 set_param(cs, 'RelTol', '1e-3'); % 相对误差默认 1e-3 即可

这里getActiveConfigSet从模型拿到配置对象，set_param对它写入三个参数：求解器、最大步长、相对误差。MaxStep=1e-3表示求解器最长走 1 毫秒一步，对 50Hz 系统意味着每个周波走 20 个点，足够看波形，也不会把计算量拉爆。若你想看更细的暂态，比如断路器开断时刻的电压尖峰，把MaxStep降到1e-4，多花一点时间换取更平滑的曲线，我自己在保护分析时偶尔会这样用。

4.2 Simulink 外部模式：在线调参，但别一开头就用

外部模式（External Mode）是 Simulink 与外部目标机通信的仿真运行模式，适用于快速原型验证：宿主 MATLAB 把模型编译后下载到目标机运行，同时可以在线修改参数、看波形。对于电力系统实时仿真，常见做法是配一台实时目标机或 Simulink Desktop Real-Time 环境，先离线验证，再进入外部模式做信号级测试。

但我的建议是：刚接触电力系统建模，先不要碰外部模式。原因很简单，外部模式的调试链路等于多了一个黑匣子——模型、实时目标机、通信、时钟，任何一个环节出问题都会让你误以为电力系统模型错了。先把 Normal 模式跑通，保存好一组稳定波形，再升级到外部模式，心里才有底。

如果确实要用外部模式，步骤一般是三件事：在模型设置里把仿真模式改为External，选择实时目标文件（如 slrealtime 对应文件，或桌面目标），再点“构建并连接”。用脚本做代码生成时，也可以这样控制，但注意区分两种目标文件：

% 以 ERT 目标生成嵌入式 C 代码（不是外部模式！） cfg = getActiveConfigSet('smib_demo'); set_param(cfg, 'SystemTargetFile', 'ert.tlc'); % 嵌入式代码目标 set_param(cfg, 'GenCodeOnly', 'on'); % 只生成代码，不运行 slbuild('smib_demo');

这段脚本生成的是一份可在嵌入式处理器上编译的 C 代码，输出文件通常在模型的slprj目录下；GenCodeOnly='on'表示不继续编译生成可执行文件。如果你要做外部模式，应该把目标文件换成实时仿真目标，并在运行时设置里打开外部模式通信。很多人在论坛上遇到的“外部模式连接失败”，往往是没有按目标机手册选择正确的目标文件就开始点连接，结果一直在兜圈子。

注意：常规模型里出现From Workspace模块、evalin回调或基础工作区变量时，代码生成和外部模式都可能失败。凡是准备生成代码的模型，参数尽量改成模型工作区或 MATLAB 参数对象，这是个长期主义做法。

4.3 三个必须调对的位置：故障相、短路容量和故障时刻

三相故障模块不是只能做三相短路。它的界面里有一组故障相选择复选框，默认三个勾全都打上，做的是 ABC 三相短路接地。想做单相接地、两相短路或两相接地，必须手动取消或勾选对应相。这个细节常被忽略，不少人以为放一个 Three-Phase Fault 就能模拟所有故障类型，结果看到的波形永远是三相对称短路，和论文里的不对称故障对不上。

无穷大母线的短路容量同样关键。Three-Phase Source 模块除了电压和频率，还有一个短路容量参数，我一开始就用默认值，结果故障电流小得离谱。把短路容量设到发电机容量的 10 倍以上，才算接近“无穷大”的含义；如果需要更精确，可以从潮流计算中获得戴维南等值参数再填写。

故障时刻则要注意写在模块“切换时间”而非“仿真时间”里。很多人以为仿真开始时间即故障时刻，其实模块内部使用独立的切换时间，默认可能是[Inf]，表示不动作。你需要在参数里写成[0.2 0.3]，并且仿真的StopTime必须大于 0.3，否则根本看不到切除后的恢复过程。

4.4 五条踩坑记录，每一条都是血泪经验

以下是五条真实高频的踩坑记录，全部按“现象 → 原因 → 解决”组织，排查时可以按顺序对照。

第 1 条：一仿真就 NaN，波形直接飞到 1e30。原因 90% 是同步电机没有正确初始化。很多第一次建 SMIB 的人，直接给电机一个电压然后点运行，Powergui 还没参与初始化，电机内部状态和网络节点电压不匹配，第一步就把微分方程解开碰破了。解决：在 Powergui 的Tools > Initial State Setting里选择Set Initial States，或打开Machines Initialization工具，自动求一次稳态初始值；再删掉故障块重跑一次稳态物理通道。若仍发散，检查母线是否有接地路径——变压器二次侧为星形不接地时，单相短路也没有完整通路，先改成 Yn-Δ 接法。

第 2 条：波形在高频处出现锯齿毛刺，且毛刺集中在故障切除时刻。原因通常是断路器以理想开关模型瞬间切换电流，等效于在仿真频域引入了极高频率分量，而MaxStep太大，求解器没有在开关瞬间附近细分步长。解决：把MaxStep由1e-3调到1e-4，并在故障块参数里打开Breaker resistance，串联一个很小的阻尼电阻，典型为 0.01Ω，抑制电流斩断引发的数值振荡。注意不要用连续变阻来模拟断路器，那会改变故障电流峰值。

第 3 条：想做单相接地，却只能得到三相短路。原因：Three-Phase Fault 的故障相默认三相全选，你没有取消不需要的相。解决：双击故障块，找到故障类型或故障相选择，只勾选 Phase A，同时接地路径选择ground或经过阻抗接地。如果模型中变压器一次侧为三角形联结，零序电流没有路径，单相接地仿真结果也不真实，这一步需要回看变压器联结组别。

第 4 条：外部模式连接提示 Target Not Responding。原因：目标机配置不对，或者模型里含有From Workspace、To Workspace这类不适合实时运行的块，代码生成在目标机上被卡住。解决：先把模型仿真模式切回 Normal，确认离线仿真完全正常；再用“代码生成”按钮先编译一次，观察是否报缺少变量；最后再切到 External 并按目标机的文档检查通信端口和 IP。不要同时打开多个外部模式会话，同一个目标通常只允许一个宿主连接。

第 5 条：生成 C 代码时报 “Undefined variable” 或 “Missing Parameter”。原因：你的 Simulink 模型里仍有大量参数存在于基础工作区，代码生成时目标机没有 MATLAB 环境，访问不到这些变量。解决：把需要生成代码的参数改为模型工作区（Model Workspace）对象，或在 MATLAB 里使用Simulink.Parameter并设置StorageClass为ExportedGlobal；同时检查模型回调中是否有隐藏的evalin('base', ...)调用并清除。这个习惯最好在搭模型时就养成，而不是等生成代码阶段再补课。

5. 进阶：用 SimulationInput 批量扫描，把模型变成可交付的 matlab 文档

最后这部分写点能提升效率的东西：参数批量扫描与结果文档化。别小看这一步，多数 Simulink 电力系统项目最大的工作量不是“搭模型”，而是“调参数和解释波形”。手动改一次参数、运行一次、截图一次，做十个工况就要花掉一整天；用脚本批量跑，十分钟能把几十个工况跑完，还能把结果统一导成一个数据文件，交给下游同事。

Simulink 官方支持的核心方式是Simulink.SimulationInput数组，配合sim或parsim并行运行。它的价值在于：不修改模型内部任何参数，而是在运行前注入变量，从而保持原始模型不被“玩坏”。代码是这样的：

% 故障时刻批量扫描，比较 0.15s 和 0.25s 短路的暂态响应 mdl = 'smib_demo'; simin(1) = Simulink.SimulationInput(mdl); simin(1) = simin(1).setVariable('fault_time', 0.15); simin(2) = Simulink.SimulationInput(mdl); simin(2) = simin(2).setVariable('fault_time', 0.25); out = parsim(simin, 'ShowSimulationManager', 'on');

这段代码里Simulink.SimulationInput为每个工况创建一个独立运行实例，setVariable注入你要扫的参数；parsim并行运行所有实例，并返回结果数组。注意故障块内部要写成使用fault_time变量的形式，例如切换时间写成[fault_time fault_time+0.1]，而不是硬编码数值。parsim并行时每个工作进程都要能访问模型和变量，不要在循环里用assignin('base', ...)，那个在并行场景下大概率失败。

跑完之后，最容易被忽略的是结果整理。out里的每个Simulink.SimulationOutput都带logsout，需要手动提取波形和指标，拼成一个表格或数据集：

% 提取每轮扫描中的电压波形和峰值 for i = 1:numel(out) V = out(i).logsout.getElement('Vabc').Values; % 电压波形 peak = max(abs(V.Data(:,1))); % 找第一相最大电压 fprintf('Case %d: 电压峰值 %.2f V\n', i, peak); end

这里getElement取得已记录的信号，Values.Data是采样矩阵，括号里的(:,1)取第一相。把峰值、时间和工况参数一并存入array2table，最后导出 CSV，整个流程就可以复制到报告中。文档落地我通常用publish或slreportgen库，把 M 脚本转成带波形的 HTML 或 PDF，这就是标题里所谓 “matlab 文档” 的一种交付形态。

我自己的习惯是在每个项目目录下放一个run_cases.m，把模型名、参数表、仿真脚本、结果导出写在同一份文件里，并把对应的 Simulink 模型以.slx形式连同备份快照都存在同一目录。这样哪怕三个月后回看，也能清楚某个波形对应哪个工况。以前我吃过一个亏：模型跑通了，但没把参数扫描逻辑留在脚本里，结果评审时要重换故障时间，对着 GUI 找半天，从此我把所有能脚本化的环节都脚本化了。数据不丢、参数可查、一次跑完，才是 Simulink 电力系统建模与仿真真正的收尾标准。希望这一篇能帮你少踩几个一样的坑，也希望你能早点把模型变成一个能传承的 matlab 文档。

本文还有配套的精品资源，点击获取