org.deegree.crs.transformations
Class TransformationFactory

java.lang.Object
  org.deegree.crs.transformations.TransformationFactory

public class TransformationFactory
extends Object

The GeocentricTransform class is the central access point for all transformations between different crs's.

It creates a transformation chain for two given CoordinateSystems by considering their type. For example the Transformation chain from EPSG:31466 ( a projected crs with underlying geographic crs epsg:4314 using the DHDN datum and the TransverseMercator Projection) to EPSG:28992 (another projected crs with underlying geographic crs epsg:4289 using the 'new Amersfoort Datum' and the StereographicAzimuthal Projection) would result in following Transformation Chain:

1. Inverse projection - thus getting the coordinates in lat/lon for geographic crs epsg:4314
2. Geodetic transformation - thus getting x-y-z coordinates for geographic crs epsg:4314
3. WGS84 transformation -thus getting the x-y-z coordinates for the WGS84 datum
4. Inverse WGS84 transformation -thus getting the x-y-z coordinates for the geodetic from epsg:4289
5. Inverse geodetic - thus getting the lat/lon for epsg:4289
6. projection - getting the coordinates (in meters) for epsg:28992

Version:

$Revision:$, $Date:$

Author:

Rutger Bezema, last edited by: $Author:$

Method Summary

CRSTransformation	createFromCoordinateSystems(CoordinateSystem sourceCRS, CoordinateSystem targetCRS) Creates a transformation between two coordinate systems.
static TransformationFactory	getInstance()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static TransformationFactory getInstance()

Returns:

the default coordinate transformation factory.

createFromCoordinateSystems

public CRSTransformation createFromCoordinateSystems(CoordinateSystem sourceCRS,
                                                     CoordinateSystem targetCRS)
                                              throws TransformationException

Creates a transformation between two coordinate systems. This method will examine the coordinate systems in order to construct a transformation between them. This method may fail if no path between the coordinate systems is found.

Parameters:

sourceCRS - Input coordinate system.

targetCRS - Output coordinate system.

Returns:

A coordinate transformation from sourceCS to targetCS.

Throws:

TransformationException

TransformationException - if no transformation path has been found.