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
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.

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