com.luciad.util.height

LuciadLightspeedClass TLcdInterpolatingRasterHeightProvider

java.lang.Object

com.luciad.util.height.TLcdInterpolatingRasterHeightProvider

All Implemented Interfaces:

ILcdBounded, ILcdHeightProvider

public class TLcdInterpolatingRasterHeightProvider
extends Object
implements ILcdHeightProvider

This height provider retrieves its heights from a given raster using interpolation between height values to gain a smoother result.

The interpolation method is illustrated in the following figure :

The interpolation is implemented by defining an area around the given point, the size of a pixel. Each corner of this area lies onto a different pixel of the raster. For each of these pixels, the value is retrieved from the raster (sampling of the pixel values is done at the pixel center). These values are then combined by weighted average according to area (w1, w2, w3, w4).

Since:

9.1

Constructor Summary

Constructors

Constructor and Description
TLcdInterpolatingRasterHeightProvider(ILcdRaster aRaster) Creates a new height provider based on the given raster.
TLcdInterpolatingRasterHeightProvider(ILcdRaster aRaster, int aMinValidHeight, int aMaxValidHeight) Creates a new height provider based on the given raster.

Method Summary

Modifier and Type	Method and Description
ILcdBounds	getBounds() Returns the ILcdBounds by which the geometry of this ILcdBounded object is bounded.
double	retrieveHeightAt(ILcdPoint aPoint) Returns the height at the given point.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdInterpolatingRasterHeightProvider

public TLcdInterpolatingRasterHeightProvider(ILcdRaster aRaster)

Creates a new height provider based on the given raster. Raster heights outside the range of -12000 to 10000 are returned as invalid (Double.NaN). The height provider interpolates the height values to gain a smoother result.

Parameters:

aRaster - the raster from which the heights will be retrieved.

TLcdInterpolatingRasterHeightProvider

public TLcdInterpolatingRasterHeightProvider(ILcdRaster aRaster,
                                             int aMinValidHeight,
                                             int aMaxValidHeight)

Creates a new height provider based on the given raster. Raster heights outside the given range are returned as invalid (Double.NaN). The height provider interpolates the height values to gain a smoother result.

Parameters:

aRaster - the raster from which the heights will be retrieved.

aMinValidHeight - the minimum valid height.

aMaxValidHeight - the maximum valid height.

Method Detail

retrieveHeightAt

public double retrieveHeightAt(ILcdPoint aPoint)

Description copied from interface: ILcdHeightProvider

Returns the height at the given point.

Specified by:

retrieveHeightAt in interface ILcdHeightProvider

Parameters:

aPoint - a 2D point, in the horizontal reference that is determined by the implementation.

Returns:

the elevation at the given point, in the vertical reference that is determined by the implementation. The value may also be Double.NaN, if the elevation is not known.

getBounds

public ILcdBounds getBounds()

Description copied from interface: ILcdBounded

Returns the ILcdBounds by which the geometry of this ILcdBounded object is bounded.

If the geometry does not allow retrieving valid bounds (for example a polyline with 0 points) the return value is unspecified. It is highly recommended to return an undefined bounds. You can create undefined bounds using the default constructors of TLcdLonLatBounds or TLcdXYBounds.

Specified by:

getBounds in interface ILcdBounded

Returns:

the ILcdBounds by which the geometry of this ILcdBounded object is bounded.