Simulink 决策计数

自 R2022b 起

度量 ID

slcomp.SimulinkDecisions

描述

使用此度量来计算单元或组件每一层中 Simulink^® 块的 Simulink 决策数。

支持的工件

您可以针对Units和组件收集此度量。要控制仪表板将哪些对象分类为单元或组件，请参阅将模型按层级结构分类为组件或单元。

常见模块类型的决策计数

下表显示了该度量如何计算常见 Simulink 块的决策计数。

决策计数表

模块或实体	决策计数	描述
Abs	1	对于决策计数，Abs 模块可以视为 `if-else` 语句：如果 Abs 模块的输入小于零，则 Abs 模块的输出为输入乘以 -1。否则，默认情况下，Abs 模块的输出等于 Abs 模块的输入。 if (input < 0) % one decision output = -1*input; else % default path % zero decisions output = input; end `if-else` 语句的决策计数为 1，因为 `if` 语句表示一个决策，而 `else` 语句表示默认行为（不做出任何决策）。
Combinatorial Logic	真值表参数中的行数减 1	决策次数取决于真值表中的行数。如果真值表包含五行，则决策计数为 4。真值表中的一行包含默认输出，其余四行包含取决于所做决定的潜在输出。注意该度量要求您直接在 Combinatorial Logic 模块中指定真值表，并且要求您使用定义所有可能的模块输出的矩阵来指定真值表参数。如果该度量无法解析矩阵，则该度量返回决策计数为 1。
Dead Zone	2	Dead Zone 模块的输出取决于模块输入 (`U`) 以及死区起点（下限，`LL`）和死区终点（上限，`UL`）参数的值。对于决策计数，Dead Zone 模块可以视为 `if-elseif-else` 语句：如果 `U >= LL` 和 `U <= UL`，则输出为 `0`。如果为 `U > UL`，则输出为 `U - UL`。否则，输出为 `U - LL`。 if ((U >= LL) & (U <= UL)) % one decision output = 0; elseif (U > UL) % one decision output = U - UL; else % default path % zero decisions output = U - LL; end `if-elseif-else` 语句的决策计数为 2，因为 `if` 语句代表一个决策，`elseif` 语句代表一个决策，而 `else` 语句代表默认行为（不做出任何决策）。
Delay	可以是 0、1 或 2	决策计数取决于显示使能端口参数和外部重置参数。如果清除显示使能端口复选框并将外部重置设置为 `None`，则决策计数为 0。如果您选择显示使能端口并将外部重置设置为 `None`，则决策计数为 1。如果清除显示使能端口复选框并将外部重置设置为 `None` 以外的值，则决策计数为 1。如果您选择显示使能端口并将外部重置设置为 `None` 以外的值，则决策计数为 2。
Discrete-Time Integrator	可以是 0、1、2 或 3	决策计数取决于外部重置参数和限制输出参数。如果将外部重置设置为 `none`，并清除限制输出复选框，则决策计数为 0。这是 Discrete-Time Integrator 模块的默认行为。如果将外部重置设置为 `none` 以外的值，并且清除限制输出复选框，则决策计数为 1。如果将外部重置设置为 `none` 并选择限制输出，则决策计数为 2。如果将外部重置设置为 `none` 以外的值，并选择限制输出，则决策计数为 3。
Discrete Filter	0 或 1	决策计数取决于外部重置参数。如果外部重置设置为 `None`，则决策计数为 1。否则，决策计数为 0。
Discrete FIR Filter	可以是 0、1 或 2	决策计数取决于显示使能端口参数和外部重置参数。如果清除显示使能端口复选框并将外部重置设置为 `None`，则决策计数为 0。如果您选择显示使能端口并将外部重置设置为 `None`，则决策计数为 1。如果清除显示使能端口复选框并将外部重置设置为 `None` 以外的值，则决策计数为 1。如果您选择显示使能端口并将外部重置设置为 `None` 以外的值，则决策计数为 2。
已启用和已触发的模型或子系统	1	对于决策计数，已启用并触发的模型或子系统可以视为 `if-else` 语句：如果模型或子系统已启用并触发，则该模型或子系统将执行。否则，默认情况下，模型或子系统不会执行。 `if-else` 语句的决策计数为 1，因为 `if` 语句表示一个决策，而 `else` 语句表示默认行为（不做出任何决策）。
已启用模型或子系统	1	对于决策计数，已启用的模型或子系统可以视为 `if-else` 语句：如果模型或子系统已启用，则模型或子系统将执行。否则，默认情况下，模型或子系统不会执行。 `if-else` 语句的决策计数为 1，因为 `if` 语句表示一个决策，而 `else` 语句表示默认行为（不做出任何决策）。
For Iterator Subsystem	1	对于决策计数，For Iterator Subsystem 模块可以视为 `if-else` 语句：如果迭代值小于或等于迭代限制，则遍历 For Iterator Subsystem 模块中的块。否则，子系统将不会执行。 `if-else` 语句的决策计数为 1，因为 `if` 语句表示一个决策，而 `else` 语句表示默认行为（不做出任何决策）。
If	`if` 和 `elseif` 表达式的数量	每个 `if` 语句代表一个决定，每个 `elseif` 语句也代表一个决定。决策计数是 `if` 和 `elseif` 语句的数量。例如，以下代码包含一个 `if` 语句和一个 `elseif` 语句，因此其决策计数为 2： if (u > 0) % one decision y = 1; elseif (u < 0) % one decision y = 2; else % default path, zero decisions y = 0; end
Index Vector	1	Index Vector 模块的决策计数为 1。 Index Vector 模块是 Multiport Switch 模块的一种特殊配置，其中您可以指定一个数据输入，并且控制输入是从零开始的。例如，如果输入向量为 `[18 15 17 10]`，控制输入为 `3`（从零开始的索引），则输出为 `10`。使用控制输入对输入向量进行索引被视为一个单一决策。
MinMax	可以是 1，也可以是输入端口数减 1。	决策次数取决于输入端口的数量：如果输入端口数为 1，则决策计数为 1。否则，决策计数为输入端口数减 1。
Multiport Switch	数据端口数减 1	Multiport Switch 模块的决策计数取决于输入该模块的数据端口的数量。数据端口的数量代表了可能的结果数量。决策计数是数据端口数减 1，因为其中一个可能的结果就是默认路径。对于默认路径，尚未做出任何决定。例如，如果数据输入数量为 3，则决策计数为 2。如果只有一个数据端口，则 Multiport Switch 模块充当 Index Vector 模块，决策计数为 1。
Rate Limiter	2	Rate Limiter 模块的输出是通过将 rate 与上升沿压摆率 (`R`) 和下降沿压摆率 (`F`) 参数进行比较来确定的。对于决策计数，Rate Limiter 模块可以视为 `if-elseif-else` 语句：如果 rate 大于 `R`，则使用上升转换速率计算输出。如果 rate 小于 `F`，则使用下降转换速率计算输出。否则，速率介于 `R` 和 `F` 之间，输出的变化等于输入的变化。 `if-elseif-else` 语句的决策计数为 2，因为 `if` 语句代表一个决策，`elseif` 语句代表一个决策，而 `else` 语句代表默认行为（不做出任何决策）。
Relay	2	Relay 模块的输出由关闭点和开启点参数决定。对于决策计数，Relay 模块可以视为 `if-elseif-else` 语句：如果继电器处于开启状态，则输出将保持开启状态，直到输入低于关闭点参数的值。如果继电器关闭，则输出保持关闭状态，直到输入超过开启点参数的值。否则，输入值介于关闭点和开启点之间，输出值保持不变。 `if-elseif-else` 语句的决策计数为 2，因为 `if` 语句代表一个决策，`elseif` 语句代表一个决策，而 `else` 语句代表默认行为（不做出任何决策）。
Saturation	2	Saturation 模块的输出是通过将输入与上限和下限参数进行比较来确定的。对于决策计数，Saturation 模块可以视为 `if-elseif-else` 语句：如果输入小于下限，则输出为下限的值。如果输入值大于上限，则输出值为上限。否则，输出值即为输入值。 `if-elseif-else` 语句的决策计数为 2，因为 `if` 语句代表一个决策，`elseif` 语句代表一个决策，而 `else` 语句代表默认行为（不做出任何决策）。
Send	0 或 1	决策计数取决于显示使能端口参数。如果取消选中显示使能端口复选框，则决策计数为 0。如果选择显示使能端口，则决策计数为 1。
Sign	2	Sign 模块的输出由输入决定。对于决策计数，Sign 模块可以视为 `if-elseif-else` 语句：如果输入为负数，则输出为-1。如果输入为正数，则输出为正数 1。否则，输出为 0。 `if-elseif-else` 语句的决策计数为 2，因为 `if` 语句代表一个决策，`elseif` 语句代表一个决策，而 `else` 语句代表默认行为（不做出任何决策）。
Switch	1	Switch 模块的决策计数为 1：如果输入 2（控制输入）满足所选标准，则输出等于输入 1。否则，输出等于输入 3。例如，以下代码显示决策计数为 1： switch (u2 > 0) case 1 % one decision y = u1; otherwise % default path, zero decisions y = u3; end
Switch Case	外端口数减 1	`default` 情况代表默认行为（不做任何决定）。但每个后续的 `case` 都代表一个决定。决策计数为出港数量减 1。例如，以下代码表示一个具有 3 个输出且决策计数为 2 的 Switch Case 模块： switch u1 case 1 % one decision y = port1; case 2 % one decision y = port2; otherwise % default path, zero decisions y = port3; end
触发模型或子系统	1	对于决策计数，被触发的模型或子系统可以被视为 `if-else` 语句：如果模型或子系统被触发，则模型或子系统执行。否则，默认情况下，模型或子系统不会执行。 `if-else` 语句的决策计数为 1，因为 `if` 语句表示一个决策，而 `else` 语句表示默认行为（不做出任何决策）。
Trigonometric Function	0 或 3	决策计数取决于函数参数和删除防止超范围输入的代码参数。如果将函数参数设置为 `asin` 或 `acos`，并且清除删除防止超范围输入的代码复选框，则决策计数为 3。否则，决策计数为 0。
While Iterator Subsystem	1	对于决策计数，While Iterator Subsystem 模块可以视为 `if-else` 语句：如果输入条件的值为 `true` 或 `1`，则执行子系统的内容。否则，子系统将不会执行。 `if-else` 语句的决策计数为 1，因为 `if` 语句表示一个决策，而 `else` 语句表示默认行为（不做出任何决策）。

计算详细信息

该度量是一种启发式方法，用于估计 Simulink 决策的数量。计算出的决策次数并不准确。

度量：

决策计数包括活动和非活动变体。
决策计数不包括带注释的模块。
无法编译模型。该度量仅考虑静态信息。
无法解析参数。例如，如果您使用变量指定模块参数，度量不会将参数解析为变量值，因为这需要度量编译模型。

该度量与Simulink Coverage™返回的决策覆盖率一致。有关信息，请参阅接受覆盖率的模型对象 (Simulink Coverage)。

收集

要收集此度量的数据，请将 getMetrics 与度量标识符 slcomp.SimulinkDecisions 结合使用。

结果

对于此度量，metric.Result 的实例返回 Value，作为单元或组件每一层中 Simulink 块的 Simulink 决策数。

示例

要查看与不同模块类型关联的 Simulink 决策的数量，请参阅常见模块类型的决策计数。

Simulink 决策计数

度量 ID

描述

支持的工件

常见模块类型的决策计数

计算详细信息

收集

结果

示例

另请参阅

对象

函数

主题