org.geotoolkit.referencing.operation.transform
Interface EllipsoidalTransform

All Superinterfaces:

MathTransform

All Known Implementing Classes:

GeocentricTransform, MolodenskyTransform

public interface EllipsoidalTransform
extends MathTransform

A MathTransform where the source and/or the target coordinate system is ellipsoidal. Those transforms can work on two- or three- dimensional coordinates, where the third coordinate (the height) is assumed to be zero in the two-dimensional case.

Since:

3.16

Version:

3.16

Author:

Martin Desruisseaux (Geomatys)

Module:

referencing/geotk-referencing (download)

View source code for this class

Method Summary

EllipsoidalTransform

forDimensions(boolean source3D, boolean target3D) Returns a transform performing the same calculation than this, but using the specified number of dimensions.

Methods inherited from interface MathTransform

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

Method Detail

forDimensions

EllipsoidalTransform forDimensions(boolean source3D,
                                   boolean target3D)
                                   throws IllegalArgumentException

Returns a transform performing the same calculation than this, but using the specified number of dimensions. EllipsoidalTransforms work conceptually on three-dimensional coordinates, but the ellipsoidal height can be omitted resulting in two-dimensional coordinates. No dimensions other than 2 or 3 are allowed.

• If the height is omitted from the input coordinates (source3D = false), then the source dimensions is 2 and the height is assumed to be zero.
• If the height is omitted from the output coordinates (target3D = false), then the target dimensions is 2 and the computed height (typically non-zero even if the input height was zero) is lost.

Parameters:

source3D - true if the source coordinates have a height.

target3D - true if the target coordinates have a height.

Returns:

A transform having the requested source and target dimensions (may be this).

Throws:

IllegalArgumentException - If a dimension can not be changed.