org.geotools.cs
Class CoordinateSystem

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

All Implemented Interfaces:

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

Direct Known Subclasses:

CompoundCoordinateSystem, FittedCoordinateSystem, GeocentricCoordinateSystem, HorizontalCoordinateSystem, LocalCoordinateSystem, TemporalCoordinateSystem, VerticalCoordinateSystem

Deprecated. Replaced by AbstractCRS.

public abstract class CoordinateSystem

extends Info

implements Dimensioned, org.opengis.referencing.crs.CoordinateReferenceSystem

Base class for all coordinate systems. A coordinate system is a mathematical space, where the elements of the space are called positions. Each position is described by a list of numbers. The length of the list corresponds to the dimension of the coordinate system. So in a 2D coordinate system each position is described by a list containing 2 numbers.

However, in a coordinate system, not all lists of numbers correspond to a position - some lists may be outside the domain of the coordinate system. For example, in a 2D Lat/Lon coordinate system, the list (91,91) does not correspond to a position.

Some coordinate systems also have a mapping from the mathematical space into locations in the real world. So in a Lat/Lon coordinate system, the mathematical position (lat, long) corresponds to a location on the surface of the Earth. This mapping from the mathematical space into real-world locations is called a Datum.

NOTE: This CoordinateSystem class implements the OpenGIS® Coordinate System specification 1.0, not 2.0. The CoordinateReferenceSystem interface come from specification 2.0 and appears in the implements clause only as a patch for anticipating a future transition to OGC spec. 2.0.

Version:

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

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_CoordinateSystem, Serialized Form

Field Summary

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

CoordinateSystem(java.lang.CharSequence name)
Deprecated. Constructs a coordinate system.

Method Summary

static CoordinateSystem	fromGeoAPI(org.opengis.referencing.crs.CoordinateReferenceSystem crs) Deprecated. Mimic a GeoAPI interface as a legacy implementation.
abstract AxisInfo	getAxis(int dimension) Deprecated. Replaced by AbstractCS.getAxis(int).
org.opengis.referencing.cs.CoordinateSystem	getCoordinateSystem() Deprecated. For compatibility with GeoAPI interfaces.
org.opengis.referencing.datum.Datum	getDatum() Deprecated. For compatibility with GeoAPI interfaces.
Envelope	getDefaultEnvelope() Deprecated. Gets default envelope of coordinate system.
abstract int	getDimension() Deprecated. Replaced by AbstractCS.getDimension().
org.opengis.util.InternationalString	getScope() Deprecated. For compatibility with GeoAPI interfaces.
abstract Unit	getUnits(int dimension) Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().
org.opengis.metadata.extent.Extent	getValidArea() Deprecated. For compatibility with GeoAPI interfaces.

Methods inherited from class org.geotools.cs.Info

ensureNonNull, equals, equals, getAbbreviation, getAlias, getAlias, getAuthority, getAuthorityCode, getIdentifiers, getName, getRemarks, hashCode, 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

Constructor Detail

CoordinateSystem

public CoordinateSystem(java.lang.CharSequence name)

Deprecated.

Constructs a coordinate system.

Parameters:

name - The coordinate system name.

Method Detail

getDimension

public abstract int getDimension()

Deprecated. Replaced by AbstractCS.getDimension().

Returns the dimension of the coordinate system.

Specified by:

getDimension in interface Dimensioned

See Also:

CS_CoordinateSystem.getDimension()

getAxis

public abstract AxisInfo getAxis(int dimension)

Deprecated. Replaced by AbstractCS.getAxis(int).

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

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getAxis(int)

getUnits

public abstract Unit getUnits(int dimension)

Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().

Gets units for dimension within coordinate system. Each dimension in the coordinate system has corresponding units.

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getUnits(int)

getDefaultEnvelope

public Envelope getDefaultEnvelope()

Deprecated.

Gets default envelope of coordinate system. Coordinate systems which are bounded should return the minimum bounding box of their domain. Unbounded coordinate systems should return a box which is as large as is likely to be used. For example, a (lon,lat) geographic coordinate system in degrees should return a box from (-180,-90) to (180,90), and a geocentric coordinate system could return a box from (-r,-r,-r) to (+r,+r,+r) where r is the approximate radius of the Earth.

The default implementation returns an envelope with infinite bounds.

See Also:

CS_CoordinateSystem.getDefaultEnvelope()

getCoordinateSystem

public org.opengis.referencing.cs.CoordinateSystem getCoordinateSystem()

Deprecated.

For compatibility with GeoAPI interfaces.

Specified by:

getCoordinateSystem in interface org.opengis.referencing.crs.CoordinateReferenceSystem

getDatum

public org.opengis.referencing.datum.Datum getDatum()

Deprecated.

For compatibility with GeoAPI interfaces.

getScope

public org.opengis.util.InternationalString getScope()

Deprecated.

For compatibility with GeoAPI interfaces.

Specified by:

getScope in interface org.opengis.referencing.ReferenceSystem

getValidArea

public org.opengis.metadata.extent.Extent getValidArea()

Deprecated.

For compatibility with GeoAPI interfaces.

Specified by:

getValidArea in interface org.opengis.referencing.ReferenceSystem

fromGeoAPI

public static CoordinateSystem fromGeoAPI(org.opengis.referencing.crs.CoordinateReferenceSystem crs)
                                   throws UnsupportedImplementationException

Deprecated.

Mimic a GeoAPI interface as a legacy implementation. This method is provided as a temporary bridge for using new CRS object with J2D-Renderer for example.

Throws:

UnsupportedImplementationException