Enrichment
Enrichment features compute derived data from the raw model forecasts. Each feature is independently toggleable and publishes to its own Home Assistant device per location.
Overview
| Feature | Default | Description |
|---|---|---|
| Consensus | enabled | Cross-model aggregation with spread and agreement metrics |
| Alerts | enabled | Weather alerts derived from model data |
| Derived | enabled | Beaufort scale, wind chill, comfort index, WMO descriptions |
| Trends | disabled | Temperature/wind/precipitation trend directions and timing |
| Indices | disabled | Activity scores, degree days, VPD |
| History | disabled | Forecast accuracy tracking and model weighting |
Consensus
Aggregates forecasts across all models for a location into a single consensus value per parameter and horizon.
{
"Enrichment": {
"Consensus": {
"Enabled": true,
"Method": "Median",
"TrimPercent": 0.1
}
}
}| Option | Default | Description |
|---|---|---|
Method | "Median" | Aggregation method: "Median" or "TrimmedMean" |
TrimPercent | 0.1 | Fraction to trim from each end when using TrimmedMean |
Publishes to njord/{location}/consensus/h{N} with additional metadata: _spread (range), _agreement (ratio of models within threshold), _models_used (count), IQR, outlier detection, and confidence intervals.
Alerts
Generates weather alerts as binary sensors with severity levels (None, Yellow, Orange, Red) based on configurable thresholds.
{
"Enrichment": {
"Alerts": {
"Enabled": true,
"FrostThreshold": 0.0,
"HeatThresholds": [30, 35, 40],
"StormGustThreshold": 16.7,
"HeavyRainHourlyThreshold": 10.0,
"HeavyRainDailyThreshold": 25.0,
"PressureDropThreshold": 5.0,
"CapeThreshold": 1000.0,
"ThunderstormPrecipThreshold": 5.0,
"ThunderstormGustThreshold": 15.0
}
}
}Alert types: Frost, Heat, Storm, HeavyRain, UV, Fog, Snow, PressureDrop, Thunderstorm
Each alert publishes as a binary_sensor with attributes:
severity: None, Yellow, Orange, or Redconfidence: how many models agree- Type-specific fields (e.g.
expected_low,earliest_frost,models_agreeing)
TIP
Thresholds use metric units: temperatures in Celsius, wind speed in m/s, rain in mm, pressure in hPa, CAPE in J/kg.
Derived
Computes human-readable interpretations from raw forecast data.
{
"Enrichment": {
"Derived": {
"Enabled": true
}
}
}Per-horizon values:
beaufort: wind speed on the Beaufort scale (0 to 12)wind_chill: perceived temperature in Celsiusdewpoint_comfort: comfort category based on dew point (e.g. "Comfortable", "Humid")wmo_description: human-readable weather description from WMO code
Scalar values:
diurnal_amplitude: daily temperature range in Celsiussunshine_pct: percentage of daylight hours with sunshineinversion: temperature inversion detected (boolean)
Trends
Analyzes how forecast parameters change over time.
{
"Enrichment": {
"Trends": {
"Enabled": false
}
}
}Publishes to njord/{location}/trends:
- Parameter trend directions for temperature, wind, precipitation, cloud cover
- Weather change description (from WMO code transitions)
- Precipitation timing: starts-in / ends-in hours
- Temperature extrema timing: max-in / min-in hours
- Consensus stability label and ratio
- Predictability decay rate and reliable-hours estimate
Indices
Activity-oriented scores computed from forecast consensus data. Each score is 0–100 and aggregated over the next 24 hours. Scores include uncertainty envelopes (min/max/confidence) derived from model spread.
Basic configuration
{
"Enrichment": {
"Indices": {
"Enabled": false,
"Preferences": {
"IdealOutdoorTemp": 22.0,
"IndoorTemp": 22.0,
"HeatSensitivity": 1.0,
"HumiditySensitivity": 1.0,
"WindSensitivity": 1.0,
"RainSensitivity": 1.0
}
}
}
}Global preferences
These apply to all scores and all locations unless overridden.
| Option | Default | Description |
|---|---|---|
IdealOutdoorTemp | 22.0 | Peak of the outdoor comfort curve (°C). A 26 makes the outdoor score favour warmer days. |
IndoorTemp | 22.0 | Reference indoor temperature for the ventilation score (°C) |
HeatSensitivity | 1.0 | Multiplier for temperature penalties across all scores (0.0–5.0). Higher = more sensitive to heat/cold. |
HumiditySensitivity | 1.0 | Multiplier for humidity penalties (0.0–5.0). Increase if you find humid days uncomfortable. |
WindSensitivity | 1.0 | Multiplier for wind penalties (0.0–5.0). Increase if wind bothers you. |
RainSensitivity | 1.0 | Multiplier for rain penalties (0.0–5.0). Increase if you want stricter rain avoidance. |
RunningIdealTempLow | 5.0 | Lower bound of ideal running/cycling temperature range (°C) |
RunningIdealTempHigh | 20.0 | Upper bound of ideal running/cycling temperature range (°C) |
BbqMinTemp | 10.0 | Minimum temperature for the BBQ score (°C). Below this, BBQ scores drop sharply. |
BbqIdealWindLow | 1.0 | Lower bound of ideal BBQ wind range (m/s) |
BbqIdealWindHigh | 3.0 | Upper bound of ideal BBQ wind range (m/s) |
Per-score overrides
Override any preference for a specific score. Useful when you want different sensitivity for different activities.
{
"Enrichment": {
"Indices": {
"Preferences": { "HeatSensitivity": 1.0 },
"ScoreOverrides": {
"Running": { "HeatSensitivity": 0.7 },
"Bbq": { "RainSensitivity": 2.0, "BbqMinTemp": 15.0 }
}
}
}
}Valid score names: Laundry, Outdoor, Running, Cycling, Bbq, Irrigation, Solar, Ventilation.
Per-location overrides
Override preferences for a specific location. Each location can have its own global preferences and score overrides.
{
"Enrichment": {
"Indices": {
"Preferences": { "IdealOutdoorTemp": 22.0 },
"LocationOverrides": [
{
"Location": "Lucerne",
"Preferences": { "IdealOutdoorTemp": 24.0 },
"ScoreOverrides": {
"Outdoor": { "WindSensitivity": 0.8 }
}
}
]
}
}
}Location names are matched case-insensitively against the configured locations.
Resolution cascade
For any (location, score, property), the first non-null value wins:
LocationOverrides[location].ScoreOverrides[score].{Property}LocationOverrides[location].Preferences.{Property}ScoreOverrides[score].{Property}Preferences.{Property}- Hardcoded default
Published values
- Activity scores (0–100): laundry, outdoor, running, cycling, BBQ, irrigation, solar, ventilation
- Score envelopes: min, max, confidence for each activity score
- Frost: hours-until-frost, confidence
- VPD: vapour pressure deficit value (kPa) and category
History
Tracks forecast accuracy over time by comparing past predictions against observations. Requires persistence to be configured.
{
"Enrichment": {
"History": {
"Enabled": false,
"RetentionDays": 30,
"MinSampleSize": 48,
"SnapshotInterval": 100
}
}
}| Option | Default | Description |
|---|---|---|
RetentionDays | 30 | How many days of history to keep |
MinSampleSize | 48 | Minimum data points before publishing accuracy metrics |
SnapshotInterval | 100 | Events between persistence snapshots |
Published values:
- Per-model: MAE (7-day and 30-day), weight, drift
- Seasonal best model
- Anomaly detection (boolean + deviation in sigma)
- Accuracy-weighted temperature
WARNING
History enrichment depends on Akka.Persistence. Make sure a persistence provider is configured and the data volume is mounted.