deegree 2.1 (2007/11/08 09:57 build-328-official)

org.deegree.model.crs
Class CoordinateSystem

java.lang.Object
  extended by org.deegree.datatypes.QualifiedName
      extended by org.deegree.model.crs.CoordinateSystem
All Implemented Interfaces:
Serializable

public class CoordinateSystem
extends QualifiedName

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:
2.0
Version:
$Revision: 6259 $, 1.0. $Revision: 6259 $, $Date: 2007-03-20 10:15:15 +0100 (Di, 20 Mär 2007) $
Author:
Andreas Poth, last edited by: $Author: bezema $
See Also:
Serialized Form

Constructor Summary
protected CoordinateSystem(String name)
          e.g. epgs:4326
(package private) CoordinateSystem(String prefix, String localName, URI namespace)
           
(package private) CoordinateSystem(String name, URI namespace)
           
 
Method Summary
 String getAsURN()
          returns the CRS name as URN. e.g. urn:epsg:crs:4326 or urn:adv:crs:DE_DHDN_3GK2_NW177
 String getCode()
          returns the CRSs code.
 int getDimension()
           
 String getIdentifier()
          in opposit to getName() this method always returns the prefix of a CRS name in lower case characters.
 String getName()
          returns the name of the CRS with - if available - prefix seperated with ':' from the CRS code
 String getUnits()
          returns the units use by the CRS
 
Methods inherited from class org.deegree.datatypes.QualifiedName
equals, getAsString, getFormattedString, getLocalName, getNamespace, getPrefix, getPrefixedName, hashCode, isInNamespace, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CoordinateSystem

CoordinateSystem(String prefix,
                 String localName,
                 URI namespace)
Parameters:
prefix - must be not null
localName -
namespace -

CoordinateSystem

CoordinateSystem(String name,
                 URI namespace)
Parameters:
name -
namespace -

CoordinateSystem

protected CoordinateSystem(String name)
e.g. epgs:4326

Parameters:
name -
Method Detail

getName

public String getName()
returns the name of the CRS with - if available - prefix seperated with ':' from the CRS code

Returns:
the name of the CRS

getIdentifier

public String getIdentifier()
in opposit to getName() this method always returns the prefix of a CRS name in lower case characters. This method will be used to set CRS for transformation using proj4

Returns:
the prefix of a CRS name in lower case characters
See Also:
getName()

getCode

public String getCode()
returns the CRSs code. In case of EPSG:4326 it will be 4326; in case of adv:DE_DHDN_3GK2_NW177 it will be DE_DHDN_3GK2_NW177

Returns:
the CRSs code

getAsURN

public String getAsURN()
returns the CRS name as URN. e.g. urn:epsg:crs:4326 or urn:adv:crs:DE_DHDN_3GK2_NW177

Returns:
the CRS name as URN

getUnits

public String getUnits()
returns the units use by the CRS

Returns:
the units use by the CRS

getDimension

public int getDimension()
Returns:
2

deegree 2.1 (2007/11/08 09:57 build-328-official)

an open source project founded by lat/lon, Bonn, Germany.
For more information visit: http://deegree.sourceforge.net