org.deegree.crs.coordinatesystems
Class CoordinateSystem

java.lang.Object
  org.deegree.crs.Identifiable
      org.deegree.crs.coordinatesystems.CoordinateSystem

Direct Known Subclasses:

GeocentricCRS, GeographicCRS, ProjectedCRS

public abstract class CoordinateSystem
extends Identifiable

Three kinds of CoordinateSystems (in this class abbreviated with CRS) are supported in this lib.

• Geographic CRS: A position (on the ellipsoid) is given in Lattitude / Longitude (Polar Cooridnates) given in rad° min''sec. The order of the position's coordinates are to be contrued to the axis order of the CRS. These lat/lon coordinates are to be tranformed to x,y,z values to define their location on the underlying datum.
• GeoCentric CRS: A position (on the ellipsoid) is given in x, y, z (cartesian) coordinates with the same units defined as the ones in the underlying datum. The order of the position's coordinates are to be contrued to the axis order of the datum.
• Projected CRS: The position (on the map) is given in a 2D-tuple in pre-defined units. The Axis of the CRS are defined (through a transformation) for an underlying Datum, which can have it's own axis with their own units. The order of the position's coordinates are to be contrued to the axis order of the CRS

Summarizing it can be said, that each CRS has following features

• A reference code (an casesensitive String identifying this CRS, for example 'EPGS:4326' or 'urn:ogc:def:crs:OGC:2:84' or 'luref')
• An optional version.
• A humanly readable name.
• An optional description.
• An optional area of use, describing where this CRS is used.
• The order in which the axis of ther crs are defined.
• The underlying Datum

Version:

$Revision:$, $Date:$

Author:

Rutger Bezema, last edited by: $Author:$

Field Summary

static int	GEOCENTRIC_CRS Defines this CRS as a GeoCentric one.
static int	GEOGRAPHIC_CRS Defines this CRS as a Geographic one.
static int	PROJECTED_CRS Defines this CRS as a Projected one.

Constructor Summary

CoordinateSystem(GeodeticDatum datum, Axis[] axisOrder, Identifiable identity)


CoordinateSystem(GeodeticDatum datum, Axis[] axisOrder, String[] identifiers, String[] names, String[] versions, String[] descriptions, String[] areasOfUse)


Method Summary

boolean	equals(Object other)
Axis[]	getAxis()
abstract int	getDimension()
GeodeticDatum	getGeodeticDatum()
abstract int	getType()
protected String	getTypeName() Helper function to get the typename as a String.
Unit	getUnits()
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()

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

GEOCENTRIC_CRS

public static final int GEOCENTRIC_CRS

Defines this CRS as a GeoCentric one.

See Also:

Constant Field Values

GEOGRAPHIC_CRS

public static final int GEOGRAPHIC_CRS

Defines this CRS as a Geographic one.

See Also:

Constant Field Values

PROJECTED_CRS

public static final int PROJECTED_CRS

Defines this CRS as a Projected one.

See Also:

Constant Field Values

Constructor Detail

CoordinateSystem

public CoordinateSystem(GeodeticDatum datum,
                        Axis[] axisOrder,
                        Identifiable identity)

Parameters:

datum - of this coordinate system.

axisOrder - the axisorder of this coordinate system.

identity -

CoordinateSystem

public CoordinateSystem(GeodeticDatum datum,
                        Axis[] axisOrder,
                        String[] identifiers,
                        String[] names,
                        String[] versions,
                        String[] descriptions,
                        String[] areasOfUse)

Parameters:

datum - of this coordinate system.

axisOrder - the axisorder of this coordinate system.

identifiers - of this coordinate system.

names -

versions -

descriptions -

areasOfUse -

Method Detail

getAxis

public final Axis[] getAxis()

Returns:

(all) axis' in their defined order.

getGeodeticDatum

public final GeodeticDatum getGeodeticDatum()

Returns:

the usedDatum.

getUnits

public Unit getUnits()

Returns:

the units of the coordinatesystem.

getDimension

public abstract int getDimension()

Returns:

the dimension of this CRS.

getType

public abstract int getType()

Returns:

one of the *_CRS types defined in this class.

getTypeName

protected String getTypeName()

Helper function to get the typename as a String.

Returns:

either the type as a name or 'Unknown' if the tpye is not known.

equals

public boolean equals(Object other)

Overrides:

equals in class 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()

toString

public String toString()

Overrides:

toString in class Identifiable