org.deegree.crs.transformations
Class WGS84ConversionInfo

java.lang.Object
  org.deegree.crs.Identifiable
      org.deegree.crs.transformations.WGS84ConversionInfo

public class WGS84ConversionInfo
extends Identifiable

Parameters for a geographic transformation into WGS84. The Bursa Wolf parameters should be applied to geocentric coordinates, where the X axis points towards the Greenwich Prime Meridian, the Y axis points East, and the Z axis points North.

Version:

$Revision:$, $Date:$

Author:

Rutger Bezema, last edited by: $Author:$

Field Summary

double	dx Bursa Wolf shift in meters.
double	dy Bursa Wolf shift in meters.
double	dz Bursa Wolf shift in meters.
double	ex Bursa Wolf rotation in arc seconds, which is 1/3600 of a degree.
double	ey Bursa Wolf rotation in arc seconds.
double	ez Bursa Wolf rotation in arc seconds.
double	ppm Bursa Wolf scaling in parts per million.

Constructor Summary

WGS84ConversionInfo(double dx, double dy, double dz, double ex, double ey, double ez, double ppm, Identifiable identifiable)

WGS84ConversionInfo(double dx, double dy, double dz, double ex, double ey, double ez, double ppm, String identifier)

WGS84ConversionInfo(double dx, double dy, double dz, double ex, double ey, double ez, double ppm, String[] identifiers)

WGS84ConversionInfo(double dx, double dy, double dz, double ex, double ey, double ez, double ppm, String[] identifiers, String[] names, String[] versions, String[] descriptions, String[] areaOfUses)

WGS84ConversionInfo(double dx, double dy, double dz, double ex, double ey, double ez, double ppm, String identifier, String name, String version, String description, String areaOfUse)

WGS84ConversionInfo(String identifier)
Construct a conversion info with all parameters set to 0;

WGS84ConversionInfo(String[] identifiers)
Construct a conversion info with all parameters set to 0;

WGS84ConversionInfo(String[] identifiers, String[] names, String[] versions, String[] descriptions, String[] areasOfUse)
Construct a conversion info with all parameters set to 0;

Method Summary

boolean	equals(Object object)
javax.vecmath.Matrix4d	getAsAffineTransform() Returns an affine tranformation also known as the "Helmert" transformation.
int	hashCode() Implementation as proposed by Joshua Block in Effective Java (Addison-Wesley 2001), which supplies an even distribution and is relatively fast.
String	toString() Returns the Well Know Text (WKT) for this object.

Methods inherited from class org.deegree.crs.Identifiable

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

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

dx

public double dx

Bursa Wolf shift in meters.

dy

public double dy

Bursa Wolf shift in meters.

dz

public double dz

Bursa Wolf shift in meters.

ex

public double ex

Bursa Wolf rotation in arc seconds, which is 1/3600 of a degree.

ey

public double ey

Bursa Wolf rotation in arc seconds.

ez

public double ez

Bursa Wolf rotation in arc seconds.

ppm

public double ppm

Bursa Wolf scaling in parts per million.

Constructor Detail

WGS84ConversionInfo

public WGS84ConversionInfo(String identifier)

Construct a conversion info with all parameters set to 0;

Parameters:

identifier -

WGS84ConversionInfo

public WGS84ConversionInfo(String[] identifiers)

Construct a conversion info with all parameters set to 0;

Parameters:

identifiers -

WGS84ConversionInfo

public WGS84ConversionInfo(String[] identifiers,
                           String[] names,
                           String[] versions,
                           String[] descriptions,
                           String[] areasOfUse)

Construct a conversion info with all parameters set to 0;

Parameters:

identifiers -

names -

versions -

descriptions -

areasOfUse -

WGS84ConversionInfo

public WGS84ConversionInfo(double dx,
                           double dy,
                           double dz,
                           double ex,
                           double ey,
                           double ez,
                           double ppm,
                           String[] identifiers,
                           String[] names,
                           String[] versions,
                           String[] descriptions,
                           String[] areaOfUses)

Parameters:

dx - Bursa Wolf shift in meters.

dy - Bursa Wolf shift in meters.

dz - Bursa Wolf shift in meters.

ex - Bursa Wolf rotation in arc seconds.

ey - Bursa Wolf rotation in arc seconds.

ez - Bursa Wolf rotation in arc seconds.

ppm - Bursa Wolf scaling in parts per million.

identifiers -

names -

versions -

descriptions -

areaOfUses -

WGS84ConversionInfo

