mirror of
https://github.com/jpawlowski/hass.tibber_prices.git
synced 2026-05-28 18:43:40 +00:00
docs(sensors-volatility): clarify price rank calculation and provide automation example
Enhance the documentation for volatility sensors by explaining that the maximum price rank will never reach 100% and providing a YAML automation example for managing device usage during peak pricing. Impact: Users gain a clearer understanding of price rank behavior and practical automation guidance.
This commit is contained in:
parent
91147bd79c
commit
6d22ea7151
1 changed files with 26 additions and 0 deletions
|
|
@ -156,6 +156,15 @@ Price rank (percentile rank) = (number of intervals strictly cheaper than subjec
|
|||
|
||||
The cheapest interval always returns 0% — you can use `state == 0` to detect the absolute cheapest moment.
|
||||
|
||||
:::note 100% is never reached
|
||||
By design, **the most expensive interval of the day will never show 100%**. The formula counts how many intervals are *strictly cheaper* than the subject price. For the daily maximum, every other interval is cheaper — but the interval itself is not counted. With 96 quarter-hour intervals per day, the maximum value is 95 ÷ 96 × 100 = **99.0%**.
|
||||
|
||||
This means:
|
||||
- `state == 0` → cheapest interval of the reference set ✅
|
||||
- `state == 100` → **never true** ❌
|
||||
- `state >= 99` → most expensive interval of the day ✅ (use this instead)
|
||||
:::
|
||||
|
||||
### Available Sensors
|
||||
|
||||
**Current interval** (price of the active quarter-hour):
|
||||
|
|
@ -259,6 +268,23 @@ automation:
|
|||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Show YAML: Avoid running devices at the most expensive time of day</summary>
|
||||
|
||||
```yaml
|
||||
automation:
|
||||
- alias: "Pause non-essential devices at peak price"
|
||||
trigger:
|
||||
- platform: numeric_state
|
||||
entity_id: sensor.<home_name>_current_price_rank_today
|
||||
above: 99 # 100 is never reached — use >= 99 to catch the daily maximum
|
||||
action:
|
||||
- service: switch.turn_off
|
||||
entity_id: switch.dishwasher
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Show YAML: Pre-heat when the next interval is cheap</summary>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue