带触发器和计算的分析¶
Calculation step(计算步骤)¶
在测量轨迹分析中,可以使用 Calculation step(计算步骤) 基于简单表达式对信号进行计算和检查。
为此,系统提供了一个对话框,可通过 Calculation step(计算步骤) 对应的按钮打开(
)。
用于创建和编辑 Calculation step(计算步骤) 的对话框提供以下选项:
通用
可在 Name 字段中为 Calculation step(计算步骤) 指定一个便于理解的名称。
该名称会显示在分析编辑器概览和报告中。
名称中可以使用 package 变量,语法为 {variable_name}。在报告中,
变量值会插入到名称中的相应位置。
此外,还可以在 Description 字段中输入说明文本。说明中 同样可以包含 package 变量,这些变量在报告中会被替换为其实际值。
表达式
该字段用于输入要计算和评估的表达式。 可使用信号、package 变量、函数调用和算术运算,并可通过 auto-completion(自动补全) 方便地选择。
Info
所有可用函数的概览参见章节 Functions for use in expressions(表达式中可用的函数)。
示例: 假设需要检查某个信号是否始终小于 0.5。
可使用以下 Expression:
SignalToCheck < 0.5
该表达式会计算出一个布尔离散信号(即 True 或 False)。默认情况下,Calculation step(计算步骤)
会检查该结果是否始终为 True。
Info
实际评估方式在对话框的 Evaluation 区域中配置(见下文)。
保存到
此处可输入一个泛型信号名称。表达式结果将通过该名称提供给其他 trace step 或图表使用。如果输入了一个未知信号名称,系统会自动创建一个同名新信号。
评估
通过此选项可以定义具体的评估方式。启用评估后,将显示 Expectation 和 Options 两个标签页。
Expectation
本节第一部分用于指定基于时间戳的期望。 可选值列在下表中,其中每一行表示一种模式, 即同一行中的两个条目可以作为同义项使用。
期望
长名称
‘always’
‘Fulfilled everywhere’
‘once’
‘Fulfilled at least once’
‘duration’
‘Fulfilled for at least’
‘Fulfilled everywhere’
如果在所用信号的所有时间戳上都满足该期望,则结果为 True。
‘Fulfilled at least once’
如果在每个触发范围内,所用信号至少有一个时间戳满足该期望,则结果为 True。
‘Fulfilled for at least’
如果在每个触发范围内,所用信号在某一时间戳满足该期望,并且从该时间戳开始, 在参数 Minimum duration 指定的时长内不存在使该期望失效的采样点,则结果为 True。 如果被评估范围的长度小于 “Minimum duration”,则该范围会被评估为 FAILED。
可以通过两个切换按钮微调评估行为。 按钮
决定最小持续时间是匹配一个成功子范围,还是匹配成功子范围的累计持续时间。
按钮
用于指定“Minimum duration”的值为以百分比(%)表示的相对值。Caution
如果使用相对最小时长,则该计算只能在 Trigger blocks(触发块) 内使用!
由于采用 sample-and-hold 原理,该选项仅适用于所用信号的采样点尽可能覆盖整个触发范围的情况。
时长基于实际评估得到的子范围计算,并遵循 sample-and-hold 原理覆盖两个子范围之间的过渡区间。
示例:
0.0 - 8.0 Trigger range 1.0 - 2.0 subrange SUCCESS 4.0 - 6.0 subrange FAILED其结果为:3.0(1.0 到 4.0)评估为 SUCCESS,4.0(4.0 到 8.0)评估为 FAILED。 对应比例分别为 42.86% SUCCESS 和 57.14% FAILED。
在下一部分中,可以指定基于表达式结果的期望。 除与
True比较这一默认评估方式外,还可选择其他评估类型。 例如,可选择Numeric,以便方便地输入容差。 测量轨迹分析会据此输出 SUCCESS 或 FAILED。切换到 manual 模式,或将评估类型设为 Unspecific, 即可输入应返回
True或False的 Python 表达式。 表达式计算结果可通过关键字 value 访问。Options
在 Options 区域中,可以为评估指定附加设置。
Vector/Matrix handling
启用对向量值或矩阵值信号的评估,其期望定义方式类似于 “Numeric”。 根据所选设置,当所有分量都满足期望,或至少有一个分量满足期望时,结果分别返回 SUCCESS。
Result … as result for the empty range
如果计算表达式在任何时间戳上都未被计算,则结果按此设置给出。
SUCCESS comment
如果计算结果为 SUCCESS,则使用该替代结果文本。
FAILED comment
当计算结果为 FAILED 时使用的替代结果文本。
将检测到的点添加到报告
用于配置需要在报告中明确列出的检测点和范围的最大数量。
Minimum distance 定义了这些显式报告的检测点之间允许的最小间距。 如果最坏判定比报告中此前已显示的最差检测点更差,那么即使两个检测点之间小于该最小间距,也仍会被报告。
Trigger blocks(触发块)¶
Trigger blocks 可用于基于表达式在 Trace 中定位特定范围。 通过在 Trigger blocks(触发块) 内添加其他 trace step,可以仅在这些定位到的范围内执行测量轨迹分析。
可通过按钮
(“New trigger block”)创建新的 trigger block。
Trigger Block 的对话框提供以下选项:
通用
可在 Name 字段中为 trigger block 指定一个说明性名称。 该名称会显示在分析编辑器概览和报告中。名称中也可以包含 package 变量,执行时会替换为实际值。
此外,还可以在 Description 字段中输入说明。在该处也可以使用 Package 变量。
参数
Trigger blocks(触发块) 的参数分为三个标签页:Conditions、Extended options 和 Report,下文将分别说明。
Conditions
Conditions 标签页用于配置 trigger block 的基础功能。
Trigger mode:
Mode 用于指定如何处理 start trigger 条件(以及可能的 stop trigger 条件), 以生成触发范围。可选值见下表,其中每一行代表一种模式, 即每行前两个条目可作为同义项使用。
模式
长名称
需要 stop trigger
‘while start trigger’
‘as long as start trigger is fulfilled’
否
‘start trigger while not stop trigger’
‘from start trigger as long as stop trigger is not fulfilled’
是
‘start trigger to next stop trigger’
‘from start trigger until next time stop trigger is fulfilled’
是
‘start trigger with time offsets’
‘with time offset if start trigger is fulfilled’
否
默认情况下,触发范围为左闭右开区间。 触发范围的开始时间属于该范围, 而停止时间通常不属于该范围。
Info
根据定义,在 stop 条件触发后,新的触发范围只能从下一个时间戳开始 (最后一种模式除外)。
‘as long as start trigger is fulfilled’
在该模式下,触发范围仅包含 start trigger 持续评估为 True 的那些时间戳。 换句话说,触发范围会在 start trigger 条件满足时开始, 并在该条件不再满足时结束。
例如,假设某个信号的时间戳覆盖区间 [0, 5)。另外,假设某个 start trigger 条件 从时间戳 2 到时间戳 4 评估为 False(更准确地说是在区间 [2, 4) 内), 其余位置均为 True。此时会生成两个触发范围:[0, 2) 和 [4, 5)。
‘from start trigger as long as stop trigger is not fulfilled’
在该模式下,触发范围的起点由 start trigger 条件和 stop trigger 条件共同决定。 系统会先评估 stop trigger 条件。凡是该条件满足的位置,无论 start trigger 条件如何, 都不能打开新的触发范围。因此,该模式可能会抑制一个原本已满足的 start trigger (参见 Report 标签页中的 Report omitted start triggers 选项)。 另一方面,如果 stop trigger 条件未满足(或无法评估),并且 start trigger 条件评估为 True, 则会生成一个触发范围。随后由 stop trigger 条件定义该触发范围的结束位置 (参见参数 Stop trigger)。
例如,再次考虑一个时间戳覆盖区间 [0, 5) 的信号。假设 start trigger 条件除 时间范围 1 到 3 之外始终成立(更准确地说是在区间 [1, 3) 内不成立), 并且 stop trigger 条件从时间戳 2 到时间戳 4 为 True(更准确地说是在区间 [2, 4) 内)。此时会生成两个触发范围:[0, 2) 和 [4, 5)。
‘from start trigger until next time stop trigger is fulfilled’
与前一种模式不同,在该模式下,只要 start trigger 条件满足,就一定会打开一个触发范围。 因此,触发范围的起点只取决于 start trigger 条件。stop trigger 条件用于定义 触发范围的终点(参见参数 Stop trigger)。
如果将该模式应用于上一个示例,除了前面得到的触发范围 [0, 2) 和 [4, 5) 外, 还会生成额外的触发范围。这些范围位于时间戳 3(包含)与 4(不包含)之间, 并且每个范围仅覆盖两个相邻采样点之间的区间。
‘with time offset if start trigger is fulfilled’
在该模式下,每当 start trigger 条件满足时,系统都会基于 start trigger 的时间, 叠加 Start offset 和 Stop offset 来创建一个触发范围。 如果希望围绕 start trigger 展开一个范围,则必须选择负的 start offset 以及正的 stop offset。如果 start offset 和 stop offset 符号相同, 则 start trigger 本身将不位于生成的范围之内。
Info
在该模式下,可能会出现触发范围重叠!
Info
Trigger mode 可使用 package 变量或 Global Constants(全局常量)进行参数化。
Start trigger:
Start trigger 用于定义触发范围何时开始。 输入字段中的表达式可以包含泛型信号、算术运算符、逻辑运算符、 package 变量和函数。 例如,以下表达式都是有效的:
SignalToAnalyze == 5Edge(SignalToCheck, 0, 1)
信号名、变量名和函数名的选择可通过集成的 auto-completion(自动补全) 辅助完成。
Start offset:
使用 Start offset 可以将触发范围的起点向过去偏移 (负的 start offset),也可以向未来偏移(正的 start offset)。
Stop offset:
使用 Stop offset 可以将触发范围的终点向过去偏移 (负的 stop offset),也可以向未来偏移(正的 stop offset)。
Stop trigger:
根据所选 Trigger mode,可能需要设置 Stop trigger。 如果通过有效表达式定义了该条件,它将用于确定触发范围的终点。更准确地说, 触发范围的结束位置对应 stop trigger 评估为 True 的时间戳, 无论此时 start trigger 条件是否仍然成立。不过,触发该条件的时间戳本身 不会属于触发范围(右开区间)。
很多情况下,触发范围并不是由触发条件结束,而是因为到达 Trace 末尾。 启用 Handle end of trace as stop trigger 选项后,该事件会被视为普通的 stop trigger。 与常规触发范围结束不同,范围内包含的所有 trace step 还会对最后一个采样点继续评估 (闭区间)。如果未启用此选项,则因 Trace 结束而终止的触发范围会被评估为 INCONCLUSIVE。
Info
可用于 start trigger 和 stop trigger 表达式的函数概览,请参见章节 Functions for use in expressions(表达式中可用的函数)。
Extended options
Extended options 标签页包含 trigger block 的附加设置。
Trigger once
仅分析找到的第一个触发范围。后续触发范围都会被忽略。
Result … if no range found
如果未找到任何范围,则此处定义当前 trigger block 的判定结果。 默认情况下,不包含任何触发范围的 trigger block 结果为 INCONCLUSIVE。
Result … if range is truncated
如果启用此设置,被截断的区域将使用指定结果进行评估。 如果未启用,则被截断的范围按正常方式评估。
Info
使用 Start offset 和 Stop offset 时,触发范围可能会早于父级触发范围 (或 Trace 起点)开始,或者晚于父级触发范围(或 Trace 终点)结束。 由于这是不允许的,此类触发范围的开始时间或结束时间会被设置为 父级触发范围的开始时间或结束时间。 因此,实际得到的触发范围会比原先指定的更短。
Ignore time after start trigger
此处可将每个触发范围的第一个采样点排除在分析之外。 为此,请选择 First sample 设置。这样一来,包含在该 trigger block 中的所有 trace step 都不会收到第一个采样点。
更一般地,选择 Manually 选项后,可以指定 start trigger 事件之后 需要忽略的时间跨度长度(正数)。如果某个采样点恰好位于被忽略范围的边界上, 该采样点同样会被忽略。
Info
该字段中也可以输入变量。 可用值包括正数、“firstsample”、0 或 None。 字符串 “firstsample” 表示忽略第一个采样点,而 0 或 None 表示禁用该功能, 即不忽略任何采样点。
Ignore time before stop trigger
如果选择 Manually 设置,则可以指定 stop trigger 之前需要忽略的时间跨度。 如果某个采样点恰好位于被忽略范围的边界上,该采样点同样会被忽略。 如果该 trigger block 中还包含其他 trigger block,则后者生成的触发范围 最晚会在“父级触发范围的 stop trigger 时间减去父级 stop trigger 前忽略时间”的时刻结束, 即使此时没有任何信号恰好具有该时间戳也是如此。
Report:
Report 标签页包含用于调整触发范围报告方式的选项。
Condition
此选项用于设置一个条件,只有满足该条件,触发范围才会包含在报告中。
Maximum number per result and contained trace step
通过此选项可以指定需要报告的触发范围最大数量。该限制按结果分别应用, 也就是说,如果最大数量为 5,则报告中最多包含 5 个评估为 ‘SUCCESS’ 的触发范围、 最多 5 个评估为 ‘FAILED’ 的范围、最多 5 个评估为 ‘ERROR’ 的范围,以此类推。
此外,该限制按 trigger block 中包含的每个 trace step 分别生效,因此任何单个 trace step 都无法完全占用其他 trace step 的相关条目。例如,如果一个 trigger block 包含两个计算,它们在不重叠的范围内被评为‘FAILED’,那么(限制仍设为五时)报告中每个计算各包含五个‘FAILED’范围,在 trigger block 的结果表中合计为十个‘FAILED’范围。
还需要强调的是,尤其在嵌套 trigger block 的情况下,下级 trigger block 只会考虑自身设置, 而其他下级 trace step 只会考虑其直接上级 trigger block 的设置。 只要至少有一个下级范围被显示,上级 trigger block 的范围就始终会被显示 (无论其自身设置如何)。这种行为在未来版本的 ecu.test 中可能会得到改进, 届时将综合考虑并展开所有 trigger block 的设置。
Info
前面提到的所有过滤选项仅影响报告展示,也就是报告视图左侧树形结构中列出的触发范围数量, 以及右侧详细结果表中显示的触发范围数量。它们不会影响任何单个 trace step 的结果, 更不会影响整个测量轨迹分析的结果。 此外,无论过滤选项如何设置,各结果对应的触发范围总数都会始终显示在相应 trace step 的结果文本中。
Report omitted start triggers
启用此选项后,每个被省略的 start trigger 都会在报告中生成一个 spot, 并附带说明其被省略原因的消息。 在 ‘from start trigger as long as stop trigger not fulfilled’ 模式下, 如果 stop trigger 条件与 start trigger 条件在同一时刻同时满足,就可能出现被省略的 start trigger。 另一方面,在 ‘with time offset when start trigger fulfilled’ 模式下, 如果完整的触发范围将落在父级触发范围之外,则 start trigger 也可能被省略。
Mention ignored ranges in test report
如果忽略时间之和(即 start trigger 之后的忽略时间加上 stop trigger 之前的忽略时间) 大于或等于触发范围长度,则该触发范围会被忽略。 被忽略的触发范围始终评估为 NONE。取消选中 Mention ignored ranges in test report 选项后,可抑制对被忽略触发范围的详细报告。 此时,trigger block 的结果文本中只会报告被忽略范围的数量。
Info
触发范围的编号始终会考虑被忽略的范围。因此,即使前面的触发范围 1 已被忽略而未在测试报告中提及,第二个触发范围也始终标记为触发范围 2;也就是说,此时触发范围列表会从触发范围 2 开始。
示例:
下面给出一个关于 trigger block 和 calculation step 用法的简短示例。 作为输入信号,这里分析车辆记录下来的车速(单位 km/h):
在该测量轨迹分析中,车速被赋值给泛型信号 CarSpeed。该 trigger
block 基于 start trigger CarSpeed > 10 生成触发范围,
也就是车辆速度大于 10 km/h 的区间。每个范围的结束条件要么是车辆再次完全停止
(即速度为 0)的时刻,要么是 Trace 末尾(也就是 Recording 结束)。
为了分析这些触发范围,在 trigger block 下方添加了一个简单的 calculation step
(Analyses with triggers and calculations(带触发器和计算的分析))。
该步骤用于检查 CarSpeed > 10 是否成立。为提供可视化反馈,
还在 calculation step 下方插入了一个图表
(Diagram creation (Plot)(图表创建(绘图)))。
执行测量轨迹分析后,系统会自动生成报告。New trigger block 部分显示检测到了两个触发范围 (trigger range 1 和 trigger range 2)。这些范围根据 calculation step 的结果进行评估。 Calculation 部分提供了更多细节,例如可以看到 trigger range 1 的一个子区间被标记为 FAILED。
触发范围以及 calculation step 给出的评估结果会显示在图表中:
Report(报告)¶
在 Calculation trace step 的报告中,具有相同评估结果的连续时间戳会合并为范围。 每个范围由开始时间、结束时间、评估结果和消息表征。下图给出了 Calculation trace step 范围的示例:
不在 trigger block 内以及位于 trigger block 内的 Calculation trace step 范围¶
如果在 trigger block 内使用 calculation step,则其区间会以缩进的行显示在其 上级触发区间之下。
在某些情况下,无法在所有位置评估 calculation trace step 的表达式。 例如,表达式 Value(Sig1, 1.0) 用于获取当前时间戳之后 1 秒处的信号 Sig1 值 (参见章节 Functions for use in expressions(表达式中可用的函数)), 如果信号会在接下来 1 秒内结束,则该表达式无法继续评估。如果 Sig1 是在 trigger block 内由 calculation trace step 生成的, 也可能出现这种情况。此时,Sig1 的信号值只在某些触发范围内可用。无法进行评估的子范围会被标记为 INCONCLUSIVE。
若要将评估限制在合适的子范围内,可使用 ignore time 为正值的(子)trigger block。
Info
对于位于任何 trigger block 之外的 calculation trace step,依赖未来值(或过去值)的表达式 总会在信号末端(或起点)产生评估为 INCONCLUSIVE 的子范围。 因此,对于位于 trigger block 之外的 calculation trace step,这类子范围会改为评估为 NONE。
Expressions(表达式)¶
Calculation step 公式中的表达式必须至少包含一个泛型信号名称。 此外,还可以使用 package 变量、函数调用或算术运算。 相比之下,trigger block 的 start trigger 或 stop trigger 条件中的表达式 不要求必须包含泛型信号。
在 calculation step 中,表达式会在至少有一个被引用泛型信号存在采样点的所有时间戳上进行评估。 在 trigger block 中,则会在所有已使用表达式中至少有一个泛型信号存在采样点的时间戳上进行评估。 如果所有表达式中都未使用泛型信号,则使用父级 trigger block 表达式中的信号时间戳; 如果不存在父级 trigger block,则使用该 episode 中所有被引用信号的时间戳。
对于当前评估时间戳上没有采样点的其他泛型信号,其值将保持为上一次处理后的值;
若不存在该值,则为 None。通过将 calculation 或 trigger block 放入父级 trigger block 中,
还可以进一步限制其表达式评估范围。需要注意的是,函数
CheckResponse、Derivative、HoseAbsolute、HoseRelative、Integral、MovingAverage、
StartTriggerValue、StopTriggerValue 和 Value(以及当 restricted = False 时的
Always、AtLeastOnce 和 Static)都可能访问最外层触发范围之外的信号值。
例如,表达式 Value(Signal, 2) 可能会处理超出触发范围结束时间最多 2 秒的信号值。
只要无法确定全部必需值,这类表达式就会被评估为 INCONCLUSIVE。
Functions for use in expressions(表达式中可用的函数)¶
-
Always(signal, duration, restricted=
False)¶ 检查信号或条件的布尔值在指定时长 duration 内是否始终为 True。
当 duration > 0 时,会考虑右开时间区间 [t, t + duration) 内的所有信号值; 当 duration < 0 时,会考虑闭区间 [t + duration, t] 内的所有信号值。 如果左侧区间边界处没有采样点,则使用保持值。根据 restricted 参数设置, 触发范围还可能进一步限制该时间区间。
如果参数 restricted 为 False(默认),则由 duration 定义的时间范围 可以超出触发范围边界。 如果设为 True,则仅在触发范围内检查该条件。
Info
与函数 Static 不同,即使可用时间跨度短于指定的 duration,该函数也会执行评估。
示例
# True if the signal always evaluates to True for the next 2 seconds Always(Sig0, 2.0) # True if the condition 'Sig0 > 5' was always fulfilled for the last 2 seconds Always(Sig0 > 5, -2.0) # True if the signal evaluates to True for the next second or up to the # end of the current trigger range Always(Sig0, 1.0, True) # True if there is no rising edge from 0 to 1 within the next 1.5 seconds Always(not Edge(Sig0, 0, 1), 1.5)
-
AtLeastOnce(signal, duration, restricted=
False)¶ 检查信号或条件的布尔值在指定时长 duration 内是否至少有一次为 True。
当 duration > 0 时,会考虑右开时间区间 [t, t + duration) 内的所有信号值; 当 duration < 0 时,会考虑闭区间 [t + duration, t] 内的所有信号值。 如果左侧区间边界处没有采样点,则使用保持值。根据 restricted 参数设置, 触发范围还可能进一步限制该时间区间。
如果参数 restricted 为 False(默认),则由 duration 定义的时间范围 可以超出触发范围边界。 如果设为 True,则仅在触发范围内检查该条件。
Info
与函数 Static 不同,即使可用时间跨度短于指定的 duration,该函数也会执行评估。
示例
# True if the signal evaluates to True at least once in the next 2 seconds AtLeastOnce(Sig0, 2.0) # True if the condition 'Sig0 > 5' was fulfilled at least once in the past 2 seconds AtLeastOnce(Sig0 > 5, -2.0) # True if the signal evaluates to True at least once within the next second (but only # up to the end of the current trigger range) AtLeastOnce(Sig0, 1.0, True) # True if there is a rising edge from 0 to 1 within the next 1.5 seconds AtLeastOnce(Edge(Sig0, 0, 1), 1.5)
- Average(signal)¶
返回给定信号在整个触发范围内的平均值。
如果该函数在 trigger block 之外使用,则返回给定信号在其定义域上的平均值。 平均值会保存为一个常量信号,其时间戳与输入信号的时间戳相同。
Example
Important
该函数不能用于 Start trigger 和 Stop trigger 的表达式中。
Average(Sig0) # Average of the signal Sig0
- BoundControl(signal, minVal, maxVal)¶
检查输入信号在每个采样点上的值是否位于给定的最小值和最大值边界之间。
参数 minVal 和 maxVal 都可以是泛型信号名称或数值。如果向该函数传入多个信号, 则只有在所有被使用信号都存在值的位置才会进行评估。
在当前评估时间戳处,返回值如下:
如果信号值位于给定范围内,则为 True
如果信号值位于给定范围外,则为 False
Example
# True at timestamp t if 0 <= Sig0(t) <= 100 BoundControl(Sig0, 0, 100) # True at timestamp t if Sig1(t) <= Sig0(t) <= Sig2(t) BoundControl(Sig0, Sig1, Sig2)
- CheckAlive(signal, cycleLimit)¶
返回给定信号是否从 0 开始、随后以步长 1 严格递增,直到达到参数 cycleLimit 指定的上限,然后再次从 0 开始计数。
如果出现相同信号值重复、步长不等于 1、超过参数 cycleLimit 指定的上限, 或者信号没有从 0 开始(包括达到 cycleLimit 之后重新开始时),则该函数返回 False。
Example
# True if the sequence of values in Sig0 is (0, 1, 2, 3, 0...) CheckAlive(Sig0, 3)
-
CheckResponse(signal1, signal2, timeout=
None, useHoldValue=False)¶ 评估两个信号之间的时间相关性。对于每一个 signal1 为 True 的值, signal2 也必须在给定超时时间内变为 True。
这里使用布尔解释后的值,因此可以很直观地与逻辑表达式结合使用。 例如,可以写成 CheckResponse(RisingEdge(ignition), engineSpeed > 0, 0.5)。
参数 timeout 是可选的。如果未指定,CheckResponse 会检查 signal2 是否在后续时间点至少包含一个 True 值。不允许使用负值, 否则会报错。
参数 useHoldValue 仅在 signal1 和 signal2 的时间轴不同, 或者 signal2 存在间隙时才有意义。如果将 useHoldValue 设为 True, 那么在 signal1 为 True 而 signal2 没有提供值的时间点, 将使用 signal2 的最后一个有效值(保持值)。
如果该函数用于 trigger block 内的 calculation step,即使指定的超时时间超过了触发范围的末端, 也仍会继续检查 signal2 的条件。signal2 也会在 trigger block 的 ignore range 内进行检查。 相比之下,signal1 不会在 ignore range 内评估。
Info
建议在 signal1 的触发条件中使用 Edge 之类的函数, 以避免在连续采样点上被重复触发。 例如,像 ignition == 1 这样的表达式不仅会在值从 0 变为 1 时触发, 也会在之后所有值保持为 1 的采样点上持续触发。
Example
# Using logical expressions for better readability CheckResponse(RisingEdge(ignition), engineSpeed > 0, 0.5) # Use the hold value of Sig2 at the beginning of a trigger range CheckResponse(RisingEdge(Sig1), Sig2, 1.5, useHoldValue=True) # No timeout value CheckResponse(FallingEdge(Sig1), RisingEdge(Sig2))
- CheckTiming(signal, period, tolerance)¶
返回给定信号最近两个时间戳之间经过的时间是否等于 period。
如果希望允许围绕 period 的对称时间区间,可以将参数 tolerance 作为相对容差百分比(%)使用。
Example
# True if 0.9 <= time between the two most recent timestamps <= 1.1 CheckTiming(Sig0, 1, 10) # True if 0.01 seconds passed between the two most recent timestamps CheckTiming(Sig1, 0.01, 0)
- Derivative(signal)¶
返回给定信号的一阶导数。
对于第一个采样点(n=0),导数 y’(n) 的计算方式如下:
对于后续所有采样点,导数按两段斜率的平均值计算:
当时间戳等距时,后一个公式可简化为中心差分格式:
Example
Derivative(Sig0) # Derivative of signal Sig0
-
Edge(signal, valFrom=
'*', valTo='*')¶ 检查给定信号的值是否从 valFrom 变化到 valTo。
使用默认参数时,任何数值变化都会被识别为 edge (即从任意值变化到任意值)。
对于其中一个参数,也可以传入字符串 ‘<’(表示小于另一个值) 或 ‘>’(表示大于另一个值)作为参数。这样就可以检测从/到未明确指定数值的上升沿或下降沿。
Info
参数 valFrom 和 valTo 不能相等 (除非两个参数都使用默认值 ‘*’)!
Example
Edge(Sig0) # any edge (any value change) Edge(Sig0, 0, 1) # rising edge from 0 to 1 Edge(Sig0, '>', 1) # falling edge from any value greater 1 to 1 Edge(Sig0, 1, '<') # falling edge from 1 to any value less than 1 Edge(Sig2, '<', '>') # same as Edge(Sig2, '*', '>') or Edge(Sig2, '<', '*') or RisingEdge(Sig2)
- Evaluate(expression)¶
计算一个以字符串形式提供的表达式。
Example
Evaluate('Sig0 > 0') # equivalent to Sig0 > 0 Evaluate(var) # evaluates the expression stored in the variable 'var'
-
FallingEdge(signal, threshold=
'*')¶ 检查给定信号的值是否从大于等于 threshold 变为小于 threshold。
Example
FallingEdge(Sig0) # True if Sig0(n-1) > Sig0(n) FallingEdge(Sig0, 0.5) # True if Sig0(n-1) >= 0.5 and Sig0(n) < 0.5
- HasSample(signal)¶
检查 signal 是否恰好在当前考察时刻被采样。
如果该信号并未在该时刻恰好采样,而只是根据 sample-and-hold 原理得到当前值, 则函数返回 False。
Example
# Checks whether 'signal' has a sample at each # timestamp that is part of the common time # axis of 'signal' and 'clock' HasSample(signal) and clock >= 0下图展示了信号 signal 和 clock,以及该示例表达式的结果:
图中还展示了一个触发式分析的结果,用于检查在 clock 的每个上升沿之后, 是否都能在 1 秒内获取到 signal 的新采样值。 为此,需要在 trigger mode ‘from start trigger until next time stop trigger is fulfilled’ 中定义以下触发条件:
Start trigger:
clock == 1Stop trigger:
HasSample(signal)在该 trigger block 内,需要执行以下 calculation step:
StopTriggerTime() - Time(signal or clock) <= 1.0
-
HasValue(signal, restricted=
False)¶ 检查 signal 在当前时间戳处是否有值,或者是否存在保持值。
如果该函数返回 True,则随后对该信号的访问,例如调用
Value(signal, 0.0), 将返回有效的信号值。如果参数 restricted 传入 True(默认值为 False),则只考虑触发范围内的信号值。 来自触发范围之外的保持值会被忽略。
Example
HasValue(Sig0) # True, if Sig0 already has a value HasValue(Sig0, True) # True, if Sig0 already has a value (in the trigger range)
- HoseAbsolute(signalA, signalB, deltaT, deltaY)¶
为信号 signalA 计算一个 hose,并检查 signalB 的值是否位于其中。这里,deltaT 被解释为时间容差,deltaY 被解释为 信号值的绝对容差。
- deltaT:
hose 边界与信号 signalA 之间的最小时间距离, 从而使 hose 在时间坐标方向上的最终宽度至少为 2 * deltaT。 该非负参数会按下文所述方式纳入 hose 边界的计算。
Info
如果 deltaT 设为 0,则 deltaY 会应用到 signalA 的当前值 (或保持值)上。
- deltaY:
可以是一个元组(minusDeltaY, plusDeltaY)。 这些非负参数会按下文所述方式在 hose 边界计算过程中作为绝对容差使用。 如果该参数是单个数值,则会按与元组(deltaY, deltaY)类似的方式解释。
时间戳 t 处的 hose 边界计算分为两个步骤。 首先,确定信号 signalA 在时间区间 [t - deltaT, t + deltaT] 内的最大值和最小值。如果在 t - deltaT 处没有采样点, 则使用 signalA 的保持值。 其次,将该最小值减去 deltaY 的第一个分量,结果即为时间戳 t 处 hose 的下边界。 同样地,将第一步得到的最大值加上 deltaY 的第二个分量, 即可得到 hose 的上边界。
特别是在信号斜率较大时,hose 的高度可能显著大于 minusDeltaY + plusDeltaY。
Example
# True if Sig1 is within a floating range based on Sig0 with a duration of 0.2, # floating minimum and maximum expanded by 123.4 each. HoseAbsolute(Sig0, Sig1, 0.2, 123.4) # True if Sig1 is within a floating range based on Sig0 with a duration of 0.1, # only floating maximum expanded by 1.33. HoseAbsolute(Sig0, Sig1, 0.1, (0, 1.33))边界曲线的绘图或进一步处理:
HoseAbsolute() 函数的结果是一种所谓的结构化信号。除二值结果信号外, 还提供结构元素 .lower 和 .upper,分别用于存储下边界和上边界, 并且可以在表达式中使用。例如,如果函数结果通过 calculation step 的 Save in 选项保存到名为 HoseResult 的信号中, 则可以通过以下方式访问下边界和上边界曲线:
HoseResult.lower HoseResult.upper在 array-based NumPy trace step templates(基于数组的 NumPy trace step 模板) 中,访问结构化信号的方式也是类似的:
signals['HoseResult'].GetValues().lower signals['HoseResult'].GetValues().upper绘制 HoseResult 时,除二值结果外还会显示边界曲线:
- HoseRelative(signalA, signalB, deltaT, toleranceY)¶
为信号 signalA 计算一个 hose,并检查 signalB 的值是否位于其中。这里,deltaT 被解释为时间容差,toleranceY 被解释为 信号值的相对容差(百分比 %)。
- deltaT:
hose 边界与信号 signalA 之间的最小时间距离, 从而使 hose 在时间坐标方向上的最终宽度至少为 2 * deltaT。 该非负参数会按下文所述方式纳入 hose 边界的计算。
Info
如果 deltaT 设为 0,则 toleranceY 会应用到 signalA 的当前值 (或保持值)上。
- toleranceY:
可以是一个元组(minusToleranceY, plusToleranceY)。 这些非负参数会按下文所述方式在 hose 边界计算过程中作为相对容差使用。 如果该参数是单个数值,则会按与元组(toleranceY, toleranceY)类似的方式解释。
时间戳 t 处的 hose 边界计算分为两个步骤。 首先,确定信号 signalA 在时间区间 [t - deltaT, t + deltaT] 内的最大值和最小值。如果在 t - deltaT 处没有采样点, 则使用 signalA 的保持值。 其次,将该最小值按系数 minusToleranceY 减小,结果即为时间戳 t 处 hose 的下边界。 同样地,将第一步得到的最大值按系数 plusToleranceY 增大, 即可得到 hose 的上边界。
Example
# True if Sig1 is within a floating range based on Sig0 with duration of 0.2, # floating minimum and maximum expanded by 40%. HoseRelative(Sig0, Sig1, 0.2, 40) # True if Sig1 is within a floating range based on Sig0 with duration of 0.1, # only floating maximum expanded by 10%. HoseRelative(Sig0, Sig1, 0.1, (0, 10))边界曲线的绘图或进一步处理:
HoseRelative() 函数的结果是一种所谓的结构化信号。除二值结果信号外, 还提供结构元素 .lower 和 .upper,分别用于存储下边界和上边界, 并且可以在表达式中使用。例如,如果函数结果通过 calculation step 的 Save in 选项保存到名为 HoseResult 的信号中, 则可以通过以下方式访问下边界曲线:
HoseResult.lower在 array-based NumPy trace step templates(基于数组的 NumPy trace step 模板) 中,访问结构化信号的方式也是类似的:
signals['HoseResult'].GetValues().lower绘制 HoseResult 时,除二值结果外还会显示边界曲线:
- Integral(signal)¶
返回给定信号从第一个时间戳到当前时间戳之间的定积分值。
对于第一个采样点,积分结果为 0。对于后续所有采样点,其计算方式如下:
Example
Integral(Sig0) # Integral of signal Sig0 up to the current timestamp
- Monotony(signal, type)¶
如果给定信号在当前考察区间内单调递增或单调递减,则返回 True。 这里的考察区间是信号 signal 的定义域(如果适用,则限制在触发范围内)。
通常会比较上一个采样点与当前采样点。 在某些只能使用一个采样点进行评估的特殊情况下(例如 Trace 起点), 系统会向后查找下一个有效采样点。
参数 type 用于指定需要检查哪一种单调性:
‘inc’ 用于检查递增单调性
‘dec’ 用于检查递减单调性
‘inc_strict’ 用于检查严格递增单调性
‘dec_strict’ 用于检查严格递减单调性
Example
# Check whether Sig1 is monotonically increasing Monotony(Sig1, 'inc') # Check whether Sig1 is strictly decreasing Monotony(Sig1, 'dec_strict')
-
MovingAverage(signal, duration, durationKind=
'sample')¶ 使用给定时间区间返回信号 signal 的滑动平均值。
- duration:
必须是一个正数值,或由两个正数值组成的元组,用于指定区间大小。单个数值表示区间仅向过去延伸。元组则分别指定区间向过去和向未来延伸的范围。
- durationKind:
指定如何解释 duration:
将 durationKind 设为 ‘sample’ 时,duration 会按采样点数量解释。在这种情况下,duration 只能包含整数值。
将 durationKind 设为 ‘time’ 时,duration 会按时间跨度解释。如果 duration 是数值,则时间范围为闭区间 [t - duration, t];如果 duration 是元组,则时间范围为闭区间 [t - duration[0], t + duration[1]]。
Info
如果 duration 以单个数值给出,且 durationKind 设为 ‘sample’,则 duration 包含信号当前采样点。也就是说,时长为 3 时,滑动区间会包含当前采样点和过去的 2 个采样点。如果 duration 以元组形式给出,且 durationKind 设为 ‘sample’,则该元组表示除当前采样点外,还要额外考虑多少个过去采样点和未来采样点。
Example
# Moving average of the last 5 seconds MovingAverage(Sig0, 5.0, 'time') # Moving average of the last 3 and the next 2 seconds MovingAverage(Sig1, (3.0, 2.0), 'time') # Moving average of the last 10 samples (the current sample and 9 past samples) MovingAverage(Sig1, 10, durationKind='sample') # Moving average of 5 samples (2 past samples, the current sample and 2 future samples) MovingAverage(Sig2, (2, 2))
-
MovingMax(signal, duration, durationKind=
'time')¶ 使用给定时间区间返回信号 signal 的滑动最大值。
- duration:
必须是一个正数值,或由两个正数值组成的元组,用于指定区间大小。单个数值表示区间仅向过去延伸。元组则分别指定区间向过去和向未来延伸的范围。
- durationKind:
指定如何解释 duration:
将 durationKind 设为 ‘sample’ 时,duration 会按采样点数量解释。在这种情况下,duration 只能包含整数值。
将 durationKind 设为 ‘time’ 时,duration 会按时间跨度解释。如果 duration 是数值,则时间范围为闭区间 [t - duration, t];如果 duration 是元组,则时间范围为闭区间 [t - duration[0], t + duration[1]]。如果在 t - duration 处没有采样点,则会使用保持值。
Info
如果 duration 以单个数值给出,且 durationKind 设为 ‘sample’,则 duration 包含信号当前采样点。也就是说,时长为 3 时,滑动区间会包含当前采样点和过去的 2 个采样点。如果 duration 以元组形式给出,且 durationKind 设为 ‘sample’,则该元组表示除当前采样点外,还要额外考虑多少个过去采样点和未来采样点。
Example
# Moving maximum of the last 5 seconds MovingMax(Sig0, 5.0, 'time') # Moving maximum of the last 3 and the next 2 seconds MovingMax(Sig1, (3.0, 2.0), 'time') # Moving maximum of the last 10 samples (the current sample and 9 past samples) MovingMax(Sig1, 10, durationKind='sample') # Moving maximum of 5 samples (2 past samples, the current sample and 2 future samples) MovingMax(Sig2, (2, 2))
-
MovingMin(signal, duration, durationKind=
'time')¶ 使用给定时间区间返回信号 signal 的滑动最小值。
- duration:
必须是一个正数值,或由两个正数值组成的元组,用于指定区间大小。单个数值表示区间仅向过去延伸。元组则分别指定区间向过去和向未来延伸的范围。
- durationKind:
指定如何解释 duration:
将 durationKind 设为 ‘sample’ 时,duration 会按采样点数量解释。在这种情况下,duration 只能包含整数值。
将 durationKind 设为 ‘time’ 时,duration 会按时间跨度解释。如果 duration 是数值,则时间范围为闭区间 [t - duration, t];如果 duration 是元组,则时间范围为闭区间 [t - duration[0], t + duration[1]]。如果在 t - duration 处没有采样点,则会使用保持值。
Info
如果 duration 以单个数值给出,且 durationKind 设为 ‘sample’,则 duration 包含信号当前采样点。也就是说,时长为 3 时,滑动区间会包含当前采样点和过去的 2 个采样点。如果 duration 以元组形式给出,且 durationKind 设为 ‘sample’,则该元组表示除当前采样点外,还要额外考虑多少个过去采样点和未来采样点。
Example
# Moving minimum of the last 5 seconds MovingMin(Sig0, 5.0, 'time') # Moving minimum of the last 3 and the next 2 seconds MovingMin(Sig1, (3.0, 2.0), 'time') # Moving minimum of the last 10 samples (the current sample and 9 past samples) MovingMin(Sig1, 10, durationKind='sample') # Moving minimum of 5 samples (2 past samples, the current sample and 2 future samples) MovingMin(Sig2, (2, 2))
-
RisingEdge(signal, threshold=
'*')¶ 检查给定信号的值是否从小于等于 threshold 变为大于 threshold。
Example
RisingEdge(Sig0) # True if Sig0(n-1) < Sig0(n) RisingEdge(Sig0, 0.5) # True if Sig0(n-1) <= 0.5 and Sig0(n) > 0.5
- StartTriggerTime()¶
返回 start trigger 的时间戳。
如果该函数在 trigger block 之外使用,则当前 episode 中任意采样点的第一个时间戳 定义为 start trigger 时间。
如果该函数用于 Stop trigger 的表达式中, 则它引用的是当前 trigger block 自身(而不是父级 trigger block)。
Info
该函数不能用于 Start trigger 的表达式中。
Example
# True, if - at the current timestamp of Sig0 - at least one second has passed since the start trigger Time(Sig0) - StartTriggerTime() >= 1
-
StartTriggerValue(signal, deltaT=
0.0)¶ 返回给定信号在 start trigger 时间戳加上 deltaT 时刻的值。
如果该函数在 trigger block 之外使用,则给定信号的第一个时间戳 (而不是当前 episode 中任意采样点的第一个时间戳!) 定义参考时间戳(deltaT=0.0)。
如果该函数用于 Stop trigger 的表达式中, 则它引用的是当前 trigger block 自身(而不是父级 trigger block)。
Info
该函数不能用于 Start trigger 的表达式中。
Example
# Returns the signal value of Sig0 at the start trigger StartTriggerValue(Sig0)
-
Static(signal, duration, restricted=
True, constValue=True)¶ 返回给定信号的值在给定时长 duration 内是否保持(duration < 0)或将保持 (duration > 0)恒定且等于 constValue。
为确定函数在给定时间 t 的输出,会考虑以下信号值:
若 duration 为正,则检查右开时间区间 [t, t + duration) 内的信号值。 如果在该区间右边界处或之后没有可用的信号值(例如在 signal 末尾),则不使用保持的信号值。此时函数对该时刻 t 返回 False, 因为无法验证信号在整个区间内保持恒定。
如果 duration 为负,则取闭区间 [t + duration, t] 内的信号值。如果左区间边界 t + duration 处没有采样值,则使用保持的信号值。如果没有可用值,该函数针对该时刻 t 返回 False。
如果在 trigger block 内的 calculation step 中以将 restricted 设为 True(默认值)的方式对 Static 函数求值, 则该函数只能访问 trigger block 未被忽略部分中 signal 的信号值。因此, 当 restricted 设为 True 时,该函数在整个 trigger 范围内永远不会返回 True。
参数 constValue 是可选的,默认值为 True。因此,它可以很直观地与逻辑表达式一起使用。 例如,可以写成 Static(engineSpeed == 1000, 1), 而不必写成 Static(engineSpeed, 1, constValue=1000)。 如果参数 constValue 设为 None,则使用当前信号值进行比较。
Example
Static(Sig0, 2) # True if Sig0 == True for the next 2 seconds Static(Sig1, -0.5, True, 0) # True if Sig1 == 0 for the last 0.5 seconds Static(Sig1, -0.5, constValue=0) # Equivalent to the previous example Static(Sig1 == 0, -0.5) # Equivalent to the previous example Static(Sig2, 1, True, None) # True if Sig2 is constant for the next second Static(Sig3 > 1000, 1) # True if Sig3 > 1000 for the next secondInfo
如果要检查 signal 在可变时长的触发范围内是否保持不变,以下表达式更合适:
signal == StartTriggerValue(signal) Derivative(signal) == 0
- StopTriggerTime()¶
返回停止触发的时间戳。触发区间是开区间;也就是说, 返回的时间戳不包含在触发区间内。
如果该函数在 trigger block 之外使用,则当前 episode 中任意采样点的最后一个时间戳 定义为 stop trigger 时间。
Info
该函数不能用于 Start trigger 和 Stop trigger 的表达式中。
Example
# True if at the currently processed timestamp of Sig0, the stop trigger occurs after more than one second. StopTriggerTime() - Time(Sig0) > 1
-
StopTriggerValue(signal, deltaT=
0.0)¶ 返回给定信号在停止触发时间戳加上 deltaT 处的值。 触发范围是开放区间;也就是说,停止触发时间本身(因而 deltaT=0.0 处的值)不属于触发范围。
如果该函数在 trigger block 之外使用,则当前 episode 中任意采样点的最后一个时间戳 定义参考时间戳(deltaT=0.0)。
Info
该函数不能用于 Start trigger 和 Stop trigger 的表达式中。
Example
# Returns the signal value of Sig0 at the stop trigger StopTriggerValue(Sig0)
-
Time(refSignal=
None)¶ 返回当前时间戳。
如果表达式中没有其他可用信号,可以传入一个信号 refSignal 作为时间戳来源。
Example
Time(Sig0) # Obtain the current timestamp of Sig0 Time(Sig0) + Sig0 # Add the current timestamp and the value of Sig0 Time() + Sig0 # Equivalent to Time(Sig0) + Sig0 Time(Sig0) + Sig1 # Note: This expression is evaluated everytime Sig0 or Sig1 have a sample. # The call Time(Sig0) always returns the current timestamp even # if Sig0 has no sample. The hold value of Sig1 is used if Sig1 has # no sample at a timestamp. Time(Sig0) - StartTriggerTime() >= 1 # True, if at the current timestamp of Sig0 at least one # second has passed since the start trigger occurred.
- TriggerRangeStartTime()¶
返回触发范围起点的时间戳。 此函数会考虑触发模式 ‘with time offset if start trigger is fulfilled’ 中指定的 Start offset,这可能导致 触发范围的起始时间与起始触发时间(StartTriggerTime())不同。
如果该函数在 trigger block 之外使用,则当前 episode 中任意采样点的第一个时间戳 定义为触发范围起点。
如果该函数用于 Stop trigger 的表达式中, 则它引用的是当前 trigger block 自身(而不是父级 trigger block)。
Info
该函数不能用于 Start trigger 的表达式中。
Example
# True, if - at the current timestamp of Sig0 - at least one second has passed since the start of the trigger range Time(Sig0) - TriggerRangeStartTime() >= 1
-
TriggerRangeStartValue(signal, deltaT=
0.0)¶ 返回给定信号在触发范围起点的时间戳加上 deltaT 处的值。 此函数会考虑触发模式 ‘with time offset if start trigger is fulfilled’ 中指定的 Start offset,这可能导致 触发范围的起始时间与起始触发时间(StartTriggerTime())不同。
如果该函数在 trigger block 之外使用,则给定信号的第一个时间戳 (而不是当前 episode 中任意采样点的第一个时间戳!) 定义参考时间戳(deltaT=0.0)。
如果该函数用于 Stop trigger 的表达式中, 则它引用的是当前 trigger block 自身(而不是父级 trigger block)。
Info
该函数不能用于 Start trigger 的表达式中。
Example
# Returns the first signal value of Sig0 in the trigger range TriggerRangeStartValue(Sig0)
- TriggerRangeStopTime()¶
返回触发范围结束的时间戳。 该函数会考虑触发模式 ‘with time offset if start trigger is fulfilled’ 中指定的 Stop offset,这可能导致 触发范围的结束时间与触发的结束时间(StopTriggerTime())不同。
如果该函数在 trigger block 之外使用,则当前 episode 中任意采样点的最后一个时间戳 定义为触发范围终点。
Info
该函数不能用于 Start trigger 和 Stop trigger 的表达式中。
Example
# True if at the currently processed timestamp of Sig0, the trigger range continues for more than one second. TriggerRangeStopTime() - Time(Sig0) > 1
-
TriggerRangeStopValue(signal, deltaT=
0.0)¶ 返回给定信号在触发范围结束时间戳加 deltaT 处的值。 该函数会考虑触发模式 ‘with time offset if start trigger is fulfilled’ 中指定的 Stop offset, 这可能导致触发范围的结束时间与触发的结束时间(StopTriggerTime())不同。
如果该函数在 trigger block 之外使用,则当前 episode 中任意采样点的最后一个时间戳 定义参考时间戳(deltaT=0.0)。
Info
该函数不能用于 Start trigger 和 Stop trigger 的表达式中。
Example
# Returns the last signal value of Sig0 in the trigger range TriggerRangeStopValue(Sig0)