Package com.luciad.tea

package com.luciad.tea

Contains all classes for terrain elevation analysis.

Most of the functionality in this package relies on interpreting terrain data. This data is provided by the ALcdTerrainElevationProvider implementations. Most of the algorithms rely on ILcdMatrixView implementations.

For visibility computations, this package provides the following factory classes:

• TLcdP2PCoverageFactory for point-to-point intervisibility.
• TLcdLOSCoverageFactory for point-to-area intervisibility.
• TLcdVisibilityMatrixViewFactory for shape-to-shape intervisibility.

These factories need a propagation function to compute the line-of-sight. This package contains three implementations:

• TLcdLOSRadarPropagationFunction to compute visual or radar line-of-sight on an earth modeled as a sphere.
• TLcdLOSRadarPropagationFunctionSkyBackground to compute where one is visible with sky in the background.
• TLcdLOSPropagationFunctionFixedHeight to compute the visibility at a given height above the ground.

The class TLcdVisibilityMatrixViewFactory defines several methods to compute a shape-to-shape visibility between two discretized views. The figure below shows how the visibility between two shapes can be computed. First, the shapes are discretized into ILcdAltitudeMatrixView objects, for example by using the factory TLcdAltitudeMatrixViewFactory. These objects are then passed to the TLcdVisibilityMatrixViewFactory which produces a new ILcdVisibilityMatrixView that provides information on the visibility of the second shape, seen from the first shape. The sample code provides painters which can be used to visualize the resulting visibility matrix view.

Note that special matrix values are required to represent points which lie outside the shape or outside the bounds of the elevation data, and to represent points for which an invalid elevation value is found. The propagation and the handling of special matrix values, which involves the descriptors TLcdAltitudeDescriptor and the TLcdVisibilityDescriptor, is one of the more subtle things that are part of the visibility computation process, but understanding this aspect is essential to get a valid result at the end of the process.

The factory TLcdMatrixViewRasterFactory is provided to convert regular matrix views into ILcdRasters, which can be shown on the map.

The class TLcdExtremePointFinder contains functionality to locate extreme points inside a given matrix.

Since:

1.5.1

Related Packages

Package	Description
com.luciad	Super package for classes produced by Luciad.
com.luciad.tea.hypsometry	The hypsometry package provides support for computing and rendering slopes, orientations, azimuths, and other parameters derived from elevations.
com.luciad.tea.viewshed	The viewshed package provides support for computing and rendering visbility for 3D scenes consisting of any meshes, extruded shapes or terrain.

