org.geotools.ct
Class CoordinateTransformationFactory

java.lang.Object
  extended byorg.geotools.ct.CoordinateTransformationFactory

Deprecated. Replaced by org.geotools.referencing.operation.DefaultCoordinateOperationFactory

public class CoordinateTransformationFactory
extends java.lang.Object

Creates coordinate transformations.

Version:
$Id: CoordinateTransformationFactory.java 17672 2006-01-19 00:25:55Z desruisseaux $
Author:
OpenGIS, Martin Desruisseaux
See Also:
CT_CoordinateTransformationFactory

Constructor Summary
CoordinateTransformationFactory(MathTransformFactory factory)
          Deprecated. Construct a coordinate transformation factory.
 
Method Summary
 CoordinateTransformation createFromCoordinateSystems(CoordinateSystem sourceCS, CoordinateSystem targetCS)
          Deprecated. Creates a transformation between two coordinate systems.
protected  CoordinateTransformation createTransformationStep(CompoundCoordinateSystem sourceCS, CompoundCoordinateSystem targetCS)
          Deprecated. Creates a transformation between two compound coordinate systems.
protected  CoordinateTransformation createTransformationStep(GeocentricCoordinateSystem sourceCS, GeocentricCoordinateSystem targetCS)
          Deprecated. Creates a transformation between two geocentric coordinate systems.
protected  CoordinateTransformation createTransformationStep(GeocentricCoordinateSystem sourceCS, GeographicCoordinateSystem targetCS, VerticalCoordinateSystem verticalCS)
          Deprecated. Creates a transformation from a geocentric to a geographic coordinate systems.
protected  CoordinateTransformation createTransformationStep(GeocentricCoordinateSystem sourceCS, ProjectedCoordinateSystem targetCS, VerticalCoordinateSystem verticalCS)
          Deprecated. Creates a transformation from a geocentric to a projected coordinate systems.
protected  CoordinateTransformation createTransformationStep(GeographicCoordinateSystem sourceCS, VerticalCoordinateSystem verticalCS, GeocentricCoordinateSystem targetCS)
          Deprecated. Creates a transformation from a geographic to a geocentric coordinate systems.
protected  CoordinateTransformation createTransformationStep(GeographicCoordinateSystem sourceCS, VerticalCoordinateSystem sourceVCS, GeographicCoordinateSystem targetCS, VerticalCoordinateSystem targetVCS)
          Deprecated. Creates a transformation between two geographic coordinate systems.
protected  CoordinateTransformation createTransformationStep(GeographicCoordinateSystem sourceCS, VerticalCoordinateSystem sourceVCS, ProjectedCoordinateSystem targetCS, VerticalCoordinateSystem targetVCS)
          Deprecated. Creates a transformation from a geographic to a projected coordinate systems.
protected  CoordinateTransformation createTransformationStep(ProjectedCoordinateSystem sourceCS, VerticalCoordinateSystem verticalCS, GeocentricCoordinateSystem targetCS)
          Deprecated. Creates a transformation from a projected to a geocentric coordinate systems.
protected  CoordinateTransformation createTransformationStep(ProjectedCoordinateSystem sourceCS, VerticalCoordinateSystem sourceVCS, GeographicCoordinateSystem targetCS, VerticalCoordinateSystem targetVCS)
          Deprecated. Creates a transformation from a projected to a geographic coordinate systems.
protected  CoordinateTransformation createTransformationStep(ProjectedCoordinateSystem sourceCS, VerticalCoordinateSystem sourceVCS, ProjectedCoordinateSystem targetCS, VerticalCoordinateSystem targetVCS)
          Deprecated. Creates a transformation between two projected coordinate systems.
protected  CoordinateTransformation createTransformationStep(TemporalCoordinateSystem sourceCS, TemporalCoordinateSystem targetCS)
          Deprecated. Creates a transformation between two temporal coordinate systems.
protected  CoordinateTransformation createTransformationStep(VerticalCoordinateSystem sourceCS, VerticalCoordinateSystem targetCS)
          Deprecated. Creates a transformation between two vertical coordinate systems.
static CoordinateTransformationFactory getDefault()
          Deprecated. Returns the default coordinate transformation factory.
 MathTransformFactory getMathTransformFactory()
          Deprecated. Returns the underlying math transform factory.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CoordinateTransformationFactory

public CoordinateTransformationFactory(MathTransformFactory factory)
Deprecated. 
Construct a coordinate transformation factory.

Parameters:
factory - The math transform factory to use.
Method Detail

getDefault

public static CoordinateTransformationFactory getDefault()
Deprecated. 
Returns the default coordinate transformation factory.


getMathTransformFactory

public final MathTransformFactory getMathTransformFactory()
Deprecated. 
Returns the underlying math transform factory. This factory is used for constructing MathTransform objects for all CoordinateTransformation.


createFromCoordinateSystems

