Package org.geotoolkit.coverage.processing

Coverage processor implementations.

See:
Description

Class Summary

AbstractCoverageProcessor	Provides operations for different ways of accessing the grid coverage values as well as image processing functionality.
AbstractOperation	Provides descriptive information for a Coverage processing operation.
BilevelOperation	Wraps any JAI operation producing a bilevel image.
CachingCoverageProcessor	A coverage processor that cache the result of operations.
ColorMap	Colors associated to categories.
DefaultCoverageProcessor	Default implementation of a Coverage processor.
FilterOperation	Common super-class for filter operation.
IndexColorOperation	Operation applied on the IndexColorModel of the image backing the source grid coverage.
Operation2D	Deprecated. The API of this class will change in a future Geotk release.
OperationJAI	Deprecated. The API of this class will change in a future Geotk release.
OperationJAI.Parameters	A block of parameters for a GridCoverage2D processed by a OperationJAI.
Operations	Convenience, type-safe, methods for applying some common operations on coverage objects.
RangeSpecifier	Argument type for DefaultCoverageProcessor operations for specifying the range, colors and units of a computation result.

Exception Summary

CannotCropException	Throws when a "Crop" operation has been requested but the specified grid coverage can't be scaled.
CannotReprojectException	Throws when a "Resample" operation has been requested but the specified grid coverage can't be reprojected.
CannotScaleException	Throws when a "Scale" operation has been requested but the specified grid coverage can't be scaled.
CoverageProcessingException	Throws when a coverage operation failed.

Package org.geotoolkit.coverage.processing Description

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

If the operation to apply is know at compile time, then the easiest way to use this package is to use the Operations convenience class. For example a grid coverage can be resampled to a different coordinate reference system using the following code:

Coverage reprojected = Operations.DEFAULT.resample(myCoverage, newCRS);

If the operation to apply is unknown at compile time, or if the operation is not listed in the Operations convenience class, then the generic way to invoke an operation is described in the operation package.

Creating new operations
Geotk coverage operations must extend the AbstractOperation class or one of its subclasses. All operations must declare the expected parameters, including source coverages, as an ParameterDescriptorGroup object. The source coverages are ordinary parameters for which the value class is Coverage or a subclass. The parameter name of source coverages can be anything, but the Java Advanced Imaging usage is "source0" for the first source, "source1" for the second source (if any), etc.

AbstractOperation is the base class offering few convenience for the developers, but few restrictions on the kind of source coverage and on the way to implement the operation. AbstractOperation can be pure mathematical functions.

Operation2D is a subclass expecting source coverages that are specifically of type GridCoverage2D or a subclass. GridCoverage2D has a mechanism for storing its data in a packed form, typically as 8 or 16 bits integers convertible to geophysics values by a linear equation. Because most operations need to be applied on geophysics values in order to produce correct results, Operation2D provides facilities for converting the source coverages to their geophysics view, and converting the result back to the original (packed or not) view.

OperationJAI is a subclass expecting the coverage operation to be implemented as a Java Advanced Imaging (JAI) operation working on RenderedImage. Because GridCoverage2D are basically wrappers around RenderedImage, it is often good design to implement the coverage operation as a wrapper around the corresponding JAI operation. However such wrapper needs to perform some pre-processing and post-processing tasks that are relative to the geographic nature of the operation. For example calculating the sum of sample values of two images usually requires that those images are first projected in the same Coordinate Reference System (CRS). The OperationJAI class is designed for handling those common pre- and post-processing.

Since:

2.1

Version:

3.00

Author:

Martin Desruisseaux (IRD, Geomatys)

Module:

coverage/geotk-coverage (download)