org.geotools.cs
Class ProjectedCoordinateSystem

java.lang.Object
  org.geotools.cs.Info
      org.geotools.cs.CoordinateSystem
          org.geotools.cs.HorizontalCoordinateSystem
              org.geotools.cs.ProjectedCoordinateSystem

All Implemented Interfaces:

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

Deprecated. Replaced by DefaultProjectedCRS.

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:

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

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_ProjectedCoordinateSystem, Serialized Form

Field Summary

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

ProjectedCoordinateSystem(java.lang.CharSequence name, GeographicCoordinateSystem gcs, Projection projection)
Deprecated. Creates a projected coordinate system using the specified geographic system.

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

Method Summary

boolean	equals(Info object, boolean compareNames) Deprecated. Compare this coordinate system with the specified object for equality.
GeographicCoordinateSystem	getGeographicCoordinateSystem() Deprecated. Replaced by AbstractDerivedCRS.getBaseCRS().
Projection	getProjection() Deprecated. Replaced by AbstractDerivedCRS.getConversionFromBase().
Unit	getUnits(int dimension) Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().
int	hashCode() Deprecated. Returns a hash value for this coordinate system.

Methods inherited from class org.geotools.cs.HorizontalCoordinateSystem

getAxis, getDimension, getHorizontalDatum

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

Constructor Detail

ProjectedCoordinateSystem

public ProjectedCoordinateSystem(java.lang.CharSequence name,
                                 GeographicCoordinateSystem gcs,
                                 Projection projection)

Deprecated.

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(java.lang.CharSequence name,
                                 GeographicCoordinateSystem gcs,
                                 Projection projection,
                                 Unit unit,
                                 AxisInfo axis0,
                                 AxisInfo axis1)

Deprecated.

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.

See Also:

CS_CoordinateSystemFactory.createProjectedCoordinateSystem(java.lang.String, org.opengis.cs.CS_GeographicCoordinateSystem, org.opengis.cs.CS_Projection, org.opengis.cs.CS_LinearUnit, org.opengis.cs.CS_AxisInfo, org.opengis.cs.CS_AxisInfo)

Method Detail

getGeographicCoordinateSystem

public GeographicCoordinateSystem getGeographicCoordinateSystem()

Deprecated. Replaced by AbstractDerivedCRS.getBaseCRS().

Returns the geographic coordinate system.

See Also:

CS_ProjectedCoordinateSystem.getGeographicCoordinateSystem()

getProjection

public Projection getProjection()

Deprecated. Replaced by AbstractDerivedCRS.getConversionFromBase().

Gets the projection.

See Also:

CS_ProjectedCoordinateSystem.getProjection()

getUnits

public Unit getUnits(int dimension)

Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().

Gets units for dimension within coordinate system. This linear unit is the same for all axes.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getUnits(int), CS_ProjectedCoordinateSystem.getLinearUnit()

equals

public boolean equals(Info object,
                      boolean compareNames)

Deprecated.

Compare this coordinate system with the specified object for equality.

Overrides:

equals in class HorizontalCoordinateSystem

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 HorizontalCoordinateSystem

Returns:

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