org.geotools.cs
Class HorizontalDatum

java.lang.Object
  org.geotools.cs.Info
      org.geotools.cs.Datum
          org.geotools.cs.HorizontalDatum

All Implemented Interfaces:

org.opengis.referencing.IdentifiedObject, java.io.Serializable

Deprecated. Replaced by DefaultGeodeticDatum.

public class HorizontalDatum

extends Datum

Procedure used to measure positions on the surface of the Earth.

Version:

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

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_HorizontalDatum, Serialized Form

Field Summary

static HorizontalDatum

WGS84 Deprecated. The default WGS 1984 datum.

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

HorizontalDatum(java.lang.CharSequence name, DatumType.Horizontal type, Ellipsoid ellipsoid, WGS84ConversionInfo toWGS84)
Deprecated. Creates horizontal datum from ellipsoid and Bursa-Wolf parameters.

HorizontalDatum(java.lang.CharSequence name, Ellipsoid ellipsoid)
Deprecated. Creates horizontal datum from an ellipsoid.

Method Summary

boolean	equals(Info object, boolean compareNames) Deprecated. Compare this datum with the specified object for equality.
DatumType	getDatumType() Deprecated. Gets the type of the datum as an enumerated code.
Ellipsoid	getEllipsoid() Deprecated. Replaced by DefaultGeodeticDatum.getEllipsoid().
WGS84ConversionInfo	getWGS84Parameters() Deprecated. Gets preferred parameters for a Bursa Wolf transformation into WGS84.
int	hashCode() Deprecated. Returns a hash value for this horizontal datum.

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

Field Detail

WGS84

public static final HorizontalDatum WGS84

Deprecated.

The default WGS 1984 datum.

Constructor Detail

HorizontalDatum

public HorizontalDatum(java.lang.CharSequence name,
                       Ellipsoid ellipsoid)

Deprecated.

Creates horizontal datum from an ellipsoid. The datum type will be DatumType.Horizontal.OTHER.

Parameters:

name - Name to give new object.

ellipsoid - Ellipsoid to use in new horizontal datum.

HorizontalDatum

public HorizontalDatum(java.lang.CharSequence name,
                       DatumType.Horizontal type,
                       Ellipsoid ellipsoid,
                       WGS84ConversionInfo toWGS84)

Deprecated.

Creates horizontal datum from ellipsoid and Bursa-Wolf parameters.

Parameters:

name - Name to give new object.

type - Type of horizontal datum to create.

ellipsoid - Ellipsoid to use in new horizontal datum.

toWGS84 - Suggested approximate conversion from new datum to WGS84, or null if there is none.

See Also:

CS_CoordinateSystemFactory.createHorizontalDatum(java.lang.String, org.opengis.cs.CS_DatumType, org.opengis.cs.CS_Ellipsoid, org.opengis.cs.CS_WGS84ConversionInfo)

Method Detail

getDatumType

public DatumType getDatumType()

Deprecated.

Gets the type of the datum as an enumerated code. Note: return type will be changed to DatumType.Horizontal when are able to use generic types (with JDK 1.5).

Overrides:

getDatumType in class Datum

See Also:

CS_Datum.getDatumType()

getEllipsoid

public Ellipsoid getEllipsoid()

Deprecated. Replaced by DefaultGeodeticDatum.getEllipsoid().

Returns the ellipsoid.

See Also:

CS_HorizontalDatum.getEllipsoid()

getWGS84Parameters

public WGS84ConversionInfo getWGS84Parameters()

Deprecated.

Gets preferred parameters for a Bursa Wolf transformation into WGS84. The 7 returned values correspond to (dx,dy,dz) in meters, (ex,ey,ez) in arc-seconds, and scaling in parts-per-million. This method will always return null for horizontal datums with type DatumType.Horizontal.OTHER. This method may also return null if no suitable transformation is available.

See Also:

CS_HorizontalDatum.getWGS84Parameters()

equals

public boolean equals(Info object,
                      boolean compareNames)

Deprecated.

Compare this datum with the specified object for equality.

Overrides:

equals in class Datum

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 horizontal datum. Name, alias, authority code and the like are not taken in account. In other words, two horizontal datums will return the same hash value if they are equal in the sense of equals(Info, false).

Overrides:

hashCode in class Datum

Returns:

The hash code value. This value doesn't need to be the same in past or future versions of this class.