mirror of https://github.com/ecmwf/eccodes.git
81 lines
3.1 KiB
Plaintext
81 lines
3.1 KiB
Plaintext
/*! \page installation GRIB API installation
|
|
GRIB API installation is based on the standard configure utility. It is tested on several platforms
|
|
and with several compilers. However for some platforms modifications to the installation
|
|
engine may be required. If you encounter any problem during the installation procedure please
|
|
send an e-mail with your problem to Software.Support@ecmwf.int.
|
|
|
|
The only required package for a standard installation is
|
|
<a href="http://www.ece.uvic.ca/~mdadams/jasper/">jasper</a> which enables the jpeg2000
|
|
packing/unpacking algorithm. It is possible to build GRIB API without jasper, by using the
|
|
--disable-jpeg configure option, but to install a fully functional library, its download is recommended.
|
|
|
|
|
|
\section standard_installation Standard installation
|
|
-# Download GRIB API from <a href="http://www.ecmwf.int/products/data/software/download/grib_api.html">ECMWF web site</a>.
|
|
-# Unpack distribution:
|
|
\code
|
|
> gunzip grib_api-X.X.X.tar.gz
|
|
> tar xf grib_api-X.X.X.tar
|
|
\endcode
|
|
-# Create the directory where to install GRIB API say \e grib_api_dir
|
|
\code
|
|
> mkdir grib_api_dir
|
|
\endcode
|
|
-# Run the configure in the grib_api-X.X.X
|
|
\code
|
|
> cd grib_api-X.X.X
|
|
> ./configure --prefix=grib_api_dir
|
|
\endcode
|
|
Please give the full path of grib_api_dir to the prefix option.
|
|
-# make, check and install
|
|
\code
|
|
> make
|
|
...
|
|
> make check
|
|
...
|
|
> make install
|
|
...
|
|
\endcode
|
|
|
|
\section parameters_installation Parameter files installation
|
|
The following instructions are valid only if you have already
|
|
installed GRIB API and you need to update the current parameter files.
|
|
The parameter files should work with any version of GRIB API.
|
|
|
|
To install the parameter files, then please unpack the downloaded archive
|
|
in the definition files folder of your GRIB API installation, i.e.:
|
|
|
|
\code
|
|
> cd definitions
|
|
> gunzip grib_api_parameters-vX.tar.gz
|
|
> tar xf grib_api_parameters-vX.tar
|
|
\endcode
|
|
|
|
This process will overwrite any changes you might have done to the parameter files,
|
|
so please do make a backup of the definition files folder before installing the
|
|
downloaded GRIB API parameter files.
|
|
|
|
\section definitions_installation Definition files installation
|
|
The following instructions are valid only if you have already
|
|
installed GRIB API and you need to update the definition files compatible
|
|
with the same library version you have already installed.
|
|
Please note that using the definition files with a version
|
|
of the library different from the one indicated as compatible
|
|
will cause some problems in decoding/encoding.
|
|
|
|
-# Download GRIB API definition files from <a href="http://www.ecmwf.int/products/data/software/download/grib_api.html#definitions">ECMWF web site</a>.
|
|
-# Unpack distribution:
|
|
\code
|
|
> gunzip grib_def-X.X.X.X.tar.gz
|
|
> tar xf grib_def-X.X.X.X.tar
|
|
\endcode
|
|
-# Run the installation script from the grib_def-X.X.X.X directory:
|
|
\code
|
|
./installDefinitions.sh grib_api_dir def_files_dir
|
|
\endcode
|
|
where grib_api_dir is the path to a working installation of
|
|
GRIB API and def_files_dir is the directory where you
|
|
want to install the new version of the defintion files.
|
|
|
|
*/
|