fdb5lib 5.21.4.21

"fdb5lib"

[!IMPORTANT] This software is Graduated and subject to ECMWF's guidelines on Software Maturity.

FDB

FDB (Fields DataBase) is a domain-specific object store developed at ECMWF for storing, indexing and retrieving GRIB data. Each GRIB message is stored as a field and indexed trough semantic metadata (i.e. physical variables such as temperature, pressure, ...). A set of fields can be retrieved specifying a request using a specific language developed for accessing MARS Archive

FDB consists of several artefacts:

libfdb.so

In-process database with C++ API

fdb-tools

Commandline tools to interact with FDB trough CLI tools

z3fdb

A python-zarr v3 store implementation that provides a virtual zarr store from FDB.

Requirements

Runtime dependencies:

eccodes : http://github.com/ecmwf/eccodes

eckit : http://github.com/ecmwf/eckit

metkit : http://github.com/ecmwf/metkit

Build dependencies:

CMake : For use and installation see http://www.cmake.org/

ecbuild : ECMWF library of CMake macros ()

Installation

fdb employs an out-of-source build/install based on CMake.

Make sure ecbuild is installed and the ecbuild executable script is found ( which ecbuild ).

Now proceed with installation as follows: :

# Environment --- Edit as needed
srcdir=$(pwd)
builddir=build
installdir=$HOME/local  

# 1. Create the build directory:
mkdir $builddir
cd $builddir

# 2. Run CMake
ecbuild --prefix=$installdir -- -DCMAKE_INSTALL_PREFIX=</path/to/installations> $srcdir

# 3. Compile / Install
make -j10
make install

How to reference FDB5

Two publications, co-authored by Simon D. Smart, Tiago Quintino, Baudouin Raoult describe fdb architecture and have been presented at PASC'17 A Scalable Object Store for Meteorological and Climate Data and PASC'19 A High-Performance Distributed Object-Store for Exascale Numerical Weather Prediction and Climate

In the following the two BibTeX snippets: :

@inproceedings{10.1145/3093172.3093238,
   author    = {Smart, Simon D. and Quintino, Tiago and Raoult, Baudouin},
   title     = {A Scalable Object Store for Meteorological and Climate Data},
   year      = {2017},
   isbn      = {9781450350624},
   publisher = {Association for Computing Machinery},
   address   = {New York, NY, USA},
   url       = {https://doi.org/10.1145/3093172.3093238},
   doi       = {10.1145/3093172.3093238},
   booktitle = {Proceedings of the Platform for Advanced Scientific Computing Conference},
   articleno = {13},
   numpages  = {8},
   location  = {Lugano, Switzerland},
   series    = {PASC ’17}
}

@inproceedings{10.1145/3324989.3325726,
   author    = {Smart, Simon D. and Quintino, Tiago and Raoult, Baudouin},
   title     = {A High-Performance Distributed Object-Store for Exascale Numerical Weather Prediction and Climate},
   year      = {2019},
   isbn      = {9781450367707},
   publisher = {Association for Computing Machinery},
   address   = {New York, NY, USA},
   url       = {https://doi.org/10.1145/3324989.3325726},
   doi       = {10.1145/3324989.3325726},
   booktitle = {Proceedings of the Platform for Advanced Scientific Computing Conference},
   articleno = {16},
   numpages  = {11},
   location  = {Zurich, Switzerland},
   series    = {PASC ’19}
}