Skip to content

Horizons ​

Horizons define the forecast time offsets that njord publishes as separate sensor values. Each horizon produces a sensor per parameter per model.

Configuration ​

json
{
  "Njord": {
    "Horizons": [3, 6, 12, 24, 48, 72]
  }
}

The default is [3, 6, 12, 24, 48, 72], covering forecasts for 3, 6, 12, 24, 48, and 72 hours ahead.

What each horizon means ​

Each value represents how many hours into the future the forecast applies:

HorizonTopic segmentMeaning
3h33 hours from now
6h66 hours from now
12h1212 hours from now
24h24Tomorrow, same time
48h482 days from now
72h723 days from now
96h964 days from now

Valid range ​

Each horizon must be between 1 and 96 (hours). At least one horizon is required.

Model horizon limits ​

Not every model provides data out to every horizon. For example, icon_d2 only forecasts ~48 hours ahead. When a model has no data at a configured horizon:

  • njord does not publish a value for that model at that horizon
  • No null payloads are sent; the sensor simply does not update
  • The expire_after mechanism (2x poll interval) marks the sensor as unavailable in Home Assistant

This is expected behavior: short-range regional models naturally cover fewer horizons than global models.

Fine-grained presets ​

For high-resolution monitoring of the next 24 hours, use closely spaced horizons:

json
{
  "Njord": {
    "Horizons": [1, 2, 3, 4, 6, 8, 12, 18, 24, 36, 48, 72]
  }
}

WARNING

More horizons means more sensors per model device. With the default Weather parameter group and 12 horizons, each model device has over 100 sensors. Consider using parameter excludes to reduce the sensor count, and see budget for API usage impact.

Sensor count formula ​

The number of sensors per model device is:

(hourly parameters x horizons) + (daily parameters x forecast days)

With defaults (31 hourly + 17 daily parameters, 6 horizons, 4 forecast days): 31 x 6 + 17 x 4 = 254 sensors per model device.

Open-Meteo data is licensed under CC BY 4.0.