org.deegree.model.crs
Class GeoTransformer

java.lang.Object
  org.deegree.model.crs.GeoTransformer

public class GeoTransformer
extends java.lang.Object

class for transforming deegree geometries to new coordinate reference systems.

------------------------------------------------------------

Version:

$Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18 Jun 2009) $

Author:

Andreas Poth, last edited by: $Author: mschneider $

Constructor Summary

GeoTransformer(CoordinateSystem targetCRS)
Creates a new GeoTransformer object.

GeoTransformer(CoordinateSystem targetCRS)
Creates a new GeoTransformer object.

GeoTransformer(java.lang.String targetCRS)
Creates a new GeoTransformer object, with the given id as the target CRS.

GeoTransformer(Transformation definedTransformation)

Method Summary

GridCoverage	transform(AbstractGridCoverage coverage, Envelope targetBBOX, int dstWidth, int dstHeight, int refPointsGridSize, int degree, javax.media.jai.Interpolation interpolation) transforms a GridCoverage into another coordinate reference system.
GridCoverage	transform(AbstractGridCoverage coverage, int refPointsGridSize, int degree, javax.media.jai.Interpolation interpolation) Deprecated.
java.awt.image.BufferedImage	transform(java.awt.image.BufferedImage img, Envelope sourceBBOX, Envelope targetBBOX, int dstWidth, int dstHeight, int refPointsGridSize, int degree, javax.media.jai.Interpolation interpolation) transforms an image into another coordinate reference system.
java.util.List<javax.vecmath.Point3d>	transform(CoordinateSystem sourceCRS, java.util.List<javax.vecmath.Point3d> points)
Envelope	transform(Envelope envelope, CoordinateSystem sourceCRS) Transforms a Envelope to the target crs of the GeoTransformer instance
Envelope	transform(Envelope envelope, CoordinateSystem sourceCRS, boolean regardDistortion) Transforms a Envelope to the target crs of the GeoTransformer instance This transformation takes rotation and distortion into account when regardDistortion is true.
Envelope	transform(Envelope envelope, java.lang.String sourceCRS) Transforms a Envelope to the target crs of the GeoTransformer instance
Envelope	transform(Envelope envelope, java.lang.String sourceCRS, boolean regardDistortion) Transforms a Envelope to the target crs of the GeoTransformer instance This transformation takes rotation and distortion into account when regardDistortion is true.
Feature	transform(Feature feature) transforms all geometries contained within the passed Feature into the target CRS of a GeoTransformer instance.
FeatureCollection	transform(FeatureCollection fc) transforms all geometries contained within the passed FeatureCollection into the target CRS of a GeoTransformer instance.
Geometry	transform(Geometry geo) transforms the coordinates of a deegree geometry to the target coordinate reference system.
Geometry	transform(Geometry geo, CoordinateSystem sourceCRS)

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoTransformer

public GeoTransformer(CoordinateSystem targetCRS)
               throws java.security.InvalidParameterException

Creates a new GeoTransformer object.

Parameters:

targetCRS -

Throws:

java.security.InvalidParameterException - if the given parameter is null.

GeoTransformer

public GeoTransformer(CoordinateSystem targetCRS)

Creates a new GeoTransformer object.

Parameters:

targetCRS -

Throws:

java.security.InvalidParameterException - if the given parameter is null.

GeoTransformer

public GeoTransformer(Transformation definedTransformation)

Parameters:

definedTransformation - to use instead of the CRSFactory.

GeoTransformer

public GeoTransformer(java.lang.String targetCRS)
               throws UnknownCRSException,
                      java.security.InvalidParameterException

Creates a new GeoTransformer object, with the given id as the target CRS.

Parameters:

targetCRS - an identifier to which all other CRS's shall be transformed.

Throws:

UnknownCRSException - if the given crs name could not be mapped to a valid (configured) crs.

java.security.InvalidParameterException - if the given parameter is null.

Method Detail

transform

public GridCoverage transform(AbstractGridCoverage coverage,
                              Envelope targetBBOX,
                              int dstWidth,
                              int dstHeight,
                              int refPointsGridSize,
                              int degree,
                              javax.media.jai.Interpolation interpolation)
                       throws CRSTransformationException

transforms a GridCoverage into another coordinate reference system.

Parameters:

coverage - grid coverage to definedTransformation

targetBBOX - envelope for the target coverage

dstWidth - width of the output coverage in pixel

dstHeight - height of the output coverage in pixel

refPointsGridSize - size of the grid used to calculate polynoms coefficients. E.g. 2 -≶ 4 points, 3 -≶ 9 points ...
Must be ≶= 2. Accuracy of coefficients increase with size of the grid. Speed decreases with size of the grid.

degree - The degree of the polynomial is supplied as an argument.

interpolation - interpolation method for warping the passed coverage. Can be null. In this case 'Nearest Neighbor' will be used as default

Returns:

a transformed GridCoverage.

Throws:

CRSTransformationException - if the gridCoverage could not be created or the transformation failed

transform

public java.awt.image.BufferedImage transform(java.awt.image.BufferedImage img,
                                              Envelope sourceBBOX,
                                              Envelope targetBBOX,
                                              int dstWidth,
                                              int dstHeight,
                                              int refPointsGridSize,
                                              int degree,
                                              javax.media.jai.Interpolation interpolation)
                                       throws CRSTransformationException

transforms an image into another coordinate reference system.

Parameters:

img - the image to definedTransformation

