org.geotools.coverage.grid.io.imageio.geotiff
Class TiePoint

Object
  extended by TiePoint

public final class TiePoint
extends Object

Quoting the geotiff spec:

      ModelTiepointTag:
      Tag = 33922 (8482.H) 
      Type = DOUBLE (IEEE Double precision)
      N = 6*K,  K = number of tiepoints
      Alias: GeoreferenceTag
      Owner: Intergraph
 
This tag stores raster->model tiepoint pairs in the order
   ModelTiepointTag = (...,I,J,K, X,Y,Z...),
 
where (I,J,K) is the point at location (I,J) in raster space with pixel-value K, and (X,Y,Z) is a vector in model space. In most cases the model space is only two-dimensional, in which case both K and Z should be set to zero; this third dimension is provided in anticipation of future support for 3D digital elevation models and vertical coordinate systems.

A raster image may be georeferenced simply by specifying its location, size and orientation in the model coordinate space M. This may be done by specifying the location of three of the four bounding corner points. However, tiepoints are only to be considered exact at the points specified; thus defining such a set of bounding tiepoints does not imply that the model space locations of the interior of the image may be exactly computed by a linear interpolation of these tiepoints.

However, since the relationship between the Raster space and the model space will often be an exact, affine transformation, this relationship can be defined using one set of tiepoints and the "ModelPixelScaleTag", described below, which gives the vertical and horizontal raster grid cell size, specified in model units.

If possible, the first tiepoint placed in this tag shall be the one establishing the location of the point (0,0) in raster space. However, if this is not possible (for example, if (0,0) is goes to a part of model space in which the projection is ill-defined), then there is no particular order in which the tiepoints need be listed.

For orthorectification or mosaicking applications a large number of tiepoints may be specified on a mesh over the raster image. However, the definition of associated grid interpolation methods is not in the scope of the current GeoTIFF spec.

Since:
2.3
Author:
Simone Giannecchini, GeoSolutions

Constructor Summary
TiePoint()
          Default constructor.
TiePoint(double i, double j, double k, double x, double y, double z)
           
 
Method Summary
 boolean equals(Object obj)
           
 double[] getData()
           
 double getValueAt(int index)
           
 int hashCode()
           
 boolean isSet()
           
 void set(double i, double j, double k, double x, double y, double z)
           
 String toString()
           
 
Methods inherited from class Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TiePoint

public TiePoint()
Default constructor.


TiePoint

public TiePoint(double i,
                double j,
                double k,
                double x,
                double y,
                double z)
Method Detail

set

public void set(double i,
                double j,
                double k,
                double x,
                double y,
                double z)

getValueAt

public double getValueAt(int index)

getData

public double[] getData()

isSet

public boolean isSet()

equals

public boolean equals(Object obj)
Overrides:
equals in class Object

hashCode

public int hashCode()
Overrides:
hashCode in class Object

toString

public String toString()
Overrides:
toString in class Object


Copyright © 1996-2009 Geotools. All Rights Reserved.