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

org.deegree.model.csct.cs
Class LocalCoordinateSystem

java.lang.Object
  extended by org.deegree.model.csct.cs.Info
      extended by org.deegree.model.csct.cs.CoordinateSystem
          extended by org.deegree.model.csct.cs.LocalCoordinateSystem
All Implemented Interfaces:
Serializable, Dimensioned

public class LocalCoordinateSystem
extends CoordinateSystem

A local coordinate system, with uncertain relationship to the world. In general, a local coordinate system cannot be related to other coordinate systems. However, if two objects supporting this interface have the same dimension, axes, units and datum then client code is permitted to assume that the two coordinate systems are identical. This allows several datasets from a common source (e.g. a CAD system) to be overlaid. In addition, some implementations of the Coordinate Transformation (CT) package may have a mechanism for correlating local datums. (E.g. from a database of transformations, which is created and maintained from real-world measurements.)

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_LocalCoordinateSystem", Serialized Form

Field Summary
 
Fields inherited from class org.deegree.model.csct.cs.Info
pool
 
Constructor Summary
LocalCoordinateSystem(Map properties, LocalDatum datum, Unit[] units, AxisInfo[] axes)
          Creates a local coordinate system.
LocalCoordinateSystem(String name, LocalDatum datum, Unit unit, AxisInfo[] axes)
          Creates a local 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()
          Dimension of the coordinate system.
 LocalDatum getLocalDatum()
          Gets the local datum.
 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
 

Constructor Detail

LocalCoordinateSystem

public LocalCoordinateSystem(String name,
                             LocalDatum datum,
                             Unit unit,
                             AxisInfo[] axes)
Creates a local coordinate system. The dimension of the local coordinate system is determined by the size of the axis array. All the axes will have the same units. If you want to make a coordinate system with mixed units, then you can make a compound coordinate system from different local coordinate systems.

Parameters:
name - Name to give new object.
datum - Local datum to use in created coordinate system.
unit - Units to use for all axes in created coordinate system.
axes - Axes to use in created coordinate system.

LocalCoordinateSystem

LocalCoordinateSystem(Map properties,
                      LocalDatum datum,
                      Unit[] units,
                      AxisInfo[] axes)
Creates a local coordinate system.

Parameters:
properties - The set of properties (see Info).
datum - Local datum to use in created coordinate system.
units - Units to use in created coordinate system.
axes - Axes to use in created coordinate system.
Method Detail

getDatum

final Datum getDatum()
Override CoordinateSystem.getDatum().

Overrides:
getDatum in class CoordinateSystem
Returns:
the datum.

getLocalDatum

public LocalDatum getLocalDatum()
Gets the local datum.

Returns:
the local datum.
See Also:
"org.opengis.cs.CS_LocalCoordinateSystem#getLocalDatum()"

getDimension

public int getDimension()
Dimension of the coordinate system.

Specified by:
getDimension in interface Dimensioned
Specified by:
getDimension in class CoordinateSystem
Returns:
See Also:
"org.opengis.cs.CS_LocalCoordinateSystem#getDimension()"

getAxis

public AxisInfo getAxis(int dimension)
Gets axis details for dimension within coordinate system.

Specified by:
getAxis in class CoordinateSystem
Parameters:
dimension - Zero based index of axis.
Returns:
axis details for dimension within coordinate system.
See Also:
"org.opengis.cs.CS_LocalCoordinateSystem#getAxis(int)"

getUnits

public Unit getUnits(int dimension)
Gets units for dimension within coordinate system.

Specified by:
getUnits in class CoordinateSystem
Parameters:
dimension - Zero based index of axis.
Returns:
units for dimension within coordinate system.
See Also:
"org.opengis.cs.CS_LocalCoordinateSystem#getUnits(int)"

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:

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