public class TLcdP2PRadarPropagationFunctionSkyBackground extends java.lang.Object implements ILcdP2PPropagationFunction
aSkyDistanceafter the end point no terrain background is found. This propagation function results 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. For example when no or invalid elevation data was found between the defining points.
|Constructor and Description|
Creates a propagation function which computes the intervisibility with sky in background between the defining points.
|Modifier and Type||Method and Description|
Computes the intervisibility with sky in background between the defining points of the coverage
public TLcdP2PRadarPropagationFunctionSkyBackground(TLcdEarthRepresentationMode aEarthRepresentationMode, ALcdTerrainElevationProvider aTerrainElevationProvider, double aKFactor, double aSkyDistance)
aSkyDistance. Currently, two earth representation modes are supported. If another representation mode is used, an
IllegalArgumentExceptionwill be thrown.
aEarthRepresentationMode- The mode indicating which earth representation to use.
aTerrainElevationProvider- The terrain elevation provider.
aKFactor- A factor indicating the reflection of radar waves on the atmosphere. For radar computations, values should be greater than 1, usually 4/3. Setting the value equal to 1 will yield the same results as visual point-to-point computations.
aSkyDistance- The distance after the end point in which the terrain is taken into account as possible background. If no background is found, the end point is visible with sky as background.
java.lang.NullPointerException- when the argument
java.lang.IllegalArgumentException- if the argument
aKFactoris smaller than or equal to zero and if the argument
aEarthRepresentationModeis not one of the expected values (
public TLcdVisibilityStatus computeVisibility(ILcdP2PCoverage aP2PCoverage, ILcdGeoReference aComputationReference)
aP2PCoveragein the reference
aComputationReferenceand returns the result as a
TLcdVisibilityStatus. A point is visible with sky in background if the point is intervisible from the start point and if in a given distance after the point no terrain background is found. The distance is configured in the constructor of this instance. Refer to the class documentation for more information about the different visibility values. Note that currently only GEODETIC computation references are supported.
aP2PCoverage- The point-to-point coverage to use.
aComputationReference- The reference in which to compute the visibility.
java.lang.NullPointerException- if one of the arguments is