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

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

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

Method Summary

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, 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.