Package org.geotoolkit.coverage.grid

GridCoverage2D implementation.

See:
Description

Interface Summary

RenderedCoverage

A grid coverage backed by a rendered image.

Class Summary

AbstractGridCoverage	Base class for Geotk implementation of grid coverage.
Calculator2D	A grid coverage backed by the same image, grid geometry and sample dimension than an other coverage, but performing some additional calculation in its evaluate methods.
GeneralGridCoordinates	Holds the set of grid coordinates that specifies the location of the grid point within the grid.
GeneralGridCoordinates.Immutable	An immutable GridCoordinates.
GeneralGridEnvelope	Defines a range of grid coverage coordinates.
GeneralGridGeometry	Describes the valid range of grid coordinates and the transform from those grid coordinates to real world coordinates.
GridCoordinates2D	Holds the set of two-dimensional grid coordinates that specifies the location of the grid point within the grid.
GridCoverage2D	Basic access to grid data values backed by a two-dimensional rendered image.
GridCoverageBuilder	Helper class for the creation of GridCoverage2D instances.
GridCoverageFactory	Deprecated. Replaced by GridCoverageBuilder.
GridEnvelope2D	Defines a range of two-dimensional grid coverage coordinates.
GridGeometry2D	A GeneralGridGeometry where only 2 dimensions have more than 1 cell.
ImageGeometry	A simple grid geometry holding the grid envelope as a rectangle and the grid to CRS relationship as an affine transform.
Interpolator2D	A grid coverage using an interpolation for evaluating points.

Enum Summary

ViewType

Enumerates different "views" over a given coverage.

Exception Summary

InvalidGridGeometryException

Thrown by GeneralGridGeometry when a grid geometry is in an invalid state.

Package org.geotoolkit.coverage.grid Description

GridCoverage2D implementation. An explanation for this package is provided in the OpenGIS® javadoc. The remaining discussion on this page is specific to the Geotk implementation.

The main class in this package is GridCoverage2D, which is a two-dimensional slice in a n-dimensional cube of data. Despite its name, GridCoverage2D instances can be associated to n-dimensional envelopes providing that only two dimensions have a grid span greater than 1.

The GridCoverage2D constructor is rather tedious. The GridCoverageBuilder convenience class provides more convenient ways to create a grid coverage.

Accurate definition of georeferencing information
While it is possible to create a grid coverage from a geodetic envelope, this approach should be used in last resort only. Instead, always specify the grid to CRS affine transform. This is preferable because envelopes have ambiguities (do we need to swap the longitude and latitude axes? Do we need to flip the y axis?) which Geotk tries to resolve using heuristic rules implemented in GridToEnvelopeMapper. Those rules are somewhat arbitrary and are not guaranteed to produce the expected result. On the other hand, the grid to CRS affine transform is fully determinist.

Since:

2.1

Version:

3.20

Author:

Martin Desruisseaux (IRD, Geomatys)

Module:

coverage/geotk-coverage (download)