ECMWF's GRIB and BUFR decoding/encoding library
Go to file
Shahram Najm 31d1171b69 Testing: grib/bufr dump tests with env var ECCODES_DEBUG and ECCODES_LOG_STREAM 2016-08-05 16:01:56 +01:00
.settings Eclipse settings 2016-08-05 15:05:55 +01:00
bamboo Disable parallel builds to overcome intermittent build breaks due to GCC/make bug 2016-07-04 13:41:42 +01:00
concepts Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
config cleanup old unused code. Made json bufr_dump default 2015-02-12 09:14:47 +00:00
confluence Add F90 example 2016-06-28 13:53:14 +01:00
data Copy over files to build area 2016-08-05 11:33:37 +01:00
definitions BUFR datetime extractions implemented for compressed and added test ECC-314 2016-08-04 14:47:30 +01:00
doxygen ECC-200: Inject struct decls by post-processing header file 2016-07-13 17:21:28 +01:00
examples Remove redirect to dev/null in case of errors 2016-08-03 16:32:15 +01:00
examples.dev Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
fortran Fix compiler warning 2016-07-26 16:57:31 +01:00
gaussian_experimental Merge grib api and eccodes - part 4 - src compiles 2014-06-20 18:18:57 +01:00
gribex Merge grib api and eccodes - part 4 - src compiles 2014-06-20 18:18:57 +01:00
html GRIB-902: Update copyright notices: 2015 -> 2016 2015-12-31 12:44:51 +00:00
ifs_samples GRIB-838: Make ifs_samples in build-dir symlinks 2015-09-25 16:47:47 +01:00
java Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
m4 cleanup old unused code. Made json bufr_dump default 2015-02-12 09:14:47 +00:00
memfs Work on memfs 2016-06-18 17:10:19 +01:00
parameters Replace macros/makefile vars to use ECCODES prefix 2015-01-24 22:19:32 +00:00
perf GRIB-902: Update copyright notices: 2015 -> 2016 2015-12-31 12:44:51 +00:00
perl GRIB-902: Update copyright notices: 2015 -> 2016 2015-12-31 12:44:51 +00:00
python Fix compiler warnings [-Wstrict-prototypes] 2016-08-05 12:57:56 +01:00
rpms ECC-72: Discontinue support for Fortran77 2015-02-27 18:21:10 +00:00
samples ECC-295 passing test with 139 bufr test data 2016-07-19 13:59:56 +01:00
share/eccodes Rebranding 2015-02-20 13:54:12 +00:00
src Comment out extraneous debug output 2016-08-05 15:01:35 +01:00
templates Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
tests Testing: grib/bufr dump tests with env var ECCODES_DEBUG and ECCODES_LOG_STREAM 2016-08-05 16:01:56 +01:00
tests.ecmwf Merge grib api and eccodes - part 4 - src compiles 2014-06-20 18:18:57 +01:00
tigge Tigge check updates for UERRA 2016-06-30 15:51:24 +01:00
tools Clean up 2016-08-04 11:07:00 +01:00
windows/msvc Add new files to Visual Studio project 2016-08-03 16:58:48 +01:00
.cproject Update Eclipse settings 2016-07-27 13:12:05 +01:00
.gitignore Remove obsolete test (bufr_filter set_unexpandedDescriptors) 2016-07-21 13:20:23 +01:00
.project Add Eclipse proj files 2014-12-11 14:45:09 +00:00
AUTHORS Update authors 2015-10-01 10:49:55 +01:00
CMakeLists.txt Python does not need libs. OpenJPEG fix for static libs 2016-07-29 18:03:54 +01:00
COPYING Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
ChangeLog Updated the top-level text files with installation info etc 2015-07-30 13:47:16 +01:00
INSTALL Added installation hints 2015-12-09 18:15:38 +00:00
LICENSE Ported grib_api 1.10.4 from p4 to git 2013-03-25 12:04:10 +00:00
Makefile.am Remove grib data from distro 2015-07-09 14:18:08 +01:00
NEWS Use of CMake for installation and new web page 2015-03-06 17:44:10 +00:00
NOTICE Update NOTICE file 2016-04-26 14:55:36 +01:00
README Improve text in README file 2016-03-08 17:51:07 +00:00
VERSION.cmake Bump up version number 2016-06-28 17:45:20 +01:00
acinclude.m4 Fix issue with pthreads test (cast to pointer from integer of different size) 2015-04-17 14:42:00 +01:00
autogen.sh Remove restriction on autoreconf version 2013-08-22 17:01:16 +01:00
configure.ac Rebranding: ABI 2015-02-25 18:11:17 +00:00
eccodes-import.cmake.in GRIB-822 Export samples and definition paths for install and build trees 2015-08-28 14:00:17 +01:00
eccodes.sublime-project Update eccodes.sublime-project 2016-06-18 23:16:33 +01:00
eccodes_config.h.in Work on memfs 2016-06-18 18:01:59 +01:00
license.pl GRIB-902: Update copyright notices: 2015 -> 2016 2015-12-31 12:44:51 +00:00
make_dist_definitions GRIB-446 and GRIB-693: Missing version information in grib_api header files 2015-02-25 17:42:04 +00:00
memfs.py Clean up and debug messages 2016-06-21 14:36:35 +01:00
project_summary.cmake Rebranding 2015-02-20 18:24:13 +00:00
tox.ini ECC-188 Add tox.ini with flake8 configuration 2015-11-12 15:52:26 +00:00
version.sh Bump up version number 2016-06-28 17:45:20 +01:00

README

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 in this release).

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 where 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 recommended that you install into a clean directory

5. Compile, test and install:
   > make
   > ctest
   > make install


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



COPYRIGHT AND LICENSE
----------------------

Copyright 2005-2016 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.