Class TLcdResidualErrorCheckingRasterReferencer
java.lang.Object
com.luciad.format.raster.reference.TLcdResidualErrorCheckingRasterReferencer
- All Implemented Interfaces:
ILcdRasterReferencer
public class TLcdResidualErrorCheckingRasterReferencer
extends Object
implements ILcdRasterReferencer
This implementation of ILcdRasterReferencer delegates the computation of the
raster reference to a given ILcdRasterReferencer, and checks the residual
errors of the results that it returns. If a residual error exceeds a
given maximum, this class throws an
IllegalArgumentException
.
This class is useful in combination with TLcdCompositeRasterReferencer
,
which can delegate the referencing to a second ILcdRasterReferencer if
a first one fails to provide a result.
- Since:
- 8.1
-
Constructor Summary
ConstructorsConstructorDescriptionTLcdResidualErrorCheckingRasterReferencer
(double aMaximumResidualTiePointError, ILcdRasterReferencer aRasterReferencer) Creates a new TLcdResidualErrorCheckingRasterReferencer that will delegate the computation of raster references to the given ILcdRasterReferencer. -
Method Summary
Modifier and TypeMethodDescriptioncreateRasterReference
(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.
-
Constructor Details
-
TLcdResidualErrorCheckingRasterReferencer
public TLcdResidualErrorCheckingRasterReferencer(double aMaximumResidualTiePointError, ILcdRasterReferencer aRasterReferencer) Creates a new TLcdResidualErrorCheckingRasterReferencer that will delegate the computation of raster references to the given ILcdRasterReferencer.- Parameters:
aMaximumResidualTiePointError
- the maximum average residual error between the image tie points and the transformed model tie points, expressed in pixels.
-
-
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 interfaceILcdRasterReferencer
- 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 benull
, 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.
-