MeteoIODoc  MeteoIODoc-2.6.0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
GSN

Format

This plugin reads meteorological data from GSN (Global Sensor Network, see GSN home page) via the RESTful web service. To compile the plugin you need to have the CURL library with its headers present.

Field mapping

Since a lot of virtual sensors in GSN rely on parameters named with fully free text, it is necessary to map some possible names to one of MeteoIO's standard parameters. Although this plugin tries to cover as many cases as possible, it is still possible that some names would fail to be mapped to a standard parameter. In such as case, the full GSN name will be used. This means that although the data will be properly read, it will probably not be usable by a numerical model. Several solutions could then be applied:

  • rename the parameter in GSN in line with the names that are already recognized by this plugin;
  • run a small test (for example with the example "meteo_reading") in order to identify the names that are not recognized, then configure MeteoIO to copy these parameter into a standard name (see raw data editing).

Units

The units of measurements are sometimes listed in the response headers, they are then parsed by the plugin and if known, like °C or %, offsets and multipliers are set to convert the data to MKSA

Otherwise the units are assumed to be the following:

  • temperatures in celsius
  • relative humidity in %
  • wind speed in m/s
  • precipitations in mm/h
  • radiation in W/m²
  • time is provided as a Unix timestamp, which is always in UTC

Keywords

This plugin uses the following keywords:

  • COORDSYS: input coordinate system (see Coords) specified in the [Input] and/or [Output] sections
  • COORDPARAM: extra input coordinates parameters (see Coords) specified in the [Input] and/or [Output] sections
  • GSN_URL: The URL of the RESTful web service e.g. http://montblanc.slf.ch:22001/rest
  • GSN_USER: The username to access the service (optional)
  • GSN_PASS: The password to authenticate the USER (optional)
  • STATION#: station code for the given station, e. g. la_fouly_1034 (case sensitive!)
  • GSN_TIMEOUT: timeout (in seconds) for the connection to the server (default: 60s)
  • GSN_DEBUG: print the full requests/answers from the server when something does not work as expected

If no STATION keys are given, the full list of ALL stations available to the user in GSN will be used! This may result in a very, very long download.

METEO = GSN
GSN_URL = http://montblanc.slf.ch:22001/rest
GSN_USER = mylogin
GSN_PASS = mypasswd
STATION1 = wind_tunnel_meteo