Package org.esa.snap.core.datamodel

Class TiePointGeoCoding

java.lang.Object
org.esa.snap.core.datamodel.AbstractGeoCoding
org.esa.snap.core.datamodel.TiePointGeoCoding
All Implemented Interfaces:
GeoCoding
@Deprecated public class TiePointGeoCoding extends AbstractGeoCoding
Deprecated.
since SNAP 8.0.0, Better use ComponentGeoCoding with TiePointInverse and one of TiePointInverse, TiePointBilinearForward and TiePointSplineForward
A geo-coding based on two tie-point grids. One grid stores the latitude tie-points, the other stores the longitude tie-points.

  • Constructor Details

    • TiePointGeoCoding

      public TiePointGeoCoding(TiePointGrid latGrid, TiePointGrid lonGrid)
      Deprecated.
      Constructs geo-coding based on two given tie-point grids based on the WGS-84 CRS.
      Parameters:
      latGrid - the latitude grid
      lonGrid - the longitude grid

    • TiePointGeoCoding

      public TiePointGeoCoding(TiePointGrid latGrid, TiePointGrid lonGrid, org.opengis.referencing.crs.CoordinateReferenceSystem geoCRS)
      Deprecated.
      Constructs geo-coding based on two given tie-point grids.
      Parameters:
      latGrid - The latitude grid
      lonGrid - The longitude grid
      geoCRS - The CRS to be used as both the geographic CRS and map CRS.

    • TiePointGeoCoding

      @Deprecated public TiePointGeoCoding(TiePointGrid latGrid, TiePointGrid lonGrid, Datum datum)
      Deprecated.
      since SNAP 1.0, use TiePointGeoCoding(TiePointGrid, TiePointGrid, CoordinateReferenceSystem)
      Constructs geo-coding based on two given tie-point grids.
      Parameters:
      latGrid - the latitude grid
      lonGrid - the longitude grid
      datum - the geodetic datum

  • Method Details

    • normalizeLat

      public static double normalizeLat(double lat)
      Deprecated.
      Gets the normalized latitude value. The method returns Double.NaN if the given latitude value is out of bounds.
      Parameters:
      lat - the raw latitude value in the range -90 to +90 degrees
      Returns:
      the normalized latitude value, Double.NaN else

    • getDatum

      public Datum getDatum()
      Deprecated.
      Gets the datum, the reference point or surface against which GeoPos measurements are made.
      Returns:
      the datum

    • isCrossingMeridianAt180

      public boolean isCrossingMeridianAt180()
      Deprecated.
      Gets the flag indicating that the geographic boundary of the tie-points in this geo-coding intersects the 180 degree meridian.
      Returns:
      true if so

    • getNumApproximations

      public int getNumApproximations()
      Deprecated.
      Gets the number of approximations used for the transformation map (lat,lon) --> image (x,y).
      Returns:
      the number of approximations, zero if no approximations could be computed

    • getApproximation

      public TiePointGeoCoding.Approximation getApproximation(int index)
      Deprecated.
      Gets the approximations for the given index.
      Parameters:
      index - the index, must be between 0 and getNumApproximations() - 1
      Returns:
      the approximation, never null

    • canGetGeoPos

      public boolean canGetGeoPos()
      Deprecated.
      Checks whether this geo-coding can determine the geodetic position from a pixel position.
      Returns:
      true, if so

    • canGetPixelPos

      public boolean canGetPixelPos()
      Deprecated.
      Checks whether this geo-coding can determine the pixel position from a geodetic position.
      Returns:
      true, if so

    • getLatGrid

      public TiePointGrid getLatGrid()
      Deprecated.
      Returns:
      the latitude grid, never null.

    • getLonGrid

      public TiePointGrid getLonGrid()
      Deprecated.
      Returns:
      the longitude grid, never null.

    • getGeoPos

      public GeoPos getGeoPos(PixelPos pixelPos, GeoPos geoPos)
      Deprecated.
      Returns the latitude and longitude value for a given pixel co-ordinate.
      Parameters:
      pixelPos - the pixel's co-ordinates given as x,y
      geoPos - an instance of GeoPos to be used as retun value. If this parameter is null, the method creates a new instance which it then returns.
      Returns:
      the geographical position as lat/lon.

    • getPixelPos

      public PixelPos getPixelPos(GeoPos geoPos, PixelPos pixelPos)
      Deprecated.
      Returns the pixel co-ordinates as x/y for a given geographical position given as lat/lon.
      Parameters:
      geoPos - the geographical position as lat/lon.
      pixelPos - an instance of Point to be used as retun value. If this parameter is null, the method creates a new instance which it then returns.
      Returns:
      the pixel co-ordinates as x/y

    • canClone

      public boolean canClone()
      Deprecated.
      Description copied from class: AbstractGeoCoding
      Check if geocoding can be cloned.
      Specified by:
      canClone in interface GeoCoding
      Overrides:
      canClone in class AbstractGeoCoding
      Returns:
      if so or not

    • clone

      public GeoCoding clone()
      Deprecated.
      Description copied from class: AbstractGeoCoding
      Creates a shallow clone of this geocoding. Geolocation raster data is shared.
      Specified by:
      clone in interface GeoCoding
      Overrides:
      clone in class AbstractGeoCoding
      Returns:
      the cloned geocoding

    • normalizeLon

      public final double normalizeLon(double lon)
      Deprecated.
      Gets the normalized longitude value. The method returns Double.NaN if the given longitude value is out of bounds or if it's normalized value is not in the value range of this geo-coding's normalized longitude grid..
      Parameters:
      lon - the raw longitude value in the range -180 to +180 degrees
      Returns:
      the normalized longitude value, Double.NaN else

    • equals

      public boolean equals(Object o)
      Deprecated.
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Deprecated.
      Overrides:
      hashCode in class Object

    • dispose

      public void dispose()
      Deprecated.
      Description copied from interface: GeoCoding
      Releases all of the resources used by this object instance and all of its owned children. Its primary use is to allow the garbage collector to perform a vanilla job.

      This method should be called only if it is for sure that this object instance will never be used again. The results of referencing an instance of this class after a call to dispose() are undefined.

    • transferGeoCoding

      public boolean transferGeoCoding(Scene srcScene, Scene destScene, ProductSubsetDef subsetDef)
      Deprecated.
      Transfers the geo-coding of the srcScene to the destScene with respect to the given subsetDef.
      Specified by:
      transferGeoCoding in class AbstractGeoCoding
      Parameters:
      srcScene - the source scene
      destScene - the destination scene
      subsetDef - the definition of the subset, may be null
      Returns:
      true, if the geo-coding could be transferred.

    • copyGridsToDestScene

      protected void copyGridsToDestScene(Scene destScene)
      Deprecated.

    • getDestGrid

      protected TiePointGrid getDestGrid(TiePointGrid grid, Scene destScene, ProductSubsetDef subsetDef)
      Deprecated.