jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-07-13 20:36:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify energy sensor statistics calculation (#1165)

Browse Source
This commit is contained in:
Erik Montnemery 2021-12-22 08:44:38 +01:00 committed by GitHub
parent 9e156bab3b
commit e466749837
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/core/entity/sensor.md
View File

@ -103,6 +103,10 @@ zero-point. When `last_reset` changes, the zero-point will be set to 0.
If last_reset is not set, the sensor's value when it was first added is used as the If last_reset is not set, the sensor's value when it was first added is used as the
zero-point when calculating `sum` statistics. zero-point when calculating `sum` statistics.
To put it in another way: the logic when updating the statistics is to update
the sum column with the difference between the current state and the previous state
unless `last_reset` has been changed, in which case don't add anything.
Example of state class `total` without last_reset: Example of state class `total` without last_reset:
| t | state | sum | sum_increase | sum_decrease | | t | state | sum | sum_increase | sum_decrease |
@ -145,6 +149,10 @@ cycle. This state class is useful for gas meters, electricity meters, water mete
The value when the sensor reading decreases will not be used as zero-point when calculating The value when the sensor reading decreases will not be used as zero-point when calculating
`sum` statistics, instead the zero-point will be set to 0. `sum` statistics, instead the zero-point will be set to 0.
To put it in another way: the logic when updating the statistics is to update
the sum column with the difference between the current state and the previous state
unless the difference is negative, in which case don't add anything.
Example of state class `total_increasing`: Example of state class `total_increasing`:
| t | state | sum | | t | state | sum |