Main Content

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

decisioninfo

从 cvdata 对象检索决策覆盖率信息

全页折叠

语法

covInfo = decisioninfo(cvdo, modelObject)
covInfo = decisioninfo(cvdo, modelObject, simMode)
covInfo = decisioninfo(cvdo, modelObject, ignoreDescendants)
[covInfo, description] = decisioninfo(cvdo, modelObject)

说明

covInfo = decisioninfo(cvdo, modelObject) 从 cvdata 对象 cvdo 返回由 modelObject 指定的模型组件的决策覆盖率结果。

covInfo = decisioninfo(cvdo, modelObject, simMode) 从 cvdata 对象 cvdo 返回由 modelObject 指定的模型组件针对仿真模式 simMode 的决策覆盖率结果。

covInfo = decisioninfo(cvdo, modelObject, ignoreDescendants) 根据 ignoreDescendants 的值返回 modelObject 的决策覆盖率结果。

[covInfo, description] = decisioninfo(cvdo, modelObject) 返回与 modelObject 相关的决策覆盖率结果和决策点的文本描述。

示例

全部折叠

打开脚本

此示例显示如何查看模型中模块的决策覆盖率数据。

加载模型。

modelName = 'slvnvdemo_cv_small_controller';
load_system(modelName);

使用 Simulink.SimulationInput 对象配置模型的覆盖率设置。

simIn = Simulink.SimulationInput(modelName);
simIn = setModelParameter(simIn,'CovEnable','on');
simIn = setModelParameter(simIn,'CovMetricStructuralLevel','Decision');
simIn = setModelParameter(simIn,'CovSaveSingleToWorkspaceVar','on');
simIn = setModelParameter(simIn,'CovSaveName','covData');

通过将 simIn 作为输入传递给 sim 来仿真模型。

simOut = sim(simIn);

从 SimulationOutput 对象 simOut 中提取覆盖率数据作为 cvdata 对象。

covData = simOut.covData;

通过使用模块路径调用 decisioninfo 来查看 Saturation 模块的决策覆盖率结果。

blockPath = [modelName,'/Saturation'];
decisionCov = decisioninfo(covData,blockPath)

decisionCov =

     3     4

decisioninfo 返回一个包含两个标量的数组。第一个值是满意的决策结果的数量，第二个值是总决策结果的数量。使用这些来确定 Saturation 模块的满意决策结果的百分比。

percentDecisionCov = 100 * decisionCov(1) / decisionCov(2)

percentDecisionCov =

    75

输入参数

全部折叠

覆盖率数据，指定为 cvdata 对象。

数据类型: cvdata

模型对象，指定为字符数组、字符串数组、Simulink 句柄、Stateflow ID 或元胞数组。

要指定模型对象（例如模块或 Stateflow 图），请使用以下格式之一：

对象设定描述

BlockPath

模型或模块的完整路径

BlockHandle

模型或模块

slObj

Simulink API 对象的句柄

sfID

Stateflow ID

sfObj

来自单独实例化的 Stateflow 图的 Stateflow API 对象的句柄

{BlockPath, sfID}

包含 Stateflow 图或原子子图的路径以及该图或子图中包含的对象的 ID 的元胞数组

{BlockPath, sfObj}

包含 Stateflow 图或子图的路径以及该图或子图中包含的 Stateflow 对象 API 句柄的元胞数组

{BlockHandle, sfID}

带有 Stateflow 图或原子子图句柄的元胞数组以及该图或子图中包含的对象的 ID

要指定 S-Function 模块或其内容，请使用以下格式之一：

对象设定描述

{BlockPath, fName}

包含 S-Function 模块路径和源文件名称的元胞数组

{BlockHandle, fName}

具有 S-Function 模块句柄和源文件名称的元胞数组

{BlockPath, fName, funName}

包含 S-Function 模块的路径、源文件的名称和函数名称的元胞数组

{BlockHandle, fName, funName}

带有 S-Function 模块句柄、源文件的名称和函数名称的元胞数组

要指定代码覆盖率结果，例如在软件在环(SIL) 或处理器在环(PIL) 分析期间收集的覆盖率数据，请使用以下格式之一：

对象设定描述

{fileName, funName}

包含源文件名称和函数名称的元胞数组

{Model, fileName}

具有模型名称或模型句柄和源文件名称的元胞数组

{Model, fileName, funName}

具有模型名称或模型句柄、源文件的名称和函数名称的元胞数组

数据类型: char | string | cell | Stateflow.State | Stateflow.Transition

