agi.foundation.terrain

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

Class TriangleTerrainInterpolator

java.lang.Object

agi.foundation.terrain.TerrainInterpolator<TerrainPosts>

agi.foundation.terrain.RasterTerrainInterpolator

agi.foundation.terrain.TriangleTerrainInterpolator

public class TriangleTerrainInterpolator
extends RasterTerrainInterpolator

This interpolator takes the four surrounding posts, which form a rectangle, and creates two triangles. The triangles are formed by splitting the rectangle from either the northwest to the southeast corners or from the southwest to the northeast corners. The height is on the face of the triangle that includes the specified longitude and latitude.

Constructor Summary

Constructors

Constructor and Description
TriangleTerrainInterpolator() Initializes a new instance with a RasterTerrainGridCellDiagonal defined from the northwest to the southeast corner.
TriangleTerrainInterpolator(RasterTerrainGridCellDiagonal rasterTerrainGridCellDiagonal) Initializes a new instance using the specified raster terrain grid cell diagonal.

Method Summary

Modifier and Type	Method and Description
FirstPartialsOfHeight	interpolateFirstPartials(TerrainPosts 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.
double	interpolateHeight(TerrainPosts data, double longitude, double latitude) Interpolates the height at a particular longitude and latitude from given terrain data.
SecondPartialsOfHeight	interpolateSecondPartials(TerrainPosts 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

TriangleTerrainInterpolator

public TriangleTerrainInterpolator()

Initializes a new instance with a RasterTerrainGridCellDiagonal defined from the northwest to the southeast corner.

TriangleTerrainInterpolator

public TriangleTerrainInterpolator(@Nonnull
                                   RasterTerrainGridCellDiagonal rasterTerrainGridCellDiagonal)

Initializes a new instance using the specified raster terrain grid cell diagonal.

Parameters:

rasterTerrainGridCellDiagonal - The raster terrain grid cell diagonal.

Method Detail

interpolateHeight

public double interpolateHeight(TerrainPosts data,
                                double longitude,
                                double latitude)

Description copied from class: TerrainInterpolator

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

Specified by:

interpolateHeight in class TerrainInterpolator<TerrainPosts>

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.

interpolateFirstPartials

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

Description copied from class: TerrainInterpolator

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.

Specified by:

interpolateFirstPartials in class TerrainInterpolator<TerrainPosts>

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.

interpolateSecondPartials

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

Description copied from class: TerrainInterpolator

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.

Specified by:

interpolateSecondPartials in class TerrainInterpolator<TerrainPosts>

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.