org.deegree_impl.model.cs
Class HorizontalDatum

java.lang.Object
  extended byorg.deegree_impl.model.cs.Info
      extended byorg.deegree_impl.model.cs.Datum
          extended byorg.deegree_impl.model.cs.HorizontalDatum
All Implemented Interfaces:
java.io.Serializable

public class HorizontalDatum
extends Datum

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

Version:
1.00
Author:
OpenGIS (www.opengis.org), Martin Desruisseaux
See Also:
CS_HorizontalDatum, Serialized Form

Nested Class Summary
private  class HorizontalDatum.Export
          Wrap a HorizontalDatum object for use with OpenGIS.
 
Nested classes inherited from class org.deegree_impl.model.cs.Info
Info.AngularUnit, Info.LinearUnit
 
Field Summary
private  Ellipsoid ellipsoid
          The ellipsoid for this datum.
private  WGS84ConversionInfo parameters
          Preferred parameters for a Bursa Wolf transformation.
private static long serialVersionUID
          Serial number for interoperability with different versions.
static HorizontalDatum WGS84
          The default WGS 1984 datum.
 
Fields inherited from class org.deegree_impl.model.cs.Datum
 
Fields inherited from class org.deegree_impl.model.cs.Info
pool
 
Constructor Summary
(package private) HorizontalDatum(java.util.Map properties, DatumType type, Ellipsoid ellipsoid, WGS84ConversionInfo parameters)
          Creates horizontal datum from ellipsoid and Bursa-Wolf parameters.
  HorizontalDatum(java.lang.String name, DatumType.Horizontal type, Ellipsoid ellipsoid, WGS84ConversionInfo parameters)
          Creates horizontal datum from ellipsoid and Bursa-Wolf parameters.
  HorizontalDatum(java.lang.String name, Ellipsoid ellipsoid)
          Creates horizontal datum from an ellipsoid.
 
Method Summary
(package private)  java.lang.String addString(java.lang.StringBuffer buffer)
          Fill the part inside "[...]".
 boolean equals(java.lang.Object object)
          Compares the specified object with this datum for equality.
 DatumType getDatumType()
          Gets the type of the datum as an enumerated code.
 Ellipsoid getEllipsoid()
          Returns the ellipsoid.
 WGS84ConversionInfo getWGS84Parameters()
          Gets preferred parameters for a Bursa Wolf transformation into WGS84.
(package private)  java.lang.Object toOpenGIS(java.lang.Object adapters)
          Returns an OpenGIS interface for this datum.
 
Methods inherited from class org.deegree_impl.model.cs.Datum
hashCode
 
Methods inherited from class org.deegree_impl.model.cs.Info
addUnit, cachedOpenGIS, ensureAngularUnit, ensureLinearUnit, ensureNonNull, ensureNonNull, ensureTimeUnit, getAbbreviation, getAlias, getAuthority, getAuthorityCode, getName, getRemarks, readResolve, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

serialVersionUID

private static final long serialVersionUID
Serial number for interoperability with different versions.

See Also:
Constant Field Values

WGS84

public static final HorizontalDatum WGS84
The default WGS 1984 datum.


ellipsoid

private final Ellipsoid ellipsoid
The ellipsoid for this datum.


parameters

private final WGS84ConversionInfo parameters
Preferred parameters for a Bursa Wolf transformation.

Constructor Detail

HorizontalDatum

public HorizontalDatum(java.lang.String name,
                       Ellipsoid ellipsoid)
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.String name,
                       DatumType.Horizontal type,
                       Ellipsoid ellipsoid,
                       WGS84ConversionInfo parameters)
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.
parameters - Suggested approximate conversion from new datum to WGS84, or null if there is none.

HorizontalDatum

HorizontalDatum(java.util.Map properties,
                DatumType type,
                Ellipsoid ellipsoid,
                WGS84ConversionInfo parameters)
Creates horizontal datum from ellipsoid and Bursa-Wolf parameters.

Parameters:
properties - The set of properties (see Info).
type - Type of horizontal datum to create.
ellipsoid - Ellipsoid to use in new horizontal datum.
parameters - Suggested approximate conversion from new datum to WGS84, or null if there is none.
Method Detail

getDatumType

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

Overrides:
getDatumType in class Datum
See Also:
CS_Datum.getDatumType()

getEllipsoid

public Ellipsoid getEllipsoid()
Returns the ellipsoid.

See Also:
CS_HorizontalDatum.getEllipsoid()

getWGS84Parameters

public WGS84ConversionInfo getWGS84Parameters()
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 returns null for horizontal datums with type DatumType.Horizontal.OTHER. This method may also returns null if no suitable transformation is available.

See Also:
CS_HorizontalDatum.getWGS84Parameters()

addString

java.lang.String addString(java.lang.StringBuffer buffer)
Fill the part inside "[...]". Used for formatting Well Know Text (WKT).

Overrides:
addString in class Datum

equals

public boolean equals(java.lang.Object object)
Compares the specified object with this datum for equality.

Overrides:
equals in class Datum

toOpenGIS

final java.lang.Object toOpenGIS(java.lang.Object adapters)
Returns an OpenGIS interface for this datum. The returned object is suitable for RMI use. Note: The returned type is a generic Object in order to avoid too early class loading of OpenGIS interface.

Overrides:
toOpenGIS in class Datum