提供的生成器

Reference test package generator(参考测试包生成器)

../_images/rtpg_dialog.png

使用场景与总体说明

Reference test package generator(参考测试包生成器)可对两个 Trace 文件(参考 Trace 与测试 Trace)的信号轨迹进行定性比较。简单的信号比较可通过 Trace Analysis Calculation Step(Trace 分析计算步骤) 实现。对于更复杂的分析,建议使用分析包中的 Trace 分析,或者单独定义 Trace 分析(基于代码)。如果两个 Trace 中的信号标识符不同,也可通过搜索模式按信号名称匹配进行关联。如果测试 Trace 相比参考 Trace 增加或删除了信号,则可以配置最终判定结果。此外,还可以通过过滤器显式排除无关信号。

Reference test package generator(参考测试包生成器)的参数化既可以 GUI-supported,也可以 code-based。对于 code-based 参数化,可使用以下内置接口:api、user、tools。Reference test package generator tools(参考测试包生成器工具) 是此生成器专用的工具集。

为便于处理 Trace 信号,系统以符合 Object API 的 Signal(信号) 对象形式提供这些信号。

操作与设置

对话框中提供以下标签页用于进一步设置:

常规

此处可控制生成方式:为所有信号比较生成一个 single package,还是为每个信号比较生成一个 separate package。也可以只生成一个包,然后通过不同信号对对应的 parameter sets 调用该包。

分析 n 个信号对时,可选择以下生成方式:

方法

生成结果

评估方式

执行速度

Single package

一个包含 n 个分析步骤的包

评估粒度较低,因为只要有一个信号比较失败,整个包就会失败

最快

Multiple packages

每个信号对生成一个包

评估能力最细致

最慢

Parameter sets

一个包含 n 个参数集的包

在速度与分析细节之间折中

中等

信号过滤

可在此定义过滤器,以便 包含或排除信号。指定的过滤器会同时应用到参考 Trace 和测试 Trace 的信号。

Package 预处理

定义生成过程中使用的单独 Package 名称。

信号匹配

说明如何将参考 Trace 与测试 Trace 中的信号进行对应分配。

Trace 分析

此处定义实际应用到信号对上的 Trace 分析。系统会生成一个 Trace 分析,并使用计算类 Trace 步骤比较参考信号与测试信号。

预览

显示执行后的代码预览。该视图仅用于调试。

示例

信号过滤示例

以下示例展示了一种特殊情况:将一个选定的参考信号应用到所有过滤后的测试信号。

def FilterSignals(refSignals, testSignals):
    """
    Use this method to filter the signals you want to be analyzed.

    :param refSignals:   list of all signals within reference trace file
    :type refSignals:    list<string>
    :param testSignals:  list of all signals within test trace file
    :type testSignals:   list<string>
    :return:             tuple of signals to be analyzed
    :rtype:              tuple(refSignals, testSignals)
    """

    # filter test signals
    testSignals = [testSignal for testSignal in testSignals if testSignal.name.startswith("Sig")]

    # filter reference signal list. The result should contain only one element.
    refSignals = [refSignal for refSignal in refSignals if refSignal.name.startswith("Ref")]

    # The first element will be the reference signal for all test signals
    singleRefSignal = refSignals[0]
    refSignals = [singleRefSignal]*len(testSignals)

    return (refSignals, testSignals)

Package 预处理示例

以下示例展示了如何根据相互分配的信号对,为每个生成的单独包创建单独名称。此外,还配置了测试 Trace 与参考 Trace 的偏移同步。

def PreparePackage(packageObject, traceAnalysisObject, signals):
    """
    Within this method the 'packageObject' and 'traceAnalysisObject' can be customized according to
    the Object API to fit individual needs. For instance, attributes or the name of the test package
    can be adjusted. Also the trace analysis can be preconfigured by adding episodes that can be
    used within 'CreateAnalysis()' by 'tools.GetOrCreateEpisode(traceAnalysisObject, episodeName)'.
    e.g. packageObject.Attributes.SetValue('MyTestcaseAttribute','theAttributeValue')

    This method is executed *once* per package.

    :param packageObject:        object of the generated reference test package
    :type packageObject:         :class:`.PackageFacade`
    :param traceAnalysisObject:  the trace analysis object
    :type traceAnalysisObject:   :class:`.TraceAnalysisFacade`
    :param signals:              list of tuples of 'refSignal' and 'testSignal'. One of those can be
                                 'None' if no matching signal was found.
    :type signals:               list<tuple(refSignal<Signal>, testSignal<Signal>)>
    :return:                     name of the package
    :rtype:                      string
    """
    api.countPreparePackageCalls += 1
    packageObject.Attributes.SetValue('MyTestcaseAttribute','theAttributeValue')

    refSignal = signals[0][0]
    testSignal = signals[0][1]

    ### custom synchronization
    syncConfig, refRecordingGroup, testRecordingGroup = tools.GetSynchronizationConfiguration(packageObject, signals)
    # configure synchronization according to Object API
    syncConfig.SetMaster(refRecordingGroup)
    offsetSync = syncConfig.AssignOffsetSynchronization(testRecordingGroup, refRecordingGroup)
    offsetSync.SetOffset('-0.4')
    syncConfig.SetActive()

    ### custom package name
    return f'MyPackage_{refSignal} vs. {testSignal}'

Trace 分析示例

除包络曲线分析外,此代码还会为每个被分析的信号对生成一张图。

def CreateAnalysis(traceAnalysisObject, refName, testName):
    """
    Customizable method to add individual TraceAnalysisSteps to the 'traceAnalysisObject'
    for a corresponding pair of signals. Use the Trace Analysis API, which is already available
    as 'traceAnalysisApi', to create custom TraceSteps for your analysis.
    This method is executed *once* for every matched signal pair (refName, testName).

    :param traceAnalysisObject:  the trace analysis object
    :type traceAnalysisObject:   :class:`.TraceAnalysisFacade`
    :param refName:  signal name of the reference trace file
    :type refName:   string
    :param testName: signal name of the test trace file
    :type testName:  string
    """

    episode = tools.GetOrCreateEpisode(traceAnalysisObject)

    calculation = traceAnalysisApi.CreateCalculation(f'Comparison {refName} vs. {testName}')
    calculation.SetExpression(f'HoseAbsolute({refName}, {testName}, 1, 5)')

    episode.AppendTraceStep(calculation)
    tools.EnablePlot(calculation, plotName=testName)

    return traceAnalysisObject

Parameter Set 生成器:多次 Package 运行

Description

该 Parameter Set 生成器可用于多次运行同一 Package,适用于压力测试,也适用于通过多次运行评估测试的稳定性。

Configuration

可以通过相应对话框配置 Parameter Set 生成器。该对话框包含两个字段:

  • 运行名称:Package 运行在执行期间以及测试报告中的显示名称。 该名称之后会附加运行编号,例如 ‘Run #1’、‘Run #2’ 等。

  • 运行次数:Package 运行次数