Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<table class="confluenceTable"><tbody>
<tr>
<td class="confluenceTd"><p> Module: </p></td>
<td class="confluenceTd"><p> gt-idl-process </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Module Maintainer: </p></td>
<td class="confluenceTd"><p> <a class="confluence-link confluence-userlink" data-username="dany111" href="/display/~dany111" data-linked-resource-id="50192" data-linked-resource-type="userinfo" username="dany111" data-linked-resource-default-alias="Daniele Romagnoli" data-base-url="http://docs.codehaus.org">Daniele Romagnoli</a> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Status: </p></td>
<td class="confluenceTd"><p> <table class="wysiwyg-macro" data-macro-name="excerpt" data-macro-parameters="atlassian-macro-output-type=INLINE" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2V4Y2VycHQ6YXRsYXNzaWFuLW1hY3JvLW91dHB1dC10eXBlPUlOTElORX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p><img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /><img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /><img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /><img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /><img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /></p></td></tr></table> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Email Help: </p></td>
<td class="confluenceTd"><p> Geotools-gt2-users@lists.sourceforge.net </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Volunteer: </p></td>
<td class="confluenceTd"><p> geotools-devel@lists.sourceforge.net </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> IP Review: </p></td>
<td class="confluenceTd"><p> <a href="http://svn.osgeo.org/geotools/trunk/modules/unsupported/idl-process/src/site/apt/review.apt">review.apt</a> </p></td>
</tr>
</tbody></table>

<p>Allow exposing IDL algorithms/functions as geotools processes.</p>

<img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3RvY30&amp;locale=en_GB&amp;version=2" data-macro-name="toc">
<h1>Module Status</h1>

<p>The module has been previously used as a dependency of a custom Geoserver 1.7. Our aim is to setup all we need to let it work on GeoServer's (2.0) WPS too.</p>

<h2>Gold Star Quality Assurance Check</h2>

<p><img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> IP Check: review.txt added, all headers are in place<br />
<img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> Releasable: ...<br />
<img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> Quality Assurance: ...<br />
<img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> Stability: No planned API changes<br />
<img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> Supported: Documentation available/Javadoc in place, module maintainer does watches user list, answers email.</p>

<h2>IP Review</h2>

<p>IP review is underway - known issue:<a href="http://svn.osgeo.org/geotools/trunk/modules/unsupported/idl-process/src/site/apt/review.apt">http://svn.osgeo.org/geotools/trunk/modules/unsupported/idl-process/src/site/apt/review.apt</a></p>

<h2>Outstanding Issues</h2>

<p>Remember that the module maintainer is a volunteer, and if you can help test this module please jump on the developers list and help out. Patches may be attached to the above issues for review by the module maintainer.</p>

<h2>Class Diagram</h2>

<p><img class="confluence-embedded-image" height="300" width="584" src="/download/attachments/231079961/IDLprocess.PNG?version=1&amp;modificationDate=1369163731500" data-image-src="/download/attachments/231079961/IDLprocess.PNG?version=1&amp;modificationDate=1369163731500" data-linked-resource-id="231374889" data-linked-resource-type="attachment" data-linked-resource-default-alias="IDLprocess.PNG" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231079961" title="null > IDLprocess.PNG"></p>

<h2>Usage (still in progress)</h2>

<ol>
	<li>First of all, you need IDL installed on your machine. Make sure to define an IDL_HOME environment variable referring to your IDL folder installation.</li>
	<li>When done, make sure the &quot;%IDL_HOME%\bin\bin.x86&quot; folder is on your Java Library Path.</li>
	<li>Create your IDL algorithm .pro definition file on &quot;%IDL_HOME%\lib folder&quot;.</li>
	<li>Use the IDL Bridge Export Assistant to produce the Wrapping Java class from that definition file.</li>
	<li>SetUp your Geotools Process and factories leveraging on the newly created wrapper.</li>
</ol>

<h2>Sample code</h2>

<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>package org.geotools.process.idl.impl;

import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.Map;

import org.geotools.process.Process;
import org.geotools.process.ProcessException;
import org.geotools.test.TestData;
import org.junit.Assert;

/**
 * Simple test class leveraging on the Feature Extraction function, offered by
 * means of the proper IDL wrapper.
 */
public class IDLProcessTest{

public void testFeatureExtractionProcess() throws InterruptedException,
			FileNotFoundException, IOException, ProcessException {
		final IDLFeatureExtractionProcessFactory factory = new IDLFeatureExtractionProcessFactory();
		final Process process = factory.create();
		File testData = TestData.file(this, "testin.tif");
		final Map&lt;String, Object> values = new LinkedHashMap&lt;String, Object>(2);
		values.put("input_data", testData.getAbsolutePath());
		Map&lt;String, Object> result = null;
		result = process.execute(values, null);
		if (result != null &amp;&amp; !result.isEmpty()) {
			final Iterator&lt;String> keysIt = result.keySet().iterator();
			final Object output = result.get(keysIt.next());
			Assert.assertNotNull(output);
		}
	}
}
</pre></td></tr></table>