Weather data
In this section, we explain which weather data is supplied to aedifion.io projects of a customer.
Meteorological conditions¶
The following table provides the meteorological conditions which are available to all projects:
| Meteorological condition | Name | Unit / Value set | Info |
|---|---|---|---|
| Apparent temperature | apparent_temperature | °C | Human-felt temperature, determined by air temperature, wind speed, and humidity. |
| Cloud coverage | cloud_cover | % | Percentage of sky occluded by clouds. |
| Daytime | daytime | [0, 1] | Boolean value indicating whether the sun as risen. |
| Dew point | dew_point | °C | Ambient steam saturation temperature. |
| Direct horizontal solar irradiance | direct_horizontal_solar_irradiance | W/m2 | Direct horizontal solar irradiance [clear sky]. |
| Direct normal solar irradiance | direct_normal_solar_irradiance | W/m2 | Direct normal solar irradiance [clear sky]. |
| Global horizontal irradiance | global_horizontal_irradiance | W/m2 | Global horizontal irradiance [clear sky]. |
| Relative humidity | relative_humidity | % | Ambient ratio of steam saturation. |
| Precipitation | precipitation | mm/h | Amount of precipitation per time unit. |
| Pressure | pressure | mBar | Atmospheric air pressure. |
| Solar radiation | solar_radiation | W/m2 | Estimated solar radiation. |
| Solar altitude | solar_altitude | ° [-90,90] | Vertical position of the above or below the horizon. |
| Solar azimuth | solar_azimuth | ° [-180,180] | Horizontal position of the sun. 0° at true south, clockwise. |
| Temperature | temperature | °C | Ambient air temperature. |
| UV index | uv_index | - | Defined by WMO, WTO, and ICNIRP commission. |
| Average visibility | visibility | km | Measurement of the transparency of ambient air. |
| Wind direction | wind_direction | ° [0,360] | Direction from which the wind is coming. 0° at true north, clockwise. Not defined for wind speed = 0. |
| Wind speed | wind_speed | m/s | Horizontal wind speed. |
We store every meteorological condition as a separate datapoint on the aedifion.io platform to historicize its state. More on this in the subchapter Datapoint and observation convention.
Current weather data¶
Current weather data is delivered for all the meteorological conditions described in meteorological conditions. There is always a delay between when current weather data is measured and when it is made available to the platform. All current weather data is updated every 15 minutes.
Forecast weather data¶
Hourly forecasts¶
Only the most important weather data is provided as a forecast. The following data is provided as an hourly forecast for the next 48 hours:
- Relative humidity
- Temperature
- Solar radiation
All forecast weather data, i.e., the 1h, 2h, ..., 48h forecast datapoints, is updated every hour. Please note that each update only adds a single new value (the prediction what the temperature is going to be in xh to each forecast datapoint) while past predictions remain as-is and are not "corrected" retrospectively. Every datapoint of a forecast represents what the given weather condition is forecasted to be at the forecast horizon. As an example, a value {"time": "2022-12-08T16:00:00Z", "value": 5.56} of the weather-service-forecast-2h-temperature datapoints means that at on 2022-12-08 at 16:00:00 UTC, the predicted temperature for two hours later, i.e., 2022-12-08 at 18:00:00 UTC was 5.56 degrees. Similarly, a value {"time": "2022-12-08T16:00:00Z", "value": 15.21} of the weather-service-forecast-24h-temperature datapoints means that at on 2022-12-08 at 16:00:00 UTC, the predicted temperature for 24 hours later, i.e., 2022-12-09 at 16:00:00 UTC was 15.21 degrees.
Average temperature forecasts¶
In addition to the hourly forecasts, weather data is also provided for the average temperature for the forecast horizons:
- 24 hours
- 48 hours
Average temperature during working hours¶
The average temperature forecast during working hours is provided every night at midnight for between 8:00 and 18:00 of the upcoming day.
Datapoint and observation convention¶
All weather data is stored in the aedifion.io plattform with a dedicated datapoint which has a unique alphanumeric identifier.
The naming convention for current weather datapoints is:
weather-service-current-<name of meteorological condition>
e.g., weather-service-current-temperature
The naming convention for forecast weather datapoints is:
weather-service-forecast-<prediction horizon>-<name of meteorological condition>
e.g., weather-service-forecast-1h-temperature
The naming convention for forecast mean weather datapoints is:
weather-service-forecast-mean-<prediction horizon>-<name of meteorological condition>
e.g., weather-service-forecast-mean-1h-temperature
The naming convention for working hours weather datapoints is:
weather-service-forecast-mean-working-hours-<begin>_<end>-<name of meteorological condition>
e.g., weather-service-forecast-mean-working-hours-8_18-temperature