TLcdUTMGridSystem
.public class TLcdUTM extends Object implementsILcdCompositeProjection
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.
int projectionIndex = utm.retrieveZone( new TLcdLonLatPoint( -40.0, 20.0 ) );
ILcdProjection projection =
utm.retrieveProjection( projectionIndex );
TLcdTransverseMercator
,
Serialized FormModifier 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 and Description |
---|
TLcdUTM()
Deprecated.
|
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. |
public static final double NORTH_LAT_LIMIT
public static final double SOUTH_LAT_LIMIT
public int getNoOfZones()
ILcdCompositeProjection
getNoOfZones
in interface ILcdCompositeProjection
public boolean isAllInBounds()
ILcdCompositeProjection
isAllInBounds
in interface ILcdCompositeProjection
true
if all LonLatPoints are within the bounds of
the projection, false
otherwise.public ILcdProjection retrieveProjection(int aZone)
ILcdCompositeProjection
aZone
.retrieveProjection
in interface ILcdCompositeProjection
aZone
- number of a zone; must be between 1 and the number of zones
of the composite projection.ILcdProjection
corresponding with the given zone
if aZone
is between 1 and nrOfZones
.public void lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP, double aRadius, ILcd2DEditableZonalPoint aZonalPointSFCT) throws TLcdOutOfBoundsException
ILcdCompositeProjection
ILcd2DEditablePoint
into a zonal cartesian
coordinate of the projection.lonlatheight2worldOnSphereSFCT
in interface ILcdCompositeProjection
aLLHP
- geodetic coordinate.aRadius
- radius of the sphere (meters).aZonalPointSFCT
- projected zonal point as side effect.TLcdOutOfBoundsException
- aLLHP
is outside the area valid for this projection.public void lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP, ILcdEllipsoid aEllipsoid, ILcd2DEditableZonalPoint aZonalPointSFCT) throws TLcdOutOfBoundsException
ILcdCompositeProjection
ILcd2DEditablePoint
into a zonal cartesian
coordinate of the projection.lonlatheight2worldOnEllipsoidSFCT
in interface ILcdCompositeProjection
aLLHP
- geodetic coordinate.aEllipsoid
- ellipsoidal representation of the earth.aZonalPointSFCT
- projected zonal point as side effect.TLcdOutOfBoundsException
- aLLHP
is outside the area valid for this projection.public void lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP, int aZone, double aRadius, ILcd2DEditableZonalPoint aZonalPointSFCT) throws TLcdOutOfBoundsException
ILcdCompositeProjection
ILcd2DEditablePoint
into a zonal cartesian
coordinate of the projection of the given zone.lonlatheight2worldOnSphereSFCT
in interface ILcdCompositeProjection
aLLHP
- geodetic coordinate.aZone
- zone of the coordinate.aRadius
- radius of the sphere (meters).aZonalPointSFCT
- projected zonal point as side effect.TLcdOutOfBoundsException
- aLLHP
is outside the area valid for this projection.public void lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP, int aZone, ILcdEllipsoid aEllipsoid, ILcd2DEditableZonalPoint aZonalPointSFCT) throws TLcdOutOfBoundsException
ILcdCompositeProjection
ILcd2DEditablePoint
into a zonal cartesian
coordinate of the projection.lonlatheight2worldOnEllipsoidSFCT
in interface ILcdCompositeProjection
aLLHP
- geodetic coordinate.aZone
- zone of the coordinate.aEllipsoid
- ellipsoidal representation of the earth.aZonalPointSFCT
- projected zonal point as side effect.TLcdOutOfBoundsException
- aLLHP
is outside the area valid for this projection.public void world2lonlatOnSphereSFCT(ILcdZonalPoint aXYZonalPoint, double aRadius, ILcd2DEditablePoint aLLPOut) throws TLcdOutOfBoundsException
ILcdCompositeProjection
ILcdZonalPoint
from the cartesian coordinate
system of the projection into a ILcd2DEditablePoint
on the
sphere.world2lonlatOnSphereSFCT
in interface ILcdCompositeProjection
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.TLcdOutOfBoundsException
- aXYZonalPoint
is outside the area valid for this projection.public void world2lonlatOnEllipsoidSFCT(ILcdZonalPoint aXYZonalPoint, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aLLPOut) throws TLcdOutOfBoundsException
ILcdCompositeProjection
ILcdZonalPoint
from the cartesian coordinate
system of the projection into a ILcd2DEditablePoint
on the
ellipsoid.world2lonlatOnEllipsoidSFCT
in interface ILcdCompositeProjection
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.TLcdOutOfBoundsException
- aXYZonalPoint
is outside the area valid for this projection.public int retrieveZone(ILcdPoint aLLP) throws TLcdOutOfBoundsException
ILcdCompositeProjection
retrieveZone
in interface ILcdCompositeProjection
aLLP
- the model point to find the zone for.TLcdOutOfBoundsException
- if the point is not within the valid area
of the projection (visible area), then this exception is thrown.public boolean inLonLatBounds(ILcdPoint aLLP)
ILcdPoint
is inside the valid area of the
composite projection.inLonLatBounds
in interface ILcdCompositeProjection
aLLP
- the point to check for.public boolean inWorldBoundsOnSphere(ILcdZonalPoint aXYZonalPoint, double aRadius)
ILcdCompositeProjection
ILcdPoint
is inside the valid cartesian area of
the composite projection.inWorldBoundsOnSphere
in interface ILcdCompositeProjection
aXYZonalPoint
- ILcdZonalPoint
to be checked upon.aRadius
- Description of Parametertrue
if valid, false
if invalid.public boolean inWorldBoundsOnEllipsoid(ILcdZonalPoint aXYZonalPoint, ILcdEllipsoid aEllipsoid)
ILcdCompositeProjection
ILcdPoint
is inside the valid cartesian area of
the composite projection.inWorldBoundsOnEllipsoid
in interface ILcdCompositeProjection
aXYZonalPoint
- ILcdZonalPoint
to be checked upon.aEllipsoid
- ellipsoidal representation of the earth.true
if valid, false
if invalid.public double[] boundaryLons(double aLat)
boundaryLons
in interface ILcdCompositeProjection
aLat
- not taken into accountpublic double[] boundaryLats(double aLon)
boundaryLats
in interface ILcdCompositeProjection
aLon
- not taken into account.public String toString()
ILcdCompositeProjection
ILcdCompositeProjection
.toString
in interface ILcdCompositeProjection
toString
in class Object
ILcdCompositeProjection
.public ILcdCompositeProjection cloneAsILcdCompositeProjection()
ILcdCompositeProjection
ILcdCompositeProjection
.cloneAsILcdCompositeProjection
in interface ILcdCompositeProjection
ILcdCompositeProjection
.public boolean equals(Object aObject)
ILcdCompositeProjection
ILcdCompositeProjection
is equal with another
Object.equals
in interface ILcdCompositeProjection
equals
in class Object
aObject
- Object to compare to.ILcdCompositeProjection
class and having the same
projection properties, false otherwise.