2025.3.4
首页 ▸ Integrations ▸

Integral

This integration provides the Riemann sum of the values provided by a source sensor. The Riemann sum is an approximation of an integral by a finite sum.

The integration sensors are updated whenever the source changes and, optionally, based on a predefined time interval. Source sensors with higher sampling frequency provide more accurate results.

配置

要将 Integral helper 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在屏幕顶部，选择标签：Helpers。

  • 在右下角，选择 创建助手 按钮。

  • 从列表中选择 Integral。

  • 按照屏幕上的说明完成设置。

Name

The name the sensor should have. You can change it again later.

Input sensor

The entity providing numeric readings to integrate.

Integral method

Riemann sum method to be used.

Precision

Round the calculated integration value to at most N decimal places.

Metric prefix

Metric unit to prefix the integration result.

Integration time

SI unit of time to integrate over.

Max sub-interval

Applies time-based integration if the source did not change for this duration. This implies that at least every max sub-interval, the integral is updated. If you don’t want time-based updates, enter 0.

YAML configuration

Alternatively, this integration can be configured and set up manually via YAML as well. To enable the Integration sensor in your installation, add the following to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

# Example configuration.yaml entry
sensor:
  - platform: integration
    source: sensor.current_power

Configuration Variables

Looking for your configuration file?
source string Required

The entity ID of the sensor providing numeric readings.

name string (Optional)

Name to use in the frontend.

Default:

source entity ID integral

unique_id string (Optional)

An ID that uniquely identifies the integration sensor. Set this to a unique value to allow customization through the UI.

round integer (Optional, default: 3)

Round the calculated integration value to at most N decimal places.

unit_prefix string (Optional, default: None)

Metric unit to prefix the integration result. Available units are k, M, G and T.

unit_time string (Optional, default: h)

SI unit of time to integrate over. Available units are s, min, h and d.

method string (Optional, default: trapezoidal)

Riemann sum method to be used. Available methods are trapezoidal, left and right.

max_sub_interval time (Optional, default: 0)

Applies time-based integration if the source did not change for this duration. This implies that at least every max sub-interval, the integral is updated. If you don’t want time-based updates, enter 0.

The unit of source together with unit_prefix and unit_time is used to generate a unit for the integral product (e.g. a source in W with prefix k and time h would result in kWh). Note that unit_prefix and unit_time are also relevant to the Riemann sum calculation.

Integration method

The Riemann Sum is an approximation of an integral by a finite sum and is therefore intrinsically inaccurate. Nonetheless, depending on the method used, values can be more or less accurate.

The integration method defines how to calculate the area under the source sensor when it changes. Regardless of the method used, the integration will be more accurate if the source updates more often. The config max_sub_interval can be used to trigger integration when the source sensor is constant.

Trapezoidal

The trapezoidal method follows the Trapezoidal rule. This method is the most accurate of the currently implemented methods, if the source updates often, since it better fits the curve of the intrinsic source.

Left

The left method follows the Left rule. The method underestimates the intrinsic source, but is extremely accurate at estimating rectangular functions which are very stable for long periods of time and change very rapidly (e.g. such as the power function of a resistive load can jump instantly to a given value and stay at the same value for hours). If your source keeps its state for long periods of time, this method is preferable to the trapezoidal.

Right

The right method follows the Right rule. The method is similar to the left method, but overestimates the intrinsic source. Again it is only appropriate to be used with rectangular functions.

Energy

An integration sensor is quite useful in energy billing scenarios since energy is generally billed in kWh and many sensors provide power in W (Watts).

If you have a sensor that provides you with power readings in Watts (uses W as unit_of_measurement, device_class of power), then you can use the integration sensor to track how much energy is being spent. Take the next manual YAML configuration as an example:

sensor:
  - platform: integration
    source: sensor.current_power
    name: energy_spent
    unit_prefix: k
    round: 2
    max_sub_interval:
      minutes: 5

This configuration will provide you with sensor.energy_spent which will have your energy in kWh, as a device_class of energy.