source: branches/PublicaMundi_David-devel/docs/_build/html/kernel/orfeotoolbox.html @ 659

Last change on this file since 659 was 659, checked in by nbozon, 10 years ago

Massive update of zoo docs
File size: 17.8 KB
Line 
1
2
3<!DOCTYPE html>
4<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
5<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
6<head>
7  <meta charset="utf-8">
8  <meta name="viewport" content="width=device-width, initial-scale=1.0">
9 
10  <title>Optional Orfeo Toolbox support &mdash; ZOO-Project 1.4a0 documentation</title>
11 
12  <link href="http://fonts.googleapis.com/css?family=Days+One" rel="stylesheet" type="text/css">
13 
14 
15
16 
17
18 
19 
20   
21      <link rel="search" type="application/opensearchdescription+xml" title="Search within ZOO-Project 1.4a0 documentation" href="../_static/opensearch.xml"/>
22   
23
24 
25
26 
27 
28    <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
29 
30
31 
32
33 
34    <link rel="top" title="ZOO-Project 1.4a0 documentation" href="../index.html"/>
35        <link rel="up" title="ZOO-Kernel" href="index.html"/>
36        <link rel="next" title="Optional SAGA GIS support" href="sagagis.html"/>
37        <link rel="prev" title="Optional MapServer support" href="mapserver.html"/> 
38
39 
40  <script src="_static/js/modernizr.min.js"></script>
41
42</head>
43
44<body class="wy-body-for-nav" role="document">
45
46  <div class="wy-grid-for-nav">
47
48   
49    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
50      <div class="wy-side-nav-search">
51       
52
53       
54          <a class="shrink" href="http://zoo-project.org"><img src="http://zoo-project.org/img/zoo-sun-logo.png" class="img-responsive sun" style="display: inline;"> ZOO</a>
55       
56
57       
58        </a>
59
60       
61<div role="search">
62  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
63    <input type="text" name="q" placeholder="Search docs" />
64    <input type="hidden" name="check_keywords" value="yes" />
65    <input type="hidden" name="area" value="default" />
66  </form>
67</div>
68
69       
70      </div>
71
72      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
73       
74         
75         
76              <ul class="current">
77<li class="toctree-l1"><a class="reference internal" href="../intro.html">Introduction</a><ul>
78<li class="toctree-l2"><a class="reference internal" href="../intro.html#what-is-zoo-project">What is ZOO-Project ?</a></li>
79<li class="toctree-l2"><a class="reference internal" href="../intro.html#zoo-project-components">ZOO-Project components</a></li>
80<li class="toctree-l2"><a class="reference internal" href="../intro.html#open-source">Open Source</a></li>
81</ul>
82</li>
83<li class="toctree-l1"><a class="reference internal" href="../install/index.html">ZOO-Project installation</a><ul>
84<li class="toctree-l2"><a class="reference internal" href="../install/install-prerequisites.html">Prerequisites</a></li>
85<li class="toctree-l2"><a class="reference internal" href="../install/install-download.html">Download</a></li>
86<li class="toctree-l2"><a class="reference internal" href="../install/install-confoptions.html">Configure options</a></li>
87<li class="toctree-l2"><a class="reference internal" href="../install/install-installation.html">Installation on Unix/Linux</a></li>
88<li class="toctree-l2"><a class="reference internal" href="../install/install-onwindows.html">Installation on Windows ™</a></li>
89<li class="toctree-l2"><a class="reference internal" href="../install/install-onmacos.html">Installation on MacOSX ™</a></li>
90</ul>
91</li>
92<li class="toctree-l1 current"><a class="reference internal" href="index.html">ZOO-Kernel</a><ul class="current">
93<li class="toctree-l2"><a class="reference internal" href="what.html">What is ZOO-Kernel ?</a></li>
94<li class="toctree-l2"><a class="reference internal" href="configuration.html">ZOO-Kernel configuration</a></li>
95<li class="toctree-l2"><a class="reference internal" href="mapserver.html">Optional MapServer support</a></li>
96<li class="toctree-l2 current"><a class="current reference internal" href="">Optional Orfeo Toolbox support</a></li>
97<li class="toctree-l2"><a class="reference internal" href="sagagis.html">Optional SAGA GIS support</a></li>
98</ul>
99</li>
100<li class="toctree-l1"><a class="reference internal" href="../services/index.html">ZOO-Services</a><ul>
101<li class="toctree-l2"><a class="reference internal" href="../services/what.html">What are ZOO-Services ?</a></li>
102<li class="toctree-l2"><a class="reference internal" href="../services/zcfg-reference.html">ZOO-Service configuration file</a></li>
103<li class="toctree-l2"><a class="reference internal" href="../services/process-profiles.html">Process profiles registry</a></li>
104<li class="toctree-l2"><a class="reference internal" href="../services/howtos.html">Create your own ZOO-Services</a></li>
105<li class="toctree-l2"><a class="reference internal" href="../services/status.html">ZOO Status Service</a></li>
106<li class="toctree-l2"><a class="reference internal" href="../services/debug.html">Debugging ZOO Services</a></li>
107<li class="toctree-l2"><a class="reference internal" href="../services/zoo-services.html">Available ZOO-Services</a></li>
108</ul>
109</li>
110<li class="toctree-l1"><a class="reference internal" href="../api/index.html">ZOO-API</a><ul>
111<li class="toctree-l2"><a class="reference internal" href="../api/what.html">What is ZOO-API ?</a></li>
112<li class="toctree-l2"><a class="reference internal" href="../api/howto.html">Using ZOO-API</a></li>
113<li class="toctree-l2"><a class="reference internal" href="../api/classes.html">ZOO-API Classes</a></li>
114<li class="toctree-l2"><a class="reference internal" href="../api/examples.html">Examples</a></li>
115</ul>
116</li>
117<li class="toctree-l1"><a class="reference internal" href="../client/index.html">ZOO-Client</a><ul>
118<li class="toctree-l2"><a class="reference internal" href="../client/what.html">What is ZOO-Client ?</a></li>
119<li class="toctree-l2"><a class="reference internal" href="../client/howto.html">Using ZOO-Client</a></li>
120<li class="toctree-l2"><a class="reference internal" href="../client/example.html">Example application</a></li>
121</ul>
122</li>
123<li class="toctree-l1"><a class="reference internal" href="../contribute/index.html">Contributor Guide</a><ul>
124<li class="toctree-l2"><a class="reference internal" href="../contribute/howto.html">How to contribute ?</a></li>
125<li class="toctree-l2"><a class="reference internal" href="../contribute/code.html">Contribute code</a></li>
126</ul>
127</li>
128</ul>
129
130         
131       
132      </div>
133      &nbsp;
134    </nav>
135
136    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
137
138     
139      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
140        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
141        <a href="../contents.html">ZOO-Project</a>
142      </nav>
143
144
145     
146      <div class="wy-nav-content">
147        <div class="rst-content">
148          <div role="navigation" aria-label="breadcrumbs navigation">
149  <ul class="wy-breadcrumbs">
150
151    <li><a href="../contents.html"> Docs</a> &#8725; &#160;</li>
152     
153          <li><a href="index.html">ZOO-Kernel</a> &#8725; &#160;</li>
154     
155    <li>Optional Orfeo Toolbox support</li>
156      <li class="wy-breadcrumbs-aside">
157       
158          <a href="../_sources/kernel/orfeotoolbox.txt" rel="nofollow"> View page source</a>
159       
160      </li>
161  </ul>
162  <hr/>
163</div>
164          <div role="main" class="document">
165           
166  <div class="section" id="optional-orfeo-toolbox-support">
167<span id="kernel-orfeotoolbox"></span><h1>Optional Orfeo Toolbox support<a class="headerlink" href="#optional-orfeo-toolbox-support" title="Permalink to this headline"></a></h1>
168<p><a class="reference external" href="http://orfeo-toolbox.org/otb/">Orfeo Toolbox</a> provides simple to advanced algorithms for processing imagery available from remote sensors.
169The optional Orfeo Toolbox support is available since <a class="reference external" href="http://zoo-project.org">ZOO-Project 1.5</a>. It allows to execute the <a class="reference external" href="http://orfeo-toolbox.org/otb/otb-applications.html">OTB Applications</a> directly as ZOO WPS Services thanks to a <a class="reference internal" href="index.html#kernel-index"><span>ZOO-Kernel</span></a> specific internal mechanism which is detailed in this section.</p>
170<div class="admonition note">
171<p class="first admonition-title">Note</p>
172<p class="last"><a class="reference internal" href="../_images/orfeotoolbox.png"><img alt="Orfeo Toolbox logo" src="../_images/orfeotoolbox.png" style="width: 45.0px; height: 34.5px;" /></a> <a class="reference external" href="https://www.orfeo-toolbox.org">Orfeo Toolbox</a> is an open source image processing library. Learn more by reading its <a class="reference external" href="https://www.orfeo-toolbox.org/documentation/">documentation</a>.</p>
173</div>
174<div class="section" id="installation-and-configuration">
175<h2>Installation and configuration<a class="headerlink" href="#installation-and-configuration" title="Permalink to this headline"></a></h2>
176<p>Follow the step described bellow in order to activate the ZOO-Project
177optional Orfeo Toolbox support.</p>
178<div class="section" id="prerequisites">
179<h3>Prerequisites<a class="headerlink" href="#prerequisites" title="Permalink to this headline"></a></h3>
180<blockquote>
181<div><ul class="simple">
182<li>latest <a class="reference external" href="http://zoo-project.org/trac/browser/trunk/zoo-project/zoo-kernel">ZOO-Kernel</a> trunk version</li>
183<li>Orfeo Toolbox (<a class="reference external" href="http://orfeo-toolbox.org/otb/">OTB 4.2.1</a> )</li>
184<li>Insight Segmentation and Registration Toolkit  (<a class="reference external" href="http://itk.org/ITK/resources/software.html/">ITK-4.7</a> )</li>
185</ul>
186</div></blockquote>
187</div>
188<div class="section" id="installation-steps">
189<h3>Installation steps<a class="headerlink" href="#installation-steps" title="Permalink to this headline"></a></h3>
190<div class="admonition note">
191<p class="first admonition-title">Note</p>
192<p class="last">These installation steps were successfully tested on Ubuntu 14.4 LTS</p>
193</div>
194<div class="admonition note">
195<p class="first admonition-title">Note</p>
196<p class="last">For OTB and ITK, the CMAKE_C_FLAGS and CMAKE_CXX_FLAGS must first be set to <code class="docutils literal"><span class="pre">-fPIC</span></code></p>
197</div>
198<p>Download lastest ZOO-Kernel code from SVN.</p>
199<div class="highlight-guess"><div class="highlight"><pre>svn checkout http://svn.zoo-project.org/svn/trunk/zoo-kernel zoo-kernel
200</pre></div>
201</div>
202<p>Then compile ZOO-Kernel using the needed configuration options as shown bellow:</p>
203<div class="highlight-guess"><div class="highlight"><pre>cd zoo-kernel
204autoconf
205./configure  --with-otb=/usr/local --with-itk=/usr/local --with-itk-version=4.7
206make
207cp zoo_loader.cgi /usr/lib/cgi-bin
208</pre></div>
209</div>
210<div class="section" id="configuration-steps">
211<h4>Configuration steps<a class="headerlink" href="#configuration-steps" title="Permalink to this headline"></a></h4>
212<div class="section" id="main-configuration-file">
213<h5>Main configuration file<a class="headerlink" href="#main-configuration-file" title="Permalink to this headline"></a></h5>
214<p>Add the following content to your <code class="docutils literal"><span class="pre">/usr/lib/cgi-bin/main.cfg</span></code> file
215in the <code class="docutils literal"><span class="pre">[env]</span></code> section:</p>
216<div class="highlight-guess"><div class="highlight"><pre>ITK_AUTOLOAD_PATH=/usr/local/lib/otb/applications
217</pre></div>
218</div>
219</div>
220<div class="section" id="services-configuration-file">
221<h5>Services configuration file<a class="headerlink" href="#services-configuration-file" title="Permalink to this headline"></a></h5>
222<p>The build of the <a class="reference external" href="http://zoo-project.org/trac/browser/trunk/thirds/otb2zcfg">otb2zcfg</a> utility is required to activate the available OTB Applications as WPS services. This can be done using the following command:</p>
223<div class="highlight-guess"><div class="highlight"><pre>mkdir build
224cd build
225ccmake ..
226make
227</pre></div>
228</div>
229<p>Run the following command to generate all the needed zcfg files for the available OTB Application:</p>
230<div class="highlight-guess"><div class="highlight"><pre>mkdir zcfgs
231cd zcfgs
232export ITK_AUTOLOAD_PATH=/your/path/to/otb/applications
233../build/otb2zcfg
234mkdir /location/to/your/cgi-bin/OTB
235cp *zcfg /location/to/your/cgi-bin/OTB
236</pre></div>
237</div>
238</div>
239<div class="section" id="test-the-zoo-otb-support">
240<h5>Test the ZOO OTB support<a class="headerlink" href="#test-the-zoo-otb-support" title="Permalink to this headline"></a></h5>
241<p>Once done, OTB Applications should be listed as available WPS Services when runing a GetCapabilities request</p>
242<div class="highlight-guess"><div class="highlight"><pre>http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&amp;service=WPS
243</pre></div>
244</div>
245<p>Each OTB Service can then be described individually using the DescribeProcess request, as for example:</p>
246<div class="highlight-guess"><div class="highlight"><pre>http://localhost/cgi-bin/zoo_loader.cgi?request=DescribeProcess&amp;service=WPS&amp;version=1.0.0&amp;Identifier=OTB.BandMath
247</pre></div>
248</div>
249<p>As an example, here is a test request executing the OTB.BandMath Application with the OTB Cookbook sample data as input</p>
250<div class="highlight-guess"><div class="highlight"><pre><span class="nt">http</span><span class="o">://</span><span class="nt">localhost</span><span class="o">/</span><span class="nt">cgi-bin</span><span class="o">/</span><span class="nt">zoo_loader</span><span class="nc">.cgi</span><span class="o">?</span><span class="nt">request</span><span class="o">=</span><span class="nt">Execute</span><span class="o">&amp;</span><span class="nt">service</span><span class="o">=</span><span class="nt">WPS</span><span class="o">&amp;</span><span class="nt">version</span><span class="o">=</span><span class="nt">1</span><span class="nc">.0.0</span><span class="o">&amp;</span><span class="nt">Identifier</span><span class="o">=</span><span class="nt">OTB</span><span class="nc">.BandMath</span><span class="o">&amp;</span><span class="nt">DataInputs</span><span class="o">=</span><span class="nt">il</span><span class="o">=</span><span class="nt">Reference</span><span class="k">@xlink</span><span class="nd">:href</span><span class="o">=</span><span class="nt">http</span><span class="o">://</span><span class="nt">hg</span><span class="nc">.orfeo-toolbox.org</span><span class="o">/</span><span class="nt">OTB-Data</span><span class="o">/</span><span class="nt">raw-file</span><span class="o">/</span><span class="nt">ca154074b282</span><span class="o">/</span><span class="nt">Examples</span><span class="o">/</span><span class="nt">verySmallFSATSW</span><span class="nc">.tif</span><span class="p">;</span><span class="nt">il</span><span class="o">=</span><span class="nt">Reference</span><span class="k">@xlink</span><span class="nd">:href</span><span class="o">=</span><span class="nt">http</span><span class="o">://</span><span class="nt">hg</span><span class="nc">.orfeo-toolbox.org</span><span class="o">/</span><span class="nt">OTB-Data</span><span class="o">/</span><span class="nt">raw-file</span><span class="o">/</span><span class="nt">ca154074b282</span><span class="o">/</span><span class="nt">Examples</span><span class="o">/</span><span class="nt">verySmallFSATSW_nir</span><span class="nc">.tif</span><span class="p">;</span><span class="nt">out</span><span class="o">=</span><span class="nt">float</span><span class="o">;</span><span class="nt">exp</span><span class="o">=</span><span class="nt">im1b3</span><span class="o">*</span><span class="nt">cos</span><span class="o">%</span><span class="nt">28im1b1</span><span class="o">%</span><span class="nt">29</span><span class="o">,</span><span class="nt">im1b2</span><span class="o">*</span><span class="nt">cos</span><span class="o">%</span><span class="nt">28im1b1</span><span class="o">%</span><span class="nt">29</span><span class="o">,</span><span class="nt">im1b1</span><span class="o">*</span><span class="nt">cos</span><span class="o">%</span><span class="nt">28im1b1</span><span class="o">%</span><span class="nt">29</span><span class="o">&amp;</span><span class="nt">RawDataOutput</span><span class="o">=</span><span class="nt">out</span><span class="k">@mimeType</span><span class="o">=</span><span class="nt">image</span><span class="o">/</span><span class="nt">png</span>
251</pre></div>
252</div>
253<div class="admonition note">
254<p class="first admonition-title">Note</p>
255<p class="last">When executing OTB applications as WPS Services, it is also possible to check the OTB process status, using the usual ZOO GetStatus request.</p>
256</div>
257</div>
258</div>
259</div>
260</div>
261</div>
262
263
264          </div>
265          <footer>
266 
267    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
268     
269        <a href="sagagis.html" class="btn btn-neutral float-right" title="Optional SAGA GIS support">Next <span class="fa fa-arrow-circle-right"></span></a>
270     
271     
272        <a href="mapserver.html" class="btn btn-neutral" title="Optional MapServer support"><span class="fa fa-arrow-circle-left"></span> Previous</a>
273     
274    </div>
275 
276
277  <hr/>
278  <div class="pfoot">
279  <div role="contentinfo">
280    <p>
281        &copy; Copyright 2009-2015, ZOO-Project team.
282    </p>
283  </div>
284  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> inspired by <a href="https://readthedocs.org">Read the Docs</a>.
285</div>
286</footer>
287
288        </div>
289      </div>
290
291    </section>
292
293  </div>
294 
295
296
297 
298
299    <script type="text/javascript">
300        var DOCUMENTATION_OPTIONS = {
301            URL_ROOT:'../',
302            VERSION:'1.4a0',
303            COLLAPSE_INDEX:false,
304            FILE_SUFFIX:'.html',
305            HAS_SOURCE:  true
306        };
307    </script>
308      <script type="text/javascript" src="../_static/jquery.js"></script>
309      <script type="text/javascript" src="../_static/underscore.js"></script>
310      <script type="text/javascript" src="../_static/doctools.js"></script>
311
312 
313
314 
315 
316    <script type="text/javascript" src="../_static/js/theme.js"></script>
317 
318
319 
320 
321  <script type="text/javascript">
322      jQuery(function () {
323          SphinxRtdTheme.StickyNav.enable();
324      });
325  </script>
326   
327
328</body>
329</html>
Note: See TracBrowser for help on using the repository browser.

Download now !

Search

Context Navigation

Main Navigation

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