MeteoIODoc 20240411.d3bdb3cb
IMIS

Format

This plugin reads data directly from the IMIS network database (Oracle database). It retrieves standard IMIS data as well as ENETZ and ANETZ data.

In order to compile this plugin, you need to install Oracle's OCCI which is bundled with some versions of the instant client. By default when compiling, MeteoIO will search for the dynamic library in the PATH environment variable (on Windows) or in subdirectories of the path pointed to by the ORACLE_HOME environment variable (Linux, MacOS). Please be aware that the development version of occi must be installed (so it contains the headers) as well as libaio (from your package manager on Linux).

Units

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²

Keywords

This plugin uses the following keywords:

  • COORDSYS: input coordinate system (see Coords) specified in the [Input] section
  • COORDPARAM: extra input coordinates parameters (see Coords) specified in the [Input] section
  • COORDSYS: output coordinate system (see Coords) specified in the [Output] section
  • COORDPARAM: extra output coordinates parameters (see Coords) specified in the [Output] section
  • DBNAME: the database to connect to. There are two possibilities:
    • as a symbolic name as defined in the tnsnames.ora Network Configuration File provided by the Database administrator (exemple: sdbo);
    • as //hostname:port/service_name (exemple: //sdbo.wd.op:1521/sdbo.slf.ch).
  • DBUSER: user name to use when connecting to the database
  • DBPASS: password to use when connecting to the database
  • STATION#: station code for the given number #
  • USEANETZ: use ANETZ stations to provide precipitations for normal IMIS stations. Almost each IMIS station is associated with one or two ANETZ stations and does a weighted average to get what should be its local precipitations if no local precipitation has been found (either nodata or 0), default: false.
  • USE_IMIS_PSUM: if set to false (default), all IMIS precipitation will be deleted (since IMIS stations don't have heated rain gauges, their precipitation measurements are not good in winter conditions). If set to true, the precipitation measurements will be accepted from IMIS stations. In this case, it is strongly advised to apply the filter FilterUnheatedPSUM to detect snow melting in the rain gauge. ANETZ stations are unaffected (their precipitation is always used), default: false.
  • USE_SNOWPACK_PSUM: if set to true, the SNOWPACK simulated Snow Water Equivalent from the database will be used to compute PSUM. Data gaps greater than 3 hours on SWE will lead to unchanged psum while all data that can properly be computed will overwrite psum. (default=false)

It is possible to use both USE_IMIS_PSUM and USE_SNOWPACK_PSUM to create composite PSUM (from SNOWPACK in the snow season and from IMIS otherwise). In such a case, as soon as SNOWPACK SWE > 0, all previous PSUM data will be deleted (ie those potentially coming from IMIS_PSUM). But if there is no SNOWPACK data, the IMIS measurements will be kept.

[Input]
METEO = IMIS
USEANETZ = true
USE_IMIS_PSUM = true
DBNAME = sdbo
DBUSER = xxx
DBPASS = xxx
STATION1 = WFJ2
STATION2 = *SIO
STATION3 = *MVE