You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Overview

ecCodes uses CMake for compilation and installation. This is a first step towards an homogenisation of the installation procedures for all ECMWF packages.

Like autotools, CMake will run some tests on the user's system to find out if required third-party software libraries are available and note their locations (paths). Based on this information it will produce the Makefiles needed to compile and install ecCodes.

CMake is a cross-platform free software program for managing the build process of software using a compiler-independent method.

Generating the Makefiles with CMake

One nice and highly recommended feature of CMake is the ability to do out of source builds. In this way you can make all your ".o" files, various temporary depend files, and even the binary executables without cluttering up your source tree. To use out of source builds, first create a build directory, then change into your build directory and run cmake pointing it to the source directory and using your own options.

The command gives feedback on what requirements are fulfilled and what software is still required. The following table gives an overview of the different options.  The default (without any options) will compile a shared library only and install it in /usr/local/.

 

CMAKE_INSTALL_PREFIXwhere you want to install your ecCodes/usr/local
CMAKE_BUILD_TYPE

to select the type of compilation:

  • Debug
  • RelWithDebInfo
  • Release
  • Production
RelWithDebInfo
CMAKE_C_COMPILERC Compiler 
CMAKE_C_FLAGSFlags for the C Compiler 
CMAKE_Fortran_COMPILERFortran Compiler 
CMAKE_Fortran_FLAGSFlags for the Fortran Compiler 
ENABLE_NETCDFFor the grib_to_netcdf convert toolAUTO
ENABLE_JPGEnable JPEG2000 support. This option should look for Jasper or OpenJPG

AUTO

ENABLE_PNGEnable PNG support for decoding/encodingOFF
ENABLE_PYTHONOffers the Python interface to the packageAUTO
ENABLE_FORTRANOffers the Fortran interface to the packageAUTO
ENABLE_GRIB_THREADSEnable POSIX threadsOFF
cmake options
doc
default


Note: The compilers can also be overridden by setting the environment variables CC and FC

 

Quick installation guide

Here is an example of a list of commands you could use to install ecCodes.  It is assumed “>” is the shell prompt.

> tar -xzf  eccodes-x.y.z-Source.tar.gz
> mkdir build ; cd build 

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

> make
> make test
> make install

 

Note that for the testing step ("make test") you need to be connected to the internet so data files can be downloaded for the tests. You can however download all the data files in one go (See the data tarball link at the top of the Releases page)


  • No labels