覆盖率分析期间的仿真模式，指定为以下选项之一：

对象设定描述

"Normal"

普通仿真模式下的模型。

"SIL" or "PIL"

软件在环 (SIL) 或处理器在环 (PIL) 仿真模式下的模型。

"ModelRefSIL" or "ModelRefPIL"

SIL 或 PIL 仿真模式下的模型参考。

"ModelRefTopSIL" or "ModelRefTopPIL"

在 SIL 或 PIL 仿真模式下的模型引用，代码接口设置为顶层模型。

数据类型: char | string

是否忽略覆盖率结果中的后代，指定为数字或逻辑 1 (true) 或 0 (false)，其中：

  • 0 (false) 包括后代对象的覆盖率结果。

  • 1 (true) 忽略后代对象的覆盖率结果。

数据类型: single | double | logical

输出参量

全部折叠

覆盖率信息，如果 cvdo 包含决策覆盖率数据，则返回为 [covered_outcomes,total_outcomes] 形式的双元素数组，如果不包含，则返回空数组。

covered_outcomesmodelObject 满足的决策结果数量
total_outcomesmodelObject 的决策结果总数

数据类型: double

决策覆盖率描述，以具有以下字段的结构体数组形式返回：

模块排除标志，如果模块被排除则返回为 1，如果没有被排除则返回为 0。

数据类型: double

模块覆盖率过滤器原理，以字符数组形式返回。

数据类型: char

已申述覆盖率目标结果的数量，以双精度标量形式返回。

数据类型: double

模块申述标志，如果模块对齐则返回 1，否则返回 0。

数据类型: double

单个决策的信息，以包含以下字段的结构体返回：

决策排除标志，如果决策被排除则返回为 1，否则返回为 0。

数据类型: double

决策申述标志，如果决策已申述则返回 1，否则返回 0。

数据类型: double

覆盖过滤器的基本原理，以字符数组形式返回。

数据类型: char

决策的描述，以字符数组形式返回。

数据类型: char

单个决策结果的信息，以包含以下字段的结构体数组返回：

text决策结果，以 'true' 或 'false' 形式返回。
executionCount决策产生此结果的时间步数，以双精度标量形式返回。
isFiltered决策结果排除标志，如果结果被排除则返回为 1，否则返回为 0。
isJustified决策结果申述标志，如果结果已申述则返回 1，如果结果未申述则返回 0。
filterRationale覆盖过滤器的基本原理，以字符数组形式返回。
executedIn聚合覆盖率测试用例可追溯性信息，以结构体数组形式返回。如果您的覆盖率数据不包含来自多个仿真的聚合结果，则 executedIn 是一个空数组。如果您的覆盖率数据包含聚合结果，executedIn 表示哪些测试运行执行了决策结果。
executedIn.uniqueId执行此条件结果的测试用例创建的 cvdata 对象的唯一标识符，以字符数组的形式返回。
executedIn.analyzedModel所分析模型的名称，以字符数组形式返回。
executedIn.description测试用例描述，以字符数组形式返回。
executedIn.date创建 cvdata 对象的仿真的日期和时间，以字符数组形式返回。
executedIn.traceLabel测试用例的简称，以字符数组形式返回。
executedIn.testRunInfo测试详细信息，以结构体数组返回。
executedIn.testRunInfo.runid生成覆盖率结果的运行的标识符，以双精度标量形式返回。
executedIn.testRunInfo.runName生成覆盖率结果的测试用例的名称，以字符数组形式返回。
executedIn.testRunInfo.testId识别生成覆盖率结果的测试用例的数据，以结构体数组的形式返回。
executedIn.testRunInfo.testId.uuid生成覆盖率结果的测试用例的唯一标识符，以字符数组形式返回。
executedIn.testRunInfo.testId.contextType

获取覆盖率结果的测试上下文，以下列值之一返回：

'RE' 表示覆盖率结果浏览器

'ST' 为 Simulink Test™ 中的测试管理器

数据类型: struct

数据类型: struct

数据类型: struct

备选方法

使用覆盖率设置来收集和显示决策覆盖率结果：

  1. 打开模型。

  2. 在模型编辑器中，选择建模选项卡上的模型设置。

  3. 在配置参数对话框的覆盖率窗格中，选择启用覆盖率分析。

  4. 在覆盖率度量下，选择决策作为结构覆盖率级别。

  5. 点击确定关闭配置参数对话框并保存更改。

  6. 通过点击运行按钮来仿真模型并查看结果。

版本历史记录

在 R2006b 中推出

另请参阅

| | | | | | | | | |

主题