org.geotools.cs
Class LocalCoordinateSystem

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

All Implemented Interfaces:

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

Deprecated. Replaced by DefaultEngineeringCRS.

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:

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

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_LocalCoordinateSystem, Serialized Form

Field Summary

static LocalCoordinateSystem	CARTESIAN Deprecated. A two-dimensional cartesian coordinate system with x,y axis in metres.
static LocalCoordinateSystem	PROMISCUOUS Deprecated. A two-dimensional wildcard coordinate system with x,y axis in metres.

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

LocalCoordinateSystem(java.lang.CharSequence name, LocalDatum datum, Unit[] units, AxisInfo[] axes)
Deprecated. Creates a local coordinate system.

LocalCoordinateSystem(java.lang.CharSequence name, LocalDatum datum, Unit unit, AxisInfo[] axes)
Deprecated. Creates a local 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. Dimension of the coordinate system.
LocalDatum	getLocalDatum() Deprecated. Replaced by AbstractSingleCRS.getDatum().
Unit	getUnits(int dimension) Deprecated. Gets units for dimension within coordinate system.
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

CARTESIAN

public static final LocalCoordinateSystem CARTESIAN

Deprecated.

A two-dimensional cartesian coordinate system with x,y axis in metres. By default, this coordinate system has no transformation path to any other coordinate system (i.e. a map using this CS can't be reprojected to a geographic coordinate system for example). This is therefore a strict cartesian CS.

PROMISCUOUS

public static final LocalCoordinateSystem PROMISCUOUS

Deprecated.

A two-dimensional wildcard coordinate system with x,y axis in metres. At the difference of CARTESIAN, this coordinate system is treated specially by the default coordinate transformation factory with loose transformation rules: if no transformation path were found (for example through a fitted coordinate system), then the transformation from this CS to any CS with a compatible number of dimensions is assumed to be the identity transform. This CS is usefull as a kind of wildcard when no CS were explicitly specified.

Constructor Detail

LocalCoordinateSystem

public LocalCoordinateSystem(java.lang.CharSequence name,
                             LocalDatum datum,
                             Unit unit,
                             AxisInfo[] axes)

Deprecated.

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.

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.

See Also:

CS_CoordinateSystemFactory.createLocalCoordinateSystem(java.lang.String, org.opengis.cs.CS_LocalDatum, org.opengis.cs.CS_Unit, org.opengis.cs.CS_AxisInfo[])

LocalCoordinateSystem

public LocalCoordinateSystem(java.lang.CharSequence name,
                             LocalDatum datum,
                             Unit[] units,
                             AxisInfo[] axes)

Deprecated.

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.

Parameters:

name - Name to give new object.

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.

See Also:

CS_CoordinateSystemFactory.createLocalCoordinateSystem(java.lang.String, org.opengis.cs.CS_LocalDatum, org.opengis.cs.CS_Unit, org.opengis.cs.CS_AxisInfo[])

Method Detail

getLocalDatum

public LocalDatum getLocalDatum()

Deprecated. Replaced by AbstractSingleCRS.getDatum().

Gets the local datum.

See Also:

CS_LocalCoordinateSystem.getLocalDatum()

getDimension

public int getDimension()

Deprecated.

Dimension of the coordinate system.

Specified by:

getDimension in interface Dimensioned

Specified by:

getDimension in class CoordinateSystem

See Also:

CS_CoordinateSystem.getDimension()

getAxis

public AxisInfo getAxis(int dimension)

Deprecated.

Gets axis details for dimension within coordinate system.

Specified by:

getAxis in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getAxis(int)

getUnits

public Unit getUnits(int dimension)

Deprecated.

Gets units for dimension within coordinate system.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getUnits(int)

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.