主要内容

systemcomposer.importModel

MATLAB

描述

例子

archModel= systemcomposer.importModel (modelName组件港口连接portInterfacesrequirementLinks基于MATLAB建立新的体系结构模型®指定组件、端口、连接、端口接口和需求链接的表。唯一需要的输入参数是modelName组件表格对于空表输入参数,输入table.empty。但是,后面的空表将被忽略,不需要输入。若要导入基本体系结构模型,请参见定义基本架构。进口requirementLinks,你需要一个金宝app®要求™许可证。

archModel= systemcomposer.importModel (modelNameimportStruct创建基于MATLAB表结构的新的体系结构模型,这些表具有指定的格式来指定模型元素关系、原型和属性。有关导入结构的详细信息,请参见导入和导出体系结构模型

archModelidMappingTableimportLogerrorLog= systemcomposer.importModel(___创建带有输出参数的新架构模型idMappingTable有了表信息,importLog显示导入信息,和errorLog查询导入错误信息。所有以前的语法描述都包括在内。

例子

全部折叠

在System Composer™中,架构完全由三组信息定义:

  • 组件信息

  • 端口信息

  • 连接信息

当此信息在MATLAB®表中定义或转换为MATLAB®表时,可以将架构导入System Composer。

在本例中,在Microsoft®Excel®电子表格中定义了简单无人机系统的体系结构信息,并用于创建system Composer体系结构模型。它还将元素链接到指定的系统级需求。当数据包含所需的信息时,您可以修改本例中的文件以导入外部工具中定义的体系结构。该示例还展示了如何将该体系结构信息从System Composer体系结构模型导出到Excel电子表格。

架构定义数据

您可以将架构描述为组件网络,并通过在MATLAB表格中定义组件、端口、连接、接口和需求链接来导入。的组件表必须包含每个组件的名称、唯一ID和父组件ID。电子表格还可以包括为引用模型构建架构层次结构所需的其他相关信息,以及原型限定符名称。的港口表中必须包含端口名称、方向、组件和端口ID信息。还可能需要端口接口信息来为组件分配端口。的连接表中包含连接端口的信息。该表至少必须包括连接ID、源端口ID和目的端口ID。

systemcomposer.importModel (importModelName)API:

  • 类中的原型名称组件表并加载配置文件

  • 创建组件并连接端口

  • 使用连接映射创建连接

  • 在端口上设置接口

  • 将元素链接到指定的需求

  • 保存引用模型

  • 保存体系结构模型

实例化要从Excel读取的适配器类。modelName =“simpleUAVArchitecture”importModelFromExcel函数读取Excel文件并创建MATLAB表。importAdapter = ImportModelFromExcel(“SmallUAVModel.xls”“组件”“端口”“连接”“PortInterfaces”“RequirementLinks”);importAdapter.readTableFromExcel ();

导入架构

model = systemcomposer.importModel(modelName,importAdapter.Components,importAdapter.Ports、importAdapter.Connections importAdapter.Interfaces,importAdapter.RequirementLinks);在生成的模型中自动排列块金宝appSimulink.BlockDiagram.arrangeSystem (modelName);

导出架构

您可以将架构导出到MATLAB表,然后将表转换为外部文件。

exportedSet = systemcomposer.exportModel(modelName);函数的输出是一个结构,其中包含组件表、端口表、%连接表、接口表和需求链接表。将上述结构保存到Excel文件。SaveToExcel (“ExportedUAVModel”, exportedSet);

输入参数

全部折叠

要创建的模型名称,指定为字符向量或字符串。

例子:“importedModel”

数据类型:字符|字符串

建模组件信息,指定为MATLAB表格。组件表必须包含列名字ID,ParentID。指定组件类型作为变体作文(默认),StateflowBehavior,或行为(引用组件和子系统组件)并设置ReferenceModelName,请参阅导入可变组件、状态流行为或引用组件。使用以下命令应用构造型stereotypename并将属性值设置为组件,请参见在导入模型上应用原型并设置属性值

数据类型:表格

模型端口信息,指定为MATLAB表格。端口表必须包含这些列名字方向ID,列表。的方向列可以有值输入输出,或物理。可选列InterfaceID指定接口。portInterfaces还可能需要将接口分配到端口。

数据类型:表格

建模连接信息,指定为MATLAB表。连接表必须包含列名字IDSourcePortID,DestPortID。指定SourceElementDestinationElement在体系结构端口上,请参见在架构端口上指定元素。使用可选列分配原型stereotypename。可选种类列可以指定为默认值数据物理用于物理连接。

数据类型:表格

模型端口接口信息,指定为MATLAB表格。端口接口表必须包含这些列名字IDParentID数据类型单位复杂性最低,最大。导入接口并将端口映射到接口,请参见导入数据接口,将端口映射到接口。使用选项列添加描述描述。使用可选列分配原型stereotypename

数据类型:表格

模型需求链接信息,指定为MATLAB表格。需求链接表必须包含列标签IDSourceIDDestinationTypeDestinationID,类型。有关示例,请参见在导入模型上分配需求链接。若要从导入的文件更新引用需求链接并将它们集成到模型中,请参见从导入的文件中更新引用需求链接。可选列包括:DestinationArifactSourceArtifactReferencedReqID关键字CreatedOnCreatedByModifiedOnModifiedBy,修订。一个金宝app仿真软件的需求导入requirementLinks表到System Composer™体系结构模型。

数据类型:表格

为表建模,指定为包含表的结构组件港口连接portInterfaces,requirementLinks,和一个字段。只有组件表是必需的。可能的值为都是默认的“系统”对于体系结构模型和“软件”对于软件架构模型。有关导入结构的详细信息,请参见导入和导出体系结构模型

数据类型:结构体

输出参数

全部折叠

架构模型的句柄,指定为systemcomposer.arch.Architecture对象。

元素的自定义id和内部uuid的映射,返回为结构体MATLAB表格。

数据类型:结构体

确认元素已导入,并作为字符向量的单元格数组返回。

数据类型:字符

的单元格数组返回导入过程中报告的错误消息对象。方法获取错误文本getString方法消息对象。例如,errorLog.getString用于获取以字符串形式报告的错误。

更多关于

全部折叠

定义

术语 定义 应用程序 更多的信息
体系结构 System Composer体系结构表示一个组件系统,以及它们如何在结构上和行为上相互交互。您可以使用备用视图表示特定的体系结构。

不同类型的体系结构描述了系统的不同方面:

  • 功能体系结构描述系统中的数据流。

  • 逻辑架构描述系统的预期操作。

  • 物理架构描述系统中的平台或硬件。

从视觉上组合架构
模型 System Composer模型是包含架构信息的文件,包括组件、端口、连接器、接口和行为。

对模型进行操作:

  • 提取模型中包含的根级体系结构。

  • 应用概要文件。

  • 链接接口数据字典。

  • 从模型体系结构生成实例。

System Composer模型存储为SLX文件。

创建带有接口和需求链接的架构模型
组件 组件是系统中重要的、几乎独立的、可替换的部分,它在体系结构上下文中实现明确的功能。组件定义一个体系结构元素,如功能、系统、硬件、软件或其他概念性实体。组件也可以是子系统或子功能。 组件以块的形式表示,是体系结构模型的一部分,可以分离为可重用构件。 组件
港口 端口是组件或体系结构上的一个节点,它表示与其环境的一个交互点。端口允许信息流进出其他组件或系统。

有不同类型的端口:

  • 组件端口是组件上与其他组件的交互点。

  • 架构的港口是系统边界上的端口,无论边界是在组件内还是在整体体系结构模型内。

港口
连接器 连接器是提供端口之间连接的线路。连接器描述了信息如何在组件或体系结构之间流动。 连接器允许两个组件进行交互,而无需定义交互的性质。在端口上设置接口以定义组件如何交互。 连接

术语 定义 应用程序 更多的信息
接口数据字典 接口数据字典是体系结构中所有接口和值类型及其使用位置的统一列表。

可以使用接口编辑器将System Composer模型上的本地接口保存在接口数据字典中。

接口字典可以在需要使用一组给定接口、元素和值类型的模型之间重用。数据字典存储在单独的SLDD文件中。

数据接口 数据接口定义了流经端口的信息类型。同一个接口可以分配给多个端口。数据接口可以是复合的,这意味着它可以包括描述接口信号属性的数据元素。 数据接口表示通过连接器共享的信息,并通过端口进入或退出组件。使用接口编辑器创建和管理数据接口和数据元素,并将它们存储在接口数据字典中,以便在模型之间重用。 创建带有接口和需求链接的架构模型
数据元素 数据元素描述接口的一部分,例如通信消息、计算或测量参数,或该接口的其他分解。

数据接口被分解为数据元素:

  • 连接器或线束中的针或线

  • 通过总线传输的消息。

  • 组件间共享的数据结构。

值类型 值类型可以用作端口接口,定义流经该端口的原子数据块,并具有顶级类型、维度、单位、复杂性、最小值、最大值和描述。 还可以将数据接口中的数据元素类型指定为值类型。使用“接口编辑器”将值类型添加到数据字典中,以便可以重用值类型作为接口或数据元素。 创建值类型作为接口
所有接口 拥有的接口是本地定义的接口,它是特定端口的本地接口,在数据字典或模型字典中不共享。 创建一个自有接口来表示端口本地的值类型或数据接口。 定义属于端口的本地接口
适配器 适配器通过两个接口之间的映射来帮助连接两个端口接口不兼容的组件。适配器还可以充当单位延迟或速率转换。使用适配器块来实现适配器。

使用适配器,你可以在接口适配器对话框中执行功能:

  • 创建和编辑输入和输出接口之间的映射。

  • 应用接口转换UnitDelay打破一个代数循环。

  • 应用接口转换RateTransition协调参考模型的不同采样时间率。

术语 定义 应用程序 更多的信息
需求 需求是描述系统所需行为和特征的语句的集合。需求确保系统设计的完整性,并且是可实现的、可验证的、明确的,并且彼此一致的。每个层次的设计都应该有适当的要求。 增强需求的可追溯性,将系统、功能、客户、性能或设计需求与组件和端口联系起来。将需求相互链接以表示派生的或分配的需求。在架构模型上或通过自定义视图从requirements Manager管理需求。使用测试管理器将测试用例分配给需求以进行验证和确认。 链路和跟踪需求
要求设置 需求集是需求的集合。您可以分层结构需求,并将它们链接到组件或端口。 使用需求编辑器来编辑和细化需求集中的需求。需求集存储在.slreqx文件。您可以创建一个新的需求集,并使用金宝app仿真软件的需求,或从支持的第三方工具导入需求。金宝app 管理需求
要求链接 链接是连接两个基于模型的设计元素的对象。需求链接是目的地为需求的链接。您可以将需求链接到组件或端口。 使用System Composer中的Requirements透视图查看链接。在Requirements Browser中选择一个需求,以突出显示分配需求的组件或端口。链接在外部存储为.slmx文件。
测试工具 测试套件是一个隔离被测组件的模型,带有为测试场景配置的输入、输出和验证块。您可以为一个模型组件或一个完整的模型创建一个测试工具。测试工具为模型或模型组件提供了单独的测试环境。 为System Composer组件创建测试工具,以验证模拟结果和验证设计。在System Composer测试工具模型中可以访问接口编辑器,以支持行为测试和独立于实现的接口测试。

术语 定义 应用程序 更多的信息
物理子系统 物理子系统是带有Simscape™连接的Simuli金宝appnk子系统。 具有Simscape连接的物理子系统使用一种物理网络方法,适合模拟具有真实物理组件的系统,并表示一个数学模型。 使用Simscape描述组件行为
物理端口 物理端口表示Simscape物理建模连接器端口,称为连接端口(Simscape) 使用物理端口连接架构模型中的组件或启用Simulink子系统中的物理系统。金宝app 在组件上定义物理端口
身体上的连接器

物理连接器可以表示特定物理域的非定向保存连接。连接器也可以表示物理信号。

使用物理连接器连接表示系统特征的物理组件,以进行数学模拟。 具有Simscape行为的直流电机体系结构模型
物理接口

物理接口定义了流经物理端口的信息类型。同一个接口可以分配给多个端口。物理接口是一种复合接口,相当于金宝app仿真软件。ConnectionBus对象,该对象至少指定一个金宝app仿真软件。ConnectionElement对象。

使用物理接口来捆绑物理元素,以使用至少一个物理域来描述物理模型。 在端口上指定物理接口
物理元素

物理元素描述物理接口的分解。一个物理元素相当于一个金宝app仿真软件。ConnectionElement对象。

定义类型将物理元素作为物理域,以便在物理模型中使用该域。 使用Simscape描述组件行为

在R2019a中引入