com.luciad.projection

LuciadLightspeedClass TLcdUTM

java.lang.Object

com.luciad.projection.TLcdUTM

All Implemented Interfaces:

ILcdCompositeProjection , Serializable

Deprecated.

Use the new TLcdUTMGridSystem.

public class TLcdUTM
extends Object
implements 
ILcdCompositeProjection

Universal Transverse Mercator projection.

Introduction

This projection is used for the UTM grid system. Within this system the earth is divided in several zones, each of which is based on a specifically defined transverse Mercator projection.

The valid area for this projection is between NORTH_LAT_LIMIT and SOUTH_LAT_LIMIT latitude.

Sample code

 int projectionIndex = utm.retrieveZone( new TLcdLonLatPoint( -40.0, 20.0 ) );
 ILcdProjection projection =
     utm.retrieveProjection( projectionIndex );
 

See Also:

TLcdTransverseMercator, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static double	NORTH_LAT_LIMIT Deprecated. The northern limit for the valid area of this projection.
static double	SOUTH_LAT_LIMIT Deprecated. The southern limit for the valid area of this projection.

Constructor Summary

Constructors

Constructor and Description
TLcdUTM() Deprecated.

Method Summary

Modifier and Type	Method and Description
double[]	boundaryLats(double aLon) Deprecated. The boundary latitudes are the same for all longitudes: -80 degrees south and 84 degrees north.
double[]	boundaryLons(double aLat) Deprecated. The UTM composite projection spans the whole longitude interval, -180 to 180, irrespective of the latitude.
ILcdCompositeProjection	cloneAsILcdCompositeProjection() Deprecated. Clones this ILcdCompositeProjection.
boolean	equals(Object aObject) Deprecated. Checks if this ILcdCompositeProjection is equal with another Object.
int	getNoOfZones() Deprecated. Gets the number of zones.
int	hashCode() Deprecated.
boolean	inLonLatBounds(ILcdPoint aLLP) Deprecated. Checks if an ILcdPoint is inside the valid area of the composite projection.
boolean	inWorldBoundsOnEllipsoid(ILcdZonalPoint aXYZonalPoint, ILcdEllipsoid aEllipsoid) Deprecated. Checks if an ILcdPoint is inside the valid cartesian area of the composite projection.
boolean	inWorldBoundsOnSphere(ILcdZonalPoint aXYZonalPoint, double aRadius) Deprecated. Checks if an ILcdPoint is inside the valid cartesian area of the composite projection.
boolean	isAllInBounds() Deprecated. Returns whether all lat-lon point are within the bounds of the composite projection.
void	lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP, ILcdEllipsoid aEllipsoid, ILcd2DEditableZonalPoint aZonalPointSFCT) Deprecated. Transforms an ILcd2DEditablePoint into a zonal cartesian coordinate of the projection.
void	lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP, int aZone, ILcdEllipsoid aEllipsoid, ILcd2DEditableZonalPoint aZonalPointSFCT) Deprecated. Transforms an ILcd2DEditablePoint into a zonal cartesian coordinate of the projection.
void	lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP, double aRadius, ILcd2DEditableZonalPoint aZonalPointSFCT) Deprecated. Transforms an ILcd2DEditablePoint into a zonal cartesian coordinate of the projection.
void	lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP, int aZone, double aRadius, ILcd2DEditableZonalPoint aZonalPointSFCT) Deprecated. Transforms a ILcd2DEditablePoint into a zonal cartesian coordinate of the projection of the given zone.
ILcdProjection	retrieveProjection(int aZone) Deprecated. Retrieves the projection for zone aZone.
int	retrieveZone(ILcdPoint aLLP) Deprecated. Return the zone id for the given model point.
String	toString() Deprecated. String representation of this ILcdCompositeProjection.
void	world2lonlatOnEllipsoidSFCT(ILcdZonalPoint aXYZonalPoint, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aLLPOut) Deprecated. Transforms a ILcdZonalPoint from the cartesian coordinate system of the projection into a ILcd2DEditablePoint on the ellipsoid.
void	world2lonlatOnSphereSFCT(ILcdZonalPoint aXYZonalPoint, double aRadius, ILcd2DEditablePoint aLLPOut) Deprecated. Transforms a ILcdZonalPoint from the cartesian coordinate system of the projection into a ILcd2DEditablePoint on the sphere.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

NORTH_LAT_LIMIT

public static final double NORTH_LAT_LIMIT

Deprecated.

The northern limit for the valid area of this projection.

See Also:

Constant Field Values

SOUTH_LAT_LIMIT

public static final double SOUTH_LAT_LIMIT

Deprecated.

The southern limit for the valid area of this projection.

See Also:

Constant Field Values

Constructor Detail

TLcdUTM

public TLcdUTM()

Deprecated.

Method Detail

getNoOfZones

public int getNoOfZones()

Deprecated.

Description copied from interface: ILcdCompositeProjection

Gets the number of zones.

Specified by:

getNoOfZones in interface ILcdCompositeProjection

Returns:

noOfZones.

isAllInBounds

public boolean isAllInBounds()

Deprecated.

Description copied from interface: ILcdCompositeProjection

Returns whether all lat-lon point are within the bounds of the composite projection.

Specified by:

isAllInBounds in interface ILcdCompositeProjection

Returns:

true if all LonLatPoints are within the bounds of the projection, false otherwise.

retrieveProjection

public ILcdProjection retrieveProjection(int aZone)

Deprecated.

Description copied from interface: ILcdCompositeProjection

Retrieves the projection for zone aZone.

Specified by:

retrieveProjection in interface ILcdCompositeProjection

Parameters:

aZone - number of a zone; must be between 1 and the number of zones of the composite projection.

Returns:

the ILcdProjection corresponding with the given zone if aZone is between 1 and nrOfZones.

lonlatheight2worldOnSphereSFCT

public void lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP,
                                           double aRadius,
                                           ILcd2DEditableZonalPoint aZonalPointSFCT)
                                    throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Transforms an ILcd2DEditablePoint into a zonal cartesian coordinate of the projection.

Specified by:

lonlatheight2worldOnSphereSFCT in interface ILcdCompositeProjection

Parameters:

aLLHP - geodetic coordinate.

aRadius - radius of the sphere (meters).

aZonalPointSFCT - projected zonal point as side effect.

Throws:

TLcdOutOfBoundsException - aLLHP is outside the area valid for this projection.

lonlatheight2worldOnEllipsoidSFCT

public void lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP,
                                              ILcdEllipsoid aEllipsoid,
                                              ILcd2DEditableZonalPoint aZonalPointSFCT)
                                       throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Transforms an ILcd2DEditablePoint into a zonal cartesian coordinate of the projection.

Specified by:

lonlatheight2worldOnEllipsoidSFCT in interface ILcdCompositeProjection

Parameters:

aLLHP - geodetic coordinate.

aEllipsoid - ellipsoidal representation of the earth.

aZonalPointSFCT - projected zonal point as side effect.

Throws:

TLcdOutOfBoundsException - aLLHP is outside the area valid for this projection.

lonlatheight2worldOnSphereSFCT

public void lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP,
                                           int aZone,
                                           double aRadius,
                                           ILcd2DEditableZonalPoint aZonalPointSFCT)
                                    throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Transforms a ILcd2DEditablePoint into a zonal cartesian coordinate of the projection of the given zone.

Specified by:

lonlatheight2worldOnSphereSFCT in interface ILcdCompositeProjection

Parameters:

aLLHP - geodetic coordinate.

aZone - zone of the coordinate.

aRadius - radius of the sphere (meters).

aZonalPointSFCT - projected zonal point as side effect.

Throws:

TLcdOutOfBoundsException - aLLHP is outside the area valid for this projection.

lonlatheight2worldOnEllipsoidSFCT

public void lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP,
                                              int aZone,
                                              ILcdEllipsoid aEllipsoid,
                                              ILcd2DEditableZonalPoint aZonalPointSFCT)
                                       throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Transforms an ILcd2DEditablePoint into a zonal cartesian coordinate of the projection.

Specified by:

lonlatheight2worldOnEllipsoidSFCT in interface ILcdCompositeProjection

Parameters:

aLLHP - geodetic coordinate.

aZone - zone of the coordinate.

aEllipsoid - ellipsoidal representation of the earth.

aZonalPointSFCT - projected zonal point as side effect.

Throws:

TLcdOutOfBoundsException - aLLHP is outside the area valid for this projection.

world2lonlatOnSphereSFCT

public void world2lonlatOnSphereSFCT(ILcdZonalPoint aXYZonalPoint,
                                     double aRadius,
                                     ILcd2DEditablePoint aLLPOut)
                              throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Transforms a ILcdZonalPoint from the cartesian coordinate system of the projection into a ILcd2DEditablePoint on the sphere.

Specified by:

world2lonlatOnSphereSFCT in interface ILcdCompositeProjection

Parameters:

aXYZonalPoint - projected zonal point for which the corresponding geodetic point is sought.

aRadius - radius of the sphere (meters).

aLLPOut - geodetic coordinate on the sphere as side effect.

Throws:

TLcdOutOfBoundsException - aXYZonalPoint is outside the area valid for this projection.

world2lonlatOnEllipsoidSFCT

public void world2lonlatOnEllipsoidSFCT(ILcdZonalPoint aXYZonalPoint,
                                        ILcdEllipsoid aEllipsoid,
                                        ILcd2DEditablePoint aLLPOut)
                                 throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Transforms a ILcdZonalPoint from the cartesian coordinate system of the projection into a ILcd2DEditablePoint on the ellipsoid.

Specified by:

world2lonlatOnEllipsoidSFCT in interface ILcdCompositeProjection

Parameters:

aXYZonalPoint - projected zonal point for which the corresponding geodetic point is sought.

aEllipsoid - ellipsoidal representation of the earth.

aLLPOut - geodetic coordinate on the ellipsoid as side effect.

Throws:

TLcdOutOfBoundsException - aXYZonalPoint is outside the area valid for this projection.

retrieveZone

public int retrieveZone(ILcdPoint aLLP)
                 throws TLcdOutOfBoundsException

Deprecated.

Description copied from interface: ILcdCompositeProjection

Return the zone id for the given model point.

Specified by:

retrieveZone in interface ILcdCompositeProjection

Parameters:

aLLP - the model point to find the zone for.

Returns:

the zone to which the model point belongs.

Throws:

TLcdOutOfBoundsException - if the point is not within the valid area of the projection (visible area), then this exception is thrown.

inLonLatBounds

public boolean inLonLatBounds(ILcdPoint aLLP)

Deprecated.

Checks if an ILcdPoint is inside the valid area of the composite projection.

Specified by:

inLonLatBounds in interface ILcdCompositeProjection

Parameters:

aLLP - the point to check for.

Returns:

true if the Y value of the given point is between NORTH_LAT_LIMIT and SOUTH_LAT_LIMIT.

inWorldBoundsOnSphere

public boolean inWorldBoundsOnSphere(ILcdZonalPoint aXYZonalPoint,
                                     double aRadius)

Deprecated.

Description copied from interface: ILcdCompositeProjection

Checks if an ILcdPoint is inside the valid cartesian area of the composite projection.

Specified by:

inWorldBoundsOnSphere in interface ILcdCompositeProjection

Parameters:

aXYZonalPoint - ILcdZonalPoint to be checked upon.

aRadius - Description of Parameter

Returns:

true if valid, false if invalid.

inWorldBoundsOnEllipsoid

public boolean inWorldBoundsOnEllipsoid(ILcdZonalPoint aXYZonalPoint,
                                        ILcdEllipsoid aEllipsoid)

Deprecated.

Description copied from interface: ILcdCompositeProjection

Checks if an ILcdPoint is inside the valid cartesian area of the composite projection.

Specified by:

inWorldBoundsOnEllipsoid in interface ILcdCompositeProjection

Parameters:

aXYZonalPoint - ILcdZonalPoint to be checked upon.

aEllipsoid - ellipsoidal representation of the earth.

Returns:

true if valid, false if invalid.

boundaryLons

public double[] boundaryLons(double aLat)

Deprecated.

The UTM composite projection spans the whole longitude interval, -180 to 180, irrespective of the latitude.

Specified by:

boundaryLons in interface ILcdCompositeProjection

Parameters:

aLat - not taken into account

Returns:

-180 to 180.

boundaryLats

public double[] boundaryLats(double aLon)

Deprecated.

The boundary latitudes are the same for all longitudes: -80 degrees south and 84 degrees north.

Specified by:

boundaryLats in interface ILcdCompositeProjection

Parameters:

aLon - not taken into account.

Returns:

-80 degrees south and 84 degrees north

toString

public String toString()

Deprecated.

Description copied from interface: ILcdCompositeProjection

String representation of this ILcdCompositeProjection.

Specified by:

toString in interface ILcdCompositeProjection

Overrides:

toString in class Object

Returns:

String representation of this ILcdCompositeProjection.

cloneAsILcdCompositeProjection

public ILcdCompositeProjection cloneAsILcdCompositeProjection()

Deprecated.

Description copied from interface: ILcdCompositeProjection

Clones this ILcdCompositeProjection.

Specified by:

cloneAsILcdCompositeProjection in interface ILcdCompositeProjection

Returns:

Clone of this ILcdCompositeProjection.

equals

public boolean equals(Object aObject)

Deprecated.

Description copied from interface: ILcdCompositeProjection

Checks if this ILcdCompositeProjection is equal with another Object.

Specified by:

equals in interface ILcdCompositeProjection

Overrides:

equals in class Object

Parameters:

aObject - Object to compare to.

Returns:

true if the Object is an instance of the same ILcdCompositeProjection class and having the same projection properties, false otherwise.

hashCode

public int hashCode()

Deprecated.

Overrides:

hashCode in class Object