This page is part of archived documentation for openHAB 4.0. Go to the current stable version

# Sager Weathercaster Binding

The Sager Weathercaster is a scientific instrument for accurate prediction of the weather.

# Limitations

  • To operate, this binding will need to use channel values provided by other means (e.g. Weather Binding, Netatmo, a 1-Wire personal weather station...)

  • This binding buffers readings for some hours before producing weather forecasts (wind direction and sea level pressure). SagerWeatherCaster needs an observation period of minimum 6 hours.

For these reasons, this binding is not a binding in the usual sense.

# Discovery

A default sagercaster thing will be automatically discovered, based on system location.

# Binding Configuration

The binding itself does not require any configuration.

# Thing Configuration

# SagerCaster

Name Type Description
location (*) Location Latitude and longitude of the desired weather forecast.
observation-period int Minimum delay (in hours) before producing forecasts. Defaulted to 6.

(*) Only latitude is used by the algorithm.

# Channels

The binding will use some input channels, that can be configured directly with profiles (sample below).

Name Group Type Description
is-raining (*) input Switch On if it is raining, else Off.
rain-qtty (*) input Number Any value that give indication of a current rain volume
or input Number:Speed Any value that give indication of a current rain volume eg mm/h
or input Number:Length Any value that give indication of a current rain volume eg mm
cloudiness input Number:Dimensionless Cloud cover percentage
wind-speed-beaufort input Number Wind speed expressed using the Beaufort scale
pressure input Number:Pressure Sea level pressure
wind-angle input Number:Angle Wind direction
temperature input Number:Temperature Outside temperature
timestamp output DateTime Timestamp of the last forecast update
forecast output String Description of the weather forecast
velocity output String Description of the expected wind evolution
velocity-beaufort output Number Expected wind evolution using the Beaufort scale
wind-from output String Expected wind orientation
wind-to output String Evolution of the expected wind orientation
wind-evolution output String Wind orientation evolution over observation period
pressure-trend output String Pressure evolution over observation period
temperature-trend output String Temperature evolution over observation period

(*) You may use either is-raining, either rain-qtty depending upon the data available in your system.

# Full Example

# Things

sagercaster:sagercaster:triel "Sager Triel" @ "Outside" [location="48,2"]

# Items

Input channel can be updated via profiles in versions of OH > 2.4.

Number:Pressure NWS_Abs_Pressure "Pression absolue" <pressure> {channel="netatmo:NAMain:home:insidews:AbsolutePressure", channel="sagercaster:sagercaster:triel:input#pressure" [profile="follow"]}
Number:Angle NWS_wind_angle   "Orientation [%d°]"  {channel="netatmo:NAModule2:home:anemometre:WindAngle", channel="sagercaster:sagercaster:triel:input#wind-angle" [profile="follow"]}
Number:Dimensionless OWM_Cloudiness "Cloudiness [%d %unit%]" <clouds> {channel="openweathermap:weather-and-forecast:api:local:current#cloudiness", channel="sagercaster:sagercaster:triel:input#cloudiness" [profile="follow"] }
Number Synop_beaufort "Beaufort [%d]" <beaufort> {channel="synopanalyzer:synopanalyzer:orly:wind-speed-beaufort", channel="sagercaster:sagercaster:triel:input#wind-speed-beaufort" [profile="follow"] }
Number:Length NWS_rain_1h "Précipitation 1h [%.2f %unit%]" <rain> {channel="netatmo:NAModule3:home:pluviometre:SumRain1", channel="sagercaster:sagercaster:triel:input#rain-qtty" [profile="follow"]}

Here is the definition of output channels

// Items directly derived from inputs
String  SWC_windevolution       "Wind Evolution"                        (gSager)                {channel="sagercaster:sagercaster:triel:output#wind-evolution"}
String  SWC_presstrend          "Pressure Trend"                        (gSager)                {channel="sagercaster:sagercaster:triel:output#pressure-trend"}

// SagerWeatherCaster Forecast Items
String  SWC_forecast            "Weather Forecast"                      (gSager)                {channel="sagercaster:sagercaster:triel:output#forecast"}
String  SWC_velocity            "Wind Velocity"                         (gSager)                {channel="sagercaster:sagercaster:triel:output#velocity"}
String  SWC_windfrom            "Wind from"                             (gSager)                {channel="sagercaster:sagercaster:triel:output#wind-from"}
 
DateTime SWC_ObservationTime    "Timestamp [%1$tH:%1$tM]"       <time>  (gSager, gTrackAge)     {channel="sagercaster:sagercaster:triel:output#timestamp" }