获取执行信息

使用此工具可获取关于执行的信息，即采集时间和上一周期持续时间。您还可以使用此工具来测量特定工具或一组特定工具的执行持续时间。有关所需设置的更多信息，请参阅下一部分。

如何测量工具的执行时间
  1. 添加两个“获取执行信息”工具：一个在要测量的工具上方，另一个在下方。
  2. 将第一个“获取执行信息”工具的“时间”结果连接到第二个“获取执行信息”工具的“开始时间”参数。这确保了从待测工具开始执行的确切时间开始测量时间差。
  3. 相应地设置触发器：
    1. 创建一个从第一个“获取执行信息”工具到待测工具的触发器。
    2. 创建一个从待测工具到第二个“获取执行信息”工具的触发器。
    3. 如果已有一个工具连接到待测工具，则创建一个从所连接工具到第一个“获取执行信息”工具的触发器。

以下示例显示了测量工具读取 Data Matrix ECC 200的执行时间所需的触发器连接。创建的第一个触发器连接是从 从文件获取图像 到第一个获取执行信息工具，因为“从文件获取图像”是唯一将数据发送到待测工具的工具。从第一个“获取执行信息”工具到“读取 Data Matrix ECC 200”的触发器连接以及从“读取 Data Matrix ECC 200”到第二个“获取执行信息”的触发器连接确保了这些工具以正确的顺序执行。

如果要测量一组特定工具的执行时间，请按照上面的说明进行设置。不过，这里要将选定的一组工具（而不是一个工具）置于两个“获取执行信息”工具之间。如果这些工具已连接，则创建两个触发器连接就足够了：一个从第一个“获取执行信息”工具到工具组的第一个工具，另一个从工具组的最后一个工具到第二个“获取执行信息”。

对于特定的工具群和连接设置，所计算出的结果时差可能不精确。如果 MERLIC Vision App 中有工具可以与“获取执行信息”工具或待测工具并行执行，则工具结果“自开始时间以来的持续时间”中得出的时间也可能包含任何并行执行的工具的执行时间。在这种情况下，“自开始时间以来的持续时间”中的时间不代表待测工具的执行时间。

因此，我们建议调整 MERLIC Vision App，以确保一次只执行待测的工具。

执行行为

此工具的执行行为不同于默认行为。通常，在以下情况下会执行 MERLIC 工具：

  • MERLIC Vision App 在连续模式下显式执行。
  • MERLIC Vision App 在“运行一次”模式下显式执行。
  • 在 MERLIC Creator 中打开了包含该工具的 MERLIC Vision App。
  • 在 MERLIC Creator 中更改了该工具的参数值。

不过，仅在以下情况下会执行获取执行信息工具：

  • MERLIC Vision App 在连续模式下显式执行。
  • MERLIC Vision App 在“运行一次”模式下显式执行。

这可以确保在加载 MVApp 或更改该工具的参数值时该工具不收集任何数据。该工具的结果（包括带有执行周期数的计数器）仅返回已显式触发的工具执行的数据。

参数

基本参数

时间格式：

此参数定义在结果“时间”中返回当前时间的“时间格式”。默认情况下设置为“简化”。您可以在相应的连接器中更改格式。更改时间格式也会更新结果时间。

值

描述

简化

返回的采集时间不包含特殊字符，因此可用作文件名称，例如，“20200414_094941_108”。

ISO-8601

返回的采集时间的格式遵循 ISO-8601 标准，例如：“2020-04-14T09:49:41,108”。

相对

采集时间以 Unix 时间戳格式返回，即从 1970 年 1 月 1 日 00:00:00 UTC（Unix 纪元）起经过的时间。不过，MERLIC 返回的时间是毫秒数（而不是秒），例如“1586850581108.0”。

开始时间：

此参数表示计算结果“自开始时间以来的持续时间”中返回的时间差的开始时间。默认情况下设置为 0。如果要测量特定工具或一组特定工具的执行持续时间，可以使用此参数，像如何测量工具的执行时间部分中所述。对于这种情况，必须将“开始时间”参数连接至上一“获取执行信息”工具的“时间”结果以确保从待测工具开始执行的确切时间开始测量时间差。将该参数连接到上一工具的结果或手动定义值时，必须确保参数“开始时间”中的时间格式与“时间格式”参数中选择的时间格式相对应。

其他参数

重置：

使用此参数可以重置目前已处理的所选结果的值。定义为布尔值，默认情况下设置为 0。这表示不会重置结果。要重置值，可将参数设为 1。它会自动设置回 0。重置将影响以下结果：

  • 计数器
  • 上一周期持续时间
  • 自开始时间以来的持续时间
  • 随机数

如果重置结果，则所有已收集的执行信息都将丢失。此操作无法撤销。如有必要，请确保在重置值之前备份数据。

结果

基本结果

计数器：

此结果表示已执行的周期数。返回的结果为整数。

时间：

此结果返回执行的当前时间。时间会以“简化”格式、“ISO-8601”或“相对”时间格式返回，具体取决于参数“时间格式”中的选定值。

下面的示例显示了特定时间以各个时间格式返回的结果。

示例时间：

2020 04 14 09 49 41 108
年 月 天 小时 分 秒 毫秒

结果时间格式：

时间格式

结果

简化

20200414_094941_108

ISO-8601

2020-04-14T09:49:41,108

相对

1586850581108.0
上一周期持续时间：

此结果以毫秒为单位返回上次执行周期的时间差，即上次执行与当前执行之间的持续时间。

自开始时间以来的持续时间：

此结果返回从参数“开始时间”中定义的时间到结果“时间”中的当前执行时间的时间差。它以毫秒为单位返回结果。如果参数“开始时间”已连接到上一“获取执行信息”工具的“时间”结果，则此结果中的结果时间表示置于两个“获取执行信息”工具之间的所有工具的执行时间。对于长时间测量（即 > 24 小时），我们建议使用时间格式“相对”。

工具状态：

“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。

其他结果

随机数：

此结果产生一个介于 0 和 1 之间的随机实数，用于测试。

处理时间:

此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。