Class TLcdMatrixViewRasterFactory
Creates an ILcdRaster
from an ILcdMatrixView
.
The geometry of the associated matrix points depends on the used factory method and the mapping type.
The method createRaster
together with a backward mapping requires a rectangular
geometry. This means that, when all associated points are drawn on a map, the associated point of pixel
(0,0) should correspond to the point that lies in the bottom left corner. In the top right corner, the
associated point of pixel (col_count1,row_count1) should be found. In combination with the forward
mapping, no specific geometry is required.
The method createEquivalentRaster
requires also a rectangular matrix
view. It creates an ILcdRaster
assuming a onebyone relation, meaning that every pixel
in the raster corresponds to one associated matrix point and each associated matrix point corresponds
to one raster pixel. An associated matrix point is defined to be the center point of the corresponding
raster pixel.

Constructor Summary
ConstructorDescriptionConstructs a new factory for converting matrix views to rasters. 
Method Summary
Modifier and TypeMethodDescriptionvoid
addStatusListener
(ILcdStatusListener aStatusListener) Starts notifying a listener with the progress of the raster creation.createEquivalentRaster
(ILcdMatrixView aMatrix, ILcdGeoReference aMatrixReference, ILcdMatrixRasterValueMapper aMatrixRasterValueMapper) Creates anILcdRaster
from theILcdMatrixView
assuming a onebyone relation.createRaster
(ILcdMatrixView aMatrix, ILcdGeoReference aMatrixReference, ILcdMatrixRasterValueMapper aMatrixRasterValueMapper, ILcdGeoReference aTargetReference, double aTargetPixelDensity, TLcdCoverageFillMode aFillMode) Creates anILcdRaster
from theILcdMatrixView
using the given target reference, pixel density and fill mode.void
removeStatusListener
(ILcdStatusListener aStatusListener) Terminates notifying a listener of the progress of the raster creation.

Constructor Details

TLcdMatrixViewRasterFactory
public TLcdMatrixViewRasterFactory()Constructs a new factory for converting matrix views to rasters.


Method Details

addStatusListener
Starts notifying a listener with the progress of the raster creation. Parameters:
aStatusListener
 will be notified of progress of the raster creation. See Also:

removeStatusListener
Terminates notifying a listener of the progress of the raster creation. Parameters:
aStatusListener
 will no longer be notified of progress of the raster creation. See Also:

createRaster
public ILcdRaster createRaster(ILcdMatrixView aMatrix, ILcdGeoReference aMatrixReference, ILcdMatrixRasterValueMapper aMatrixRasterValueMapper, ILcdGeoReference aTargetReference, double aTargetPixelDensity, TLcdCoverageFillMode aFillMode) Creates an
ILcdRaster
from theILcdMatrixView
using the given target reference, pixel density and fill mode. TheaTargetReference
defines the reference in which the raster will be defined. Using the pixel density and the fill mode, the given matrix view is resampled into a rectangular coverage.The target pixel density is the pixel density of the resulting raster. This is the average number of pixels in an area of 1 by 1 in model coordinates. Higher densities will lead to more detailed coverage of the area. Note that the result is bound by the density of the samples taken of the underlying terrain data (which depends on the row and column count of the given matrix view). The size occupied in memory by the coverage will increase linearly with this density.
The fill mode
aFillMode
indicates how the raster should be filled. Possible choices are: maximum: the pixel value corresponds to the maximum value found in the matrix for that pixel.
 minimum: the pixel value corresponds to the minimum value found in the matrix for that pixel.
 nearest neighbor: the pixel value corresponds to the value computed nearest to the bottom left of the pixel location. This mode will ensure that the raster contains no holes.
The fill mode is combined with the given
ILcdMatrixRasterValueMapper
to map the matrix entry values onto raster pixel values. There are two possibilities. The first maps a matrix value to a raster value. This forward mapping is used with the minimum and the maximum fill mode. The methodILcdMatrixRasterValueMapper.mapMatrixValue
will be used to retrieve the raster value. The second maps a raster pixel to a number of matrix entries and combines the corresponding matrix values to a raster value, ensuring that all raster pixels are filled with a value. This backwards mapping is used with the nearest neighbor fill mode. The interface methodILcdMatrixRasterValueMapper.combineMatrixValues
is used with only one matrix value which corresponds to the matrix value of the point nearest to the raster pixel and only one weight value, which is1
.For the backward mapping, the geometry of the associated matrix points needs to be rectangular. This means that, when all associated points are drawn on a map, the associated point of pixel (0,0) should correspond to the point that lies in the bottom left corner. In the top right corner, the associated point of pixel (col_count1,row_count1) should be found. For the forward mapping, this geometry is not required.
 Parameters:
aMatrix
 The matrix to convert.aMatrixReference
 The reference in which the matrix is defined.aMatrixRasterValueMapper
 The mapper to map matrix values on raster values.aTargetReference
 The target reference in which the result will be defined.aTargetPixelDensity
 The pixel density of the resulting raster.aFillMode
 The fill mode indicating how the raster should be filled. Returns:
 a raster representation of the given matrix view.
 Throws:
NullPointerException
 when one of the arguments (aMatrix
,
aMatrixReference
,
aMatrixRasterValueMapper
,aTargetReference
oraFillMode
) isnull
.IllegalArgumentException
 when the required raster bounds has a0
width or height or when the target pixel density is too low that the column or row count needs to be0
.

createEquivalentRaster
public ILcdRaster createEquivalentRaster(ILcdMatrixView aMatrix, ILcdGeoReference aMatrixReference, ILcdMatrixRasterValueMapper aMatrixRasterValueMapper) Creates an
ILcdRaster
from theILcdMatrixView
assuming a onebyone relation. This means that every pixel in the raster corresponds to one associated matrix point and each associated matrix point corresponds to one raster pixel. An associated matrix point is defined to be the center point of the corresponding raster pixel.The method
ILcdMatrixRasterValueMapper.mapMatrixValue(short, double, TLcdCoverageFillMode)
is used to find the raster value corresponding to a matrix value. The method arguments are respectively the default value from the given matrixrastervalue mapper, the matrix value from the given matrix view and the fill modeMAXIMUM
. Parameters:
aMatrix
 The matrix viewaMatrixReference
 The matrix reference that will also be the raster reference.aMatrixRasterValueMapper
 The mapper to map matrix values on raster values. Returns:
 the raster equivalent to the matrix view.
 Throws:
IllegalArgumentException
 when the matrix column count or matrix row count is not greater than0
or when the required raster bounds has a0
width or height.