public CoordinateTransformation createFromCoordinateSystems(CoordinateSystem sourceCS,
                                                            CoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two coordinate systems. This method will examine the coordinate systems and delegate the work to one or many createTransformationStep(...) methods. This method fails if no path between the coordinate systems is found.

Parameters:
sourceCS - Input coordinate system.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.
See Also:
CT_CoordinateTransformationFactory.createFromCoordinateSystems(org.opengis.cs.CS_CoordinateSystem, org.opengis.cs.CS_CoordinateSystem)

createTransformationStep

protected CoordinateTransformation createTransformationStep(TemporalCoordinateSystem sourceCS,
                                                            TemporalCoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two temporal coordinate systems. The default implementation checks if both coordinate systems use the same datum, and then adjusts for axis orientation, units and epoch.

Parameters:
sourceCS - Input coordinate system.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(VerticalCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two vertical coordinate systems. The default implementation checks if both coordinate systems use the same datum, and then adjusts for axis orientation and units.

Parameters:
sourceCS - Input coordinate system.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(GeographicCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem sourceVCS,
                                                            GeographicCoordinateSystem targetCS,
                                                            VerticalCoordinateSystem targetVCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two geographic coordinate systems. The default implementation can adjust axis order and orientation (e.g. transforming from (NORTH,WEST) to (EAST,NORTH)), performs units conversion and apply Bursa Wolf transformation if needed.

Parameters:
sourceCS - The input horizontal coordinate system.
sourceVCS - The input vertical coordinate system, or null if none.
targetCS - The output horizontal coordinate system.
targetVCS - The output vertical coordinate system, or null if none.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.
Task:
TODO: When rotating the prime meridian, we should ensure that transformed longitudes stay in the range [-180..+180?].

createTransformationStep

protected CoordinateTransformation createTransformationStep(ProjectedCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem sourceVCS,
                                                            ProjectedCoordinateSystem targetCS,
                                                            VerticalCoordinateSystem targetVCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two projected coordinate systems. The default implementation can adjust axis order and orientation. It also performs units conversion if it is the only extra change needed. Otherwise, it performs three steps:
  1. Unproject sourceCS.
  2. Transform from sourceCS.geographicCS to targetCS.geographicCS.
  3. Project targetCS.

Parameters:
sourceCS - The input horizontal coordinate system.
sourceVCS - The input vertical coordinate system, or null if none.
targetCS - The output horizontal coordinate system.
targetVCS - The output vertical coordinate system, or null if none.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.
Task:
REVISIT: What to do about prime meridian?

createTransformationStep

protected CoordinateTransformation createTransformationStep(GeographicCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem sourceVCS,
                                                            ProjectedCoordinateSystem targetCS,
                                                            VerticalCoordinateSystem targetVCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation from a geographic to a projected coordinate systems.

Parameters:
sourceCS - The input horizontal coordinate system.
sourceVCS - The input vertical coordinate system, or null if none.
targetCS - The output horizontal coordinate system.
targetVCS - The output vertical coordinate system, or null if none.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(ProjectedCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem sourceVCS,
                                                            GeographicCoordinateSystem targetCS,
                                                            VerticalCoordinateSystem targetVCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation from a projected to a geographic coordinate systems. The default implementation returns createTransformationStep(targetCS, targetVCS, sourceCS, sourceVCS).inverse().

Parameters:
sourceCS - The input horizontal coordinate system.
sourceVCS - The input vertical coordinate system, or null if none.
targetCS - The output horizontal coordinate system.
targetVCS - The output vertical coordinate system, or null if none.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(GeocentricCoordinateSystem sourceCS,
                                                            GeocentricCoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two geocentric coordinate systems. The default implementation can adjust for axis order and orientation, performs units conversion and apply Bursa Wolf transformation if needed.

Parameters:
sourceCS - Input coordinate system.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(GeographicCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem verticalCS,
                                                            GeocentricCoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation from a geographic to a geocentric coordinate systems. Since the source coordinate systems doesn't have a vertical axis, height above the ellipsoid is assumed equals to zero everywhere.

Parameters:
sourceCS - Input geographic coordinate system.
verticalCS - Input vertical coordinate system, or null if none.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(GeocentricCoordinateSystem sourceCS,
                                                            GeographicCoordinateSystem targetCS,
                                                            VerticalCoordinateSystem verticalCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation from a geocentric to a geographic coordinate systems. The default implementation returns createTransformationStep(targetCS, verticalCS, sourceCS).inverse().

Parameters:
sourceCS - Input coordinate system.
targetCS - Output coordinate system.
verticalCS - Output vertical coordinate system, or null if none.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(ProjectedCoordinateSystem sourceCS,
                                                            VerticalCoordinateSystem verticalCS,
                                                            GeocentricCoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation from a projected to a geocentric coordinate systems.

Parameters:
sourceCS - Input projected coordinate system.
verticalCS - Input vertical coordinate system, or null if none.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(GeocentricCoordinateSystem sourceCS,
                                                            ProjectedCoordinateSystem targetCS,
                                                            VerticalCoordinateSystem verticalCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation from a geocentric to a projected coordinate systems.

Parameters:
sourceCS - Input projected coordinate system.
targetCS - Output coordinate system.
verticalCS - Output vertical coordinate system, or null if none.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.

createTransformationStep

protected CoordinateTransformation createTransformationStep(CompoundCoordinateSystem sourceCS,
                                                            CompoundCoordinateSystem targetCS)
                                                     throws CannotCreateTransformException
Deprecated. 
Creates a transformation between two compound coordinate systems.

Parameters:
sourceCS - Input coordinate system.
targetCS - Output coordinate system.
Returns:
A coordinate transformation from sourceCS to targetCS.
Throws:
CannotCreateTransformException - if no transformation path has been found.


Copyright © GeoTools. All Rights Reserved.