ECMWF's GRIB and BUFR decoding/encoding library
Go to file
Shahram Najm 1db0056878 ECC-1882: GRIB2: Adapt recently added On-Demand DT encodings to fit generalised approach 2024-08-12 09:31:36 +00:00
.github Regression test suite: For tests use the git repo and for DATA/REF point to elsewhere 2024-07-31 15:32:54 +01:00
bamboo Bamboo CIE: Enable extra tools 2024-03-01 23:01:36 +00:00
cmake Add libaec_ROOT as search hint for FindAEC 2023-09-25 09:30:44 +01:00
confluence ECC-1235: Add to Confluence 2021-04-26 14:28:30 +01:00
data ECC-1858: Data encodings parameters are always re-computed 2024-07-30 18:30:46 +01:00
definitions ECC-1882: GRIB2: Adapt recently added On-Demand DT encodings to fit generalised approach 2024-08-12 09:31:36 +00:00
deprecated Deprecated travis yaml 2024-03-07 21:11:32 +00:00
doxygen Doxygen: Fix python version 2022-12-27 13:10:01 +00:00
examples ECC-1868: CMake: Add option for enabling the Geoiterator and nearest neighbour functionality 2024-07-12 09:51:12 +01:00
experimental Remove deprecated files 2023-01-29 18:10:47 +00:00
fortran ECC-1899: API function to allow setting debug level 2024-08-09 14:27:16 +01:00
html Documentation 2022-05-17 13:57:48 +01:00
ifs_samples IFS Samples: GRIB samples with packingType=grid_ieee 2022-06-30 19:09:15 +01:00
memfs ECC-1276: MEMFS: Better management of generated files 2021-08-31 11:38:56 +01:00
samples ECC-1874: GRIB: Sample files for regular Gaussian grids should have jDirectionIncrementGiven=0 2024-07-17 10:38:27 +01:00
share/eccodes Rebranding 2015-02-20 13:54:12 +00:00
src Cosmetics 2024-08-11 12:27:10 +01:00
tests Testing: BUFR descriptor checks 2024-08-10 14:02:42 +01:00
tools tools/bufr_compare_dir: Support directory names with spaces 2024-08-07 19:48:31 +01:00
.appveyor.yml AppVeyor: Disable netcdf 2024-07-05 11:11:54 +01:00
.clang-format Clang-format 2023-02-13 10:36:47 +00:00
.gitignore Prepare migration 2024-03-15 21:07:54 +00:00
AUTHORS Update author list 2024-02-27 10:51:27 +00:00
CMakeLists.txt Enable the 'inline' directive based on ECCODES_HAVE_C_INLINE 2024-07-23 13:16:17 +01:00
COPYING Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
ChangeLog Update URLs 2019-01-28 12:47:22 +00:00
INSTALL Documentation re pip 2024-03-14 16:15:47 +00:00
LICENSE Copyright notices: use new format 2020-01-28 18:07:47 +00:00
NEWS Update URLs 2019-01-28 12:47:22 +00:00
NOTICE Fix WMO URL 2021-12-26 20:30:56 +00:00
README.md Cleanup 2024-04-13 12:32:50 +01:00
VERSION Bump up version 2024-06-22 13:41:52 +01:00
eccodes-import.cmake.in ECC-1143: CMake: Migration to ecbuild v3.4 2020-08-27 16:01:14 +01:00
eccodes.code-workspace Memfs generation 2020-10-19 09:16:24 +01:00
eccodes.sublime-project Update sublime text project 2017-03-17 18:46:27 +00:00
eccodes_config.h.in Enable the 'inline' directive based on ECCODES_HAVE_C_INLINE 2024-07-23 13:16:17 +01:00
memfs.py Performance: Exclude METAR definition files from MEMFS 2022-07-19 12:45:42 +01:00
project_summary.cmake Remove deprecated stuff 2024-01-31 15:57:58 +00:00

README.md

ecCodes

Linux & macOS: master Linux & macOS: develop

Windows: master Windows: develop

codecov

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://confluence.ecmwf.int/display/ECC/ecCodes+Home

INSTALLATION

  1. Download ecCodes from https://confluence.ecmwf.int/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

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

If you encounter any problems please visit our Support Portal:

https://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.