meteoio

Getting-started

Table of Content

How to get started with MeteoIO

Introduction

First, we would thank you for your interest in MeteoIO. As primarily a library, MeteoIO is:

  • a way to easily integrate meteorological data into an application
  • an easy and robust way to automatically and transparently handle meteo data
  • a toolbox at your disposal for enhancing your application

It is not per see an end user application or a graphical user interface to meteorological data but it comes with a command line application (meteoio_timeseries, see below) and can be directly used from within the Inishell Graphical User Interface. When using Inishell, you get the best of both worlds: a user friendly GUI while still keeping the possibility to run the generated ini configuration file in batch mode.

This document will now explain you how to download MeteoIO, how to compile it according to your needs and how to find your way in its code and documentation. Please consider using the Inishell GUI (as it helps reduce configuration errors and provides an easy access to the documentation) and it is also a good idea to have a good text editor at hand (to edit input or output files). You can for example use Atom (multi plateform), Kate for Linux or Notepad++ for Windows.

Getting MeteoIO

See page Getting-MeteoIO.

Compiling MeteoIO

See page Compiling-MeteoIO.

Standalone applications

In the "bin" subdirectory, there is a small standalone application "meteoio_timeseries" that can be used to process timeseries from the command line. This application can directly be called from the Inishell Graphical User Interface.

Moreover, a few very simple applications are provided in doc/examples and can prove useful:

  • data_converter reads data with one plugin, processes it and writes it back with another plugin (so it can convert between data formats). It takes as arguments a starting date, end date and a timestep (in hours);
  • 2D_interpolations produces 2D grids (maps) at the provided timestamp;
  • meteo_reading just prints on the screen the processed data at the provided timestamp.

Getting help

See page GettingHelp.

From a binary package

An HTML documentation is available in the MeteoIO installation directory, in doc/html/index.html. Binary packages might have installed a link to this file in your start menu. A few code examples, with a very simple Makefile and some test input data are also part of the documentation. You will find them in the MeteoIO installation directory, in doc/examples.

From a source installation

A full doxygen documentation exists and is available starting in doc/MeteoIO_doc.html. If this documentation would not be part of your package, follow the instructions in Compiling-MeteoIO, section "Generating the documentation".

you can regenerate it by typing "make doc" (you need doxygen installed on your system). In this documentation, you are encouraged to follow the "quick overview" link in order to get a general overview of the domains covered by MeteoIO. A few code examples are provided in doc/examples and can be a good starting point for experimenting with the library (although these examples are voluntarily very simple and in no way replace the proper documentation!).

From a documentation only package

If you have a source package but don't want to install doxygen, you can get a documentation only package. This is part of the various downloads that are offered with each release. It contains the html documentation as well as the code examples.

External links

The online documentation for the latest stable release is available.