org.geotoolkit.referencing.operation.transform
Interface LinearTransform

All Superinterfaces:

LenientComparable, MathTransform

All Known Implementing Classes:

AffineTransform2D, GeocentricAffineTransform, IdentityTransform, LinearTransform1D, ProjectiveTransform

public interface LinearTransform
extends MathTransform, LenientComparable

A MathTransform which can be represented by a matrix. Such transforms are often affine, but not necessarily.

The number of columns is equal to the number of source dimensions plus 1, and the number of rows is equal to the number of target dimensions plus 1.

Since:

2.0

Version:

3.18

Author:

Martin Desruisseaux (IRD, Geomatys)

Module:

referencing/geotk-referencing (download)

View source code for this class

Method Summary

boolean	equals(Object object, ComparisonMode mode) Compares this linear transform with the given object for equality.
Matrix	getMatrix() Returns this transform as an affine transform matrix.
boolean	isIdentity(double tolerance) Tests whether this transform does not move any points, by using the provided tolerance value.

Methods inherited from interface MathTransform

derivative, getSourceDimensions, getTargetDimensions, inverse, isIdentity, toWKT, transform, transform, transform, transform, transform

Methods inherited from interface LenientComparable

equals

Method Detail

getMatrix

Matrix getMatrix()

Returns this transform as an affine transform matrix.

Returns:

A copy of the underlying matrix.

isIdentity

boolean isIdentity(double tolerance)

Tests whether this transform does not move any points, by using the provided tolerance value. The signification of tolerance value is the same than in the following pseudo-code:

((Xmatrix) getMatrix()).isIdentity(tolerance);

Parameters:

tolerance - The tolerance factor.

Returns:

true if this transform is the identity one

Since:

2.4

See Also:

MatrixFactory.getMatrix(MathTransform), XMatrix.isIdentity(double)

equals

boolean equals(Object object,
               ComparisonMode mode)

Compares this linear transform with the given object for equality. To be considered equal, the two objects must meet the following conditions, which depend on the mode argument:

• STRICT: the two transforms must be of the same class and have the same parameter values.
• All other modes: the two transforms shall compare only their matrixes as documented in the XMatrix.equals(…) javadoc. This rule is based on the assumption that the linear transforms behavior are fully determined by their matrix.

Specified by:

equals in interface LenientComparable

Parameters:

object - The object to compare to this.

mode - The strictness level of the comparison.

Returns:

true if both objects are equal.

Since:

3.18