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> OGR data store </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Module Maintainer: </p></td>
<td class="confluenceTd"><p> <a class="confluence-link confluence-userlink" data-username="aaime" href="/display/~aaime" data-linked-resource-id="787" data-linked-resource-type="userinfo" username="aaime" data-linked-resource-default-alias="Andrea Aime" data-base-url="http://docs.codehaus.org">Andrea Aime</a> </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> 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-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> <img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> </p></td></tr></table> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Model  </p></td>
<td class="confluenceTd"><p> <a class="confluence-link" href="/display/GEOTOOLS/OGR+Data+Store+design" data-linked-resource-id="75146" data-linked-resource-type="page" data-linked-resource-default-alias="OGR Data Store design" data-base-url="http://docs.codehaus.org">OGR Data Store design</a> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> User doc <br class="atl-forced-newline" /> </p></td>
<td class="confluenceTd"><p> <a class="confluence-link unresolved" data-content-title="OGR Data Store user guide" data-space-key="GEOTDOC" data-linked-resource-default-alias="OGR Data Store user guide" href="#">OGR Data Store user guide</a> </p></td>
</tr>
</tbody></table>

<h1>Gold Star Quality Assurance Check:</h1>

<p><img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> IP Check: need to ensure all headers are in place<br />
<img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> <a class="confluence-link unresolved" data-content-title="OGR Data Store user guide" data-space-key="GEOTDOC" data-linked-resource-default-alias="OGR Data Store user guide" href="#">user</a> and <a class="confluence-link" href="/display/GEOTOOLS/OGR+Data+Store+design" data-linked-resource-id="75146" data-linked-resource-type="page" data-linked-resource-default-alias="OGR Data Store design" data-base-url="http://docs.codehaus.org">design</a> docs. Module maintainer does watches user list, answers email.</p>

<h1>Target</h1>

<p>A module dedicated to integrate the <a href="http://www.gdal.org/ogr">OGR Simple Features Library</a> into GeoTools as a DataStore implementation.</p>

<h1>Motivation</h1>

<p><a href="http://www.gdal.org/ogr">OGR</a> is a C++ open source library providing read (and sometimes write) access to a variety of vector file formats including, among the others, S-57, SDTS, Mapinfo TAB formats, ESRI personal GeoDatabase, GRASS, Microstation DGN (see full list in the <a href="http://www.gdal.org/ogr/ogr_formats.html">OGR Vector Formats page</a>).</p>

<p>The list of supported formats is long, and includes significant formats that are not supported by pure java GeoTools data stores. An integration that leverages the work done by OGR provides good value with a relatively low effort, and opens the door for the ever growing set of OGR supported formats, at least one the read side (for issues with the write side, the the <a class="confluence-link" href="/display/GEOTOOLS/OGR+Data+Store+design" data-linked-resource-id="75146" data-linked-resource-type="page" data-linked-resource-default-alias="OGR Data Store design" data-base-url="http://docs.codehaus.org">design docs</a>).</p>

<h1>Target Audience</h1>

<p>This module is appealing to anyone needing to open and serve contents of spatial data files that are supported by OGR, but not natively by pure java GeoTools data stores. Initial support focuses on feature reading, and for OGR drivers supporting it, write in append mode.</p>

<h1>Quality Assurance</h1>

<h2>Unit test coverage</h2>

<p>The module targets a high level of code coverage (raw numbers pending).</p>

<h2>Unit testing strategy</h2>

<p>Unit tests do focus on getting high code coverage level by using a driver with full capabilities and an easy GeoTools reference to be used for comparison: the shapefile format.<br />
The ShapefileDataStore tests are being reused extensively to make sure the OGR datastore is as capable as the native GeoTools one.<br />
The downside of this testing strategy is that the datastore is not tested with formats not enjoing an equally complete driver (say, formats that do only support feature appending, or that loose random access capabilities once a spatial filter is attached to them).</p>

<h1>Status</h1>

<p>The module is in early alpha stage. It requires users to either download and use a native OGR build, available for selected operating systems on the <a class="confluence-link unresolved" data-content-title="OGR Data Store user guide" data-space-key="GEOTDOC" data-linked-resource-default-alias="OGR Data Store user guide" href="#">user guide</a>, or to provide their own compiled version (both library and java bindings).</p>