[634] | 1 | .. _kernel-sagagis: |
---|
| 2 | |
---|
| 3 | How To Use the SAGA-GIS support |
---|
| 4 | ============================================= |
---|
| 5 | |
---|
| 6 | :Authors: Nicolas Bozon, Gérald Fenoy, Jeff McKenna |
---|
[635] | 7 | :Last Updated: $Date: 2015-04-24 15:39:26 +0000 (Fri, 24 Apr 2015) $ |
---|
[634] | 8 | |
---|
| 9 | The key idea of the ZOO `SAGA GIS <http://saga-gis.org/>`_ support implementation is to take advantage of the `SAGA-GIS Modules <http://www.saga-gis.org/saga_module_doc/2.1.4/index.html>`_ by using them directly as ZOO-Services, without any modifications. |
---|
| 10 | |
---|
| 11 | Here is an overview of the installation procedure and the required configuration to activate the SAGA-GIS support in ZOO-Project. |
---|
| 12 | |
---|
| 13 | .. contents:: Table of Contents |
---|
| 14 | :depth: 3 |
---|
| 15 | :backlinks: top |
---|
| 16 | |
---|
| 17 | How to make it working ? |
---|
| 18 | ------------------------ |
---|
| 19 | |
---|
| 20 | Requirements |
---|
| 21 | ************** |
---|
| 22 | |
---|
| 23 | * latest `ZOO-Kernel <http://zoo-project.org/trac/browser/trunk/zoo-project/zoo-kernel>`_ trunk version |
---|
| 24 | * SAGA-GIS (`SAGA-GIS 2.1.4 <http://saga-gis.org/>`_ ) |
---|
| 25 | * libLAS-1.2 (`LibLAS-1.2 <https://github.com/libLAS/libLAS-1.2>`_ ) |
---|
| 26 | |
---|
| 27 | Installation steps |
---|
| 28 | ******************** |
---|
| 29 | |
---|
| 30 | Download lastest ZOO-Kernel code from SVN. |
---|
| 31 | |
---|
| 32 | .. code-block:: guess |
---|
| 33 | |
---|
| 34 | svn checkout http://svn.zoo-project.org/svn/trunk/zoo-kernel zoo-kernel |
---|
| 35 | |
---|
| 36 | Then compile ZOO-Kernel using the needed configuration options as shown bellow: |
---|
| 37 | |
---|
| 38 | .. code-block:: guess |
---|
| 39 | |
---|
| 40 | cd zoo-kernel |
---|
| 41 | autoconf |
---|
| 42 | ./configure --with-saga=/usr/local/ |
---|
| 43 | make |
---|
| 44 | cp zoo_loader.cgi /usr/lib/cgi-bin |
---|
| 45 | |
---|
| 46 | Configuration steps |
---|
| 47 | ************************* |
---|
| 48 | |
---|
| 49 | Services configuration file |
---|
| 50 | ^^^^^^^^^^^^^^^^^^^^^^^^^^ |
---|
| 51 | |
---|
| 52 | Building the `saga2zcfg <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: |
---|
| 53 | |
---|
| 54 | .. code-block:: guess |
---|
| 55 | |
---|
| 56 | cd thirds/saga2zcfg |
---|
| 57 | make |
---|
| 58 | |
---|
| 59 | Run the following command to generate all the needed zcfg files for the available SAGA-GIS Modules: |
---|
| 60 | |
---|
| 61 | .. code-block:: guess |
---|
| 62 | |
---|
| 63 | mkdir zcfgs |
---|
| 64 | cd zcfgs |
---|
| 65 | ../saga2zcfg |
---|
| 66 | mkdir /location/to/your/cgi-bin/SAGA |
---|
| 67 | cp *zcfg /location/to/your/cgi-bin/SAGA |
---|
| 68 | |
---|
| 69 | Test the ZOO SAGA support |
---|
| 70 | ^^^^^^^^^^^^^^^^^^^^^^^ |
---|
| 71 | |
---|
| 72 | Once done, SAGA-GIS Modules should be listed as available WPS Services when runing a GetCapabilities request |
---|
| 73 | |
---|
| 74 | .. code-block:: guess |
---|
| 75 | |
---|
| 76 | http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS |
---|
| 77 | |
---|
| 78 | Each SAGA-GIS Service can then be described individually using the DescribeProcess request, as for example: |
---|
| 79 | |
---|
| 80 | .. code-block:: guess |
---|
| 81 | |
---|
| 82 | http://localhost/cgi-bin/zoo_loader.cgi?request=DescribeProcess&service=WPS&version=1.0.0&Identifier=SAGA.garden_fractals.1 |
---|
| 83 | |
---|
| 84 | And executed according to your needs, as for the following example |
---|
| 85 | executing SAGA.garden_fractals.1 with no optional parameter |
---|
| 86 | |
---|
| 87 | .. code-block:: guess |
---|
| 88 | |
---|
| 89 | 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 |
---|
| 90 | |
---|
| 91 | When executing SAGA-GIS Modules as WPS Services, it is also possible to check its ongoing status, using the usual asynchronous Execute requests and polling the ZOO GetStatus request. |
---|