主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

iterate

遍历模型元素

说明

iterate(arch,iterType,iterFunction)iterType 指定的顺序遍历架构 arch 中的组件,并在每个组件上调用由函数句柄 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);

输入参数

全部折叠

迭代类型,指定为 "PreOrder""PostOrder""TopDown""BottomUp"

  • Pre-order - 从顶层开始,移至子组件,并递归处理该组件的子组件,然后再移至同级组件。

  • Top-Down - 与前序遍历类似,但在移至子组件之前先处理所有同级组件。

  • Post-order - 从没有子组件的组件开始,处理每个同级组件,然后移至父组件。

  • Bottom-up - 与后序遍历类似,但先处理所有同一深度的子组件,再将其移至父节点。

数据类型: char | string

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

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

名称-值参数

全部折叠

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

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

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

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

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

数据类型: logical

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

数据类型: logical

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

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

数据类型: logical

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

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

数据类型: logical

详细信息

全部折叠

版本历史记录

在 R2019a 中推出