MeteoIODoc 20240227.fb5b3765
How to build your io.ini configuration file

As shown in config_doc , the operation of MeteoIO is driven by a configuration file. Please note that it is highly recommended to use inishell to build your io.ini configuration file, since this significantly reduces the number of errors and provides help text for each keys.

Anyway, this section will show you how to manually set up a configuration file. Please read General concepts documentation page before starting!

You first need to create the various sections:

  • [General] : The documentation about this section is found in Config. It currently contains some buffering keys (see BufferedIOHandler).
  • [Input] : This section contains the list of all the plugins that you want to use as well as their parameters. You can use one plugin for the meteorological data (key=METEO), one for grids (key=GRID2D), one for the Points Of Interest (key=POI), one for data assimilation (key=DA), one for landuse (key=LANDUSE) and one for Digital Elevation Model (key=DEM). Please see IO plugins for the available plugins. Afterwards, each plugin comes with its own set of keys, as specified in the plugin's documentation. Morevover, the geographic coordinate system should often be specified, as explained in Available coordinate systems as well as a fallback time zone (so if some time information comes without a time zone, it will use the one declared in this section).
  • [InputEditing] : Through keys configured in this section, it is possible to perform some editing on the input meteorological timeseries, see Input Data Editing as well as various kind of spatial resampling (see Spatial resampling and regridding handling).
  • [Output] : This section is very similar to the [Input] section, but (obviously) for outputing the data.
  • [Filters] : This section lists the pre-processing that has to be performed on the incoming meteorological data. It builds a stack of processing elements one after the other one, for each meteorological parameter. See Processing overview for more information.
  • [Interpolations1D] : This section deals with temporal resampling of the incoming meteorological data. The goal is to be able to take in data at any sampling rate and to extract values at any user given time step according to the resampling specifications of the user. The search window size can be given with key WINDOW_SIZE that expresses (in seconds) how far a valid point can be searched for when re-interpolating a missing value (up to WINDOW_SIZE/2 before and after the requested point). See Resampling overview .
  • [Interpolations2D] : This section deals with the spatial interpolation of meteorological data, based on a provided Digital Elevation Model. The goal is to populate two dimensional grids with meteorological parameters from point measurements, according to the specifications of the user. See Spatial interpolations .
  • [GridInterpolations1D] : This section is for temporal resampling between existing gridded data.

The application that you are using might also need its own section(s), check this with your application.