Package com.luciad.format.raster.reference

Class TLcdRationalRasterReferencer

java.lang.Object

com.luciad.format.raster.reference.TLcdRationalRasterReferencer

All Implemented Interfaces:

ILcdRasterReferencer

public class TLcdRationalRasterReferencer
extends Object
implements ILcdRasterReferencer

This implementation of ILcdRasterReferencer computes raster references using rational approximations, based on the given tie points. The degrees of the nominator and the denominator can be specified. Note that low degrees generally work best; high degrees quickly lead to strongly oscillating approximations.

The referencer returns an ILcdRasterReference whose model reference is an ILcdGridReference. The projection of this ILcdGridReference is a TLcdRectifiedRationalProjection.

If the initial reference of the model tie points is also an ILcdGridReference, then the newly created grid reference will have exactly the same parameters, except that the initial projection is wrapped inside the rectified projection. Thus, you can consider the new reference system as being equivalent to the original reference, but slightly adjusted to match the tie points.

If the initial reference of the model tie points is an ILcdGeoReference, then the newly created grid reference will be a ILcdGridReference with the same geodetic datum.

Since:

8.1

See Also:

• TLcdPolynomialRasterReferencer

Constructor Summary

Constructors

Constructor	Description
TLcdRationalRasterReferencer(int aNumeratorDegree, int aDenominatorDegree)	Creates a new TLcdRationalRasterReferencer that creates rational approximations with the given degrees for the numerator and denominator.

Method Summary

Modifier and Type	Method	Description
ILcdRasterReference	createRasterReference(int aImageWidth, int aImageHeight, ILcdPoint[] aImageTiePoints, ILcdModelReference aModelReference, ILcdPoint[] aModelTiePoints, ILcdPoint[] aMappedModelTiePointsSFCT)	Creates a raster reference for an image of a given size, based on pairs of tie points.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TLcdRationalRasterReferencer

public TLcdRationalRasterReferencer(int aNumeratorDegree,
 int aDenominatorDegree)

Creates a new TLcdRationalRasterReferencer that creates rational approximations with the given degrees for the numerator and denominator.

Method Details

createRasterReference

public ILcdRasterReference createRasterReference(int aImageWidth,
 int aImageHeight,
 ILcdPoint[] aImageTiePoints,
 ILcdModelReference aModelReference,
 ILcdPoint[] aModelTiePoints,
 ILcdPoint[] aMappedModelTiePointsSFCT)

Description copied from interface: ILcdRasterReferencer

Creates a raster reference for an image of a given size, based on pairs of tie points.

An optional array can be provided for obtaining the model tie points transformed to image coordinates on return. These reflect the effects of the referencing. The differences between the transformed model tie points (expressed in pixels) and the original image tie points (also expressed in pixels) provide a measure for the success of the referencing. With a perfect raster reference, the resulting model tie points correspond to the original image tie points.

Specified by:

createRasterReference in interface ILcdRasterReferencer

Parameters:

aImageWidth - the image width of the raster, expressed in pixels.

aImageHeight - the image height of the raster, expressed in pixels.

aImageTiePoints - the image tie points, expressed in pixels.

aModelReference - the reference of the model tie points.

aModelTiePoints - the model tie points corresponding to the image tie points, expressed in model coordinates.

aMappedModelTiePointsSFCT - an optional array for obtaining the the model tie points mapped to image coordinates upon return. This parameter may be null, if the mapped points are not required.

Returns:

a raster reference containing a new model reference and raster bounds that try to satisfy the given tie points.