find

使用查询查找架构模型元素

全页折叠

语法

[paths] = find(model,constraint,Name=Value)

[paths, elements] = find(___)

[elements] = find(___)

[paths] = find(model,constraint,rootArch,Name=Value)

说明

[paths] = find(model,constraint,Name=Value) 查找从模型根架构开始的、满足 constraint 查询条件的所有元素路径，并通过一个或多个名称-值参量指定附加选项。

示例

[paths, elements] = find(___) 返回满足 constraint 查询的组件元素 elements 及其 paths。输入参量的语法如上。如果没有提供 rootArch，则函数会在模型的根架构中查找模型元素。输出参量 paths 包含 elements 中每个组件从给定根架构出发的完全限定命名路径。

示例

[elements] = find(___) 查找满足 constraint 查询条件的所有组件、端口或连接器元素 elements，以及由一个或多个名称-值参量指定的附加选项，这些参量必须包括 'Port' 或 'Connector' 以用于 'ElementType'。

示例

[paths] = find(model,constraint,rootArch,Name=Value) 查找从指定根架构 rootArch 开始的、满足 constraint 查询条件的所有元素路径，并通过一个或多个名称-值参量指定附加选项。

示例

全部折叠

查找满足查询的模型元素路径

导入模型并运行查询，根据指定的子约束选择具有构造型的架构元素。

import systemcomposer.query.*;
scKeylessEntrySystem
modelObj = systemcomposer.openModel("KeylessEntryArchitecture");
find(modelObj,HasStereotype(IsStereotypeDerivedFrom("AutoProfile.BaseComponent")),...
 Recurse=true,IncludeReferenceModels=true)

创建一个查询，查找在 Name 属性中包含字母 c 的组件。

constraint = contains(systemcomposer.query.Property("Name"),"c");
find(modelObj,constraint,Recurse=true,IncludeReferenceModels=true)

查找架构模型中的元素

打开实时脚本

根据 System Composer™ 查询查找架构模型中的元素。

创建模型

创建一个包含两个组件的架构模型。

m = systemcomposer.createModel("exModel");
comps = m.Architecture.addComponent(["c1","c2"]);

创建配置文件和构造型

为架构模型创建配置文件和构造型。

pf = systemcomposer.profile.Profile.createProfile("mProfile");
b = pf.addStereotype("BaseComp",AppliesTo="Component",Abstract=true);
s = pf.addStereotype("sComp",Parent=b);

应用配置文件和构造型

在架构模型中应用配置文件和构造型。

m.Architecture.applyProfile(pf.Name)
comps(1).applyStereotype(s.FullyQualifiedName)

查找元素

根据查询在架构模型中查找元素。

import systemcomposer.query.*
[p, elem] = find(m, HasStereotype(IsStereotypeDerivedFrom("mProfile.BaseComp")),...
Recurse=true,IncludeReferenceModels=true)

p = 1×1 cell array
    {'exModel/c1'}

elem = 
  Component with properties:

     IsAdapterComponent: 0
           Architecture: [1×1 systemcomposer.arch.Architecture]
                   Name: 'c1'
                 Parent: [1×1 systemcomposer.arch.Architecture]
                  Ports: [0×0 systemcomposer.arch.ComponentPort]
             OwnedPorts: [0×0 systemcomposer.arch.ComponentPort]
      OwnedArchitecture: [1×1 systemcomposer.arch.Architecture]
             Parameters: [0×0 systemcomposer.arch.Parameter]
               Position: [15 15 135 115]
                  Model: [1×1 systemcomposer.arch.Model]
         SimulinkHandle: 151.0626
    SimulinkModelHandle: 149.1050
                   UUID: '5502ff5b-d92a-40ef-a60d-0acafe3f3c50'
            ExternalUID: ''

清理

移除模型和配置文件。

cleanUpFindElementsInModel

在架构模型中查找端口

创建一个用于查询的模型，并创建两个组件。

m = systemcomposer.createModel("exModel");
comps = m.Architecture.addComponent(["c1","c2"]);
port = comps(1).Architecture.addPort("cport1","in");

创建一个查询，查找在 Name 属性中包含字母 c 的端口。

