# Main concepts

# Forecast model

Weacast aims at gathering, exposing, and making use of weather forecast data generated by forecast models. It does often exist different instances of a forecast model producing more or less accurate data, usually in term of spatial or temporal resolution. As an example the GFS (opens new window) model produces data at 1° or 0.5° degree of resolution with different time steps (e.g. each 3 hours until the production time + 240 hours). The production of a set of forecast data is called a run of the model and occurs on a regular daily basis, e.g. every 6 hours.

The spatial properties of a model instance are completely defined by a grid. The temporal properties are defined by interval values describing at which frequency/time the forecast data are produced (so called run interval/time) and which time steps are available (so called forecast interval/time).

# Forecast element

Each configured forecast model instance output hundreds of forecast elements (i.e. meteorological elements) such as temperature, wind direction, etc. Forecast data are continuously updated because the model instance produces new forecast data for its elements every N hours.

# Probe

Probes are virtual sensors used to probe forecast data at specific locations of interest (e.g. airports, cities, stores, etc.). It does exist two kind of probes:

  • on-demand probing, which allow to compute on-demand forecast element values for a given forecast time and a set of locations,
  • probing stream, which allow to automatically and continuously compute forecast element values for a set of locations as new forecast data are gathered.

TIP

Probed values are computed using interpolation of the forecast data.

# Probe results querying

While on-demand probing directly returns the results you asked for, probing streams generates the results continuously without your intervention. We thus need a way to query the persisted results on-demand using:

  • selectors: to find all results where an attribute has (or does not have) the specified value (e.g. forecast time);
  • comparison operators: to find all results where the target element value is less, less or equal, greater, greater or equal than a given value;
  • spatial operators: to find all results located within a given geometry on the ground (e.g. in a given radius around a point),
  • aggregation operators: to aggregate all target element values for a set of forecast times.

# Alert

Alerts are user-defined conditions automatically and continuously evaluated on streamed probe results as new forecast data are gathered. It can be viewed as an automated query of the probe results that will raise an event whenever a matching result is found. With alert you can create triggers which will fire on an occurrence of the selected weather conditions (temperature, humidity, pressure, etc.) in a specified period of time and area.