跳转到内容

钳位过滤器

将数值限制在 min_valuemax_value 之间的闭区间内。

配置变量:

  • min_value (可选, float): 范围的下限。
  • max_value (可选, float): 范围的上限。
  • ignore_out_of_range (可选, bool): 如果为 true,则忽略所有超出范围的传感器值。默认为 false

必须至少指定 min_valuemax_value 中的一个。

当传感器值通过此过滤器时,如果它小于 min_value,它将被设置为 min_value。如果它大于 max_value,它将被设置为 max_value。 未指定的边界被视为无界限(即,如果未设置 min_value,则没有下限)。

NaN(非数字)值如果设置了 min_value 将被钳位到下限,否则被钳位到上限。 正无穷或负无穷值如果设置了相应的边界,将分别被钳位到上限或下限。

如果 ignore_out_of_range 为 true,任何不在指定范围内的值将被忽略而不是被钳位。

# 示例配置条目
filters:
- clamp:
min_value: 10
max_value: 75
ignore_out_of_range: true