Installation

There are three components to gridpp: The gridpp command-line tool, the gridpp library, and the gridpp python package.

Required dependencies

• Boost >= 1.59
• Armadillo >= 6.6
• GNU Scientific Library
• Netcdf

On Ubuntu Bionic, these can be installed like this:

sudo apt-get update
sudo apt-get install libboost-all-dev
sudo apt-get install libgsl0-dev libblas-dev
sudo apt-get install netcdf-bin libnetcdf-dev
sudo apt-get install cmake
sudo apt-get install libarmadillo6 libarmadillo-dev

Note that Ubuntu Xenial only has Armadillo 6.5 in its apt repository. In that case you need to install Armadillo 6.6 or later manually.

Installing the python interface to gridpp only

The python package is available on pypi.org. Provided you have installed the dependencies listed above, you can install the python package as follows:

pip3 install gridpp --user

Full gridpp installation from source

1. Either download the source code from the latest release, unzip the file and navigate into the extracted folder; or clone the repo from github.

2. Create a build directory

mkdir build

3. Run cmake to set up installation

cd build
cmake ..

This will set up the gridpp command-line tool to be installed in /usr/local/bin on Ubuntu. To specify a custom installation path, use:

cmake .. -DCMAKE_INSTALL_PREFIX=<custom path>

4. Run cmake to install

cmake --build .
cmake --build . --target install

Installing from debian packages

Follow instructions here: https://launchpad.net/~metno/+archive/ubuntu/gridpp

Additional dependencies for developing the code

Optional: If you are developing the code, install the google test library:

sudo apt-get install libgtest-dev
sudo apt-get install lcov
sudo sudo gem install coveralls-lcov

Change the cmake step above to the following:

cmake .. -DCMAKE_BUILD_TYPE=DEBUG -DENABLE_TESTS=ON -DGTEST_DIR=/usr/src/gtest

where /usr/src/gtest is the location of the google test library code.