Class TLcdUTMGridSystem

java.lang.Object
com.luciad.view.map.TLcdUTMGridSystem

public class TLcdUTMGridSystem extends Object
This class can be used to retrieve a TLcdUTMGrid reference for a specific point or UTM zone.
Since:
11.0
  • Field Details

    • NORTH_LAT_LIMIT

      public static final double NORTH_LAT_LIMIT
      The northern limit for the valid UTM area.
      See Also:
    • SOUTH_LAT_LIMIT

      public static final double SOUTH_LAT_LIMIT
      The southern limit for the valid UTM area.
      See Also:
  • Constructor Details

    • TLcdUTMGridSystem

      public TLcdUTMGridSystem()
      Creates a new TLcdUTMGridSystem for the WGS84 geodetic datum. The TLcdUTMGrid instances returned by this class will contain this datum.
    • TLcdUTMGridSystem

      public TLcdUTMGridSystem(ILcdGeodeticDatum aGeodeticDatum)
      Creates a new TLcdUTMGridSystem for the given geodetic datum. The TLcdUTMGrid instances returned by this class will contain this datum.
      Parameters:
      aGeodeticDatum - a geodetic datum.
  • Method Details

    • getGeodeticDatum

      public ILcdGeodeticDatum getGeodeticDatum()
      Returns the used geodetic datum.
      Returns:
      the used geodetic datum.
    • getUTMGrid

      public TLcdUTMGrid getUTMGrid(int aZone, boolean aNorth)
      Returns the TLcdUTMGrid for the given zone.
      Parameters:
      aZone - a given zone, should lie in the interval [1,60]
      aNorth - true to return the utm grid for the northern hemisphere, and false otherwise.
      Returns:
      the TLcdUTMGrid for the given zone.
    • getUTMGrid

      public TLcdUTMGrid getUTMGrid(ILcdPoint aLLP) throws TLcdOutOfBoundsException
      Returns the TLcdUTMGrid for the given lon lat point.
      Parameters:
      aLLP - a given lon lat point.
      Returns:
      the TLcdUTMGrid for the given lon lat point
      Throws:
      TLcdOutOfBoundsException - when the given lon lat point is outside the bounds of the UTM grid system.
    • retrieveZone

      public static int retrieveZone(ILcdPoint aLLP) throws TLcdOutOfBoundsException
      Returns the UTM zone for the given point.
      Parameters:
      aLLP - a given lon lat point.
      Returns:
      the UTM zone for the given point
      Throws:
      TLcdOutOfBoundsException - when the given lon lat point is outside the bounds of the UTM grid system.
    • inLonLatBounds

      public static boolean inLonLatBounds(ILcdPoint aLLP)
      Checks if an ILcdPoint is inside the valid area of the UTM grid system.
      Parameters:
      aLLP - the point to check for.
      Returns:
      true if the y value of the given point is between NORTH_LAT_LIMIT and SOUTH_LAT_LIMIT.