org.deegree.model.csct.cs
Class GeographicCoordinateSystem

java.lang.Object
  org.deegree.model.csct.cs.Info
      org.deegree.model.csct.cs.CoordinateSystem
          org.deegree.model.csct.cs.HorizontalCoordinateSystem
              org.deegree.model.csct.cs.GeographicCoordinateSystem

All Implemented Interfaces:

Serializable, Dimensioned

public class GeographicCoordinateSystem
extends HorizontalCoordinateSystem

A coordinate system based on latitude and longitude. Some geographic coordinate systems are latitude/longiude, and some are longitude/latitude. You can find out which this is by examining the axes. You should also check the angular units, since not all geographic coordinate systems use degrees.

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

Field Summary

static GeographicCoordinateSystem

WGS84 A geographic coordinate system using WGS84 datum.

Fields inherited from class org.deegree.model.csct.cs.Info

pool

Constructor Summary

GeographicCoordinateSystem(Map properties, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo axis0, AxisInfo axis1)
Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

GeographicCoordinateSystem(String name, HorizontalDatum datum)
Creates a geographic coordinate system.

GeographicCoordinateSystem(String name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo axis0, AxisInfo axis1)
Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

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.
Envelope	getDefaultEnvelope() Gets default envelope of coordinate system.
PrimeMeridian	getPrimeMeridian() Returns the prime meridian.
Unit	getUnits(int dimension) Gets units for dimension within coordinate system.
Set	getWGS84ConversionInfos() Gets details on conversions to WGS84.

Methods inherited from class org.deegree.model.csct.cs.HorizontalCoordinateSystem

getAxis, getDatum, getDimension, getHorizontalDatum

Methods inherited from class org.deegree.model.csct.cs.CoordinateSystem

checkAxis, equals, 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

Field Detail

WGS84

public static final GeographicCoordinateSystem WGS84

A geographic coordinate system using WGS84 datum. This coordinate system use longitude/latitude ordinates with longitude values increasing north and latitude values increasing east. Angular units are degrees and prime meridian is Greenwich.

Constructor Detail

GeographicCoordinateSystem

public GeographicCoordinateSystem(String name,
                                  HorizontalDatum datum)

Creates a geographic coordinate system. This coordinate system will use longitude/latitude ordinates with longitude values increasing east and latitude values increasing north. Angular units are degrees and prime meridian is Greenwich.

Parameters:

name - Name to give new object.

datum - Horizontal datum for created coordinate system.

GeographicCoordinateSystem

public GeographicCoordinateSystem(String name,
                                  Unit unit,
                                  HorizontalDatum datum,
                                  PrimeMeridian meridian,
                                  AxisInfo axis0,
                                  AxisInfo axis1)

Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

Parameters:

name - Name to give new object.

unit - Angular units for created coordinate system.

datum - Horizontal datum for created coordinate system.

meridian - Prime Meridian for created coordinate system.

axis0 - Details of 0th ordinates.

axis1 - Details of 1st ordinates.

GeographicCoordinateSystem

GeographicCoordinateSystem(Map properties,
                           Unit unit,
                           HorizontalDatum datum,
                           PrimeMeridian meridian,
                           AxisInfo axis0,
                           AxisInfo axis1)

Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

Parameters:

properties - The set of properties (see Info).

unit - Angular units for created coordinate system.

datum - Horizontal datum for created coordinate system.

meridian - Prime Meridian for created coordinate system.

axis0 - Details of 0th ordinates.

axis1 - Details of 1st ordinates.

Method Detail

getUnits

public Unit getUnits(int dimension)

Gets units for dimension within coordinate system. This angular unit is the same for all axis.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

Returns:

units for dimension within coordinate system. This angular unit is the same for all axis.

See Also:

"org.opengis.cs.CS_GeographicCoordinateSystem#getUnits(int)"

getPrimeMeridian

public PrimeMeridian getPrimeMeridian()

Returns the prime meridian.

Returns:

the prime meridian.

See Also:

"org.opengis.cs.CS_GeographicCoordinateSystem#getPrimeMeridian()"

getDefaultEnvelope

public Envelope getDefaultEnvelope()

Gets default envelope of coordinate system.

Overrides:

getDefaultEnvelope in class CoordinateSystem

Returns:

default envelope of coordinate system.

See Also:

"org.opengis.cs.CS_GeographicCoordinateSystem#getDefaultEnvelope()"

getWGS84ConversionInfos

public Set getWGS84ConversionInfos()

Gets details on conversions to WGS84. Some geographic coordinate systems provide several transformations into WGS84, which are designed to provide good accuracy in different areas of interest. The first conversion should provide acceptable accuracy over the largest possible area of interest.

Returns:

A set of conversions info to WGS84. The default implementation returns an empty set.

See Also:

"org.opengis.cs.CS_GeographicCoordinateSystem#getNumConversionToWGS84()", "org.opengis.cs.CS_GeographicCoordinateSystem#getWGS84ConversionInfo(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 HorizontalCoordinateSystem

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).

Overrides:

addString in class HorizontalCoordinateSystem

Parameters:

buffer -

Returns: