org.opengis.cs
Interface CS_CoordinateSystem

All Superinterfaces:

CS_Info, java.rmi.Remote

All Known Subinterfaces:

CS_CompoundCoordinateSystem, CS_FittedCoordinateSystem, CS_GeocentricCoordinateSystem, CS_GeographicCoordinateSystem, CS_HorizontalCoordinateSystem, CS_LocalCoordinateSystem, CS_ProjectedCoordinateSystem, CS_VerticalCoordinateSystem

All Known Implementing Classes:

CompoundCoordinateSystem.Export, CoordinateSystem.Export, GeocentricCoordinateSystem.Export, GeographicCoordinateSystem.Export, HorizontalCoordinateSystem.Export, LocalCoordinateSystem.Export, ProjectedCoordinateSystem.Export, VerticalCoordinateSystem.Export

public interface CS_CoordinateSystem

extends CS_Info

Base interface 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.

Since:

1.00

Version:

1.01

Author:

Martin Daly

Method Summary

CS_AxisInfo	getAxis(int dimension) Gets axis details for dimension within coordinate system.
PT_Envelope	getDefaultEnvelope() Gets default envelope of coordinate system.
int	getDimension() Dimension of the coordinate system.
CS_Unit	getUnits(int dimension) Gets units for dimension within coordinate system.

Methods inherited from interface org.opengis.cs.CS_Info

getAbbreviation, getAlias, getAuthority, getAuthorityCode, getName, getRemarks, getWKT, getXML

Method Detail

getDimension

public int getDimension()
                 throws java.rmi.RemoteException

Dimension of the coordinate system.

Throws:

java.rmi.RemoteException - if a remote method call failed.

getAxis

public CS_AxisInfo getAxis(int dimension)
                    throws java.rmi.RemoteException

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.

Throws:

java.rmi.RemoteException - if a remote method call failed.

getUnits

public CS_Unit getUnits(int dimension)
                 throws java.rmi.RemoteException

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

Parameters:

dimension - Zero based index of axis.

Throws:

java.rmi.RemoteException - if a remote method call failed.

getDefaultEnvelope

public PT_Envelope getDefaultEnvelope()
                               throws java.rmi.RemoteException

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.

Throws:

java.rmi.RemoteException - if a remote method call failed.