The individual forecast maps are widly configurable to match the desired look. Below you find a detailed description of all possible parameters and their use.
All parameters have standard values in case they are not specified. The order of the parameters has no influence.
The parameters are described with the wind_stream maps but they are valid for all forecast maps.
Parameters "latrange" and "lonrange"
Parameters "lat" and "lon"
Standard values: "lat" = 0, "lon" = 0
Accepted values: "lat" -90 to 90, "lon" -180 to 360
The parameter "lat" (Latitude) and "lon" (Longitude) specify the position of the weather forecast in decimal degrees.
For example Abu Dhabi, UAE: lat=24.48411&lon=54.36870
Parameters "latrange" and "lonrange"
Standard values: "latrange" = 10, "lonrange" = 14
Accepted values: "latrange" 4 to 180, "lonrange" 4 to 360
The parameters "latrange" (Latitude) and "lonrange" (Longitude) specify the range around the center of the forecast map in decimal degrees.
For example latrange=20, lonrange=28 and to compare latrange=180, lonrange=360:
Parameter "t"
Standard value: "t" = 0h
Accepted values: 0h to 234h in steps of 3h
The parameter "t" specifiy the moment of the forecast in hours from (roughly) the actual time. The forecast is actualized every 6 hours.
For example Rio de Janeiro, Brasilien:
Parameter "duration"
Standard value: "duration" = 1
Accepted values: 1 to 81
The parameter "duration" is only used with the variable "precipitation". It specify the duration of the summation of the precipitation in steps of 3 hours. "1" means the next 3 hours of precipitation will be added from the start of the forecast (see parameter "t" above), "8" means the next 24 hours of precipitation will be added from the start of the forecast.
Example Rio de Janeiro, Brasil:
Parameter "label"
Standard value: "label" = ""
Accepted values: All characters but not all special characters
This parameter specifies the name of the location printed on the forecast map.
There are limitations: Umlauts (Ä,Ö,Ü,ä,ö,ü) and some special characters such as "ß" can not be displayed. Also the beginning and end of the line will be cut if the line exceeds the width of the meteogram. Just try it.
For example Jakarta, Indonesien:
Parameters "nx" and "ny"
Standard values: "nx" = 770, "ny" = 595
Accepted values: "nx" 256 to 1920, "ny" 256 to 1920
This parameter specifies the size of the forecast map. "nx" specifies the width and "ny" the height.
For example Santiago, Chile:
Parameter "lang"
Standard value: "lang" = de
Accepted values: de, en, fr, es
This parameter specifies the language of the labeling on the meteogram:
- de = German
- en = English
- fr = French
- es = Spanish
For example Athen, Griechenland:
Parameter "background_color"
Standard value: "background_color" = black
Accepted values:
Color | RGB color code | value |
---|---|---|
0, 0, 0 | black | |
255,255,255 | white |
The parameter "background_color" specifes the background color of the forecast map.
For example Chennai, Indien:
Parameter "map_color"
Standard value: "map_color" = white
Accepted values:
color | RGB color code | value |
---|---|---|
0, 0, 0 | black | |
255,255,255 | white | |
160, 0, 200 | purple | |
130, 0, 220 | dark purple | |
30, 60, 255 | dark blue | |
0, 160, 255 | medium blue | |
0, 200, 200 | light blue | |
0, 210, 140 | aqua | |
0, 220, 0 | green | |
160, 230, 50 | yellow/green | |
230, 220, 50 | yellow | |
230, 175, 45 | dark yellow | |
240, 130, 40 | orange | |
250, 60, 60 | red | |
240, 0, 130 | magenta | |
170, 170, 170 | gray |
The parameter "map_color" specifies the color for the contours of the landscapes.
For example cape north:
Parameter "label_color"
Standard value: "label_color" = red
Accepted values:
Farbe | RGB Farbcode | Wert |
---|---|---|
0, 0, 0 | black | |
255,255,255 | white | |
160, 0, 200 | purple | |
130, 0, 220 | dark purple | |
30, 60, 255 | dark blue | |
0, 160, 255 | medium blue | |
0, 200, 200 | light blue | |
0, 210, 140 | aqua | |
0, 220, 0 | green | |
160, 230, 50 | yellow/green | |
230, 220, 50 | yellow | |
230, 175, 45 | dark yellow | |
240, 130, 40 | orange | |
250, 60, 60 | red | |
240, 0, 130 | magenta | |
170, 170, 170 | gray |
The parameter "label_color" specifies the color of the label.
For example Dakar:
Parameter "scale"
Standard value: "scale" = fixed
Accepted values: fixed, variable
"scale" specifies how the shown parameter is scaled:
- fixed = the scale is fixed (e.g. wind speed 1-12 BFT). A disadvantage is the inaccurancy if there are only small values in the forecast area, an advantage is the comparability as same colors mean same values at different forecast maps.
- variable = the scale is variable. The maximum is always the highest value in the forecast map. An advantage is the accurancy if there are only small values in the forecast area, a disadvantage are the different colors for the same values in different forecast maps.
For example Manaus in the Amazonas and Cape Horn, island Homos:
You see immediately with "scale=fixed" in the comparasion, that the wind speed in the rain forest is slower then at Cape Horn, but it´s difficult to recognize the differences in the wind speed arounf Manaus.
It´s easy to recognize the different wind speed within the particular forecast maps with "scale=variable", but it´s difficult to compare the values of the differend forecast maps.
Parameter "projection"
Standard value: "projection" = latlon
Accepted values: latlon, scaled, nps, sps, orthogr, mollweide, robinson
The parameter specifies which map projection will be used to display the weather map:
- latlon = The equirectangular projection (also called the equidistant cylindrical projection, geographic projection, or la carte parallélogrammatique projection, and which includes the special case of the plate carrée projection or geographic projection) is a simple map projection.
- scaled = In principle like the "latlon" projection, except the aspect ration is not maintained, it´s variable. The map is stretched to use the whole drawing area.
- nps = The azimuthal equidistant projection with view on the north pole is an azimuthal map projection. It has the useful properties that all points on the map are at proportionately correct distances from the center point, and that all points on the map are at the correct azimuth (direction) from the center point. A useful application for this type of projection is a polar projection which shows all meridians (lines of longitude) as straight, with distances from the pole represented correctly.
- sps = The azimuthal equidistant projection with view on the south pole is an azimuthal map projection. It has the useful properties that all points on the map are at proportionately correct distances from the center point, and that all points on the map are at the correct azimuth (direction) from the center point. A useful application for this type of projection is a polar projection which shows all meridians (lines of longitude) as straight, with distances from the pole represented correctly.
- orthogr = The use oforthographic projection in cartography dates back to antiquity. Like the stereographic projection and gnomonic projection, orthographic projection is a perspective (or azimuthal) projection, in which the sphere is projected onto a tangent plane or secant plane.
- mollweide = The Mollweide projection is an equal-area, pseudocylindrical map projection generally used for global maps of the world or night sky.
- robinson = The Robinson projection is a map projection of a world map which shows the entire world at once. It was specifically created in an attempt to find a good compromise to the problem of readily showing the whole globe as a flat image.
Now some examples to illustrate the different kinds of projections:
First the standard projection "latlon", the equirectangular projection. With this projection it´s possible to generate any details of the earth (see other examples above):
An example of "scaled". Also with this projection it´s possible to generate any details of the earth (see other examples above):
An example of "nps", a view on the north pole:
"lat" has to be between 45 and 90. "latrange" must be (90-lat)*2. With "lon" the map can be rotated around the center. "lon" has to be between -180 and 180. "lonrange" must be 360. Only considering this rules will produce resonable maps.
With "sps" it´s possible to look on the south pole:
"lat" has to be between -45 and -90. "latrange" must be (90-|lat|)*2. With "lon" the map can be rotated around the center. "lon" has to be between -180 and 180. "lonrange" must be 360. Only considering this rules will produce resonable maps.
With "orthogr" it´s possible to look on the equator:
"lat" must be 0. "latrange" must be 180. With "lon" the map can be rotated around the poles. "lon" has to be between -180 and 180. "lonrange" must be 180. Only considering this rules will produce resonable maps.
With "mollweide" would map in mollweide projection will be generated:
"lat" must be 0. "latrange" must be 180. With "lon" the map can be rotated around the poles. "lon" has to be between -180 and 180. "lonrange" must be 180. Only considering this rules will produce resonable maps.
If "lon" is not equal 0, at the left and right side to much of the country contours will be drawn. The area of the weather data is absolutly correct.
With "robinson" a world map in robinson projection will be generated:
"lat" must be 0. "latrange" must be 180. With "lon" the map can be rotated around the poles. "lon" has to be between -180 and 180. "lonrange" must be 180. Only considering this rules will produce resonable maps.
If "lon" is not equal 0, at the left and right side to much of the country contours will be drawn. The area of the weather data is absolutly correct.
Parameter "unit"
The parameter "unit" specifies the unit of the values.
For variables "wind_stream", "wind_barb" or "wind_vector"
Standard value: "unit" = BFT
Accepted values: BFT, m/s, km/h, kn or mph
Beaufort (BFT), meters per second (m/s), kilometers per hour (km/h), miles per hour (mph).
For "air_temperatur"
Standard value: "unit" = C
Accepted values: C, F, K
degree Celsius (C), degree Fahrenheit (F), degree Kelvin (K).
For "surface_pressure"
Standard value: "unit" = hPa
Accepted values: hPa, mbar, mmHg, inHg, Torr, psi
hektopascal (hPa), millibar (mbar), millimeter of mercury (mmhG), inch of mercury (inhG), Torr (Torr), pounds per square inch (psi)
For "precipitation"
Standard value: "unit" = mm/h
Accepted values: mm/h, in/h
millimeter per hour, equal to liter per squaremeter per hour (mm/h), inch per hour (in/h)
For "significant_wave_height"
Standard value: "unit" = m
Accepted values: m, ft
meter (m), feet (ft)
For example wind_stream for Seattle, USA:
Parameter "display_type"
For variables "air_temperatur",
Standard value: "display_type" = contour
Accepted values: contour or shaded
The parameter "display_type" specifies if the desired parameter is visualised in contours or shaded.
For example Seattle, USA:
Individual and highly configurable forecast maps can be requested. They are very useful for integration in web pages, software or apps.
A detailed explanation of the parameters for the configuation you can find here: Individual forecast maps - parameters
The individual forecasts are available for the following variables:
wind_stream:
Visualisation of the average wind speed in 10m height.
The direction of the strem lines is in downwind direction. The color shows the wind intensity in the desired unit.
Example:
wind_barb:
Visualisation of the average wind speed in 10m height.
The direction of the barb is in upwind direction. The color shows the wind intensity in the desired unit.
Example:
wind_vector:
Visualisation of the average wind speed in 10m height.
The direction of the arrow is in downwind direction. The color and the lenght of the arrow are showing the wind intensity in the desired unit
Example:
gust:
Visualisation of the gust speed.
The color shows the gust intensity in the desired unit.
Example:
air_temperature:
Visualisation of the temperature in 2m height.
The color specifies the value of the temperature in the desired unit.
Example:
surface_pressure:
Visualization of the atmospheric pressure by isobars in the desired unit.
The isobars are lines with the same atmospheric pressure.
The color indicates the atmospheric pressure in the desired unit.
Example:
cloud_cover:
Visualization of the cloud cover.
The color indicates the value of the cloud cover in %.
Example:
relative_humidity:
Visualization of the relative humidity.
The color indicates the value of the relative humidity in %.
Example:
precipitation:
Visualization of the precipitation.
The color indicates the value of the precipitation in the desired unit.
Example:
significant_wave_height:
Visualization of the significant wave height.
The color indicates the value of the significant wave height in the desired unit.
Example:
primary_wave_height_direction:
Visualization of the significant wave height and direction.
The direction of the arrows points into the moving direction of the wave, the color indicates the value of the significant wave height in the desired unit.
Example:
primary_wave_period:
Visualization of the significant wave period.
The color of the shading indicates the period time of the significant waves.
Example:
wind_wave_height_direction:
Visualization of the wind wave height and direction.
The direction of the arrows points into the moving direction of the wind waves, the color indicates the value of the wind waves height in the desired unit.
Example:
wind_wave_period:
Visualization of the significant wave period.
The color of the shading indicates the period time of the wind waves.
Example:
swell_height_direction:
Visualization of the swell height and direction.
The direction of the arrows points into the moving direction of the swell, the color indicates the value of the swell height and direction in the desired unit.
Example:
swell_period:
Visualization of the swell period.
The color of the shading indicates the period time of the swell.
Example:
sea_surface_current:
Visualization of the Sea surface current.
The color of the shading indicates the speed of the current.
Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated.
Example:
sea_surface_temperature:
Visualization of the Sea surface temperature.
The color of the stream lines indicates the sea surface temperature.
Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated.
Example:
sea_ice_coverage:
Visualization of the Sea ice coverage.
The color of the shading indicates the sea surface caverage.
Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated. The ice covered area is calculated only by the influence of the energy balance of the ocean (Wind and currents are ignored.) and can be partly significantly different compared with the reality.
Example:
sea_ice_thickness:
Visualization of the Sea ice thickness.
The color of the shading indicates sea ice thickness.
Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated. The ice thickness of the ice is calculated only by the influence of the energy balance of the ocean (Wind and currents are ignored.) and can be partly significantly different compared with the reality.
Example: