org.geotools.cs
Class FittedCoordinateSystem

java.lang.Object
  org.geotools.cs.Info
      org.geotools.cs.CoordinateSystem
          org.geotools.cs.FittedCoordinateSystem

All Implemented Interfaces:

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

Deprecated. Replaced by org.opengis.referencing.crs.DefaultDerivedCRS.

public class FittedCoordinateSystem

extends CoordinateSystem

A coordinate system which sits inside another coordinate system. The fitted coordinate system can be rotated and shifted, or use any other math transform to inject itself into the base coordinate system.

Version:

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

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

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

FittedCoordinateSystem(java.lang.CharSequence name, CoordinateSystem base, MathTransform toBase, AxisInfo[] axes)
Deprecated. Creates a fitted coordinate system.

Method Summary

boolean	equals(Info object, boolean compareNames) Deprecated. Compare this coordinate system with the specified object for equality.
AxisInfo	getAxis(int dimension) Deprecated. Gets axis details for dimension within coordinate system.
CoordinateSystem	getBaseCoordinateSystem() Deprecated. Replaced by AbstractDerivedCRS.getBaseCRS().
int	getDimension() Deprecated. Returns the dimension of the coordinate system.
MathTransform	getToBase() Deprecated. Replaced by AbstractDerivedCRS.getConversionFromBase(), except that the transform needs to be inverted.
Unit	getUnits(int dimension) Deprecated. Gets units for dimension within coordinate system.
int	hashCode() Deprecated. Returns a hash value for this coordinate system.

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

FittedCoordinateSystem

public FittedCoordinateSystem(java.lang.CharSequence name,
                              CoordinateSystem base,
                              MathTransform toBase,
                              AxisInfo[] axes)

Deprecated.

Creates a fitted coordinate system. The units of the axes in the fitted coordinate system will be inferred from the units of the base coordinate system. If the affine map performs a rotation, then any mixed axes must have identical units. For example, a (lat_deg,lon_deg,height_feet) system can be rotated in the (lat,lon) plane, since both affected axes are in degrees. But you should not rotate this coordinate system in any other plane.

Parameters:

name - Name to give new object.

base - Coordinate system to base the fitted CS on.

toBase - The transform from created CS to base CS.

axes - Axes for fitted coordinate system. The number of axes must match the source dimension of the transform toBase. If this argument is null, then axes will be infered from the base coordinate system.

Throws:

org.opengis.spatialschema.geometry.MismatchedDimensionException - if source and target dimensions of toBase don't match the number to axes and the base coordinate system dimensions.

See Also:

CS_CoordinateSystemFactory.createFittedCoordinateSystem(java.lang.String, org.opengis.cs.CS_CoordinateSystem, java.lang.String, org.opengis.cs.CS_AxisInfo[])

Method Detail

getBaseCoordinateSystem

public CoordinateSystem getBaseCoordinateSystem()

Deprecated. Replaced by AbstractDerivedCRS.getBaseCRS().

Returns the underlying coordinate system. Its dimension is equals to getToBase().getDimTarget().

See Also:

CS_FittedCoordinateSystem.getBaseCoordinateSystem()

getToBase

public MathTransform getToBase()

Deprecated. Replaced by AbstractDerivedCRS.getConversionFromBase(), except that the transform needs to be inverted.

Returns the math transform to the base coordinate system. The dimension of this fitted coordinate system is determined by the source dimension of the math transform. The transform should be one-to-one within this coordinate system's domain, and the base coordinate system dimension must be at least as big as the dimension of this coordinate system.

See Also:

CS_FittedCoordinateSystem.getToBase()

getDimension

public int getDimension()

Deprecated.

Returns the dimension of the coordinate system. This is equals to getToBase().getDimSource().

Specified by:

getDimension in interface Dimensioned

Specified by:

getDimension in class CoordinateSystem

See Also:

CS_CoordinateSystem.getDimension()

getAxis

public AxisInfo getAxis(int dimension)

Deprecated.

Gets axis details for dimension within coordinate system.

Specified by:

getAxis in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getAxis(int)

getUnits

public Unit getUnits(int dimension)

Deprecated.

Gets units for dimension within coordinate system.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getUnits(int)

equals

public boolean equals(Info object,
                      boolean compareNames)

Deprecated.

Compare this coordinate system with the specified object for equality.

Overrides:

equals in class Info

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 Info

Returns:

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