org.deegree.model.csct.cs
Class ProjectedCoordinateSystem

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

All Implemented Interfaces:

Serializable, Dimensioned

public class ProjectedCoordinateSystem
extends HorizontalCoordinateSystem

A 2D cartographic coordinate system. Projected coordinates are the two-dimensional cartesian coordinates typically found on maps and computer displays. The cartesian axes are often called "paper coordinates" or "display coordinates." The conversions from a three-dimensional curvilinear coordinate system (whether ellipsoidal or spherical) to projected coordinates may be assumed to be well known. Examples of projected coordinate systems are: Lambert, Mercator, and transverse Mercator. Conversions to, and conversions between, projected spatial coordinate systems often do not preserve distances, areas and angles.

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

Field Summary

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

pool

Constructor Summary

ProjectedCoordinateSystem(Map properties, GeographicCoordinateSystem gcs, Projection projection, Unit unit, AxisInfo axis0, AxisInfo axis1)
Creates a projected coordinate system using a projection object.

ProjectedCoordinateSystem(String name, GeographicCoordinateSystem gcs, Projection projection)
Creates a projected coordinate system using the specified geographic system.

ProjectedCoordinateSystem(String name, GeographicCoordinateSystem gcs, Projection projection, Unit unit, AxisInfo axis0, AxisInfo axis1)
Creates a projected coordinate system using a projection object.

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.
GeographicCoordinateSystem	getGeographicCoordinateSystem() Returns the geographic coordinate system.
Projection	getProjection() Gets the projection.
Unit	getUnits(int dimension) Gets units for dimension within coordinate system.

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

ProjectedCoordinateSystem

public ProjectedCoordinateSystem(String name,
                                 GeographicCoordinateSystem gcs,
                                 Projection projection)

Creates a projected coordinate system using the specified geographic system. Projected coordinates will be in meters, x values increasing east and y values increasing north.

Parameters:

name - Name to give new object.

gcs - Geographic coordinate system to base projection on.

projection - Projection from geographic to projected coordinate system.

ProjectedCoordinateSystem

public ProjectedCoordinateSystem(String name,
                                 GeographicCoordinateSystem gcs,
                                 Projection projection,
                                 Unit unit,
                                 AxisInfo axis0,
                                 AxisInfo axis1)

Creates a projected coordinate system using a projection object.

Parameters:

name - Name to give new object.

gcs - Geographic coordinate system to base projection on.

projection - Projection from geographic to projected coordinate system.

unit - Linear units of created PCS.

axis0 - Details of 0th ordinates in created PCS coordinates.

axis1 - Details of 1st ordinates in created PCS coordinates.

ProjectedCoordinateSystem

ProjectedCoordinateSystem(Map properties,
                          GeographicCoordinateSystem gcs,
                          Projection projection,
                          Unit unit,
                          AxisInfo axis0,
                          AxisInfo axis1)

Creates a projected coordinate system using a projection object.

Parameters:

properties - The set of properties (see Info).

gcs - Geographic coordinate system to base projection on.

projection - Projection from geographic to projected coordinate system.

unit - Linear units of created PCS.

axis0 - Details of 0th ordinates in created PCS coordinates.

axis1 - Details of 1st ordinates in created PCS coordinates.

Method Detail

getGeographicCoordinateSystem

public GeographicCoordinateSystem getGeographicCoordinateSystem()

Returns the geographic coordinate system.

Returns:

the geographic coordinate system.

See Also:

"org.opengis.cs.CS_ProjectedCoordinateSystem#getGeographicCoordinateSystem()"

getProjection

public Projection getProjection()

Gets the projection.

Returns:

the projection.

See Also:

"org.opengis.cs.CS_ProjectedCoordinateSystem#getProjection()"

getUnits

public Unit getUnits(int dimension)

Gets units for dimension within coordinate system. This linear 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.

See Also:

"org.opengis.cs.CS_ProjectedCoordinateSystem#getUnits(int)", "org.opengis.cs.CS_ProjectedCoordinateSystem#getLinearUnit()"

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: