# Interface ILcdGridReference

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

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.

• ## Field Summary

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

`CARTESIAN, GEODETIC`
• ## Method Summary

Modifier and Type
Method
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.util.ILcdCloneable

`clone`

### Methods inherited from interface com.luciad.reference.ILcdGeoReference

`getCoordinateType, getGeodeticDatum`
• ## Method Details

• ### 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`.