org.geotools.cs
Class GeocentricCoordinateSystem

java.lang.Object
  org.geotools.cs.Info
      org.geotools.cs.CoordinateSystem
          org.geotools.cs.GeocentricCoordinateSystem

All Implemented Interfaces:

org.opengis.referencing.crs.CoordinateReferenceSystem, Dimensioned, org.opengis.referencing.IdentifiedObject, org.opengis.referencing.ReferenceSystem, java.io.Serializable

Deprecated. Replaced by DefaultGeocentricCRS.

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:

$Id: GeocentricCoordinateSystem.java 17672 2006-01-19 00:25:55Z desruisseaux $

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_GeocentricCoordinateSystem, Serialized Form

Field Summary

static GeocentricCoordinateSystem

DEFAULT Deprecated. The default geocentric coordinate system.

Fields inherited from interface org.opengis.referencing.ReferenceSystem

SCOPE_KEY, VALID_AREA_KEY

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

GeocentricCoordinateSystem(java.lang.CharSequence name, HorizontalDatum datum)
Deprecated. Constructs a geocentric coordinate system with default axis.

GeocentricCoordinateSystem(java.lang.CharSequence name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian)
Deprecated. Constructs a geocentric coordinate system with default axis.

GeocentricCoordinateSystem(java.lang.CharSequence name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo[] axis)
Deprecated. Constructs a geocentric coordinate system.

Method Summary

boolean	equals(Info object, boolean compareNames) Deprecated. Compare this coordinate system with the specified object for equality.
AxisInfo	getAxis(int dimension) Deprecated. Gets axis details for dimension within coordinate system.
int	getDimension() Deprecated. Returns the dimension of this coordinate system, which is usually 3.
HorizontalDatum	getHorizontalDatum() Deprecated. Replaced by AbstractSingleCRS.getDatum().
PrimeMeridian	getPrimeMeridian() Deprecated. Replaced by DefaultGeodeticDatum.getPrimeMeridian().
Unit	getUnits(int dimension) Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().
int	hashCode() Deprecated. Returns a hash value for this coordinate system.

Methods inherited from class org.geotools.cs.CoordinateSystem

fromGeoAPI, getCoordinateSystem, getDatum, getDefaultEnvelope, getScope, getValidArea

Methods inherited from class org.geotools.cs.Info

ensureNonNull, equals, getAbbreviation, getAlias, getAlias, getAuthority, getAuthorityCode, getIdentifiers, getName, getRemarks, toString, toWKT

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

DEFAULT

public static final GeocentricCoordinateSystem DEFAULT

Deprecated.

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

Constructor Detail

GeocentricCoordinateSystem

public GeocentricCoordinateSystem(java.lang.CharSequence name,
                                  HorizontalDatum datum)

Deprecated.

Constructs a geocentric coordinate system with default axis. Units are metres and prime meridian is greenwich.

Parameters:

name - The coordinate system name.

datum - The horizontal datum.

GeocentricCoordinateSystem

public GeocentricCoordinateSystem(java.lang.CharSequence name,
                                  Unit unit,
                                  HorizontalDatum datum,
                                  PrimeMeridian meridian)

Deprecated.

Constructs 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(java.lang.CharSequence name,
                                  Unit unit,
                                  HorizontalDatum datum,
                                  PrimeMeridian meridian,
                                  AxisInfo[] axis)

Deprecated.

Constructs 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 length 3.

Method Detail

getDimension

public int getDimension()

Deprecated.

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

Specified by:

getDimension in interface Dimensioned

Specified by:

getDimension in class CoordinateSystem

See Also:

CS_CoordinateSystem.getDimension()

getHorizontalDatum

public HorizontalDatum getHorizontalDatum()

Deprecated. Replaced by AbstractSingleCRS.getDatum().

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.

See Also:

CS_GeocentricCoordinateSystem.getHorizontalDatum()

getUnits

public Unit getUnits(int dimension)

Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().

Gets units for dimension within coordinate system. For a GeocentricCoordinateSystem, the units are the same for all axes.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getUnits(int)

getAxis

public AxisInfo getAxis(int dimension)

Deprecated.

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.

See Also:

CS_CoordinateSystem.getAxis(int)

getPrimeMeridian

public PrimeMeridian getPrimeMeridian()

Deprecated. Replaced by DefaultGeodeticDatum.getPrimeMeridian().

Returns the prime meridian.

See Also:

CS_GeocentricCoordinateSystem.getPrimeMeridian()

equals

public boolean equals(Info object,
                      boolean compareNames)

Deprecated.

Compare this coordinate system with the specified object for equality.

Overrides:

equals in class Info

Parameters:

object - The object to compare to this.

compareNames - true to comparare the name, alias, authority code, etc. as well, or false to compare only properties relevant to transformations.

Returns:

true if both objects are equal.

hashCode

public int hashCode()

Deprecated.

Returns a hash value for this coordinate system. Name, alias, authority code and the like are not taken in account. In other words, two coordinate systems will return the same hash value if they are equal in the sense of equals(Info, false).

Overrides:

hashCode in class Info

Returns:

The hash code value. This value doesn't need to be the same in past or future versions of this class.