org.geotools.referencing.operation.transform

Class GeocentricTranslation

Object

Formattable

AbstractMathTransform

ProjectiveTransform

GeocentricTranslation

All Implemented Interfaces:

Serializable, LinearTransform, MathTransform

public class GeocentricTranslation
extends ProjectiveTransform

An affine transform applied on geocentric coordinates. While "geocentric translation" is a little bit more restrictive name, it describes the part which is common to all instances of this class. A rotation may also be performed in addition of the translation, but the rotation sign is operation-dependent (EPSG 9606 and 9607 have opposite sign). This transform is used for the following operations:

EPSG name	EPSG code
Geocentric translations	9603
Position Vector 7-param. transformation	9606
Coordinate Frame rotation	9607

The conversion between geographic and geocentric coordinates is usually not part of this transform. However, the Geotools implementation of the provider accepts the following extensions:

• If "src_semi_major" and "src_semi_minor" parameters are provided, then a "Ellipsoid_To_Geocentric" transform is concatenated before this transform.
• If "tgt_semi_major" and "tgt_semi_minor" parameters are provided, then a "Geocentric_To_Ellipsoid" transform is concatenated after this transform.

Since:

2.2

Author:

Martin Desruisseaux (IRD)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GeocentricTranslation.Provider Base class for geocentric affine transform providers.
static class	GeocentricTranslation.ProviderFrameRotation Geocentric affine transform provider for "Coordinate Frame rotation".
static class	GeocentricTranslation.ProviderSevenParam Base class for geocentric affine transform providers with rotation terms.

Nested classes/interfaces inherited from class ProjectiveTransform

ProjectiveTransform.ProviderAffine, ProjectiveTransform.ProviderLongitudeRotation

Nested classes/interfaces inherited from class AbstractMathTransform

AbstractMathTransform.Inverse

Field Summary

Fields inherited from class Formattable

SINGLE_LINE

Constructor Summary

Constructors

Constructor and Description
GeocentricTranslation(BursaWolfParameters parameters) Creates a new geocentric affine transform.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object object) Compares the specified object with this math transform for equality.
ParameterDescriptorGroup	getParameterDescriptors() Returns the parameter descriptors for this math transform.
ParameterValueGroup	getParameterValues() Returns the parameters for this math transform.
int	hashCode() Returns a hash value for this transform.

Methods inherited from class ProjectiveTransform

create, create, createScale, createSelectMatrix, createTranslation, derivative, derivative, getMatrix, getSourceDimensions, getTargetDimensions, inverse, isIdentity, isIdentity, transform, transform

Methods inherited from class AbstractMathTransform

createTransformedShape, ensureNonNull, formatWKT, getName, needCopy, normalizeAngle, rollLongitude, transform, transform, transform, transform

Methods inherited from class Formattable

cleanupThreadLocals, toString, toWKT, toWKT, toWKT, toWKT

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface MathTransform

toWKT, transform, transform, transform

Constructor Detail

GeocentricTranslation

public GeocentricTranslation(BursaWolfParameters parameters)

Creates a new geocentric affine transform. If the parameters don't contain rotation terms, then this transform will be of kind "Geocentric translations". Otherwise, it will be of kind "Position Vector 7-param. transformation".

Parameters:

parameters - The Bursa-Wolf parameters to use for initializing the transformation.

Method Detail

getParameterDescriptors

public ParameterDescriptorGroup getParameterDescriptors()

Returns the parameter descriptors for this math transform.

Overrides:

getParameterDescriptors in class ProjectiveTransform

Returns:

The parameter descriptors for this math transform, or null.

See Also:

OperationMethod.getParameters()

getParameterValues

public ParameterValueGroup getParameterValues()

Returns the parameters for this math transform.

Overrides:

getParameterValues in class ProjectiveTransform

Returns:

A copy of the parameter values for this math transform.

See Also:

Operation.getParameterValues()

hashCode

public int hashCode()

Returns a hash value for this transform. This value need not remain consistent between different implementations of the same class.

Overrides:

hashCode in class ProjectiveTransform

equals

public boolean equals(Object object)

Compares the specified object with this math transform for equality.

Overrides:

equals in class ProjectiveTransform

Parameters:

object - The object to compare with this transform.

Returns:

true if the given object is a transform of the same class and if, given identical source position, the transformed position would be the equals.