iterate

遍历模型元素

全页折叠

语法

iterate(arch,iterType,iterFunction)

iterate(___,Name=Value)

iterate(___,Name=Value,additionalArgs)

说明

iterate(arch,iterType,iterFunction) 按 arch 指定的顺序遍历架构 iterType 中的组件，并在每个组件上调用由函数句柄 iterFunction 指定的函数。

注意

该函数是实例编程接口的一部分，可用于逐元素迭代分析模型。instance 指的是执行迭代的元素实例。

iterate(___,Name=Value) 使用之前的所有语法和附加选项迭代架构中的组件。

iterate(___,Name=Value,additionalArgs) 会遍历架构中带有附加选项的组件，并将指定为 additionalArgs 的所有尾部参量作为参量传递给 iterFunction。带有 additionalArgs 的名称-值参量必须指定为以逗号分隔的名称-值对组形式。

示例

全部折叠

计算电池容量

有关电池选型示例的更多信息，请参阅电池选型与汽车电气系统分析。

openExample("systemcomposer/BatterySizingAndAutomotiveAnalysisExample")
archModel = systemcomposer.openModel("scExampleAutomotiveElectricalSystemAnalysis");
% Instantiate battery sizing class used by analysis function to store
% analysis results.
objcomputeBatterySizing = computeBatterySizing;
% Run the analysis using the iterator
iterate(archModel,"TopDown",@computeLoad,"Recurse",true,objcomputeBatterySizing);

输入参数

全部折叠

`arch` — 要遍历的架构
架构对象 | 架构实例对象

要遍历的架构，指定为 systemcomposer.arch.Architecture 或 systemcomposer.analysis.ArchitectureInstance 对象。

`iterType` — 迭代类型
`"PreOrder"` | `"PostOrder"` | `"TopDown"` | `"BottomUp"`

迭代类型，指定为 "PreOrder"、"PostOrder"、"TopDown" 或 "BottomUp"。

Pre-order - 从顶层开始，移至子组件，并递归处理该组件的子组件，然后再移至同级组件。
Top-Down - 与前序遍历类似，但在移至子组件之前先处理所有同级组件。
Post-order - 从没有子组件的组件开始，处理每个同级组件，然后移至父组件。
Bottom-up - 与后序遍历类似，但先处理所有同一深度的子组件，再将其移至父节点。

数据类型: char | string

`iterFunction` — 迭代函数
函数句柄

迭代函数，指定为对每个组件进行迭代的函数句柄。

`additionalArgs` — 附加函数参量
逗号分隔的函数参量列表

附加函数参量，指定为逗号分隔的参量列表，并传递给 iterFunction。

名称-值参数

全部折叠

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

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

示例: iterate(archModel,"TopDown",@computeLoad,"Recurse",true,objcomputeBatterySizing)

`Recurse` — 递归遍历模型组件的选项
`1` (`true`) (默认) | `0` (`false`)

递归遍历模型组件的选项，指定为 1 (true) 表示递归遍历，指定为 0 (false) 表示只遍历此架构中的组件，而不导航到子组件的架构中。

Recurse 仅适用于 systemcomposer.arch.Architecture 对象。

数据类型: logical

`IncludePorts` — 迭代组件和架构端口的选项
`0` (`false`) (默认) | `1` (`true`)

迭代组件和架构端口的选项，指定为 0 (false) 则只迭代组件，指定为 1 (true) 则迭代组件和架构端口。

数据类型: logical

`IncludeConnectors` — 迭代组件和连接器的选项
`0` (`false`) (默认) | `1` (`true`)

迭代组件和连接器的选项，指定为 0 (false) 时只迭代组件，指定为 1 (true) 时迭代组件和连接器。

IncludeConnectors 仅适用于 systemcomposer.analysis.ArchitectureInstance 对象。

数据类型: logical

`FollowConnectivity` — 确保迭代顺序的选项
`0` (`false`) (默认) | `1` (`true`)

根据组件从源点到终点的连接方式确保迭代顺序的选项，指定为 0 (false) 或 1 (true)。如果该选项指定为 1 (true)，迭代类型 iterType 必须是 "TopDown" 或 "BottomUp"。如果指定了其他选项，迭代类型默认为 "TopDown"。

FollowConnectivity 仅适用于 systemcomposer.arch.Architecture 对象。

数据类型: logical

详细信息

全部折叠

定义

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

术语	定义	应用	更多信息
分析	静态分析分析系统结构，针对某些特性对架构进行定量评估。静态分析使用分析函数以及系统模型中捕获的属性和参数的参数值。	使用分析计算系统的总体可靠性、质量卷积、性能或热特性，或执行大小、重量和功率 (SWaP) 分析以提高效率。	使用分析函数分析架构模型属性分析架构使用具有属性的机器人系统进行简单的汇总分析
分析函数	分析函数是一个 MATLAB^® 数，它使用模型实例中每个元素的属性以及组件和架构层级的实例特定参数计算评估架构所需的值。	使用分析函数计算分析结果。	分析函数构造编写分析函数
实例模型	实例模型是实例的集合。	您可以根据模型的更改更新实例模型，但实例模型不会根据活动变体或模型引用的更改而更新。您可以使用保存在 `MAT` 文件中的 System Composer 架构模型的实例模型进行分析。	运行分析函数
实例	实例是架构模型元素在给定时间点上的具体体现。	实例会冻结实例模型中组件的活动变体或模型引用。	创建用于分析的模型实例

版本历史记录

在 R2019a 中推出

另请参阅

instantiate | lookup | systemcomposer.analysis.Instance

主题

分析架构

iterate

语法

说明

示例

计算电池容量

输入参数

arch — 要遍历的架构 架构对象 | 架构实例对象

iterType — 迭代类型 "PreOrder" | "PostOrder" | "TopDown" | "BottomUp"

iterFunction — 迭代函数 函数句柄

additionalArgs — 附加函数参量 逗号分隔的函数参量列表

名称-值参数

Recurse — 递归遍历模型组件的选项 1 (true) (默认) | 0 (false)

IncludePorts — 迭代组件和架构端口的选项 0 (false) (默认) | 1 (true)

IncludeConnectors — 迭代组件和连接器的选项 0 (false) (默认) | 1 (true)

FollowConnectivity — 确保迭代顺序的选项 0 (false) (默认) | 1 (true)

详细信息

定义

版本历史记录

另请参阅

主题

`arch` — 要遍历的架构
架构对象 | 架构实例对象

`iterType` — 迭代类型
`"PreOrder"` | `"PostOrder"` | `"TopDown"` | `"BottomUp"`

`iterFunction` — 迭代函数
函数句柄

`additionalArgs` — 附加函数参量
逗号分隔的函数参量列表

`Recurse` — 递归遍历模型组件的选项
`1` (`true`) (默认) | `0` (`false`)

`IncludePorts` — 迭代组件和架构端口的选项
`0` (`false`) (默认) | `1` (`true`)

`IncludeConnectors` — 迭代组件和连接器的选项
`0` (`false`) (默认) | `1` (`true`)

`FollowConnectivity` — 确保迭代顺序的选项
`0` (`false`) (默认) | `1` (`true`)