org.deegree.crs.configuration
Class TransformationFactory

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

public class TransformationFactory
extends Object

The TransformationFactory 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: 22634 $, $Date: 2010-02-19 11:32:33 +0100 (Fr, 19 Feb 2010) $

Author:

Rutger Bezema, last edited by: $Author: rbezema $

Constructor Summary

TransformationFactory(CRSProvider provider)
The default coordinate transformation factory.

Method Summary

Transformation

createFromCoordinateSystems(CoordinateSystem sourceCRS, CoordinateSystem targetCRS) Creates a transformation between two coordinate systems.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransformationFactory

TransformationFactory(CRSProvider provider)

The default coordinate transformation factory. Will be constructed only when first needed.

Parameters:

provider - used to do lookups of transformations

Method Detail

createFromCoordinateSystems

public Transformation createFromCoordinateSystems(CoordinateSystem sourceCRS,
                                                  CoordinateSystem targetCRS)
                                           throws TransformationException,
                                                  IllegalArgumentException

Creates a transformation between two coordinate systems. This method will examine the coordinate systems in order to construct a transformation between them.

Parameters:

sourceCRS - Input coordinate system.

targetCRS - Output coordinate system.

Returns:

A coordinate transformation from sourceCRS to targetCRS.

Throws:

TransformationException

TransformationException - if no transformation path has been found.

IllegalArgumentException - if the sourceCRS or targetCRS are null.