org.deegree.model.csct.cs
Class GeocentricCoordinateSystem

java.lang.Object
  org.deegree.model.csct.cs.Info
      org.deegree.model.csct.cs.CoordinateSystem
          org.deegree.model.csct.cs.GeocentricCoordinateSystem

All Implemented Interfaces:

Serializable, Dimensioned

public class GeocentricCoordinateSystem
extends CoordinateSystem

A 3D coordinate system, with its origin at the center of the Earth. The X axis points towards the prime meridian. The Y axis points East or West. The Z axis points North or South. By default the Z axis will point North, and the Y axis will point East (e.g. a right handed system), but you should check the axes for non-default values.

Version:

1.00, $Revision: 6259 $, $Date: 2007-03-20 10:15:15 +0100 (Di, 20 Mär 2007) $

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux, last edited by: $Author: bezema $

See Also:

"org.opengis.cs.CS_GeocentricCoordinateSystem", Serialized Form

Field Summary

static GeocentricCoordinateSystem

DEFAULT The default geocentric coordinate system.

Fields inherited from class org.deegree.model.csct.cs.Info

pool

Constructor Summary

GeocentricCoordinateSystem(Map properties, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo[] axis)
Construct a geocentric coordinate system.

GeocentricCoordinateSystem(String name, HorizontalDatum datum)
Construct a geocentric coordinate system with default axis.

GeocentricCoordinateSystem(String name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian)
Construct a geocentric coordinate system with default axis.

GeocentricCoordinateSystem(String name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo[] axis)
Construct a geocentric coordinate system.

Method Summary

(package private) String	addString(StringBuffer buffer) Fill the part inside "[...]".
boolean	equivalents(CoordinateSystem cs) Returns true if this coordinate system is equivalents to the specified coordinate system.
AxisInfo	getAxis(int dimension) Gets axis details for dimension within coordinate system.
(package private) Datum	getDatum() Override CoordinateSystem.getDatum().
int	getDimension() Returns the dimension of this coordinate system, which is usually 3.
HorizontalDatum	getHorizontalDatum() Returns the horizontal datum.
PrimeMeridian	getPrimeMeridian() Returns the prime meridian.
Unit	getUnits(int dimension) Gets units for dimension within coordinate system.

Methods inherited from class org.deegree.model.csct.cs.CoordinateSystem

checkAxis, equals, getDefaultEnvelope, getUnits

Methods inherited from class org.deegree.model.csct.cs.Info

addString, addUnit, ensureAngularUnit, ensureLinearUnit, ensureNonNull, ensureNonNull, ensureTimeUnit, getAbbreviation, getAlias, getAuthority, getAuthorityCode, getName, getRemarks, hashCode, readResolve, toString

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT

public static final GeocentricCoordinateSystem DEFAULT

The default geocentric coordinate system. Prime meridian is Greenwich, horizontal datum in WGS84 and linear units are metre. The X axis points towards the prime meridian. The Y axis points East. The Z axis points North.

Constructor Detail

GeocentricCoordinateSystem

public GeocentricCoordinateSystem(String name,
                                  HorizontalDatum datum)

Construct a geocentric coordinate system with default axis. Unit are metres and prime meridian is greenwich.

Parameters:

name - The coordinate system name.

datum - The horizontal datum.

GeocentricCoordinateSystem

public GeocentricCoordinateSystem(String name,
                                  Unit unit,
                                  HorizontalDatum datum,
                                  PrimeMeridian meridian)

Construct a geocentric coordinate system with default axis. The X axis points towards the prime meridian. The Y axis points East. The Z axis points North.

Parameters:

name - The coordinate system name.

unit - The linear unit.

datum - The horizontal datum.

meridian - The prime meridian.

GeocentricCoordinateSystem

public GeocentricCoordinateSystem(String name,
                                  Unit unit,
                                  HorizontalDatum datum,
                                  PrimeMeridian meridian,
                                  AxisInfo[] axis)

Construct a geocentric coordinate system.

Parameters:

name - The coordinate system name.

unit - The linear unit.

datum - The horizontal datum.

meridian - The prime meridian.

axis - The axis info. This is usually an array of lenght 3.

GeocentricCoordinateSystem

GeocentricCoordinateSystem(Map properties,
                           Unit unit,
                           HorizontalDatum datum,
                           PrimeMeridian meridian,
                           AxisInfo[] axis)

Construct a geocentric coordinate system.

Parameters:

properties - The set of properties (see Info).

unit - The linear unit.

datum - The horizontal datum.

meridian - The prime meridian.

axis - The axis info. This is usually an array of lenght 3.

Method Detail

getDimension

public int getDimension()

Returns the dimension of this coordinate system, which is usually 3.

Specified by:

getDimension in interface Dimensioned

Specified by:

getDimension in class CoordinateSystem

Returns:

the dimension of this coordinate system, which is usually 3.

See Also:

"org.opengis.cs.CS_GeocentricCoordinateSystem#getDimension()"

getDatum

final Datum getDatum()

Override CoordinateSystem.getDatum().

Overrides:

getDatum in class CoordinateSystem

Returns:

the datum.

getHorizontalDatum

public HorizontalDatum getHorizontalDatum()

Returns the horizontal datum. The horizontal datum is used to determine where the center of the Earth is considered to be. All coordinate points will be measured from the center of the Earth, and not the surface.

Returns:

the horizontal datum.

See Also:

"org.opengis.cs.CS_GeocentricCoordinateSystem#getHorizontalDatum()"

getUnits

public Unit getUnits(int dimension)

Gets units for dimension within coordinate system. For a GeocentricCoordinateSystem, the units is the same for all axis.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

Returns:

See Also:

"org.opengis.cs.CS_GeocentricCoordinateSystem#getUnits(int)"

getAxis

public AxisInfo getAxis(int dimension)

Gets axis details for dimension within coordinate system. Each dimension in the coordinate system has a corresponding axis.

Specified by:

getAxis in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

Returns:

See Also:

"org.opengis.cs.CS_CoordinateSystem#getAxis(int)"

getPrimeMeridian

public PrimeMeridian getPrimeMeridian()

Returns the prime meridian.

Returns:

the prime meridian.

See Also:

"org.opengis.cs.CS_GeocentricCoordinateSystem#getPrimeMeridian()"

equivalents

public boolean equivalents(CoordinateSystem cs)

Returns true if this coordinate system is equivalents to the specified coordinate system. Two coordinate systems are considered equivalent if the CoordinateTransformation from this to cs would be the identity transform. The default implementation compare datum, units and axis, but ignore name, alias and other meta-data informations.

Overrides:

equivalents in class CoordinateSystem

Parameters:

cs - The coordinate system (may be null).

Returns:

true if both coordinate systems are equivalent.

addString

String addString(StringBuffer buffer)

Fill the part inside "[...]". Used for formatting Well Know Text (WKT).

Parameters:

buffer -

Returns: