Package com.luciad.projection
Class TLcdMercator
java.lang.Object
com.luciad.projection.ALcdProjection
com.luciad.projection.ALcdCylindrical
com.luciad.projection.TLcdMercator
- All Implemented Interfaces:
ILcdCylindrical
,ILcdProjection
,ILcdPropertyChangeSource
,Serializable
,Cloneable
- Direct Known Subclasses:
TLcdPseudoMercator
Mercator projection.
Introduction
Cylindrical conformal projection.
Properties
- The projection is conformal.
- Meridians are equally spaced straight lines. Parallels are also straight lines but they are unequally spaced.
- The scale of the projection is
true
along the equator. - Loxodromes (rhumb lines) are shown as straight lines.
- The poles are at infinity, there is a great distortion of area in the polar regions.
Example
Sample code
ILcdProjection projection = new TLcdMercator(0.0, 0.0);
Implementation aspects
The equations of the mercator projection are taken from [Snyder1987].
- See Also:
-
Field Summary
Fields inherited from class com.luciad.projection.ALcdProjection
fPropertyChangeDispatcher
Fields inherited from interface com.luciad.projection.ILcdProjection
EPSILON
-
Constructor Summary
ConstructorDescriptionConstructs a mercator projection with the central meridian at 0.0.TLcdMercator
(double aCentralMeridian) Constructs a mercator projection with the specified central meridian. -
Method Summary
Modifier and TypeMethodDescriptiondouble[][]
boundaryLats
(double lon) Default implementation.double[][]
boundaryLons
(double lat) Default implementation.clone()
Makes a deep clone of thisILcdProjection
.boolean
Checks if thisILcdProjection
equals some other Object.Returns the upper and lower latitude boundaries of the projection.double
Returns the latitude which is made standard, with true scale.int
hashCode()
boolean
inLonLatBounds
(ILcdPoint aLLP) Checks if anILcdPoint
is inside the valid area of geodetic coordinates of the projection.boolean
inWorldBoundsOnEllipsoid
(ILcdPoint aXYPoint, ILcdEllipsoid aEllipsoid) Default implementation callsinWorldBoundsOnSphere
withaEllipsoid.getAuxRadius()
as sphere radius.boolean
inWorldBoundsOnSphere
(ILcdPoint aXYPoint, double aRadius) Checks if aILcdPoint
is inside the valid cartesian area of the projection.boolean
If all geodetic coordinates (l ,j ) are projected (visible) by anILcdProjection
and all (x,y ) coordinates are bounded this istrue
.boolean
AnILcdProjection
is continuous if there are no interruptions in the world coordinates.void
loadProperties
(String aPrefix, Properties aProperty) Load the property of anALcdCylindrical
: the central meridian of the projection.void
lonlatheight2worldOnEllipsoidSFCT
(ILcdPoint aLLHP, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aXYPointSFCT) Default implementation callslonlatheight2worldOnEllipsoidSFCT
withaEllipsoid.getAuxRadius()
as sphere radius.void
lonlatheight2worldOnSphereSFCT
(ILcdPoint aLLHP, double aRadius, ILcd2DEditablePoint aXYPointSFCT) Transforms anILcd2DEditablePoint
on a sphere into the cartesian coordinate system of the projection.void
setLatitudeLimits
(ILcdInterval aLatitudeInterval) Changes the upper and lower latitude boundaries of the projection.void
setTrueScaleLatitude
(double aLatitude) Sets the latitude which is made standard, with true scale.toString()
Returns theString
representation of the mercator projection.void
world2DEditableBoundsOnEllipsoidSFCT
(ILcdEllipsoid aEllipsoid, ILcd2DEditableBounds aWorldBound) Default implementation callsworld2lonlatOnSphereSFCT
withaEllipsoid.getAuxRadius()
as sphere radius.void
world2DEditableBoundsOnSphereSFCT
(double aRadius, ILcd2DEditableBounds aWorldBound) Projection is cut off near the poles.void
world2lonlatOnEllipsoidSFCT
(ILcdPoint aXYPoint, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aLLPSFCT) Default implementation callsworld2lonlatOnSphereSFCT
withaEllipsoid.getAuxRadius()
as sphere radius.void
world2lonlatOnSphereSFCT
(ILcdPoint aXYPoint, double aRadius, ILcd2DEditablePoint aLLPSFCT) Transforms anILcdPoint
from the cartesian coordinate system of the projection into anILcd2DEditablePoint
onto a sphere.void
writePropertiesSFCT
(String aPrefix, Properties aPropertySFCT) Writes the property of anALcdCylindrical
: the central meridian of the projection.Methods inherited from class com.luciad.projection.ALcdCylindrical
calculateCachedValues, getCentralMeridian, getOrigin, setCentralMeridian
Methods inherited from class com.luciad.projection.ALcdProjection
addPropertyChangeListener, firePropertyChangeEvent, removePropertyChangeListener
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.luciad.util.ILcdPropertyChangeSource
addPropertyChangeListener, removePropertyChangeListener
-
Constructor Details
-
TLcdMercator
public TLcdMercator()Constructs a mercator projection with the central meridian at 0.0. -
TLcdMercator
public TLcdMercator(double aCentralMeridian) Constructs a mercator projection with the specified central meridian.- Parameters:
aCentralMeridian
- the central meridian of the mercator projection.
-
-
Method Details
-
lonlatheight2worldOnEllipsoidSFCT
public void lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aXYPointSFCT) throws TLcdOutOfBoundsException Description copied from class:ALcdProjection
Default implementation callslonlatheight2worldOnEllipsoidSFCT
withaEllipsoid.getAuxRadius()
as sphere radius.- Specified by:
lonlatheight2worldOnEllipsoidSFCT
in interfaceILcdProjection
- Overrides:
lonlatheight2worldOnEllipsoidSFCT
in classALcdProjection
- Parameters:
aLLHP
- point to be projected.aEllipsoid
- ellipsoid on which the point is defined.aXYPointSFCT
- projected point as side effect.- Throws:
TLcdOutOfBoundsException
- If theILcdPoint
aLLHP
is not within the valid area of the projection (visible area), then this exception is thrown.
-
lonlatheight2worldOnSphereSFCT
public void lonlatheight2worldOnSphereSFCT(ILcdPoint aLLHP, double aRadius, ILcd2DEditablePoint aXYPointSFCT) throws TLcdOutOfBoundsException Description copied from interface:ILcdProjection
Transforms anILcd2DEditablePoint
on a sphere into the cartesian coordinate system of the projection.- Parameters:
aLLHP
- point to be projected.aRadius
- radius of the sphere (meters).aXYPointSFCT
- projected point as side effect.- Throws:
TLcdOutOfBoundsException
- If theILcdPoint
aLLHP
is not within the valid area of the projection (visible area), then this exception is thrown.
-
getTrueScaleLatitude
public double getTrueScaleLatitude()Returns the latitude which is made standard, with true scale.- Returns:
- the latitude which is true to scale.
-
setTrueScaleLatitude
public void setTrueScaleLatitude(double aLatitude) Sets the latitude which is made standard, with true scale. Note that the parallel with the opposite latitude automatically becomes standard as well.- Parameters:
aLatitude
- the latitude which is true to scale
-
world2lonlatOnSphereSFCT
public void world2lonlatOnSphereSFCT(ILcdPoint aXYPoint, double aRadius, ILcd2DEditablePoint aLLPSFCT) throws TLcdOutOfBoundsException Description copied from interface:ILcdProjection
Transforms anILcdPoint
from the cartesian coordinate system of the projection into anILcd2DEditablePoint
onto a sphere.- Parameters:
aXYPoint
- projected point for which the corresponding geodetic point is sought.aRadius
- radius of the sphere (meters).aLLPSFCT
- resulting geodetic coordinate as side effect.- Throws:
TLcdOutOfBoundsException
- If theILcdPoint
aXYPoint
is not within the valid area of the projection (visible area), then this exception is thrown.
-
world2lonlatOnEllipsoidSFCT
public void world2lonlatOnEllipsoidSFCT(ILcdPoint aXYPoint, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aLLPSFCT) throws TLcdOutOfBoundsException Description copied from class:ALcdProjection
Default implementation callsworld2lonlatOnSphereSFCT
withaEllipsoid.getAuxRadius()
as sphere radius.- Specified by:
world2lonlatOnEllipsoidSFCT
in interfaceILcdProjection
- Overrides:
world2lonlatOnEllipsoidSFCT
in classALcdProjection
- Parameters:
aXYPoint
- projected point for which the corresponding geodetic point is sought.aEllipsoid
- ellipsoid on which the geodetic coordinate is defined.aLLPSFCT
- resulting geodetic coordinate as side effect.- Throws:
TLcdOutOfBoundsException
- If theILcdPoint
aXYPoint
is not within the valid area of the projection (visible area), then this exception is thrown.
-
isAllInBounds
public boolean isAllInBounds()Description copied from interface:ILcdProjection
If all geodetic coordinates (l ,j ) are projected (visible) by anILcdProjection
and all (x,y ) coordinates are bounded this istrue
. AllILcdProjection
objects have bounded (x,y ) coordinates because the projection is cut off if necessary.- Returns:
true
if all LonLatPoints are within the bounds of the projection,false
otherwise.
-
isContinuous
public boolean isContinuous()Description copied from interface:ILcdProjection
AnILcdProjection
is continuous if there are no interruptions in the world coordinates. Most projections are continuous.- Specified by:
isContinuous
in interfaceILcdProjection
- Overrides:
isContinuous
in classALcdCylindrical
- Returns:
true
if the projection is continuous,false
otherwise.
-
inLonLatBounds
Description copied from interface:ILcdProjection
Checks if anILcdPoint
is inside the valid area of geodetic coordinates of the projection. The valid area is determined by the LonLatPoints that are visible and for which the corresponding cartesian coordinate is within the boundaries.- Parameters:
aLLP
-ILcdPoint
to be checked upon.- Returns:
true
if valid,false
if invalid.
-
boundaryLons
public double[][] boundaryLons(double lat) Description copied from class:ALcdProjection
Default implementation. To be redefined for specific projections.- Specified by:
boundaryLons
in interfaceILcdProjection
- Overrides:
boundaryLons
in classALcdProjection
- Parameters:
lat
- latitude in decimal degrees and -90.0 <=aLat
<= 90.0.- Returns:
- the array of pairs of longitudes[0] and longitudes[1], where the closed interval longitudes[0] -> longitudes[1] is in visible area and -180.0 <= lon[i] <= 180.0.
-
boundaryLats
public double[][] boundaryLats(double lon) Description copied from class:ALcdProjection
Default implementation. To be redefined for specific projections.- Specified by:
boundaryLats
in interfaceILcdProjection
- Overrides:
boundaryLats
in classALcdProjection
- Parameters:
lon
- longitude in decimal degrees -180.0 <= lon <= 180.0 .- Returns:
- the array of pairs of latitudes lats[0] and lats[1], where the closed interval lats[0] -> lats[1] is in visible area and -90.0 <= lats[i] <= 90.0 .
-
setLatitudeLimits
Changes the upper and lower latitude boundaries of the projection. Anything higher than the upper boundary or lower than the lower boundary will not be included in the projection.- Parameters:
aLatitudeInterval
- the latitude boundaries of the projection. The interval should not extend [ -89.5, 89.5 ]- Throws:
IllegalArgumentException
- if the interval extends [ -89.5, 89.5 ]
-
getLatitudeLimits
Returns the upper and lower latitude boundaries of the projection. The default is the interval [ -89.5, 89.5 ]- Returns:
- the latitude boundaries of the projection
-
inWorldBoundsOnSphere
Description copied from interface:ILcdProjection
Checks if aILcdPoint
is inside the valid cartesian area of the projection. The valid cartesian area is determined naturally by the projection bounds or by an artificial introduced boundary limit because some cartesian points are at infinity. The shape of the valid cartesian area is in many cases rectangular or circular although it might be more complex.- Parameters:
aXYPoint
- point to be checked upon.aRadius
- radius of the sphere.- Returns:
true
if valid,false
if invalid.
-
inWorldBoundsOnEllipsoid
Description copied from class:ALcdProjection
Default implementation callsinWorldBoundsOnSphere
withaEllipsoid.getAuxRadius()
as sphere radius.- Specified by:
inWorldBoundsOnEllipsoid
in interfaceILcdProjection
- Overrides:
inWorldBoundsOnEllipsoid
in classALcdProjection
- Parameters:
aXYPoint
- point to be checked upon.aEllipsoid
- ellipsoid on which the geodetic coordinate is defined.- Returns:
true
if valid,false
if invalid.- See Also:
-
world2DEditableBoundsOnSphereSFCT
Projection is cut off near the poles.- Parameters:
aRadius
- radius of the sphere.aWorldBound
- the bounds of the projection in world coordinates as side effect.
-
world2DEditableBoundsOnEllipsoidSFCT
public void world2DEditableBoundsOnEllipsoidSFCT(ILcdEllipsoid aEllipsoid, ILcd2DEditableBounds aWorldBound) Description copied from class:ALcdProjection
Default implementation callsworld2lonlatOnSphereSFCT
withaEllipsoid.getAuxRadius()
as sphere radius.- Specified by:
world2DEditableBoundsOnEllipsoidSFCT
in interfaceILcdProjection
- Overrides:
world2DEditableBoundsOnEllipsoidSFCT
in classALcdProjection
- Parameters:
aEllipsoid
- ellipsoid considered.aWorldBound
- the bounds of the projection in world coordinates as side effect.
-
writePropertiesSFCT
Writes the property of anALcdCylindrical
: the central meridian of the projection. This method will, given aPrefix, store he property of thisALcdCylindrical
into the aPropertiesSFCT object. The value of following key is stored:- <aPrefix><the name of the class that extends this abstract class>.centralMeridian
lattitude limits
andtrue scale latitude
using the following properties:- <aPrefix><the name of the class that extends this abstract class>.trueScaleLatitude
- <aPrefix><the name of the class that extends this abstract class>.upperLatitude
- <aPrefix><the name of the class that extends this abstract class>.lowerLatitude
- Specified by:
writePropertiesSFCT
in interfaceILcdProjection
- Overrides:
writePropertiesSFCT
in classALcdCylindrical
- Parameters:
aPrefix
- prefix for the property names.aPropertySFCT
- Properties object to store the serialized properties by side effect.
-
loadProperties
Load the property of anALcdCylindrical
: the central meridian of the projection. This method will, given aPrefix, analyze the aProperties object to set the property of thisALcdCylindrical
. The value of following key is retrieved:- <aPrefix><the name of the class that extends this abstract class>.centralMeridian
lattitude limits
andtrue scale latitude
using the following properties:- <aPrefix><the name of the class that extends this abstract class>.trueScaleLatitude
- <aPrefix><the name of the class that extends this abstract class>.upperLatitude
- <aPrefix><the name of the class that extends this abstract class>.lowerLatitude
- Specified by:
loadProperties
in interfaceILcdProjection
- Overrides:
loadProperties
in classALcdCylindrical
- Parameters:
aPrefix
- prefix of the property names.aProperty
- Properties object containing the serialized properties.- Throws:
IllegalArgumentException
- if the projection cannot be created.
-
toString
Returns theString
representation of the mercator projection.- Specified by:
toString
in interfaceILcdProjection
- Overrides:
toString
in classObject
- Returns:
- the
String
representation of the mercator projection.
-
clone
Description copied from interface:ILcdProjection
Makes a deep clone of thisILcdProjection
.- Specified by:
clone
in interfaceILcdProjection
- Overrides:
clone
in classALcdCylindrical
- Returns:
- deep clone of this
ILcdProjection
.
-
equals
Description copied from interface:ILcdProjection
Checks if thisILcdProjection
equals some other Object.- Specified by:
equals
in interfaceILcdProjection
- Overrides:
equals
in classALcdCylindrical
- Parameters:
o
- Object to compare with.- Returns:
- true if the Object is an instance of the same
ILcdProjection
class and having the same projection properties, false otherwise.
-
hashCode
public int hashCode()- Overrides:
hashCode
in classALcdCylindrical
-