1. 用 MATLAB 脚本搭 DC-AC 逆变器模型:比拖鼠标多得到什么
把 Simulink 模型当作代码来写,是我目前最常用的一种代码开发工具用法:一个 MATLAB 脚本从头跑到尾,DC-AC 逆变器的直流源、IGBT 桥、PWM 发生器、LC 滤波、电压电流测量、示波器和求解器参数一次性就位,改拓扑只动几行变量,不用再在画布上翻库、找模块、拉线、双击填参数。这套做法适合两类人:一类是要反复改参数看波形的电力电子调试,另一类是要把模型纳入版本管理、让别人能原样复现的协作场景。
它不替代 Simulink 图形界面,而是把界面里那些重复动作固化成可重跑的脚本。下面按我实际写脚本的顺序讲:先建空模型,再放功率级,然后连线、配求解器,最后说哪几行最容易报错、参数为什么取这些值。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 用脚本代码放置功率级:add_block 与 set_param 的写法
脚本建模最容易犯的错误是先写一堆 add_block 再去调路径,结果每加一个模块就报一次找不到模块。我的顺序是:先确认模型名,再确认库路径,最后才谈参数。模型名会成为后续所有路径的前缀,库路径决定模块能不能被找到,参数只是第三步。
2.1 new_system 与 open_system 的分工
matlab复制% 清掉工作区变量和已打开的模型,避免上一轮残留干扰
clear all; close all;
modelName = 'DC_AC_Inverter_Simulation';
new_system(modelName); % 新建空模型,此时不会弹出画布
open_system(modelName); % 打开画布,方便边跑边观察
new_system 只创建模型对象,不显示窗口;open_system 才把画布打开。这两句分开写的好处是,你可以在建好模型之后、打开界面之前先把模块全塞进去,脚本跑完再一次性看到完整拓扑,少了很多中间状态的误操作。
modelName 这个字符串是后面每个 add_block 第二个参数的前缀,写成 [modelName '/DC_Voltage_Source'] 的形式。目标路径里的斜杠表示模型内的层级,模块名自己起,但要保证全模型唯一,否则第二次 add_block 会报路径冲突。
clear all 在纯建模脚本里够用,但如果脚本要读外部工作区数据(比如从文件加载的工况表),就不要用 clear all,换成 clearvars -except 保留那几个变量,这是我吃过一次亏之后改的习惯。
2.2 直流源、桥和 PWM:三个参数决定输出
matlab复制% 直流母线
add_block('simscape/Electrical/Specialized Power Systems/Fundamental Blocks/Sources/DC Voltage Source', ...
[modelName '/DC_Voltage_Source']);
set_param([modelName '/DC_Voltage_Source'], 'Voltage', '400'); % 母线 400V
% 三相/单相通用桥,这里按单相全桥用
add_block('simscape/Electrical/Specialized Power Systems/Power Electronics/Universal Bridge', ...
[modelName '/Inverter_Bridge']);
set_param([modelName '/Inverter_Bridge'], 'BridgeType', 'IGBT/Diode');
% 两电平 PWM 发生器
add_block('simscape/Electrical/Specialized Power Systems/Extras/Measurements & Signals/PWM Generator (2-Level)', ...
[modelName '/PWM_Generator']);
set_param([modelName '/PWM_Generator'], 'CarrierFrequency', '10e3'); % 载波 10kHz
set_param([modelName '/PWM_Generator'], 'ModulationIndex', '0.8'); % 调制比 0.8
add_block 第一个参数是库浏览器里的完整路径,第二个是模型内目标路径。路径里有空格(Specialized Power Systems、PWM Generator (2-Level))完全没问题,因为它是字符串而不是标识符,但复制路径时别手动敲,从库浏览器右键复制最稳。
Voltage 设成 '400' 是直流母线电压。注意 set_param 的值一律是字符串,写 400 会报类型错误,这是新手最常见的一次翻车。
BridgeType 设 'IGBT/Diode' 决定了桥臂用带反并联二极管的 IGBT,也决定了门极输入端口叫什么名字——这一条在连线那章会咬人,先记住。
CarrierFrequency 是 '10e3',也就是 10kHz。按 50Hz 基波算,一个基波周期 20ms 里有 200 个载波周期,开关次数足够,谐波被推到高频段,后面的 LC 才有得滤。载波频率不是越高越好,太高会让求解器步长被压得很小,仿真时间成倍增长。
ModulationIndex 取 0.8 是留余量:调制比直接决定输出基波幅值相对直流母线的占比,先给 0.8,波形不对时还有往上调的空间;直接拉到 1 附近,过调制区波形会削顶,排查起来更绕。
2.3 滤波电感和电容:BranchType 决定哪个参数生效
matlab复制% 滤波电感
add_block('simscape/Electrical/Specialized Power Systems/Elements/Series RLC Branch', ...
[modelName '/Filter_Inductor']);
set_param([modelName '/Filter_Inductor'], 'BranchType', 'Ind');
set_param([modelName '/Filter_Inductor'], 'L', '1e-3'); % 1mH
% 滤波电容
add_block('simscape/Electrical/Specialized Power Systems/Elements/Series RLC Branch', ...
[modelName '/Filter_Capacitor']);
set_param([modelName '/Filter_Capacitor'], 'BranchType', 'Cap');
set_param([modelName '/Filter_Capacitor'], 'C', '10e-6'); % 10uF
% 电压、电流测量
add_block('simscape/Electrical/Specialized Power Systems/Fundamental Blocks/Measurements/Voltage Measurement', ...
[modelName '/Voltage_Measurement']);
add_block('simscape/Electrical/Specialized Power Systems/Fundamental Blocks/Measurements/Current Measurement', ...
[modelName '/Current_Measurement']);
Series RLC Branch 是一个模块顶三种元件用,靠 BranchType 切换。设成 'Ind' 时只认 L,设成 'Cap' 时只认 C,设成 'R' 时只认 R,其余参数即使填了也被忽略。很多人把 L 和 C 都填上,然后疑惑波形怎么没变化,原因就在这里——顺序必须是先设 BranchType 再设对应参数。
1mH 和 10μF 这两个值可以反推一下位置:LC 截止频率约等于 1/(2π√(LC)),代入后大约 1.6kHz,正好落在 50Hz 基波和 10kHz 载波之间。滤波器的任务就是把 10kHz 附近的开关谐波压下去、把 50Hz 放过去,参数落在这个区间才合理;如果算出来接近载波频率,说明电感或电容选小了一个量级。
Voltage Measurement 在电气网络里是并联取压,Current Measurement 是串联插入回路。脚本里它们被接在滤波电容之后,实际连线时要注意这两类模块走的是电气连接而不是信号连接,接错位置示波器上就是一条零线。
3. 连线、测量与求解器:脚本里最容易断的三段
模块放完只是搭好了零件,脚本真正容易断的地方在连线、在端口名、在求解器参数。这三段里任何一段出错,表现都不是"报错退出",而是模型建成了但仿真跑出来一片空白,排查成本比直接报错高得多。
3.1 add_line 的四个参数与门极端口 g
matlab复制% 直流母线到桥
add_line(modelName, [modelName '/DC_Voltage_Source'], ...
[modelName '/Inverter_Bridge'], 'autorouting', 'on');
% PWM 到桥的门极输入
add_line(modelName, [modelName '/PWM_Generator'], ...
[modelName '/Inverter_Bridge/g'], 'autorouting', 'on');
% 桥输出经电感、电容,再到测量
add_line(modelName, [modelName '/Inverter_Bridge'], ...
[modelName '/Filter_Inductor'], 'autorouting', 'on');
add_line(modelName, [modelName '/Filter_Inductor'], ...
[modelName '/Filter_Capacitor'], 'autorouting', 'on');
add_line(modelName, [modelName '/Filter_Capacitor'], ...
[modelName '/Voltage_Measurement'], 'autorouting', 'on');
add_line(modelName, [modelName '/Filter_Capacitor'], ...
[modelName '/Current_Measurement'], 'autorouting', 'on');
add_line 的签名是:模型名、源端口全路径、目标端口全路径,后面可以跟 'autorouting','on'。源是模块的输出端口,目标是模块的输入端口,不写 autorouting 时,如果两个模块位置靠得太近或端口方向别扭,会报"无法自动布线",脚本就停在那行。
[modelName '/Inverter_Bridge/g'] 里的 /g 是门极输入端口名。这个端口名不是固定的,它跟着 BridgeType 走:设成 'IGBT/Diode' 时门极输入是 g,换成别的桥型端口名可能就变了。所以脚本里 set_param 设 BridgeType 必须写在 add_line 之前,顺序颠倒就会出现"端口不存在"的报错。
Filter_Capacitor 那条线接出去两个目标(电压测量和电流测量),这在电气网络里意味着电容两端同时挂了两个测量支路。结构上没问题,但要清楚电流测量是串联取样,它的存在会改变回路,不是纯观测。
3.2 示波器接线与多路信号
matlab复制% 示波器
add_block('simulink/Sinks/Scope', [modelName '/Scope']);
% 电压、电流两路信号进同一个示波器
add_line(modelName, [modelName '/Voltage_Measurement'], ...
[modelName '/Scope'], 'autorouting', 'on');
add_line(modelName, [modelName '/Current_Measurement'], ...
[modelName '/Scope'], 'autorouting', 'on');
Scope 的输入端口是动态的:每 add_line 一次到它,就多出一个输入端口,第二条线自动进 In1 的第二个口。所以两路信号进同一个 Scope 完全可行,不需要手动在 Scope 里配置端口数。
但要注意,Voltage Measurement 和 Current Measurement 输出的是 Simulink 信号,走的是信号线,不是电气线。脚本里从测量模块拉线到 Scope 用的是同一条 add_line,写法和电气连线一样,语义却不同——这是最容易看混的地方,接错了几次之后我现在会在脑子里先问一句"这条线是电气还是信号"。
3.3 StopTime 与 Solver:0.02 秒能看出什么
matlab复制% 仿真时长与求解器
set_param(modelName, 'StopTime', '0.02'); % 20ms
set_param(modelName, 'Solver', 'ode45'); % 变步长
% 保存模型
save_system(modelName);
StopTime 设 0.02 秒,对应 20ms,正好是 50Hz 基波的一个周期。这个时长够看一个完整正弦,但不够看稳态:LC 滤波和直流母线建立都需要时间,仿真从零状态起步,第一个周期里波形还在爬升,你看到的"正弦有点歪"很可能是启动过程而不是拓扑问题。
Solver 用 ode45 是变步长求解器,它会在 IGBT 开关瞬间自动把步长压小以保证精度。好处是不用自己算步长,坏处是当载波频率是 10kHz 时,一个开关周期 100μs,求解器为了收敛可能把步长压到微秒级以下,仿真时间明显变长。我一般的做法是不加 MaxStep,先跑一次看耗时,如果卡得厉害再补一句 set_param(modelName,'MaxStep','1e-5'),把步长上限压在载波周期的十分之一量级,牺牲一点精度换可接受的仿真时间。
save_system 把模型存成 slx 文件。脚本建模的一个隐性好处就在这里:模型文件可以进版本库,配合脚本本身,别人拿到后重跑一遍就能得到同样的拓扑和参数,而不是拿到一个改了参数却没人知道改了什么的模型。
4. 脚本建模的五个坑:报错、空波形与卡死的仿真
脚本建模的失败模式和手工建模不太一样。手工拖拽出错你当场就看见了,脚本出错要等整段跑完才发现,而且报错信息往往只指向一行,根因在上一段。下面五条是我实际反复遇到的,按现象、原因、解决写。
4.1 模块找不到,脚本第一段就挂
现象:add_block 报找不到名为 simscape/Electrical/Specialized Power Systems/... 的模块,或者提示库未加载。脚本在第一段就退出,后面什么都没建。
原因:Simscape Electrical 的库没有加载,或者脚本里的库路径和当前安装版本的库结构对不上。add_block 不会替你去打开库,它只按字符串找路径。
解决:先 load_system 把对应库加载进来,或者在库浏览器里点到目标模块、右键复制准确路径替换脚本里的字符串。路径核对这一步花两分钟,比反复改脚本猜路径省时间。我的习惯是新建一段建模脚本时,先把所有 add_block 的路径在库里逐个确认一遍,再往下写参数。
4.2 端口名对不上,连线报错
现象:add_line 报 Inverter_Bridge/g 端口不存在,或者连线后门极信号进不去,仿真出来的桥输出是一条平线。
原因:门极端口名跟着 BridgeType 变。脚本里如果先写了 add_line 到 /g,后面才 set_param 设 BridgeType,模块当时还是默认桥型,端口名自然不是 g。
解决:把 set_param 的 BridgeType 提到所有 add_line 之前,让模块先变成 IGBT/Diode 桥,再连门极。脚本里的执行顺序就是建模顺序,不能按"先连线后填参数"的手工习惯来。
4.3 波形全是毛刺,看不到正弦
现象:仿真能跑完,Scope 打开是一片高频毛刺,偶尔有个正弦轮廓但畸变严重。
原因有两个常见来源。一是 StopTime 只给了一个基波周期,启动过程还没结束,你看到的是暂态;二是 LC 参数和载波频率不匹配,1mH 配 10μF 的截止频率在 1.6kHz 附近,如果电容被误设成 10e-7(0.1μF),截止频率上移十倍,10kHz 谐波就滤不干净了。
解决:先把 StopTime 延长到几个基波周期,确认波形进入稳态再判断拓扑;然后回头核对 L 和 C 的数值量级,用 1/(2π√(LC)) 粗算一下截止频率,看它是否落在基波和载波之间。这两个动作能排掉大部分"波形不对"的抱怨。
4.4 电感填了值但等效为零
现象:滤波电感设了 L = 1e-3,但输出电流波形和没接电感一样,谐波原样过去。
原因:Series RLC Branch 的 BranchType 没有设成 'Ind',模块还停在默认的电阻分支上,L 参数被忽略。参数不是填了就生效,得先让模块变成对应元件。
解决:set_param 的顺序固定为:先 BranchType,再 L 或 C。同一个脚本里两个 RLC 模块,一个设 'Ind' 一个设 'Cap',别复制粘贴后忘了改类型。
4.5 仿真卡住不动,进度条长时间停在同一处
现象:sim 或界面上的运行按钮点下去,仿真进度很久不动,风扇转起来,日志里没有报错。
原因:ode45 是变步长,10kHz 载波下每个开关边沿都要求它把步长压到很小才能收敛,边沿一多,累计步数就上去了。
解决:给求解器加步长上限,set_param(modelName,'MaxStep','1e-5'),把最大步长压在 100μs 的十分之一;或者评估一下换固定步长求解器是否更合适。另外每次重跑前检查模型是不是已经开着,new_system 遇到同名模型会失败,脚本开头加一句 if bdIsLoaded(modelName), bdclose(modelName); end 能省掉一类莫名其妙的报错。
5. 把脚本改成参数化模板:一次改参、批量验证
单个脚本跑通之后,我做的第一件事是把模型名和所有关键参数提到函数签名里,而不是散落在脚本中间。这样同一套建模逻辑可以按不同工况反复调用,不用每次改一行就跑一遍。
matlab复制function build_inverter(modelName, udc, fc, m, Lf, Cf, tEnd)
% 同名模型先关掉,避免 new_system 冲突
if bdIsLoaded(modelName)
bdclose(modelName);
end
new_system(modelName);
open_system(modelName);
add_block('simscape/Electrical/Specialized Power Systems/Fundamental Blocks/Sources/DC Voltage Source', ...
[modelName '/DC_Voltage_Source']);
set_param([modelName '/DC_Voltage_Source'], 'Voltage', num2str(udc));
add_block('simscape/Electrical/Specialized Power Systems/Power Electronics/Universal Bridge', ...
[modelName '/Inverter_Bridge']);
set_param([modelName '/Inverter_Bridge'], 'BridgeType', 'IGBT/Diode');
add_block('simscape/Electrical/Specialized Power Systems/Extras/Measurements & Signals/PWM Generator (2-Level)', ...
[modelName '/PWM_Generator']);
set_param([modelName '/PWM_Generator'], 'CarrierFrequency', num2str(fc));
set_param([modelName '/PWM_Generator'], 'ModulationIndex', num2str(m));
set_param(modelName, 'StopTime', num2str(tEnd));
set_param(modelName, 'Solver', 'ode45');
end
函数化的关键点是 set_param 收字符串,所以数值参数一律 num2str 转一下再传,直接写数字会报类型错误。模型名带参数后缀(比如 INV_m80),可以保证批量跑的时候每轮都是独立模型,不会互相覆盖。
批量验证我一般这么写:
matlab复制for m = [0.6 0.7 0.8]
name = sprintf('INV_m%d', round(m * 100));
build_inverter(name, 400, 10e3, m, 1e-3, 10e-6, 0.06);
out = sim(name); % 跑仿真,结果带到工作区
% 从记录数据里取输出波形,核对峰值和周期
y = out.get('yout');
fprintf('m=%.2f peak=%.1f\n', m, max(abs(y)));
end
要点有三个。一是 StopTime 给到 0.06 秒,也就是三个基波周期,留足启动时间,取最后一段数据判断稳态。二是每轮模型名不同,跑完不互相污染,结果可以并排对比。三是把测量输出接到工作区记录,用 max、find 这类命令在命令行核对峰值和过零点间隔,比肉眼盯 Scope 可靠得多。
批量之前还有一步别省:先确认 Series RLC Branch 的 BranchType 在每一轮里都设对了。参数化模板把 L、C 变成变量之后,最容易出现的是模板本身漏了 BranchType,于是所有工况跑出来都像没接滤波器,你还以为是调制比的问题。
从那以后我每次写这类建模脚本,都先把库路径和端口名核对一遍再往下加模块,参数化的时候先检查 BranchType 和 set_param 的字符串转换,最后才谈波形好不好看。这套顺序省下来的返工时间,比写脚本本身多得多。希望帮到你。