constraint = contains(systemcomposer.query.Property("Name"),"c");
find(m,constraint,Recurse=true,IncludeReferenceModels=true,ElementType="Port")

查找满足查询的架构元素路径

import systemcomposer.query.*;
scKeylessEntrySystem
modelObj = systemcomposer.openModel("KeylessEntryArchitecture");
find(modelObj,HasStereotype(IsStereotypeDerivedFrom("AutoProfile.BaseComponent")),...
 modelObj.Architecture,Recurse=true,IncludeReferenceModels=true)

输入参数

全部折叠

`model` — 架构模型
模型对象

架构模型，指定为 systemcomposer.arch.Model 对象。

`constraint` — 查询
查询约束对象

查询，指定为代表特定条件的 systemcomposer.query.Constraint 对象。

一个约束可以包含一个子约束，该子约束可以使用 AND 或 OR 与另一个约束连接。可以使用 NOT 否定约束。

查询对象和约束条件

查询对象	条件
`Property`	给定属性或构造型属性的非计算值。
`PropertyValue`	来自 System Composer™ 对象或构造型属性的已计算属性值。
`HasConnector`	组件具有满足给定子约束条件的连接器。
`HasPort`	组件的端口满足给定的子约束条件。
`HasInterface`	端口有满足给定子约束条件的接口。
`HasInterfaceElement`	一个接口有一个满足给定子约束条件的接口元素。
`HasStereotype`	架构元素具有满足给定子约束条件的构造型。
`IsInRange`	属性值在给定范围内。
`AnyComponent`	元素是一个组件，而不是端口或连接器。
`IsStereotypeDerivedFrom`	构造型是从给定的构造型中派生出来的。

`rootArch` — 模型的根架构
架构对象 | 模型对象的 `Architecture` 属性

模型的根架构，指定为 systemcomposer.arch.Architecture 对象或 systemcomposer.arch.Model 对象的 Architecture 属性。

示例: modelObj.Architecture

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，需使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: find(model,constraint,Recurse=true,IncludeReferenceModels=true)

`Recurse` — 递归搜索模型的选项
`1` (`true`) (默认) | `0` (`false`)

递归搜索模型或仅搜索特定图层的选项，指定为 1 (true) 表示递归搜索或 0 (false) 表示仅搜索特定图层。

示例: find(model,constraint,Recurse=true)

数据类型: logical

`IncludeReferenceModels` — 搜索引用架构的选项
`0` (`false`) (默认) | `1` (`true`)

搜索引用架构的选项，指定为 1 (true) 或 0 (false)。

示例: find(model,constraint,IncludeReferenceModels=true)

数据类型: logical

`ElementType` — 按类型搜索的选项
`"Component"` (默认) | `"Port"` | `"Connector"`

按类型搜索的选项，指定为以下类型之一

"Component" 以查找满足查询的组件
"Port" 以查找满足查询的端口
"Connector' 以找到满足查询的连接器

示例: find(model,constraint,ElementType="Port")

数据类型: char | string

输出参量

全部折叠

`paths` — 元素路径
字符向量元胞数组

元素路径，以满足 constraint 的字符向量元胞数组形式返回。

数据类型: char

`elements` — 元素
元素对象

元素，以满足 constraint 的 systemcomposer.arch.Element 对象形式返回。

详细信息

全部折叠

定义

