2023.1.13

• All Superinterfaces:
Cloneable, ILcdCloneable, ILcdGeoReference
All Known Implementing Classes:
TLcdDHDNGermanGridReference, TLcdGridReference, TLcdLambert1972BelgiumGridReference, TLcdLambertFrenchGridReference, TLcdRD1918DutchGridReference , TLcdSwissGridReference, TLcdUPSGrid, TLcdUTMGrid

```public interface ILcdGridReference
extends ILcdGeoReference```
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 Easting-Northing 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.
The following explains the parameters of the `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.
The `ILcdEllipsoid` of the `ILcdProjection` is always the same as the `ILcdEllipsoid` of the `ILcdGeodeticDatum`.
The (x, y) coordinates obtained by applying the `ILcdProjection` 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 a `falseEasting` and a `falseNorthing`: this defines a translation that is applied on the cartesian coordinates of the map projection after scaling, rotation, and applying the `unitOfMeasure`. 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 Easting-Northing 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.

• ### Fields inherited from interface com.luciad.reference.ILcdGeoReference

`CARTESIAN, GEODETIC`
• ### Method Summary

All Methods
Modifier and Type Method and Description
`double` `getCosRotation()`
Returns the cosine of the rotation of this `ILcdGridReference`.
`double` `getFalseEasting()`
Returns the false easting of this `ILcdGridReference`.
`double` `getFalseNorthing()`
Returns the false northing of this `ILcdGridReference`.
`ILcdProjection` `getProjection()`
Returns the `ILcdProjection` of this `ILcdGridReference`.
`double` `getRotation()`
Returns the rotation of this `ILcdGridReference` in radians, clockwise.
`double` `getScale()`
Returns the scale of this `ILcdGridReference`.
`double` `getSinRotation()`
Returns the sine of the rotation of this `ILcdGridReference`.
`double` `getUnitOfMeasure()`
Returns the unitOfMeasure of this `ILcdGridReference` w.r.t. to meters.
• ### Methods inherited from interface com.luciad.reference.ILcdGeoReference

`getCoordinateType, getGeodeticDatum`
• ### Methods inherited from interface com.luciad.util.ILcdCloneable

`clone`
• ### Method Detail

• #### getProjection

`ILcdProjection getProjection()`
Returns the `ILcdProjection` of this `ILcdGridReference`.
Returns:
the `ILcdProjection` of this `ILcdGridReference`.
• #### getFalseEasting

`double getFalseEasting()`
Returns the false easting of this `ILcdGridReference`. 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 this `ILcdGridReference`. 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 this `ILcdGridReference`.
Returns:
the scale of this `ILcdGridReference`.
• #### getUnitOfMeasure

`double getUnitOfMeasure()`
Returns the unitOfMeasure of this `ILcdGridReference` 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 this `ILcdGridReference` 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 this `ILcdGridReference`.
Returns:
the cosine of the rotation of this `ILcdGridReference`.
• #### getSinRotation

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