ECMWF's GRIB and BUFR decoding/encoding library
Go to file
Shahram Najm 46bda29a22 grib_util_set_spec: Refactoring 2021-02-15 19:05:36 +00:00
.github/workflows
.settings
bamboo
cmake Build: openjpeg 2.4.0 2020-12-29 13:37:42 +00:00
config
confluence
data ECC-1197: grib_get_data: Words on the first line should be separated by spaces not commas 2021-02-02 18:25:49 +00:00
definitions Definitions: formatting/comments 2021-02-15 14:44:27 +00:00
doxygen
examples Examples: Fortran formatting (https://github.com/pseewald/fprettify) 2021-02-14 18:14:39 +00:00
experimental
fortran Fortran API: formatting (https://github.com/pseewald/fprettify) 2021-02-15 12:46:59 +00:00
html
ifs_samples
m4
memfs
perf
python
rpms
samples
share/eccodes
src grib_util_set_spec: Refactoring 2021-02-15 19:05:36 +00:00
tests Testing: check surface types too. Cater for keys not present 2021-02-11 15:02:11 +00:00
tigge
tools Tools: clang-format 2021-02-07 22:06:42 +00:00
windows/msvc
.appveyor.yml Bump up version 2021-01-19 13:35:09 +00:00
.clang-format
.cproject
.gitignore
.project
.travis.yml GitHub CI: remove ENABLE_PYTHON=0 (By default Python2 is disabled) 2020-12-22 19:34:54 +00:00
AUTHORS
CMakeLists.txt Bump up version 2021-01-19 13:35:09 +00:00
COPYING
ChangeLog
INSTALL
LICENSE
Makefile.am
NEWS
NOTICE
README.md
acinclude.m4
autogen.sh
configure.ac ECC-1189: CMake: Rename option GRIB_TIMER to ECCODES_TIMER 2021-01-06 17:49:43 +00:00
eccodes-import.cmake.in
eccodes.code-workspace
eccodes.sublime-project
eccodes_config.h.in ECC-1189: CMake: Rename option GRIB_TIMER to ECCODES_TIMER 2021-01-06 17:49:43 +00:00
memfs.py
project_summary.cmake
show_compile.sh
tox.ini
version.sh Bump up version 2021-01-19 13:35:09 +00:00

README.md

ecCodes

Linux & macOS: master Linux & macOS: develop Windows: master Windows: develop

ecCodes is a package developed by ECMWF which provides an application programming interface and a set of tools for decoding and encoding messages in the following formats:

  • WMO FM-92 GRIB edition 1 and edition 2
  • WMO FM-94 BUFR edition 3 and edition 4
  • WMO GTS abbreviated header (only decoding)

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.

Documentation can be found here: https://software.ecmwf.int/wiki/display/ECC/ecCodes+Home

INSTALLATION

  1. Download ecCodes from https://software.ecmwf.int/wiki/display/ECC/Releases

  2. Unpack distribution:

    tar -xzf eccodes-x.y.z-Source.tar.gz
    
  3. Create a separate directory to build ecCodes:

    mkdir build
    cd build
    
  4. Run cmake pointing to the source and specify the installation location:

    cmake  ../eccodes-x.y.z-Source -DCMAKE_INSTALL_PREFIX=/path/to/where/you/install/eccodes
    

    It is strongly recommended that you install into a clean directory

  5. Compile, test and install:

    make
    ctest
    make install
    

To add the Python3 bindings, use pip3 install from PyPI as follows:

pip3 install eccodes

or

pip3 install --install-option="--prefix=/path/to/where/you/install/eccodes" eccodes

For more details, please see: https://software.ecmwf.int/wiki/display/ECC/ecCodes+installation

If you encounter any problems please send an e-mail with your problem to:

Software.Support@ecmwf.int

(C) Copyright 2005- ECMWF.

This software is licensed under the terms of the Apache Licence Version 2.0 which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.

In applying this licence, ECMWF does not waive the privileges and immunities granted to it by virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.