new_system

R2026b

在内存中创建 Simulink 模型或库

全页折叠

语法

handle = new_system
handle = new_system(name)
handle = new_system(name,FromTemplate=template)
handle = new_system(name,FromFile=file)
handle = new_system(name,"Model")
handle = new_system(name,Model=subsys)
handle = new_system(name,"Subsystem")
handle = new_system(name,"Library")
handle = new_system(___"ErrorIfShadowed")

描述

handle = new_system 根据您的默认模型模板创建名为 untitled（随后为 untitled1、untitled2，依此类推）的模型，并返回新模型的数值句柄。

在 Simulink® 起始页上或使用 Simulink.defaultModelTemplate 函数选择您的默认模型模板。

new_system 函数不会打开新模型。此函数在内存中创建模型。要保存模型，请使用 save_system。

示例

handle = new_system(name) 使用指定名称创建模型。

为了避免遮蔽，如果 name 为空，则 new_system 函数将检查在路径上加载的模型和文件，并使用下一个可用名称 untitled、untitled1、untitled2 等创建一个模型。

示例

handle = new_system(name,FromTemplate=template) 根据指定的模板创建模型。

示例

handle = new_system(name,FromFile=file) 根据指定的模型或模板创建模型。

示例

handle = new_system(name,"Model") 根据 Simulink 默认模型创建空模型并返回新模型的数值句柄。Simulink 默认模型也称为根模块图，具有数值句柄 0。如果 name 为空，此函数将创建名为 untitled、untitled1、untitled2 等的模型或库。

示例

handle = new_system(name,Model=subsys) 根据当前加载的模型中的子系统 subsys 创建模型。

示例

handle = new_system(name,"Subsystem") 使用指定名称创建一个空的子系统文件。

示例

handle = new_system(name,"Library") 使用指定名称创建一个空的库。

示例

handle = new_system(___"ErrorIfShadowed") 可以与上述语法中的任何输入结合使用并执行相同的操作，但当该操作创建的名称与 MATLAB® 路径或工作区中的另一个模型、MATLAB 文件或变量同名时，会返回错误。

示例

示例

全部折叠

基于默认模板在内存中创建两个模型。使用默认名称创建第一个模型，使用名称 myModel 创建第二个模型。

使用默认名称创建模型。

h1 = new_system;

使用 get_param 函数获取新模型的名称。

get_param(h1,"Name")
ans =

    'untitled'

创建名为 myModel 的模型。

h2 = new_system("myModel");

假设您在 MATLAB 路径中有名为 myTemplate 的自定义模板。

根据模板创建名为 myModel 的模型。

h = new_system("myModel",FromTemplate="myTemplate");

假设您在 MATLAB 路径中有名为 myModel1 的模型。

根据 myModel1 创建名为 myModel2 的模型。

h = new_system("myModel2",FromFile="myModel1");

基于 Simulink 默认模型（根模块图）创建一个名为 myModel 的空模型。

h = new_system("myModel","Model");

假设您有已加载的名为 myModel1 的模型，其中包含名为 mySubsystem 的子系统。基于该子系统创建一个名为 myModel2 的新模型。

h = new_system("myModel2",Model="myModel1/mySubsystem");

创建一个名为 mySubsystem 的空子系统文件。

h = new_system("mySubsystem","Subsystem");

创建名为 myLibrary 的库。

h = new_system("myLibrary","Library");

创建一个名为 cycle 的变量。

cycle = 3;

尝试使用 ErrorIfShadowed 选项创建一个与该变量同名的模型。

new_system("cycle","ErrorIfShadowed")
The model 'cycle' cannot be created because this name is shadowing another name on the MATLAB path or in the workspace. Choose another name, or do not use the option
'ErrorIfShadowed'

输入参数

全部折叠

新模型或库的名称，指定为满足以下条件的字符串或字符向量：

  • 具有 150 个或更少字符

  • 不是 MATLAB 关键字

  • 不是 simulink

  • 在 MATLAB 路径和工作区中的模型名称、变量和 MATLAB 文件中是唯一的

示例: "mymodel"

新模型依据的子系统，指定为当前打开的模型中的 Subsystem 模块路径。将路径格式化为字符串或字符向量。

有关获取模块路径的信息，请参阅Get Handles and Paths。

示例: "myModel/mySubsystem"

数据类型: string | character vector

新模型依据的模板的名称，指定为字符串或字符向量。模板必须位于 MATLAB 路径中。在 Simulink 编辑器中创建模板。在仿真选项卡中，选择保存 > 模板。

示例: "mytemplate", "mytemplate.sltx"

数据类型: string | character vector

新模型所依据的模型或模板的路径名称，指定为字符串或字符向量。您可以使用 .mdl、.slx 或 .sltx 文件。包含扩展名并使用完整路径或相对路径。

示例: "Models/mymodel.slx", "mytemplate.sltx", "model.mdl"

数据类型: string | character vector

输出参量

全部折叠

新模型或库的数值句柄，以双精度形式返回。

数据类型: double

版本历史记录

在 R2006a 之前推出

另请参阅

| |

主题