金宝appSimulink.SubSystem.convertToModelReference

将子系统转换为模型引用

描述

金宝appSimulink.SubSystem.convertToModelReference (gcb UseConversionAdvisor,真的)打开模型参考转换顾问为选定的子系统块。

[特遣部队H] = 金宝appSimulink.SubSystem.convertToModelReference(中高模型转换指定的子系统参考模型。

对于每个子系统的功能转换,它:

  • 创建一个模型。

  • 复制子系统的内容复制到新的模式。

  • 更新任意根级别的输入和输出块与模型的配置参数以匹配原始子系统的编译属性。

  • 将原始模型的模型工作区的内容复制到新模型中。

在您使用此功能,加载包含子系统模型。

[特遣部队H] = 金宝appSimulink.SubSystem.convertToModelReference(中高模型名称,值使用一个或多个名称-值对参数指定选项。

例子

全部收缩

打开F14模型。

open_system(“f14”);

F14型号,选择控制器子系统的输出信号,然后点击测井信号

在Simuli金宝appnk®编辑器,选择控制器子系统。打开模型参考转换顾问从命令窗口。

金宝appSimulink.SubSystem.convertToModelReference(GCB,'UseConversionAdvisor',真正的);

使用advisor执行转换。

转换巴士柜台子系统到被引用模型的命名bus_counter_ref_model

open_system('sldemo_mdlref_conversion');金宝appSimulink.SubSystem.convertToModelReference (“sldemo_mdlref_conversion /公车计数器”'bus_counter_ref_model'“AutoFix”,真的,“ReplaceSubsystem”,真的,'CheckSimulationResults',真正的);
###成功地转换子系统块模型块。

用一个命令转换两个子系统。

open_system(“f14”);set_param(GCS,“SaveOutput”'上''SaveFormat'“数据集”);set_param(GCS,“SignalResolutionControl”“UseLocalSettings”);金宝appSimulink.SubSystem.convertToModelReference ({'F14 /控制器'“F14 /飞机动力学模型”},{'controller_ref_model''aircraft_dynamics_ref_model'},“ReplaceSubsystem”,真的,“AutoFix”,真的,'CheckSimulationResults',真正的)

输入参数

全部收缩

子系统名称或把手,指定为数字数组,字符向量,特征向量的单元阵列中,或字符串数​​组。

有关哪些子系统可以转换的信息,请参阅修改有条件执行的引用模型

数据类型:|烧焦|字符串

参考模型的名称,指定为字符向量,特征向量的单元阵列中,或字符串数​​组。每个模型名称必须是59个字符或更少。

如果您指定了多个要转换的子系统,请指定相同数量的引用模型名称。每个模型名称都对应于指定的子系统,顺序相同。

数据类型:烧焦|字符串

名称 - 值对参数

指定可选的用逗号分隔的对名称,值参数。的名字是参数的名称和价值为对应值。的名字必须出现引号内。您可以按照任何顺序指定多个名称和值对参数名1,值1,...,NameN,值N

例:金宝appSimulink.SubSystem.convertToModelReference ...(engineModelRef engineSubsys ReplaceSubsystem,真的)

选项来修复可自动修复的所有转换问题,指定为逗号分隔对,由“AutoFix”真正的

如果你设置自动修复真正的,该函数修复它能修复的所有转换问题。对于功能无法修复的问题,转换过程将生成通过修改模型来解决的错误消息。

注意

如果你设置真正的,则该功能不会自动修复转换问题。

数据类型:合乎逻辑

选项,以即使有错误完全转化,指定为逗号分隔的一对组成的'力'真正的

如果真正的,该函数返回转换错误,警告和与转换仍然没有固定的错误,即使你设定自动修复真正的。该选项允许你使用该功能进行转换的初始步骤,然后完成转换过程自己。

数据类型:合乎逻辑

选项从父模型复制代码映射到新的,转换后的模型,指定为逗号分隔的一对组成的“CopyCodeMappings”真正的

如果真正的中,函数副本从父模型中的现有代码映射配置到新的,转换参考模型。

如果,该函数不会将现有的代码映射配置从父模型复制到新的转换后的模型。

数据类型:合乎逻辑

选项转换前后检查仿真结果,指定为逗号分隔的一对组成的'CheckSimulationResults'真正的

执行转换之前:

如果模拟结果之间的差超过了容许水平,功能显示一条消息。

数据类型:合乎逻辑

用于比较的绝对信号公差,指定为逗号分隔的一对组成的'AbsoluteTolerance'和一个数字标。

只有当您设置此选项CheckSimulationResults真正的

数据类型:

用于比较的相对信号公差,指定为逗号分隔的一对组成的'RelativeTolerance'和一个数字标。

只有当您设置此选项CheckSimulationResults真正的

数据类型:

用于存储转换数据的文件的名称,指定为逗号分隔的对,由'DataFileName'和字符向量。你可以指定一个绝对或相对路径。

您可以保存在MAT文件转换数据(默认)或MATLAB®文件。如果你使用00文件扩展名,函数序列化的所有变量到MATLAB文件。

默认情况下,该函数使用由模型名称的文件名加_conversion_data.mat

数据类型:烧焦

选择更换子系统块与模型块,指定为逗号分隔的对,由“ReplaceSubsystem”真正的

如果将值设置为真正的,考虑使原始模型的备份在转换之前的子系统。如果你想撤消转换,具有备份可以更容易地恢复模型。

如果你设置ReplaceSubsystem真正的,转换操作取决于您是否使用自动修复选项。

  • 如果您使用自动修复,然后转换替换子系统用块模型块,除非自动修复更改了输入或输出端口。如果端口更改,则转换包括a中的子系统的内容模型被插入在该块子系统块。

  • 如果不使用自动修复,则转换将替换子系统用块模型块。

数据类型:合乎逻辑

选项插入包装子系统以保持模型布局,指定为逗号分隔的对组成'CreateWrapperSubsystem'真正的

当您将一个子系统转换为一个被引用的模型时,您可以让转换过程插入一个包装器子系统来保留模型的布局。子系统包装器包含模型阻止转换。

如果转换修改了包装器子系统,则转换自动创建包装器子系统模型通过添加端口阻塞接口。

数据类型:合乎逻辑

模拟模式模型块,指定为逗号分隔的对,由'SimulationModes''正常''加速器'。仿真模式设置适用于模型引用转换创建的模型的块。

数据类型:烧焦

模型参考的目标,以产生,指定为逗号分隔的一对组成的'BuildTarget'“辛”“编码器”

  • “辛”- 模型参考仿真目标

  • “编码器”- 代码生成目标

数据类型:烧焦

输出参数

全部收缩

真或假的结果,返回10数据类型的合乎逻辑

的价值1指示转换成功。

如果你设置真正的,该函数返回的值1如果转换完成。但是,模拟结果可以从模拟结果转换前的型号而异。

已创建的模型块,返回一个数字数组。

数据类型:

提示

  • 你不能在同一时间转换父子系统和子系统的孩子。

  • 与单独转换每个子系统相比,用一个命令指定要转换的多个子系统可以节省时间。多个子系统转换过程只编译一次模型。

  • 如果指定了多个要转换的子系统,转换过程将尝试转换每个子系统。即使其他子系统的转换失败,成功转换的子系统也会产生引用的模型。

  • 如果指定了多个子系统,可以考虑:

    • 在输入参数,设置“Autofix”“ReplaceSubsystem”,'CheckSimulationResults'真正的

    • 在模型中,设置较短的模拟时间。

  • 数据字典中保存它时这两个条件存在创建作为转换过程的一部分总线对象:

    • 顶配车型采用了数据字典。

    • 对顶部模型的所有更改将被保存。

  • 为了保持一个蒙面子系统的行为,执行这些额外的任务:

    • 对于掩码回调、图标、端口和文档,在将其转换为引用模型之前,创建掩码子系统的备份副本。转换后,将内容从备份掩码子系统的掩码编辑器复制到新掩码编辑器模型块。

    • 替换模型参数覆盖参数(见一个可重用的引用模型的参数化实例)。

    注意

    引用机型不支持的功能,您可以用面膜初始化代码实现创金宝app建蒙面参数。

兼容性的考虑

展开全部

不建议从R2019a开始

介绍了在R2006a