sourceBBOX - envelope of the source image

targetBBOX - envelope for the target image

dstWidth - width of the output image in pixel

dstHeight - height of the output image in pixel

refPointsGridSize - size of the grid used to calculate polynoms coefficients. E.g. 2 -≶ 4 points, 3 -≶ 9 points ...
Must be ≶= 2. Accuracy of coefficients increase with size of the grid. Speed decreases with size of the grid.

degree - The degree of the polynomial is supplied as an argument.

interpolation - interpolation method for warping the passed image. Can be null. In this case 'Nearest Neighbor' will be used as default

Returns:

a transformed image.

Throws:

CRSTransformationException - if the image could not be created or the transformation failed

transform

@Deprecated
public GridCoverage transform(AbstractGridCoverage coverage,
                                         int refPointsGridSize,
                                         int degree,
                                         javax.media.jai.Interpolation interpolation)
                       throws CRSTransformationException

Deprecated.

transforms a GridCoverage into another coordinate reference system.

Parameters:

coverage - grid coverage to definedTransformation

refPointsGridSize - size of the grid used to calculate polynoms coefficients. E.g. 2 -≶ 4 points, 3 -≶ 9 points ...
Must be ≶= 2. Accuracy of coefficients increase with size of the grid. Speed decreases with size of the grid.

degree - The degree of the polynomial is supplied as an argument.

interpolation - interpolation method for warping the passed coverage. Can be null. In this case 'Nearest Neighbor' will be used as default

Returns:

a transformed GridCoverage.

Throws:

CRSTransformationException - if the gridCoverage could not be created or the transformation failed

transform

public Envelope transform(Envelope envelope,
                          CoordinateSystem sourceCRS)
                   throws CRSTransformationException

Transforms a Envelope to the target crs of the GeoTransformer instance

Parameters:

envelope - to definedTransformation

sourceCRS - CRS of the envelope

Returns:

the transformed envelope

Throws:

CRSTransformationException

transform

public Envelope transform(Envelope envelope,
                          java.lang.String sourceCRS,
                          boolean regardDistortion)
                   throws CRSTransformationException,
                          UnknownCRSException

Transforms a Envelope to the target crs of the GeoTransformer instance This transformation takes rotation and distortion into account when regardDistortion is true. Otherwise the transformed envelope may not contain the whole input envelope.

Parameters:

envelope - to definedTransformation

sourceCRS - CRS of the envelope

regardDistortion -

Returns:

the transformed envelope

Throws:

CRSTransformationException

UnknownCRSException

transform

public Envelope transform(Envelope envelope,
                          CoordinateSystem sourceCRS,
                          boolean regardDistortion)
                   throws CRSTransformationException

Transforms a Envelope to the target crs of the GeoTransformer instance This transformation takes rotation and distortion into account when regardDistortion is true. Otherwise the transformed envelope may not contain the whole input envelope.

Parameters:

envelope - to definedTransformation

sourceCRS - CRS of the envelope

regardDistortion -

Returns:

the transformed envelope

Throws:

CRSTransformationException

transform

public java.util.List<javax.vecmath.Point3d> transform(CoordinateSystem sourceCRS,
                                                       java.util.List<javax.vecmath.Point3d> points)
                                                throws CRSTransformationException,
                                                       java.lang.IllegalArgumentException

Parameters:

sourceCRS - in which the given points are referenced.

points - to definedTransformation.

Returns:

a list of transformed point3d's or an empty list if something went wrong, never null

Throws:

CRSTransformationException - if no transformation could be created for the given source and target crs.

java.lang.IllegalArgumentException - if the sourceCRS is null

transform

public Envelope transform(Envelope envelope,
                          java.lang.String sourceCRS)
                   throws CRSTransformationException,
                          UnknownCRSException

Transforms a Envelope to the target crs of the GeoTransformer instance

Parameters:

envelope - to definedTransformation

sourceCRS - CRS of the envelope

Returns:

the transformed envelope

Throws:

CRSTransformationException - if the transformation did not succeed.

UnknownCRSException - if the given string is unknown to the CRSProvider

transform

public Feature transform(Feature feature)
                  throws CRSTransformationException

transforms all geometries contained within the passed Feature into the target CRS of a GeoTransformer instance. If a geometry was transformed the Feature.setEnvelopesUpdated() method will be called.

Parameters:

feature -

Returns:

the transformed geometries in the given Feature.

Throws:

CRSTransformationException

transform

public FeatureCollection transform(FeatureCollection fc)
                            throws CRSTransformationException

transforms all geometries contained within the passed FeatureCollection into the target CRS of a GeoTransformer instance.

Parameters:

fc - the collection to definedTransformation

Returns:

the transformed geometries in the FeatureCollection

Throws:

CRSTransformationException - if the transformation cannot be created or processed.

transform

public Geometry transform(Geometry geo)
                   throws CRSTransformationException,
                          java.lang.IllegalArgumentException

transforms the coordinates of a deegree geometry to the target coordinate reference system.

Parameters:

geo - to be transformed

Returns:

the same geometry in a different crs.

Throws:

CRSTransformationException - if the transformation between the source and target crs cannot be created.

java.lang.IllegalArgumentException - if the coordinates system of the geometry is null

transform

public Geometry transform(Geometry geo,
                          CoordinateSystem sourceCRS)
                   throws CRSTransformationException

Parameters:

geo -

sourceCRS -

Returns:

a transformed geometry

Throws:

CRSTransformationException