CATS build instructions
About CATS
CATS is written in C. It has been mostly used tested under Linux, but a Windows version is also
available. The Windows version is currently cross-compiled using mingw on Linux. It should be
theoretically be possible to build CATS on Windows, either native, or using Windows Subsystem for
Linux (WSL).
Please note that the cross-compiled version performs worse than a native build.
The installation instructions below refer to Linux.
Build requirements
CATS depends on two external libraries:
and optionally on an
- MPI implementation (MPICH, openMP)
CATS used GDAL for reading and writing raster files and GDAL for random number generation
and eigenvalue/vector calculations.
Building CATS on Windows
The Windows version is currently cross-compiled using mingw on Linux. It should be
theoretically be possible to build CATS on Windows, either native, or using Windows Subsystem for
Linux (WSL).
To build CATS from source, you will also need a C compiler (only gcc is so far tested) and
Cmake (https://cmake.org/) and optionally git to check out the code.
Installing requirements on Fedora
On Fedora Linux, you can install the required packages with dnf:
sudo dnf install gdal gdal-devel gsl gsl-devel cmake gcc
and optionally MPI:
sudo dnf install mpich mpich-devel
or
sudo dnf install openmpi openmpi-devel
Installing requirements on Ubunut (untested)
The corresponding commands should be
sudo apt-get install libgdal-dev gdal-bin gsl-bin libgsl-dev gcc cmake
sudo apt-get install mpi-default-bin mpi-default-dev
Getting the source code
The CATS git repository is available at https://gitlab.phaidra.org/bdc/cats from where you can
download the source code as zip or tar.gz file.
Alternatively, you can clone the repository with git:
git clone https://gitlab.phaidra.org/bdc/cats
Building CATS with Cmake
After cloning CATS or extracting the downloaded source code, change to the directory where
this document is located. In this directory, create a new directory called build.
mkdir build
cd build
cmake ..
If everything goes well, you can build CATS using make
make
Otherwise, please refer to the error messages of cmake and make.
The binaries are found in the bin directory in build directory:
cats
ahd
cats-mpi
if MPI support was found installed.
Running CATS
See the quick start guide, found at https://cats.univie.ac.at