术语	定义	应用	更多信息
架构	System Composer 架构代表由组件组成的系统，以及这些组件在结构上和行为上如何相互关联。	不同类型的架构描述系统的不同方面。您可以使用视图来可视化架构中的组件子集。您可以使用参数编辑器在架构层级上定义参数。	可视化构建架构在 System Composer 中使用参数编辑器编写参数
根	根位于架构层次结构的顶层。根架构的边界由围绕相关系统的架构端口定义。	根架构的系统边界包围着您的架构模型。您可以添加架构端口来定义跨边界接口。	可视化构建架构
模型	System Composer 模型是包含架构信息的文件，涵盖组件、端口、连接器、接口和行为等信息。	对模型执行操作，包括提取根级架构、应用配置文件、链接接口数据字典或从模型架构生成实例。System Composer 模型存储为 SLX 文件。	创建带接口和需求链接的架构模型
组件	组件是系统中可替换的部分，用于在架构环境中实现明确的函数。组件定义架构元素，例如函数、另一个系统、硬件、软件或其他概念实体。组件也可以是子系统或子函数。	组件以模块的形式表示，是架构模型的一部分，并且可以分离成可重用的工件。使用端口接口和参数在组件之间传递信息。可以使用接口编辑器和参数编辑器来配置端口接口和参数。	可视化构建架构
端口	端口是组件或架构上的节点，表示与其环境的交互点。通过端口，信息可以流向其他组件或系统，或者从其他组件或系统流入。	组件端口是组件上与其他组件之间的交互点。架构端口是系统边界上的端口，无论该边界是在组件内还是在整体架构模型内。根架构具有由其端口定义的边界。	可视化构建架构
连接器	连接器是提供端口之间连接的线。连接器描述信息如何在组件或架构之间流动。	通过连接器，两个组件可以进行交互，而无需定义交互的性质。在端口上设置接口来定义组件之间的交互方式。	可视化构建架构

术语	定义	应用	更多信息
视图	视图显示模型中可自定义的元素子集。视图可根据组件、端口和接口的构造型或名称，以及接口元素的名称、类型或单位进行过滤。通过手动添加元素来创建视图。视图通过聚焦于架构设计的某些部分，为处理复杂架构提供了一种简化工作方式。	您可以使用不同类型的视图来表示系统。在组件图、组件层次结构或架构层次结构之间切换。软件架构可以切换到类图视图。视点代表利益相关者透视，用于指定视图的内容。	使用架构视图库创建自定义视图无钥匙进入系统的架构建模
元素组	元素组是视图中组件的组合。	使用元素组以编程方式填充视图。	交互式创建架构视图通过编程创建架构视图
查询	查询是用来描述模型元素需满足的某些约束或准则的一种规范。	使用查询以通过约束准则来搜索元素并过滤视图。	使用查询查找模型中的元素
组件图	组件图根据模型的结构，用组件、端口和连接器来表示视图。	组件图允许您以编程方式或手动方式添加和删除视图中的组件。	在自定义架构视图中检查组件
层次结构图	您可以将层次结构图可视化为包含组件、端口、引用类型、组件构造型和构造型属性的视图。	组件层次图以树形显示组件，父组件位于子组件之上。在组件层次结构视图中，每个引用模型的使用次数都是一样的。架构层次图使用组合连接显示唯一组件架构类型及其关系。在架构层次视图中，每个引用的模型只表示一次。	使用视图显示组件层次结构和架构层次结构

版本历史记录

在 R2019a 中推出

另请参阅

主题

使用架构视图库创建自定义视图

find

语法

说明

示例

查找满足查询的模型元素路径

查找架构模型中的元素

在架构模型中查找端口

查找满足查询的架构元素路径

输入参数

model — 架构模型 模型对象

constraint — 查询 查询约束对象

rootArch — 模型的根架构 架构对象 | 模型对象的 Architecture 属性

名称-值参数

Recurse — 递归搜索模型的选项 1 (true) (默认) | 0 (false)

IncludeReferenceModels — 搜索引用架构的选项 0 (false) (默认) | 1 (true)

ElementType — 按类型搜索的选项 "Component" (默认) | "Port" | "Connector"

输出参量

paths — 元素路径 字符向量元胞数组

elements — 元素 元素对象

详细信息

定义

版本历史记录

另请参阅

主题

`model` — 架构模型
模型对象

`constraint` — 查询
查询约束对象

`rootArch` — 模型的根架构
架构对象 | 模型对象的 `Architecture` 属性

`Recurse` — 递归搜索模型的选项
`1` (`true`) (默认) | `0` (`false`)

`IncludeReferenceModels` — 搜索引用架构的选项
`0` (`false`) (默认) | `1` (`true`)

`ElementType` — 按类型搜索的选项
`"Component"` (默认) | `"Port"` | `"Connector"`

`paths` — 元素路径
字符向量元胞数组

`elements` — 元素
元素对象