source: trunk/docs/kernel/sagagis.rst @ 725

Last change on this file since 725 was 725, checked in by djay, 9 years ago

Fix issue with rst files displayed from Trac. Fix strings to be translated. Always use the same string in all messages.

  • Property svn:keywords set to Date Author
  • Property svn:mime-type set to text/plain
File size: 3.3 KB
Line 
1.. _kernel-sagagis:
2   
3Optional 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
20Installation and configuration
21------------------------------
22
23Follow the step described bellow in order to activate the ZOO-Project optional SAGA GIS support.
24
25Prerequisites
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
32Installation steps
33...........................
34
35.. Note:: These installation steps were successfully tested on Ubuntu 14.4 LTS
36
37Download 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
43Then 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
52And 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
58Configuration steps
59...............................
60
61Services configuration file
62****************************
63
64Building 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
72The 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
83Test requests
84*****************
85
86The SAGA-GIS Modules should be listed as available WPS Services when
87runing a GetCapabilities request, as follow:
88
89http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS
90
91Each SAGA-GIS Service can then be described individually using the DescribeProcess request, as for example:
92
93http://localhost/cgi-bin/zoo_loader.cgi?request=DescribeProcess&service=WPS&version=1.0.0&Identifier=SAGA.garden_fractals.1
94
95And executed according to your needs. The following example executes *SAGA.garden_fractals.1* with no optional parameter:
96
97http://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
Note: See TracBrowser for help on using the repository browser.

Search

ZOO Sponsors

http://www.zoo-project.org/trac/chrome/site/img/geolabs-logo.pnghttp://www.zoo-project.org/trac/chrome/site/img/neogeo-logo.png http://www.zoo-project.org/trac/chrome/site/img/apptech-logo.png http://www.zoo-project.org/trac/chrome/site/img/3liz-logo.png http://www.zoo-project.org/trac/chrome/site/img/gateway-logo.png

Become a sponsor !

Knowledge partners

http://www.zoo-project.org/trac/chrome/site/img/ocu-logo.png http://www.zoo-project.org/trac/chrome/site/img/gucas-logo.png http://www.zoo-project.org/trac/chrome/site/img/polimi-logo.png http://www.zoo-project.org/trac/chrome/site/img/fem-logo.png http://www.zoo-project.org/trac/chrome/site/img/supsi-logo.png http://www.zoo-project.org/trac/chrome/site/img/cumtb-logo.png

Become a knowledge partner

Related links

http://zoo-project.org/img/ogclogo.png http://zoo-project.org/img/osgeologo.png