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-grassraster </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Module Maintainer: </p></td>
<td class="confluenceTd"><p> <a class="confluence-link confluence-userlink" data-username="moovida" href="/display/~moovida" data-linked-resource-id="65889" data-linked-resource-type="userinfo" username="moovida" data-linked-resource-default-alias="Andrea Antonello" data-base-url="http://docs.codehaus.org">Andrea Antonello</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-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> 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/grassraster/src/site/apt/review.apt">review.apt</a> </p></td>
</tr>
</tbody></table>

<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>Grass rasters</h1>

<p>The module supplies support for reading and writing GRASS rasters. The metadata contain both the colortable and the categories (if available) of the raster map. The original colortable of the GRASS raster is read into the geotools coverage Categories and can as such be visualized if using a default styler.</p>

<h2>Data structure of a rastermap</h2>

<p>Raster data in GRASS are stricktly bound to their workspace. Since a workspace is something more on userlevel, I will from now on use grass database for the folder structure and workspce for what the user will interact with at application level.</p>

<p>A GRASS raster map consists of several files in several subdirectories in a mapset, organized as follows:</p>

<ul>
	<li>cellhd/: map header including projection code, coordinates representing the spatial extent of the raster map, number of rows and columns, resolution, and information about map compression;</li>
	<li>cell/, fcell/ or grid3/: generic matrix of values in a compressed, portable format which depends on the raster data type (integer, floating point or 3D grid);</li>
	<li>hist/: history file which contains metadata such as the data source, the command that was used to generate the raster map, or other information provided by the user;</li>
	<li>cats/: optional category file which contains text or numeric labels assigned to the raster map categories;</li>
	<li>colr/: optional color table;</li>
	<li>cell_misc/: optional timestamp, range of values, quantization rules (for floating point maps) and null (no-data) files;</li>
	<li>WIND: contains the active processing region and the resolution</li>
	<li>PROJ_INFO: contains the information about the projection</li>
	<li>PROJ_UNITS: contains the information about projection units used</li>
	<li>vector/: contain the vector data since GRASS 6</li>
</ul>

<h1>Module Status</h1>

<p>The module derives from code that has been used and tested for years in the JGrass community and shall be defined as tested as such.<br />
In fact the creation of the module forced me to introduce a couple of geotools interfaces that were not in the library before.<br />
That said, a complete set of tests are available that check the reding at different resolutions and regions.</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: Need to be achieved.<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: even if tested in the past, needs to be tested in this new environment.<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: currently in beginning stages<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)" /> Stability: No planned API changes<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)" /> Supported: supported by Andrea Antonello</p>

<h2>IP Review</h2>

<p>IP review file added and waiting for external review.</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>