Package com.luciad.reference
Interface ILcdGridReference
 All Superinterfaces:
Cloneable
,ILcdCloneable
,ILcdGeoReference
 All Known Implementing Classes:
TLcdDHDNGermanGridReference
,TLcdGridReference
,TLcdLambert1972BelgiumGridReference
,TLcdLambertFrenchGridReference
,TLcdRD1918DutchGridReference
,TLcdSwissGridReference
,TLcdUPSGrid
,TLcdUTMGrid
,TLcyGridReference
,TLcyUTMGridReference
An
ILcdGridReference
is an ILcdGeoReference
that
contains the relation between (longitude,latitude, height) coordinates
and cartesian (x, y, z) coordinates. (x, y) is a regional EastingNorthing pair
while z is equal to the original height.
 The Easting coordinate (x) is positive for East and negative for West.
 The Northing coordinate (y) is positive for North and negative for South.
ILcdGridReference
as if performing the transformation from the (longitude,latitude, height) coordinates
to the cartesian (x, y, z) coordinates.
The reverse transformation is obtained by following the steps in the reverse order.
An ILcdGridReference
has:
 An
ILcdGeodeticDatum
from/to which coordinates in other geodetic datums can be converted.  An
ILcdProjection
: a map projection on which the grid system is based.
TheILcdEllipsoid
of theILcdProjection
is always the same as theILcdEllipsoid
of theILcdGeodeticDatum
.
The (x, y) coordinates obtained by applying theILcdProjection
on the original (longitude,latitude, height) coordinates are called "the cartesian coordinates of the map projection".  A
scale
: a factor that is applied on the cartesian coordinates of the map projection  A
rotation
aRotation
that is applied on the cartesian coordinates of the map projection after scaling. The center of the rotation is the origin of the map projection.  A
unitOfMeasure
: the Unit of Measure of length of the grid coordinates in meter.  A
falseOrigin
, given by afalseEasting
and afalseNorthing
: this defines a translation that is applied on the cartesian coordinates of the map projection after scaling, rotation, and applying theunitOfMeasure
. In other words, it defines the offset of the origin of the cartesian coordinate system with respect to the origin of the map projection defined in the unit of measure of the grid system. This results in the final EastingNorthing pair of cartesian coordinates.
This translation is used to have positive (x,y) grid coordinates for the country or region considered.
More information on references can be found on Coordinate Systems Overview by Peter H. Dana.

Field Summary
Fields inherited from interface com.luciad.reference.ILcdGeoReference
CARTESIAN, GEODETIC

Method Summary
Modifier and TypeMethodDescriptiondouble
Returns the cosine of the rotation of thisILcdGridReference
.double
Returns the false easting of thisILcdGridReference
.double
Returns the false northing of thisILcdGridReference
.Returns theILcdProjection
of thisILcdGridReference
.double
Returns the rotation of thisILcdGridReference
in radians, clockwise.double
getScale()
Returns the scale of thisILcdGridReference
.double
Returns the sine of the rotation of thisILcdGridReference
.double
Returns the unitOfMeasure of thisILcdGridReference
w.r.t. to meters.Methods inherited from interface com.luciad.util.ILcdCloneable
clone
Methods inherited from interface com.luciad.reference.ILcdGeoReference
getCoordinateType, getGeodeticDatum

Method Details

getProjection
ILcdProjection getProjection()Returns theILcdProjection
of thisILcdGridReference
. Returns:
 the
ILcdProjection
of thisILcdGridReference
.

getFalseEasting
double getFalseEasting()Returns the false easting of thisILcdGridReference
. It is defined in the unit of the grid system. Returns:
 the false easting of this
ILcdGridReference
. It is defined in the unit of the grid system.

getFalseNorthing
double getFalseNorthing()Returns the false northing of thisILcdGridReference
. It is defined in the unit of the grid system. Returns:
 the false northing of this
ILcdGridReference
. It is defined in the unit of the grid system.

getScale
double getScale()Returns the scale of thisILcdGridReference
. Returns:
 the scale of this
ILcdGridReference
.

getUnitOfMeasure
double getUnitOfMeasure()Returns the unitOfMeasure of thisILcdGridReference
w.r.t. to meters. So, if the unit of the grid reference would be millimeters, this becomes 0.001. Returns:
 the unitOfMeasure of this
ILcdGridReference
w.r.t. meters. So, if the unit of the grid reference would be millimeters, this becomes 0.001.

getRotation
double getRotation()Returns the rotation of thisILcdGridReference
in radians, clockwise. The center of the rotation is the origin of the map projection. Returns:
 the rotation of this
ILcdGridReference
in radians.

getCosRotation
double getCosRotation()Returns the cosine of the rotation of thisILcdGridReference
. Returns:
 the cosine of the rotation of this
ILcdGridReference
.

getSinRotation
double getSinRotation()Returns the sine of the rotation of thisILcdGridReference
. Returns:
 the sine of the rotation of this
ILcdGridReference
.
