agi.foundation.terrain

(agi.foundation.terrainreaders-2024r3.jar)

Class TerrainInterpolator<TData>

java.lang.Object

agi.foundation.terrain.TerrainInterpolator<TData>

Type Parameters:

TData - The type of terrain data.

Direct Known Subclasses:

BarycentricTerrainInterpolator, RasterTerrainInterpolator

public abstract class TerrainInterpolator<TData>
extends Object

The base class for classes that can interpolate over terrain data.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TerrainInterpolator() Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
abstract FirstPartialsOfHeight	interpolateFirstPartials(TData data, double longitude, double latitude) Interpolates the first order partial derivatives of terrain height with respect to longitude and latitude and returns the value at the specified location based on the given terrain data.
abstract double	interpolateHeight(TData data, double longitude, double latitude) Interpolates the height at a particular longitude and latitude from given terrain data.
abstract SecondPartialsOfHeight	interpolateSecondPartials(TData data, double longitude, double latitude) Interpolates the second order (mixed) partial derivatives of terrain height with respect to longitude and latitude and returns the value at the specified location based on the given terrain data.

Methods inherited from class java.lang.Object

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

Constructor Detail

TerrainInterpolator

protected TerrainInterpolator()

Initializes a new instance.

Method Detail

interpolateHeight

public abstract double interpolateHeight(@Nonnull
                                         TData data,
                                         double longitude,
                                         double latitude)

Interpolates the height at a particular longitude and latitude from given terrain data.

Parameters:

data - The terrain data.

longitude - The longitude, in the native units of the terrain provider.

latitude - The latitude, in the native units of the terrain provider.

Returns:

The interpolated height, in the native units of the terrain provider.

Throws:

ArgumentNullException - Thrown when data is null.

interpolateFirstPartials

@Nonnull
public abstract FirstPartialsOfHeight interpolateFirstPartials(@Nonnull
                                                                         TData data,
                                                                         double longitude,
                                                                         double latitude)

Interpolates the first order partial derivatives of terrain height with respect to longitude and latitude and returns the value at the specified location based on the given terrain data.

Note that the interpolation scheme may permit discontinuities along the boundaries of each terrain cell.

Parameters:

data - The terrain data to use when evaluating the height.

longitude - The longitude, in native units.

latitude - The latitude, in native units.

Returns:

The first order partial derivatives, in native units.

Throws:

ArgumentNullException - Thrown when data is null.

interpolateSecondPartials

@Nonnull
public abstract SecondPartialsOfHeight interpolateSecondPartials(@Nonnull
                                                                           TData data,
                                                                           double longitude,
                                                                           double latitude)

Interpolates the second order (mixed) partial derivatives of terrain height with respect to longitude and latitude and returns the value at the specified location based on the given terrain data.

Note that the interpolation scheme may permit discontinuities along the boundaries of each terrain cell.

Parameters:

data - The terrain data to use when evaluating the height.

longitude - The longitude, in native units.

latitude - The latitude, in native units.

Returns:

The second order (mixed) partial derivatives, in native units.

Throws:

ArgumentNullException - Thrown when data is null.