Class	Description
ALcdDensityBasedElevationProvider	This abstract class implements ILcdAltitudeProvider.
ALcdModelBasedTerrainElevationProvider	A terrain elevation provider that gets its terrain elevation data from a list of models.
ALcdRasterTerrainElevationProvider	A terrain elevation provider which adds raster value checking.
ALcdTerrainElevationProvider	Provides terrain elevation data.
ILcdAltitudeMatrixView	Represents a referenced matrix view containing altitude values.
ILcdAltitudeProvider	Provides altitude data.
ILcdContour	Deprecated. Use ILcdValuedPolygon in the package com.luciad.shape.
ILcdContourFactory	Deprecated. Use ILcdContourFactory in the package com.luciad.geometry.cartesian.
ILcdEditableReferencedMatrixView	An ILcdEditableReferencedMatrixView is an ILcdReferencedMatrixView of which the values and associated points can be set.
ILcdEditableVisibilityMatrixView	Represents a referenced editable matrix view containing visibility values.
ILcdExtendedLineOfSightCoverage	Represents the input and result of a line-of-sight computation.
ILcdExtendedPoint2PointIntervisibility	An ILcdPoint2PointIntervisibility extension to support multiple model references for the input points and rasters.
ILcdLineOfSightCoverage	Represents the result of line-of-sight computations.
ILcdLOSCoverage	Defines a circular area around a center point, used as input for line-of-sight computations.
ILcdLOSCoverageMatrix	Combines ILcdEditablePolarMatrixView and ILcdLOSCoverage to represent the input and the results of a line-of-sight computation.
ILcdLOSPropagationFunction	Computes values along a given azimuth and stores the result in an ILcdLOSCoverageMatrix.
ILcdLOSRadarPropagationFunction	Extension of the interface ILcdLOSPropagationFunction representing a radar line-of-sight propagation function.
ILcdMatrix	Deprecated. Use ILcdMatrixView in com.luciad.shape.
ILcdMatrixRasterValueMapper	Defines the requirements for an object that maps double matrix values to short raster values.
ILcdP2PCoverage	Represents a coverage between two points.
ILcdP2PPropagationFunction	Computes the intervisibility between two points.
ILcdPoint2PointIntervisibility	Represents the input and result of a visibility computation between two points.
ILcdProfileView	A ILcdProfileView is profile or side-view, for example of a terrain.
ILcdReferencedMatrixView	Adds a reference to the matrix view interface.
ILcdVisibilityMatrixView	Represents a referenced matrix view containing visibility values.
TLcdAltitudeDescriptor	Describes how special altitude values should be interpreted.
TLcdAltitudeInterpretation	Enumeration of interpretations for special altitude values.
TLcdAltitudeMatrixViewFactory	Creates ILcdAltitudeMatrixView objects representing a shape discretization with an altitude value for each discretized point.
TLcdContour	Deprecated. Use TLcdValuedPolygon.
TLcdContourFactory	Deprecated. Use TLcdPolylineContourFinder or TLcdComplexPolygonContourFinder.
TLcdContourFinder	Deprecated. Use TLcdPolylineContourFinder or TLcdComplexPolygonContourFinder.
TLcdContourUtil	Deprecated. Use TLcdContourUtil.
TLcdCoverageAltitudeMode	Enumeration to indicate how coverage computation results should be interpreted.
TLcdCoverageFillMode	An enumeration to indicate which values should be used to fill coverages.
TLcdDensityBasedRasterElevationProvider	This implementation of ALcdTerrainElevationProvider retrieves the elevation from a number of models containing ILcdRaster and/or ILcdMultilevelRaster instances.
TLcdEarthRepresentationMode	Enumeration for different earth representations.
TLcdElevationModelFilter	ILcdFilter implementation that recognizes models containing terrain elevation data.
TLcdExtremePointFinder	Finds the extreme (highest or lowest) points from a matrix view.
TLcdExtremePointFinder.Type	Defines an enumeration that indicates the type of extreme points that should be computed.
TLcdFixedHeightAltitudeProvider	Returns a fixed altitude value for each point.
TLcdFixedLevelBasedRasterElevationProvider	This implementation of ALcdTerrainElevationProvider retrieves the elevation from a number of Raster or MultiLevelRaster models.
TLcdGXYViewBasedTerrainElevationProvider	This class is the default implementation of TLcdViewBasedTerrainElevationProvider for ILcdGXYViews.
TLcdHeightProviderAdapter	This class wraps an ILcdHeightProvider to implement the ILcdAltitudeProvide interface.
TLcdLOSCoverage	Default ILcdLOSCoverage implementation that allows to set the line-of-sight coverage properties.
TLcdLOSCoverageFactory	Computes line-of-sight between a point and its surroundings and converts the results to either a raster or a set of polygon contours.
TLcdLOSFactory	Deprecated. use the TLcdLOSCoverageFactory instead.
TLcdLOSOptions	Defines a set of options when creating LOS propagation functions.
TLcdLOSOptions.Builder	A helper class used to create a new TLcdLOSOptions object.
TLcdLOSOptions.DataType	The data type to use to represent the input or result of LOS calculations.
TLcdLOSOptions.MemoryMode	The memory mode to be used by internal calculations.
TLcdLOSPropagationFunctionFixedHeight	Computes the visibility of points at a fixed height from the center point of a line-of-sight coverage.
TLcdLOSRadarPropagationFunction	Computes the minimal heights from which one is visible around the center point of a line-of-sight coverage.
TLcdLOSRadarPropagationFunctionCoverageMatrixWrapper	Wrapper class, enabling multiple step processing of line-of-sight computation results.
TLcdLOSRadarPropagationFunctionSkyBackground	Computes the minimal heights from which one is visible around the center point of a line-of-sight coverage with the sky as background.
TLcdMatrix	A TLcdMatrix is a "regular" ILcdMatrixView, with the x- and y-coordinates are regularly spaced.
TLcdMatrixViewRasterFactory	Creates an ILcdRaster from an ILcdMatrixView.
TLcdP2PCoverage	A TLcdP2PCoverage defines a coverage between two points.
TLcdP2PCoverageFactory	Computes the visibility between two points.
TLcdP2PFactory	Deprecated. use the TLcdP2PCoverageFactory instead.
TLcdP2PRadarPropagationFunction	Computes the intervisibility between the defining points, resulting in one of the following values: TLcdVisibilityStatus.VISIBLE: when the two points are visible to each other. TLcdVisibilityStatus.INVISIBLE: when the two points are invisible to each other. TLcdVisibilityStatus.UNCERTAIN: for points where the intervisibility is unknown.
TLcdP2PRadarPropagationFunctionSkyBackground	Computes the intervisibility with sky in background between the defining points.
TLcdProfileGenerator	Generate terrain profile points for line segments.
TLcdProfileViewJPanel	Implementation of ILcdProfileView which displays the profile in a JPanel.
TLcdRadarCoverageFactory	Deprecated. use the TLcdLOSCoverageFactory instead.
TLcdRadarP2PFactory	Deprecated. use the TLcdP2PCoverageFactory instead.
TLcdRasterMatrix	A TLcdRasterMatrix is an ILcdMatrix wrapper around a part of an ILcdRaster.
TLcdShapeAltitudeContext<T extends ILcdShape>	Container class around an ILcdShape that provides information on how to interpret the altitude information in the shape.
TLcdTeaViewUtil	Deprecated. use ALcdTerrainElevationProvider extensions to find retrieve elevation data for points.
TLcdTerrainDistanceUtil	Utility class to compute the distance between 2 points, taking into account the terrain underneath.
TLcdTerrainProfileController	A ILcdGXYController implementation that contains information on the altitude of terrain beneath the position of the mouse over the view.
TLcdTerrainProfileUtil	Deprecated. This class should not be used anymore.
TLcdTerrainRulerController	Extension of TLcdAdvancedMapRulerController which takes into account underlying terrain for distance calculations.
TLcdTerrainSegmentScanner	This is a utility class for scanning terrain elevation along a line segment.
TLcdUpdateTerrainModelAction	Deprecated. As of 2023.0, this class has been deprecated.
TLcdViewBasedTerrainElevationProvider<S extends ILcdView & ILcdLayered>	This mediator keeps track of terrain models in the ILcdView and adds/removes them to/from the specified model based terrain elevation provider.
TLcdVisibilityDescriptor	Describes how special visibility values should be interpreted.
TLcdVisibilityInterpretation	Enumeration of interpretations for special visibility values.
TLcdVisibilityMatrixViewFactory	Creates an ILcdVisibilityMatrixView object representing the visibility between two ILcdAltitudeMatrixView objects.
TLcdVisibilityStatus	Enumeration representing the result of a visibility computation.
TLcdVVTerrainProfileModel	Deprecated. As of 2023.0, this class has been deprecated.
TLcdVVTerrainProfileRenderer	This class is used for rendering the terrain profile with the use of a Vertical View.