| 1 | .. _kernel-sagagis: |
|---|
| 2 | |
|---|
| 3 | Optional SAGA GIS support |
|---|
| 4 | ====================== |
|---|
| 5 | |
|---|
| 6 | `SAGA GIS <http://orfeo-toolbox.org/otb/>`_ provides a comprehensive set of geoscientific methods and spatial algorithms. The optional SAGA GIS support is available since `ZOO-Project 1.5 <http://zoo-project.org>`__. It allows to execute the `SAGA Modules <http://www.saga-gis.org/saga_module_doc/2.1.4/index.html>`_ directly as ZOO WPS Services thanks to a :ref:`kernel_index` specific internal mechanism which is detailed in this section. |
|---|
| 7 | |
|---|
| 8 | .. note:: |
|---|
| 9 | |
|---|
| 10 | |saga| `SAGA GIS <https://www.orfeo-toolbox.org>`__ is the System for Automated Geoscientific Analyses. Learn more on official `website <http://www.saga-gis.org/en/index.html>`__. |
|---|
| 11 | |
|---|
| 12 | |
|---|
| 13 | .. |saga| image:: ../_static/sagagis.png |
|---|
| 14 | :height: 100px |
|---|
| 15 | :width: 100px |
|---|
| 16 | :scale: 45% |
|---|
| 17 | :alt: SAGA GIS logo |
|---|
| 18 | |
|---|
| 19 | |
|---|
| 20 | Installation and configuration |
|---|
| 21 | ------------------------------ |
|---|
| 22 | |
|---|
| 23 | Follow the step described bellow in order to activate the ZOO-Project optional SAGA GIS support. |
|---|
| 24 | |
|---|
| 25 | Prerequisites |
|---|
| 26 | ..................... |
|---|
| 27 | |
|---|
| 28 | * latest `ZOO-Kernel <http://zoo-project.org/trac/browser/trunk/zoo-project/zoo-kernel>`_ trunk version |
|---|
| 29 | * SAGA GIS (`SAGA-GIS 2.1.4 <http://saga-gis.org>`_ ) |
|---|
| 30 | * libLAS-1.2 (`LibLAS-1.2 <https://github.com/libLAS/libLAS-1.2>`_ ) |
|---|
| 31 | |
|---|
| 32 | Installation steps |
|---|
| 33 | ........................... |
|---|
| 34 | |
|---|
| 35 | .. Note:: These installation steps were successfully tested on Ubuntu 14.4 LTS |
|---|
| 36 | |
|---|
| 37 | Download lastest ZOO-Kernel code from SVN. |
|---|
| 38 | |
|---|
| 39 | .. code-block:: guess |
|---|
| 40 | |
|---|
| 41 | svn checkout http://svn.zoo-project.org/svn/trunk/zoo-kernel zoo-kernel |
|---|
| 42 | |
|---|
| 43 | Then compile ZOO-Kernel using the needed configuration options as shown bellow: |
|---|
| 44 | |
|---|
| 45 | .. code-block:: guess |
|---|
| 46 | |
|---|
| 47 | cd zoo-kernel |
|---|
| 48 | autoconf |
|---|
| 49 | ./configure --with-saga=/usr/local/ |
|---|
| 50 | make |
|---|
| 51 | |
|---|
| 52 | And copy the newly created zoo_loader.cgi to ``/usr/lib/cgi-bin`` : |
|---|
| 53 | |
|---|
| 54 | .. code-block:: guess |
|---|
| 55 | |
|---|
| 56 | cp zoo_loader.cgi /usr/lib/cgi-bin |
|---|
| 57 | |
|---|
| 58 | Configuration steps |
|---|
| 59 | ............................... |
|---|
| 60 | |
|---|
| 61 | Services configuration file |
|---|
| 62 | **************************** |
|---|
| 63 | |
|---|
| 64 | Building the `saga2zcfg |
|---|
| 65 | <http://zoo-project.org/trac/browser/trunk/thirds/otb2zcfg >`_ utility is required to activate the available SAGA-GIS Modules as WPS Services. This can be done using the following command: |
|---|
| 66 | |
|---|
| 67 | .. code-block:: guess |
|---|
| 68 | |
|---|
| 69 | cd thirds/saga2zcfg |
|---|
| 70 | make |
|---|
| 71 | |
|---|
| 72 | The following commands will then generate all the needed zcfg files for the available SAGA-GIS Modules: |
|---|
| 73 | |
|---|
| 74 | .. code-block:: guess |
|---|
| 75 | |
|---|
| 76 | mkdir zcfgs |
|---|
| 77 | cd zcfgs |
|---|
| 78 | ../saga2zcfg |
|---|
| 79 | mkdir /location/to/your/cgi-bin/SAGA |
|---|
| 80 | cp *zcfg /location/to/your/cgi-bin/SAGA |
|---|
| 81 | |
|---|
| 82 | |
|---|
| 83 | Test requests |
|---|
| 84 | ***************** |
|---|
| 85 | |
|---|
| 86 | The SAGA-GIS Modules should be listed as available WPS Services when |
|---|
| 87 | runing a GetCapabilities request, as follow: |
|---|
| 88 | |
|---|
| 89 | http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS |
|---|
| 90 | |
|---|
| 91 | Each SAGA-GIS Service can then be described individually using the DescribeProcess request, as for example: |
|---|
| 92 | |
|---|
| 93 | http://localhost/cgi-bin/zoo_loader.cgi?request=DescribeProcess&service=WPS&version=1.0.0&Identifier=SAGA.garden_fractals.1 |
|---|
| 94 | |
|---|
| 95 | And executed according to your needs. The following example executes *SAGA.garden_fractals.1* with no optional parameter: |
|---|
| 96 | |
|---|
| 97 | 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 |
|---|
| 98 | |
|---|
| 99 | .. note:: |
|---|
| 100 | |
|---|
| 101 | The common ZOO GetStatus requests also work when using the SAGA-GIS Modules as WPS Services. |
|---|
| 102 | |
|---|
| 103 | |
|---|
| 104 | |
|---|
| 105 | |
|---|
