org.geotools.referencing.operation.builder

Class RubberSheetBuilder

Object

MathTransformBuilder

RubberSheetBuilder

public class RubberSheetBuilder
extends MathTransformBuilder

Builds a RubberSheet transformation from a set of control points, defined as a List of MappedPosition objects, and a quadrilateral delimiting the outer area of interest, defined as a List of four DirectPosition objects.

An explanation of the RubberSheet transformation algorithm can be seen here.

Since:

2.4

Author:

Jan Jezek, Adrian Custer

Field Summary

Fields inherited from class MathTransformBuilder

mtFactory

Constructor Summary

Constructors

Constructor and Description
RubberSheetBuilder(List<MappedPosition> vectors, List<DirectPosition> vertices) Creates the Builder from a List of control points and a List of four DirectPositions defining the vertexes of the area for interpolation.

Method Summary

Modifier and Type	Method and Description
protected MathTransform	computeMathTransform() Returns MathTransform transformation setup as RubberSheet.
HashMap	getMapTriangulation() Returns the map of source and destination triangles.
int	getMinimumPointCount() Returns the minimum number of points required by this builder.

Methods inherited from class MathTransformBuilder

getCoordinateSystemType, getDimension, getErrorStatistics, getMappedPositions, getMathTransform, getName, getSourceCRS, getSourcePoints, getTargetCRS, getTargetPoints, getTransformation, printPoints, setMappedPositions, setSourcePoints, setTargetPoints, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RubberSheetBuilder

public RubberSheetBuilder(List<MappedPosition> vectors,
                          List<DirectPosition> vertices)
                   throws IllegalArgumentException,
                          MismatchedDimensionException,
                          MismatchedReferenceSystemException,
                          TriangulationException

Creates the Builder from a List of control points and a List of four DirectPositions defining the vertexes of the area for interpolation.

Parameters:

vectors - A List of MappedPosition

vertices - A List with four points defining the quadrilateral in the region of interest.

Throws:

IllegalArgumentException

MismatchedDimensionException

MismatchedReferenceSystemException

TriangulationException

Method Detail

getMinimumPointCount

public int getMinimumPointCount()

Returns the minimum number of points required by this builder.

Specified by:

getMinimumPointCount in class MathTransformBuilder

Returns:

1

getMapTriangulation

public HashMap getMapTriangulation()

Returns the map of source and destination triangles.

Returns:

The Map of source and destination triangles.

computeMathTransform

protected MathTransform computeMathTransform()
                                      throws FactoryException

Returns MathTransform transformation setup as RubberSheet.

Specified by:

computeMathTransform in class MathTransformBuilder

Returns:

calculated MathTransform

Throws:

FactoryException - when the size of source and destination point is not the same.