Optional SAGA GIS support

SAGA GIS provides a comprehensive set of geoscientific methods and spatial algorithms. The optional SAGA GIS support is available since ZOO-Project 1.5. It allows to execute the SAGA Modules directly as ZOO WPS Services thanks to a ZOO-Kernel specific internal mechanism which is detailed in this section.

Note

SAGA GIS logo SAGA GIS is the System for Automated Geoscientific Analyses. Learn more on official website.

Installation and configuration

Follow the step described bellow in order to activate the ZOO-Project optional SAGA GIS support.

Prerequisites

Installation steps

Compile ZOO-Kernel using the configuration options as shown bellow:

cd zoo-kernel
autoconf
./configure  --with-saga=/usr/local/ --with-saga-version=7
make

And copy the newly created zoo_loader.cgi to /usr/lib/cgi-bin.

Note

The --with-saga-version option let you set the major version number of SAGA-GIS.

cp zoo_loader.cgi /usr/lib/cgi-bin

Configuration steps

Services configuration file

Building the saga2zcfg utility is required to activate the available SAGA-GIS Modules as WPS Services. This can be done using the following command:

cd thirds/saga2zcfg
make

The following commands will then generate all the needed zcfg files for the available SAGA-GIS Modules:

mkdir zcfgs
cd zcfgs
../saga2zcfg
mkdir /location/to/your/cgi-bin/SAGA
cp *zcfg /location/to/your/cgi-bin/SAGA

Test requests

The SAGA-GIS Modules should be listed as available WPS Services when runing a GetCapabilities request, as follow:

http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS

Each SAGA-GIS Service can then be described individually using the DescribeProcess request, as for example:

http://localhost/cgi-bin/zoo_loader.cgi?request=DescribeProcess&service=WPS&version=1.0.0&Identifier=SAGA.garden_fractals.1

And executed according to your needs. The following example executes SAGA.garden_fractals.1 with no optional parameter:

http://localhost/cgi-bin/zoo_loader.cgi?request=Execute&service=WPS&version=1.0.0&Identifier=SAGA.garden_fractals.1&DataInputs=&ResponseDocument=RESULT@mimeType=application/json@asReference=true

Note

The common ZOO GetStatus requests also work when using the SAGA-GIS Modules as WPS Services.