Since MeteoIO is a library, you, as an end user, will not be directly exposed to it: the library is called by the program that you are using, not directly by yourself. You will basically have to set some parameters in a configuration file that defines how MeteoIO has to behave. This configuration file is often named "io.ini" and follows the INI file format standard.
It is highly recommended that you first understand the general structure of MeteoIO before moving forward. We will then show the configuration file syntax and then the configuration file structure.
The configuration inputs/outputs file is divided in sections. Each section name is enclosed in brackets.
Within each section, you might have comments and/or key/value pairs. The comments start with a "#" or a ";" sign and run until the end of the line. A whole line might be commented out, or only a fraction of it. A key/value pair is a keyword, followed by a "=" sign, followed by the value to associate with this key.
A valid value can be an integer, a float, or string, a list of keywords, a mixed list of keywords and numbers...
A value can also be an environment variable, another key or an arithmetic expression (see the Config class documentation for more details):
MeteoIO imposes a minimum structure to the configuration file: It must contain the [General], [Input] and [Output] sections. If any filter is to be used, a [Filters] section has to be present and if any spatial interpolation is to be used, an [Interpolations2D] section has to be present. A minimal set of keys has to be there, and potentially a number of optional keys. Moreover, the program that you are using might also impose you some specific keys or sections. The keys and their location in the configuration file (ie: to which section they belong) depends on the module that is actually using them. The optional keys depend on the specific options handled by each specific module (or plugin, or algorithm). Therefore, we can draw the following skeleton:
It is also possible (for advanced use) to import another configuration file, see in the Config class documentation.
As can be seen from the previous example, each plugin, each filter or each interpolation algorithm might have its own parameters. Therefore, this is the documentation of each specific plugin/filter/algorithm that has to be used in order to figure out what can be configured when it is used (see the next sections in the welcome page).