org.deegree.crs.transformations
Class GeocentricTransform

java.lang.Object
  org.deegree.crs.Identifiable
      org.deegree.crs.transformations.CRSTransformation
          org.deegree.crs.transformations.GeocentricTransform

public class GeocentricTransform
extends CRSTransformation

The GeocentricTransform class is used to create a transformation between a geocentric CRS (having lat-lon coordinates) and it's geodetic CRS (having x-y-z) coordinates and vice versa.

Version:

$Revision:$, $Date:$

Author:

Rutger Bezema, last edited by: $Author:$

Field Summary

Fields inherited from class org.deegree.crs.transformations.CRSTransformation

isInverse

Constructor Summary

GeocentricTransform(GeographicCRS source, GeocentricCRS target)
This constructor creates an identifier with following form: FROM_id1_TO_id2.

GeocentricTransform(GeographicCRS source, GeocentricCRS target, String identifier)

GeocentricTransform(GeographicCRS source, GeocentricCRS target, String identifier, String version, String description, String areaOfUse)

Method Summary

List<javax.vecmath.Point3d>	doTransform(List<javax.vecmath.Point3d> srcPts) Do a transformation, e.g. the incoming data comes from the sourceCRS and must be transformed to the targetCRS.
double	getSemiMajorAxis()
double	getSemiMinorAxis()
boolean	isIdentity()
protected void	toGeoCentric(List<javax.vecmath.Point3d> srcPts)
protected void	toGeographic(List<javax.vecmath.Point3d> srcPts) Converts geocentric coordinates (x, y, z) to geodetic coordinates (longitude, latitude, height), according to the current ellipsoid parameters.

Methods inherited from class org.deegree.crs.transformations.CRSTransformation

areInverse, createFromTo, doTransform, doTransform, getSourceCRS, getSourceDimension, getTargetCRS, getTargetDimension, getTransformationName, getTransformationPath, inverse, isInverseTransform

Methods inherited from class org.deegree.crs.Identifiable

checkForNullObject, checkForNullObject, getAreaOfUse, getAreasOfUse, getDescription, getDescriptions, getIdAndName, getIdentifier, getIdentifiers, getName, getNames, getVersion, getVersions, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GeocentricTransform

public GeocentricTransform(GeographicCRS source,
                           GeocentricCRS target,
                           String identifier,
                           String version,
                           String description,
                           String areaOfUse)

Parameters:

source - the geographic crs.

target - the geocentric crs.

identifier -

name -

version -

description -

areaOfUse -

GeocentricTransform

public GeocentricTransform(GeographicCRS source,
                           GeocentricCRS target,
                           String identifier)

Parameters:

source - the geographic crs.

target - the geocentric crs.

identifier -

GeocentricTransform

public GeocentricTransform(GeographicCRS source,
                           GeocentricCRS target)

This constructor creates an identifier with following form: FROM_id1_TO_id2. The name will be generated the same way (with getName() instead).

Parameters:

source - the geographic crs.

target - the geocentric crs.

Method Detail

doTransform

public List<javax.vecmath.Point3d> doTransform(List<javax.vecmath.Point3d> srcPts)

Description copied from class: CRSTransformation

Do a transformation, e.g. the incoming data comes from the sourceCRS and must be transformed to the targetCRS.

Specified by:

doTransform in class CRSTransformation

Parameters:

srcPts - the points which must be transformed, expected are following values either, long_1, lat_1, height_1, long_2, lat_2, height_2. or long_1, lat_1, long_2, lat_2

Returns:

the transformed points

toGeographic

protected void toGeographic(List<javax.vecmath.Point3d> srcPts)

Converts geocentric coordinates (x, y, z) to geodetic coordinates (longitude, latitude, height), according to the current ellipsoid parameters. The method used here is derived from "An Improved Algorithm for Geocentric to Geodetic Coordinate Conversion", by Ralph Toms, Feb 1996 UCRL-JC-123138.

Parameters:

srcPts - the points which must be transformed.

toGeoCentric

protected void toGeoCentric(List<javax.vecmath.Point3d> srcPts)

isIdentity

public boolean isIdentity()

Specified by:

isIdentity in class CRSTransformation

Returns:

true if this transformation doesn't transform the incoming points. (e.g. is the id. matrix)

getSemiMajorAxis

public final double getSemiMajorAxis()

Returns:

the semiMajorAxis.

getSemiMinorAxis

public final double getSemiMinorAxis()

Returns:

the semiMinorAxis.