public WGS84ConversionInfo(double dx,
                           double dy,
                           double dz,
                           double ex,
                           double ey,
                           double ez,
                           double ppm,
                           String identifier,
                           String name,
                           String version,
                           String description,
                           String areaOfUse)

Parameters:

dx - Bursa Wolf shift in meters.

dy - Bursa Wolf shift in meters.

dz - Bursa Wolf shift in meters.

ex - Bursa Wolf rotation in arc seconds.

ey - Bursa Wolf rotation in arc seconds.

ez - Bursa Wolf rotation in arc seconds.

ppm - Bursa Wolf scaling in parts per million.

identifier -

name -

version -

description -

areaOfUse -

WGS84ConversionInfo

public WGS84ConversionInfo(double dx,
                           double dy,
                           double dz,
                           double ex,
                           double ey,
                           double ez,
                           double ppm,
                           String[] identifiers)

Parameters:

dx - Bursa Wolf shift in meters.

dy - Bursa Wolf shift in meters.

dz - Bursa Wolf shift in meters.

ex - Bursa Wolf rotation in arc seconds.

ey - Bursa Wolf rotation in arc seconds.

ez - Bursa Wolf rotation in arc seconds.

ppm - Bursa Wolf scaling in parts per million.

identifiers -

WGS84ConversionInfo

public WGS84ConversionInfo(double dx,
                           double dy,
                           double dz,
                           double ex,
                           double ey,
                           double ez,
                           double ppm,
                           String identifier)

Parameters:

dx - Bursa Wolf shift in meters.

dy - Bursa Wolf shift in meters.

dz - Bursa Wolf shift in meters.

ex - Bursa Wolf rotation in arc seconds.

ey - Bursa Wolf rotation in arc seconds.

ez - Bursa Wolf rotation in arc seconds.

ppm - Bursa Wolf scaling in parts per million.

identifier -

WGS84ConversionInfo

public WGS84ConversionInfo(double dx,
                           double dy,
                           double dz,
                           double ex,
                           double ey,
                           double ez,
                           double ppm,
                           Identifiable identifiable)

Parameters:

dx - Bursa Wolf shift in meters.

dy - Bursa Wolf shift in meters.

dz - Bursa Wolf shift in meters.

ex - Bursa Wolf rotation in arc seconds.

ey - Bursa Wolf rotation in arc seconds.

ez - Bursa Wolf rotation in arc seconds.

ppm - Bursa Wolf scaling in parts per million.

identifiable - object containing all relevant id.

Method Detail

getAsAffineTransform

public javax.vecmath.Matrix4d getAsAffineTransform()

Returns an affine tranformation also known as the "Helmert" transformation. The matrix representation of this transformation (also known as "Bursa Wolf" formula) is as follows:

       S = 1 + ppm/1000000
      
       [ X ]     [ S          -ez*S  +ey*S   dx ]  [ X ]
       [ Y ]  = [ +ez*S  S          -ex*S   dy ]  [ Y ]
       [ Z ]     [ -ey*S   +ex*S   S         dz ]  [ Z ]
       [ 1 ]     [ 0           0           0           1 ]  [ 1 ]
 

This affine transform can be applied to transform geocentric coordinates from one datum into geocentric coordinates of an other datum. see http://www.posc.org/Epicentre.2_2/DataModel/ExamplesofUsage/eu_cs35.html for more information.

Returns:

the affine "Helmert" transformation as a Matrix4d.

equals

public boolean equals(Object object)

Overrides:

equals in class Object

toString

public String toString()

Returns the Well Know Text (WKT) for this object. The WKT is part of OpenGIS's specification and looks like TOWGS84[dx, dy, dz, ex, ey, ez, ppm].

Overrides:

toString in class Identifiable

Returns:

the Well Know Text (WKT) for this object.

hashCode

public int hashCode()

Implementation as proposed by Joshua Block in Effective Java (Addison-Wesley 2001), which supplies an even distribution and is relatively fast. It is created from field f as follows:

• boolean -- code = (f ? 0 : 1)
• byte, char, short, int -- code = (int)f
• long -- code = (int)(f ^ (f >>>32))
• float -- code = Float.floatToIntBits(f);
• double -- long l = Double.doubleToLongBits(f); code = (int)(l ^ (l >>> 32))
• all Objects, (where equals( ) calls equals( ) for this field) -- code = f.hashCode( )
• Array -- Apply above rules to each element

Combining the hash code(s) computed above: result = 37 * result + code;

Overrides:

hashCode in class Object

Returns:

(int) ( result >>> 32 ) ^ (int) result;

See Also:

Object.hashCode()