主要内容

将库添加到库浏览器和快速插入

此示例说明如何将库添加到 Simulink® 库浏览器 以及如何配置库模块以将其添加到快速插入菜单。

将库添加到库浏览器

库浏览器显示系统上可用库的树视图,您可以浏览这些库以向模型添加模块。

要将自定义库添加到库浏览器,请使用以下步骤:

1.加载并解锁现有库 myLib。您也可以创建一个新库。有关详细信息,请参阅创建自定义库

load_system("myLib")
set_param("myLib","Lock","off")

2.要在库浏览器中显示注解,请在库中添加文本或图像注解,右键点击它们并选择在库浏览器中显示。有关如何在模型中设置注解的信息,请参阅为模型添加注解

您可以按任意顺序排列库中的模块和注解。默认情况下,它们在库浏览器中按字母顺序显示,先列出子系统,然后列出模块,最后列出注解。库的用户可以使用库浏览器上下文菜单在字母顺序和您指定的顺序之间切换。当用户选择您指定的顺序时,库中的排列方式确定它们在库浏览器网格中的显示方式。

3.在 MATLAB® 命令行窗口中,输入以下命令将 EnableLBRepository 库属性设置为 on

set_param("myLib","EnableLBRepository","on");

仅当在保存库时启用此属性的情况下,您的库才会出现在库浏览器中。

4.将库保存在 MATLAB 路径上的文件夹中,或将其位置添加到 MATLAB 路径。

save_system("myLib");

5.要指定自定义库在库浏览器中的显示方式,请使用以下步骤:

  • 在包含您的自定义库的文件夹中创建一个新脚本 slblocks

  • 添加此函数以指定自定义库 myLib 将在库浏览器中以 My Library 名称显示:

function blkStruct = slblocks
Browser.Library = "myLib";
Browser.Name = "My Library";
blkStruct.Browser = Browser;
  • 保存 slblocks。您可以将文件保存为 .m.mlx 文件,但无法保存为 P 代码文件。

6.要打开库浏览器,请点击 Simulink 工具条中的库浏览器

7.要在库浏览器中查看新库,请右键点击库浏览器中的库列表并选择刷新库浏览器

注意,如果您在 EnableLBRepository 未设置为 on 的情况下保存自定义库,库浏览器顶部将显示一条消息。请点击修复并根据提示进行操作。

向库添加子库

如果您的库包含多个模块,可以通过将相关模块组合到单独的 Subsystem 模块中来创建子库,从而改进其组织方式。

要在库 myLib 中创建一个子库,请使用以下步骤:

  1. 添加名为 Basic Signals 的 Subsystem 模块。

  2. Basic Signals 内部,删除默认 Inport 和 Outport 模块。如果一个 Subsystem 模块内所有模块的输入端口和输出端口都已连接,则该 Subsystem 模块将被视为可重用库模块,而不是引用的库。

  3. Basic Signals 模块内添加 Step、Ramp 和 Sin 模块。

  4. (可选)您可以为 Subsystem 模块创建一个封装以显示传达库用途的文本或图像。但是,封装只能有图标。如果您在 Subsystem 模块封装中添加代码或参数,则该 Subsystem 模块将被视为可重用库模块,而不是引用的库。

  5. 保存 myLib

  6. 要在库浏览器中查看子库,请右键点击库列表并选择刷新库浏览器

使用子库时的注意事项

  • 如果 Subsystem 模块的名称包含 Examples 字样(区分大小写),库浏览器将子系统显示为模块而不是子库。

  • 如果您在库中创建子系统层次结构,则必须使用唯一子系统名称。例如,不要创建 SubsystemA/SubsystemB/SubsystemA 这样的层次结构。

设置库列表中的库顺序

您可以安排您的库在库浏览器中相对于其他库的显示顺序。默认情况下,Simulink 库以 -1 的排序优先级显示在列表顶部。其他库的排序优先级为 0,显示在 Simulink 库下方。要将您的库置于列表顶部,请将其排序优先级设置为 -2。具有相同排序优先级的库按字母顺序排序。

要设置库的排序优先级,请将 sl_customization.m 文件添加到 MATLAB 路径。sl_customization 的此示例内容将库 My Library 置于库列表顶部:

function sl_customization(cm)
cm.LibraryBrowserCustomizer.applyOrder({'My Library',-2});
end

要立即应用自定义设置,请在 MATLAB 命令行窗口中使用此命令:

sl_refresh_customizations

将库模块添加到快速插入菜单

您可以向库中的模块添加关键字,并使用这些关键字从快速插入菜单将库模块插入到模型中。快速插入菜单使您无需离开画布即可直接向模型添加模块。您只需点击画布打开快速插入菜单,然后开始键入关键字或模块名称即可添加模块。

使用以下步骤向自定义库中的模块添加关键字:

1.使用 set_param 函数,设置 Gain 模块的 BlockKeywords 参数:

set_param('myLib/Gain','BlockKeywords',["My Gain", "Your Gain"])

2.保存库。

save_system("myLib")

3.刷新库浏览器以使用新关键字更新快速插入菜单。

4.现在,您可以通过在快速插入菜单中键入模块名称或任何关键字来将 Gain 模块添加到模型中。

使用快速插入时的注意事项

  • 关键字中支持的特殊字符有 &、(、)、+、@ 和 !。

  • 您无法将关键字添加到来自 Commonly Used Blocks 的模块中,因为它们是查看各种库中常用模块的位置。如果您要向 Commonly Used Blocks 中可用的模块添加关键字,则必须在定义该模块的库中添加。

  • 快速插入菜单支持使用国际化关键字以非英语语言搜索模块。

另请参阅

工具

主题