You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

Please note that ecCodes is provided as beta version and some of its functions and tools can be changed prior to the first full release. Nevertheless the new BUFR decoding feature has been extensively tested with a wide variety of BUFR data. This version is still affected by some limitations on BUFR encoding.

ecCodes is an application program interface developed by ECMWF for decoding and encoding messages in the following formats:

A useful set of command line tools provide quick access to the messages. C, Fortran 90 and Python interfaces provide access to the main ecCodes functionality.

ecCodes is an evolution of GRIB-API.  It is designed to provide the user with a simple set of functions to access data from several formats with a key/value approach.

For GRIB encoding and decoding, the GRIB-API functionality is provided fully in ecCodes with the same user interface and behaviour. Interfaces for C, Fortran 90 and Python are all maintained as in GRIB-API.  However, the GRIB-API Fortran 77 interface is no longer available.

In addition, a new set of functions with the prefix "codes_" is provided to operate on all the supported message formats. These functions have the same interface and behaviour as the "grib_" functions. 

A selection of GRIB-API tools  has been included in ecCodes (ecCodes GRIB tools), while new tools are available for the BUFR (ecCodes BUFR tools) and GTS formats. The new tools have been developed to be as similar as possible to the existing GRIB-API tools maintaining, where possible, the same options and behaviour. A significant difference compared with GRIB-API tools is that bufr_dump produces output in json format which can be used in many web based applications.

Migration from GRIB-API to ecCodes is expected to be transparent for current GRIB-API users. The GRIB-API library is fully available in the ecCodes library.  Users are encouraged to test their GRIB-API applications by linking with the ecCodes library and to provide feedback of any problems encountered.

Name clashes prevent a simultaneous use of the GRIB-API and ecCodes libraries. For this reason, and to simplify the software maintenance, it is planned to replace the GRIB-API library by ecCodes in a timeframe of the order of one year.  The "grib_" functions will, however, be maintained in the ecCodes library.

A similar name clash is also present between the existing GRIB-API tools and the new tools provided with ecCodes. However, the behaviour of the tools is exactly the same as those provided with the current version of GRIB-API.

Currently, ecCodes includes GRIB-API version 1.14.3.  It will be updated to include new GRIB-API releases until ecCodes replaces GRIB-API.

 

  • No labels