Simulink创建自定义库

前言

日常使用Simulink进行仿真时，通常会遇到模型复用的情形。例如，使用Simulink仿真电力电子变换器的传导电磁干扰时，LISN电路与噪声分离器会经常复用，此时，如果可以创建自己的Simulink仿真模型库，并将其添加到Simulink的库浏览器中，在需要复用时，可以像调用普通Simulink模型一样调用，可以大大提高生产效率。

本文即以Matlab R2022b为实验平台，介绍在Simulink中添加自定义库的方法。

添加自定义库

首先，创建一个自定义库文件。在Simulink的起始页面，点击空白库，点击创建库。
在新建的库文件中创建自己的模型。以LISN电路为例，在库文件中创建模型：
框选该模型，右键，点击创建子系统，或者使用快捷键Ctrl+G，得到一个模型：

直接用鼠标点击选中端口进行拖动就可以调整子模型的端口位置
利用相似的方式搭建噪声分离器的模型：

完成后：
模型搭建完成后，回到Matlab工作区，在工作区输入以下代码：
```
set_param(gcs,'EnableLBRepository','on');
```
这一行代码将模型的EnableLBRepository库属性设置为on，只有这样我们创建的库才能够被库浏览器找到。
保存模型，命名为EMI.slx。

在保存的模型EMI.slx所在文件夹下创建一个脚本文件slblocks.m，在该脚本文件中添加以下内容：

function blkStruct = slblocksBrowser.Library = 'EMI';% 'EMI' 为库文件名，不需要带扩展名Browser.Name = 'EMI';% 'EMI' 是出现在库浏览器中的名词blkStruct.Browser = Browser;

保存脚本文件slblocks.m。将模型EMI.slx与slblocks.m文件所在的文件夹路径添加到Matlab的搜索路径中：
打开Simulink库浏览器，按F5刷新，此时可以看到在库浏览器中出现了EMI库与对应的模型。

指定库列表中的库顺序

利用上述方法添加的自定义库在Simulink的库浏览器中出现的位置比较随机，可以通过添加一个sl_customization.m脚本文件来设置自定义库的排序优先级，从而将其放在靠前的位置，方便查找。

默认情况下，Simulink库的排序优先级为-1，其它库的排序优先级为0。想要将自定义库放置在前面，可以将其排序优先级设置为-2。

在EMI.slx和slblocks.m所在文件夹下创建脚本文件sl_customization.m，输入以下内容：

function sl_customization(cm)% Change the order of libraries in the Simulink Library Browser. cm.LibraryBrowserCustomizer.applyOrder({'EMI',-2});
end

在Matlab工作区输入：

sl_refresh_customizations

该代码可以使得上面的排序优先级设置立即生效。

此时，再去Simulink的库浏览器，发现库EMI已经出现在最靠前的位置。

添加子库

使用上面的方法可以创建自定义库，但是有的时候可能会有不同类别的复用模型。比如，有EMI方面的复用模型，有电力电子方面的复用模型，有控制方面的复用模型，如果每一个类别的复用模型都创建一个自定义库，最终可能会显得非常臃肿。此时，利用子库的功能，可以将自己的自定义库梳理成一个树形结构，会方便很多。

例如，我现在要创建一个总的自定义库My Library，在该库下又有三个子库EMI， Power Electronics和Control，方法如下：

在EMI.slx所在文件夹下创建库文件control.slx与PE.slx，分别在两个库文件中放入几个模型。
在Matlab工作区输入以下代码后保存。
```
set_param(gcs,'EnableLBRepository','on');
```
在EMI.slx所在目录下创建一个新的库文件mylib.slx，在该库文件中放入一个Subsystem模块，删除Subsystem模块中的输入输出端口，将其命名为EMI。
右键单击命名为EMI的Subsystem模块，选择属性，选择回调，选择OpenFcn，输入EMI。
按照第3、第4步，添加Power Electronics模块，填入PE；添加Control模块，填入control。
在Matlab工作区输入以下代码后保存mylib.slx文件。
```
set_param(gcs,'EnableLBRepository','on');
```

将文件夹下的slblocks.m脚本文件进行修改并保存：

function blkStruct = slblocksBrowser.Library = 'mylib';% 'mylib' is the name of the libraryBrowser.Name = 'My Library';% 'My Library' is the library name that appears% in the Library BrowserblkStruct.Browser = Browser;

将文件夹下的sl_customization.m脚本文件进行修改并保存：

function sl_customization(cm)% Change the order of libraries in the Simulink Library Browser. cm.LibraryBrowserCustomizer.applyOrder({'My Library',-2}); %这里是库浏览器中库的名称
end

在Matlab工作区输入以下代码：
```
sl_refresh_customizations
```

此时，打开Simulink库浏览器，按F5刷新，即可看到呈树形结构的自定义库。

后话

最近刚刚申请了一个订阅号，主要分享一些电力电子与电磁兼容方面的知识以及相关的仿真软件使用方法，本文章在公众号也有发Simulink创建自定义库。

有兴趣的希望关注一下，共同进步，谢谢！