确定数据历史

使用此工具可获得关于已处理数据历史的统计信息。

执行行为

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

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

不过，仅在以下情况下会执行工具 “确定数据历史”：

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

这可以确保在加载 MVApp 或更改该工具的参数值时不向缓冲区添加任何数据。

参数

基本参数

数据值：

此参数定义检查的数据值。您可将参数连接至前一工具的适当结果并将其值用作输入，或在连接器手动定义值。

缓冲区大小：

此参数允许您调整“缓冲区大小”，以定义应存储为数据历史的数据值数量。默认情况下，此值设置为 1000。

其他参数

下边界：

此参数定义了“数据值”属于良值时所允许的最小值。它还可以与“上边界”结合用于定义表示良值的取值范围。默认情况下，此参数设置为 1。您可以使用滑块，在 -1000000.0 到“上边界”中所定义值的范围内对值进行更改。

如果被处理的“数据值”在良值的定义范围内，它将包含在“良百分比”结果中，否则将包含在“差百分比”结果中。

上边界：

此参数定义了“数据值”属于良值时所允许的最大值。它还可以与“下边界”结合用于定义表示良值的取值范围。默认情况下，此参数设置为 1。您可以使用滑块，在“下边界”中所定义值到 1000000.0 的范围内对值进行更改。

如果被处理的“数据值”在良值的定义范围内，它将包含在“良百分比”结果中，否则将包含在“差百分比”结果中。

重置：

此参数允许您重置目前已处理的数据值的历史。定义为布尔值，默认情况下设置为 0。这表示不会重置结果。如果“重置”设置为 1，所有结果都将被重置，且所收集的缓冲数据信息也将丢失。此操作无法撤销。如果使用一个新的或不同的“数据值”，尤其需要重置。否则之前数据的结果信息将不能从结果中删除。重置后，该参数会自动设置回 0。

平滑：

此参数定义缓冲数据平滑处理的系数。平滑由高斯函数确定。值定义为实数，默认情况下设置为 2。平滑处理的数据在“已处理的缓冲数据”中返回。您可以在相应的连接器中将平滑系数设置为“0”和“10”之间的范围。要禁用缓冲数据平滑处理，您需要将参数值设置为 0。这样“已处理的缓冲数据”中将返回未经平滑处理的结果数据。

样本限制：

此参数定义作为“已处理的缓冲数据”（即经过平滑处理的缓冲数据）返回的数据的数量限制。如果缓冲数据超过“样本限制”中定义的值，数据将根据“样本限制”的定义取样为多个等距值。默认情况下，此参数设置为 1,000。这意味着，如果缓冲数据超过 1,000，则会被取样为 1,000 的等距值，然后在“已处理的缓冲数据”中返回。

仅在“样本限制”低于为“缓冲区大小”定义的值，且缓冲数据的实际数量超过“样本限制”中定义的值时，才进行采样。在工具的默认设置下，由于“缓冲区大小”也默认设置为 1,000，数据的数量绝不会超过定义的“样本限制”。因此默认设置下禁用采样。但是，您可以在相应的连接器中将“样本限制”的值更改为 1-100,000 之间的值。例如，如果您选择的“样本限制”为 100，且缓冲数据数量为 1,000，则数据取样为 100 等距值，即“已处理的缓冲数据”中将返回 10 的倍数值 (1,000 / 100)。这让您可以减少返回的缓冲值数量。

结果

基本结果

平均值：

此结果为“数据值”中传递的数据的计算平均值。返回的结果为实数。

中值：

此结果为“数据值”中传递的数据的计算中值。返回的结果为实数。

最小值：

此结果为“数据值”中传递的数据的最小值。返回的结果为实数。

最大值：

此结果为“数据值”中传递的数据的最大值。返回的结果为实数。

标准偏差：

此结果为“数据值”中传递的数据的计算标准偏差。返回的结果为实数。

缓冲数据：

此结果为“数据值”中传递的 tuple 形式的所有已处理数据。

工具状态：

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

其他结果

良百分比：

此结果返回所定义数值范围“下边界”和“上边界”之间属于良的数据值比例。

差百分比：

此结果返回所定义数值范围“下边界”和“上边界”之外属于差的数据值比例。

已处理的缓冲数据：

此结果返回根据“平滑”和“样本限制”所定义的设置在“数据值”中传递的所有已处理数据。数据将以 tuple 形式返回。

当前缓冲长度：

此结果返回目前已处理的缓冲数据的当前长度。它对应于“缓冲数据”中返回的数据值的数量。

处理时间:

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

应用程序示例

此工具用于以下 MERLIC Vision App 示例：

check_saw_angles.mvapp