主要内容

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

decisioninfo

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

说明

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

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

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

[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

  1. 打开示例并加载模型。

    openExample("slcoverage/RetrieveCodeCoverageResultsExample");
  2. 使用 setupSILCoverage 函数配置模型以进行代码覆盖率分析。输出是一个 Simulink.SimulationInput 对象。

    simIn = setupSILCoverage("slvnvdemo_counter_harness");

  3. 仿真模型。

    simOut = sim(simIn);

  4. 要检索代表特定模块生成代码的覆盖率结果,请使用模块路径。例如,通过传递相对于顶层模型的模块路径,检索名为 limitSwitch 模块的决策覆盖率结果。

    covDataSIL = simOut.covdata;
    decBlockSIL = decisioninfo(covDataSIL,...
                               "slvnvdemo_counter/ limit")
        
        decBlockSIL =
        
             2     2
    

  5. 要检索生成代码中某个函数的覆盖率结果,请使用一个包含所生成源文件的文件名和函数名的元胞数组。例如,获取位于源文件 slvnvdemo_counter.c 中函数 slvnvdemo_counter 的决策覆盖率结果。

    decSILFunction = decisioninfo(covDataSIL,{"slvnvdemo_counter.c",...
                                              "slvnvdemo_counter"})
        decSILFunction =
        
             4     4

  1. 打开示例并加载数据到工作区。

    openExample("slcoverage/RetrieveSFunCoverageResultsExample");
    load slcoverage_lct_data.mat
  2. 使用 setupSFcnCoverage 函数配置模型以进行覆盖率分析。输出是一个 Simulink.SimulationInput 对象。

    simIn = setupSFcnCoverage("slcoverage_lct_bus");

  3. 仿真模型。

    simOut = sim(simIn);

  4. 要检索 S-Function 的覆盖率结果,请使用 decisioninfo 函数,并指定一个包含模块句柄或完整路径元胞数组,后跟 S-Function 源文件的文件名。根据选项,您还可以指定该源文件中的特定函数。例如,检索名为 counterbusFcn 的函数在 S-Function 文件 counterbus.c 中的决策覆盖率结果,该函数被 S-Function 模块 slcoverage_sfun_counterbus 调用。S-Function 模块位于模型 slcoverage_lct_bus 中的 TestCounter 子系统内。

    covDataSFcn = simOut.covdata;
    decSFun = decisioninfo(covDataSFcn,...
        {"slcoverage_lct_bus/TestCounter/slcoverage_sfun_counterbus",...
        "counterbus.c","counterbusFcn"})
        
        condSFun =
        
             3     4
    

输入参数

全部折叠

覆盖率数据,指定为 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,fileName}

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

{BlockHandle,fileName}

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

{BlockPath,fileName,functionName}

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

{BlockHandle,fileName,functionName}

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

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

对象设定描述

{fileName,functionName}

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

{Model,fileName}

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

{Model,fileName,functionName}

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

数据类型: 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 中推出