GeoTools : Grassraster support



Module Maintainer:

Andrea Antonello


(red star)(red star)(red star)(star)(star)

Email Help:


IP Review:


Grass rasters

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.

Data structure of a rastermap

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.

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

  • 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;
  • 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);
  • 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;
  • cats/: optional category file which contains text or numeric labels assigned to the raster map categories;
  • colr/: optional color table;
  • cell_misc/: optional timestamp, range of values, quantization rules (for floating point maps) and null (no-data) files;
  • WIND: contains the active processing region and the resolution
  • PROJ_INFO: contains the information about the projection
  • PROJ_UNITS: contains the information about projection units used
  • vector/: contain the vector data since GRASS 6

Module Status

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.
In fact the creation of the module forced me to introduce a couple of geotools interfaces that were not in the library before.
That said, a complete set of tests are available that check the reding at different resolutions and regions.

Gold Star Quality Assurance Check

(red star) IP Check: Need to be achieved.
(red star) Releasable: even if tested in the past, needs to be tested in this new environment.
(red star) Quality Assurance: currently in beginning stages
(star) Stability: No planned API changes
(star) Supported: supported by Andrea Antonello

IP Review

IP review file added and waiting for external review.

Outstanding Issues

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.