2019-01-08 17:18:02 +00:00
|
|
|
ecCodes
|
|
|
|
|
=======
|
|
|
|
|
|
2023-01-12 11:00:26 +00:00
|
|
|
[](https://github.com/ecmwf/eccodes/actions/workflows/ci.yml?query=branch%3Amaster)
|
|
|
|
|
[](https://github.com/ecmwf/eccodes/actions/workflows/ci.yml?query=branch%3Adevelop)
|
2021-10-12 15:27:27 +00:00
|
|
|
|
2023-01-14 12:17:57 +00:00
|
|
|
[](https://ci.appveyor.com/project/ecmwf/eccodes/branch/master)
|
2023-01-14 17:46:24 +00:00
|
|
|
[](https://ci.appveyor.com/project/ecmwf/eccodes/branch/develop)
|
2019-01-08 17:18:02 +00:00
|
|
|
|
2023-08-03 11:54:06 +00:00
|
|
|
[](https://codecov.io/gh/ecmwf/eccodes)
|
|
|
|
|
|
2016-03-08 17:51:07 +00:00
|
|
|
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:
|
2015-07-31 10:09:59 +00:00
|
|
|
|
2016-03-08 17:51:07 +00:00
|
|
|
* WMO FM-92 GRIB edition 1 and edition 2
|
|
|
|
|
* WMO FM-94 BUFR edition 3 and edition 4
|
2016-10-20 15:58:38 +00:00
|
|
|
* WMO GTS abbreviated header (only decoding)
|
2015-07-31 10:09:59 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
2015-02-20 18:24:13 +00:00
|
|
|
Documentation can be found here:
|
2021-12-20 16:56:02 +00:00
|
|
|
https://confluence.ecmwf.int/display/ECC/ecCodes+Home
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2015-07-30 12:47:16 +00:00
|
|
|
INSTALLATION
|
|
|
|
|
------------
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2021-12-20 16:56:02 +00:00
|
|
|
1. Download ecCodes from https://confluence.ecmwf.int/display/ECC/Releases
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2015-07-30 12:47:16 +00:00
|
|
|
2. Unpack distribution:
|
2019-05-16 11:33:59 +00:00
|
|
|
```
|
|
|
|
|
tar -xzf eccodes-x.y.z-Source.tar.gz
|
|
|
|
|
```
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2020-08-09 12:20:05 +00:00
|
|
|
3. Create a separate directory to build ecCodes:
|
2019-05-16 11:33:59 +00:00
|
|
|
```
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
```
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2015-10-08 09:56:25 +00:00
|
|
|
4. Run cmake pointing to the source and specify the installation location:
|
2019-05-16 11:33:59 +00:00
|
|
|
```
|
|
|
|
|
cmake ../eccodes-x.y.z-Source -DCMAKE_INSTALL_PREFIX=/path/to/where/you/install/eccodes
|
|
|
|
|
```
|
2015-12-02 17:37:00 +00:00
|
|
|
|
2019-01-07 18:01:20 +00:00
|
|
|
It is strongly recommended that you install into a clean directory
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2015-10-08 09:56:25 +00:00
|
|
|
5. Compile, test and install:
|
2019-05-16 11:33:59 +00:00
|
|
|
```
|
|
|
|
|
make
|
|
|
|
|
ctest
|
|
|
|
|
make install
|
|
|
|
|
```
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2019-08-09 15:35:59 +00:00
|
|
|
To add the Python3 bindings, use pip3 install from PyPI as follows:
|
2019-06-12 17:38:12 +00:00
|
|
|
```
|
2020-03-09 17:02:09 +00:00
|
|
|
pip3 install eccodes
|
2019-06-12 17:38:12 +00:00
|
|
|
```
|
|
|
|
|
or
|
2019-06-11 16:15:06 +00:00
|
|
|
```
|
2020-03-09 17:02:09 +00:00
|
|
|
pip3 install --install-option="--prefix=/path/to/where/you/install/eccodes" eccodes
|
2019-06-11 16:15:06 +00:00
|
|
|
```
|
|
|
|
|
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2015-07-30 12:47:16 +00:00
|
|
|
For more details, please see:
|
2021-12-20 16:56:02 +00:00
|
|
|
https://confluence.ecmwf.int/display/ECC/ecCodes+installation
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2023-06-14 10:05:57 +00:00
|
|
|
If you encounter any problems please visit our Support Portal:
|
2016-03-08 17:51:07 +00:00
|
|
|
|
2023-06-14 10:05:57 +00:00
|
|
|
https://support.ecmwf.int
|
2016-03-08 17:51:07 +00:00
|
|
|
|
2015-03-06 17:44:10 +00:00
|
|
|
|
|
|
|
|
|
2013-03-25 12:04:10 +00:00
|
|
|
COPYRIGHT AND LICENSE
|
2015-07-30 12:47:16 +00:00
|
|
|
----------------------
|
2013-03-25 12:04:10 +00:00
|
|
|
|
2020-01-28 14:32:34 +00:00
|
|
|
(C) Copyright 2005- ECMWF.
|
2013-03-25 12:04:10 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
