org.geotools.ct
Class CoordinateTransformation

java.lang.Object
  org.geotools.cs.Info
      org.geotools.ct.CoordinateTransformation

All Implemented Interfaces:

org.opengis.referencing.IdentifiedObject, java.io.Serializable

Deprecated. Replaced by AbstractCoordinateOperation.

public class CoordinateTransformation

extends Info

Describes a coordinate transformation. A coordinate transformation class establishes an association between a source and a target coordinate reference system, and provides a MathTransform for transforming coordinates in the source coordinate reference system to coordinates in the target coordinate reference system. These coordinate systems can be ground or image coordinates. In general mathematics, "transformation" is the general term for mappings between coordinate systems (see tensor analysis).

For a ground coordinate point, if the transformation depends only on mathematically derived parameters (as in a cartographic projection), then this is an ISO conversion. If the transformation depends on empirically derived parameters (as in datum transformations), then this is an ISO transformation.

Version:

$Id: CoordinateTransformation.java 17672 2006-01-19 00:25:55Z desruisseaux $

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CT_CoordinateTransformation, Serialized Form

Field Summary

protected MathTransform

transform Deprecated. The underlying math transform, or null if it doesn't has been constructed yet.

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

CoordinateTransformation(java.lang.String name, CoordinateSystem sourceCS, CoordinateSystem targetCS, TransformType type, MathTransform transform)
Deprecated. Construct a coordinate transformation.

Method Summary

boolean	equals(Info object, boolean compareNames) Deprecated. Compares the specified object with this coordinate transformation for equality.
MathTransform	getMathTransform() Deprecated. Replaced by AbstractCoordinateOperation.getMathTransform().
java.lang.String	getName(java.util.Locale locale) Deprecated. Replaced by AbstractIdentifiedObject.getName().
CoordinateSystem	getSourceCS() Deprecated. Replaced by AbstractCoordinateOperation.getSourceCRS().
CoordinateSystem	getTargetCS() Deprecated. Replaced by AbstractCoordinateOperation.getTargetCRS().
TransformType	getTransformType() Deprecated. No direct replacement. Check for instance of Conversion or Transformation instead.
int	hashCode() Deprecated. Returns a hash value for this coordinate transformation.
CoordinateTransformation	inverse() Deprecated. Returns the inverse transform of this object.

Methods inherited from class org.geotools.cs.Info

ensureNonNull, equals, getAbbreviation, getAlias, getAlias, getAuthority, getAuthorityCode, getIdentifiers, getName, getRemarks, toString, toWKT

Methods inherited from class java.lang.Object

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

Field Detail

transform

protected MathTransform transform

Deprecated.

The underlying math transform, or null if it doesn't has been constructed yet. If null, then subclass must initialize this field the first time getMathTransform() is invoked.

Constructor Detail

CoordinateTransformation

public CoordinateTransformation(java.lang.String name,
                                CoordinateSystem sourceCS,
                                CoordinateSystem targetCS,
                                TransformType type,
                                MathTransform transform)

Deprecated.

Construct a coordinate transformation.

Parameters:

name - The coordinate transformation name, or null for an automatically generated name.

sourceCS - The source coordinate system.

targetCS - The destination coordinate system.

type - The transform type.

transform - The math transform. This argument is allowed to be null only if this constructor is invoked from within a subclass constructor. In this case, the subclass must construct a math transform no later than the first time getMathTransform() is invoked.

Method Detail

getName

public java.lang.String getName(java.util.Locale locale)

Deprecated. Replaced by AbstractIdentifiedObject.getName().

Gets the name of this coordinate transformation.

Parameters:

locale - The desired locale, or null for the default locale.

getSourceCS

public CoordinateSystem getSourceCS()

Deprecated. Replaced by AbstractCoordinateOperation.getSourceCRS().

Gets the source coordinate system.

See Also:

CT_CoordinateTransformation.getSourceCS()

getTargetCS

public CoordinateSystem getTargetCS()

Deprecated. Replaced by AbstractCoordinateOperation.getTargetCRS().

Gets the target coordinate system.

See Also:

CT_CoordinateTransformation.getTargetCS()

getTransformType

public TransformType getTransformType()

Deprecated. No direct replacement. Check for instance of Conversion or Transformation instead.

Gets the semantic type of transform. For example, a datum transformation or a coordinate conversion.

See Also:

CT_CoordinateTransformation.getTransformType()

getMathTransform

public MathTransform getMathTransform()

Deprecated. Replaced by AbstractCoordinateOperation.getMathTransform().

Gets the math transform. The math transform will transform positions in the source coordinate system into positions in the target coordinate system.

See Also:

CT_CoordinateTransformation.getMathTransform()

inverse

public CoordinateTransformation inverse()
                                 throws org.opengis.referencing.operation.NoninvertibleTransformException

Deprecated.

Returns the inverse transform of this object.

Throws:

org.opengis.referencing.operation.NoninvertibleTransformException

hashCode

public int hashCode()

Deprecated.

Returns a hash value for this coordinate transformation.

Overrides:

hashCode in class Info

Returns:

The hash code value. This value doesn't need to be the same in past or future versions of this class.

equals

public boolean equals(Info object,
                      boolean compareNames)

Deprecated.

Compares the specified object with this coordinate transformation for equality. The default implementation compare name, transform type, source and target coordinate systems. It doesn't compare the math transform, since it should be equivalents if the above mentionned parameters are equal.

Overrides:

equals in class Info

Parameters:

object - The object to compare to this.

compareNames - true to comparare the name, alias, authority code, etc. as well, or false to compare only properties relevant to transformations.

Returns:

true if both objects are equal.