Metview's documentation is now on readthedocs!


This icon performs an ODB/SQL query on an ODB database (ODB-1) or file (ODB-2). The result is always an ODB file (in ODB-2 format).

From Macro/Python the icon can be called as odb_filter().

A tutorial about using ODB in Metview can be found here.

What is ODB?

ODB is a database developed at ECMWF to store and retrieve large volumes of meteorological observational and feedback data efficiently for use within the IFS.

Currently, ODB comes in two flavours:

  • ODB-1 (the original hierarchical table format capable of running in a parallel environment within IFS)
  • ODB-2 (a new flat format with a modern API used for archiving in MARS).

Gallery Examples using ODB Filter

The ODB Filter Editor

ODB Filename

Specifies the path to the input ODB

ODB Data

Specifies the input ODB as an icon. If both an icon (in ODB Data) and a filename (in ODB Filename) are specified the icon takes precedence.

ODB Query

Specifies the ODB/SQL query to run.


Specifies the maximum number of rows in the result. If -1 is given here the number of rows is not limited in the output. The default value is -1.

Fail On Empty Output

When it is set to No the icon will not fail if the resulting ODB is empty (in Macro the return value is nil while in Python it is None). Otherwise when it is set to Yes the icon will fail on empty output. The default value is Yes.