org.geotools.referencing.operation.builder |
package org.geotools.referencing.operation.builder
A package of convenience classes which use control points common to two
data sets to derive empirically the transformation parameters needed to
convert positions between the coordinate systems of the two data sets.
Note the implementation is currently (January 2008) limited to two
dimensions. The methods, however, are generic and could be expanded to
three dimensions someday. At that time, we will probably make minor
changes to the API.
The package consists of two types of convenience classes: the various
builder classes which use a set of individual control points to obtain
the conversion and the GridToEnvelopeMapper class which derives the
conversion from a grid range to a georeferenced Envelope.
The builder classes should be used by users who have two data sets that
are known to share certain common points but who currently do not line up.
This could be the case, for example, if a user has two data sets
describing the same region but one of these has an unknown coordinate
referencing system. In this situation, there is no way to convert
coordinate positions between the two data sets. However, if the user can
identify a series of positions coupled in each data set, a Builder can
calculate an empirical conversion between the two data sets. The
different Builder classes use different mathematical approaches to obtain
the empirical estimate.
The GridToEnvelopeMapper should be used by users who have a grid, such as
an image, which is not georeferenced but the user knows the grid is
aligned in one of the four cardinal directions and the user can identify
the outer georeferenced envelope of the grid. The Mapper class can then
calculate an empirical conversion object to map positions in the image
coordinate system to georeferenced positions.
The builder classes require a matched set of known positions, one from a
"source" data set and another from a "target" data set; the builder will
then provide a structure which contains a conversion object to transform
positions from the "source" coordinate system to the "target" coordinate
system. The builders require a list of
{@linkplain org.geotools.referencing.operation.builder.MappedPosition MappedPosition}
objects which are associations of a
{@linkplain org.opengis.referencing.DirectPosition DirectPosition} in the
"source" data set with another DirectPosition in the "target" data set. The
{@linkplain org.geotools.referencing.operation.builder.MathTransformBuilder#getTransformation() getTransformation() method}
in the builder can then be used to provide a
{@linkplain org.opengis.referencing.operation.Transformation Transformation}
object from which the user can obtain the
{@linkplain org.opengis.referencing.operation.MathTransform MathTransform}
to use for conversion operations.
Different builders use different mathematical approaches for obtaining the
empirical estimate of the conversion parameters. The builders are:
- {@linkplain org.geotools.referencing.operation.builder.ProjectiveTransformBuilder ProjectiveTransformBuilder}
- {@linkplain org.geotools.referencing.operation.builder.AffineTransformBuilder AffineTransformBuilder}
- {@linkplain org.geotools.referencing.operation.builder.SimilarTransformBuilder SimilarTransformBuilder}
- {@linkplain org.geotools.referencing.operation.builder.BursaWolfTransformBuilder BursaWolfTransformBuilder}
- {@linkplain org.geotools.referencing.operation.builder.RubberSheetBuilder RubberSheetBuilder}
with the mathematical details of each estimation procedure explained in
the documentation of the builder class itself. The first four of these use
a least squares estimation method in which, if the system is
over-determined by having more than the minimum number of control points
necessary to derive the estimate, the best matching parameter estimate
will be obtained by minimising the sum of the squared distances to the
points. The RubberSheet algorithm uses a linear interpolation between the
various control points.
|
Java Source File Name | Type | Comment |
AffineTransformBuilder.java | Class | Builds
setup as Affine transformation from a list of
. |
BursaWolfTransformBuilder.java | Class | Builds
setup as BursaWolf transformation from a list of
.
The calculation uses least square method. |
BursaWolfTransformBuilderTest.java | Class | |
Circle.java | Class | Simple Circle focused on Delaunays triangulation. |
ExtendedPosition.java | Class | DirectPosition associated with another DirectPosition. |
GridToEnvelopeMapper.java | Class | A helper class for building n-dimensional
mapping
to
. |
GridToEnvelopeMapperTest.java | Class | Tests
GridToEnvelopeMapper . |
LocalizationGrid.java | Class | A factory for
MathTransform2D backed by a grid of localization.
A grid of localization is a two-dimensional array of coordinate points. |
LocalizationGridTransform2D.java | Class | Transform a set of coordinate points using a grid of localization.
Input coordinates are index in this two-dimensional array.
Those input coordinates (or index) should be in the range
xinput = [0..width-1] and
yinput = [0..height-1] inclusive,
where
width and
height are the number of columns and
rows in the grid of localization. |
MappedPosition.java | Class | An association between a
and
direct positions. |
MapTriangulationFactory.java | Class | Implements methods for triangulation for
transformation. |
MathTransformBuilder.java | Class | Provides a basic implementation for
builders.
Math transform builders create
MathTransform objects for transforming
coordinates from a source CRS
(
) to
a target CRS using empirical parameters. |
MathTransformBuilderTest.java | Class | A test for the MathTransformBuilders. |
MissingInfoException.java | Class | Thrown when a required operation can't be performed because some information is missing or isn't set up properly. |
Polygon.java | Class | Simple polygons like three - sided (triangle) or four - sided
(qadrilateral), that are used for triangulation. |
ProjectiveTransformBuilder.java | Class | Builds
setup as Projective transformation from a list of
. |
Quadrilateral.java | Class | A simple four-sided polygon. |
RubberSheetBuilder.java | Class | Builds a RubberSheet transformation from a set of control points, defined as
a List of
objects, and a quadrilateral delimiting the outer area of interest, defined
as a List of four
objects. |
RubberSheetTransform.java | Class | This provides the transformation method based on RubberSheeting (also
known as Billinear interpolated transformation) The class is accessed
. |
SimilarTransformBuilder.java | Class | Builds
setup as Similar transformation from a list of
.
The The calculation uses least square method. |
TINTriangle.java | Class | A triangle, with special methods for use with RubberSheetTransform. |
TriangulationException.java | Class | Thrown when it is unable to generate TIN. |
TriangulationFactory.java | Class | Generates TIN with respect to delaunay criterion. |
TriangulationFactoryTest.java | Class | |