public interface ILcdLOSRadarPropagationFunction extends ILcdLOSPropagationFunction
ILcdLOSPropagationFunction
representing a radar lineofsight
propagation function. It adds some property methods that can be used by the propagation functions
which are based on a radar lineofsight computation.
The matrix resulting from this propagation function can contain the following special values:
INVISIBLE
: for points where the object is invisible.UNKNOWN
: for points where the visibility is unknown. For example when
no elevation data or invalid data was found at that point.The following image gives a visual explanation of the parameters of a radar propagation function. The thin black arrows denote the minimum and maximum vertical angles. The red line corresponds to the radar tilt angle. The whole radar is rotated around the rotation axis.
Keep in mind that, if the radar tilt angle is not zero, the minimum and maximum viewing angles
should be recomputed in the method ILcdLOSPropagationFunction.applyForAzimuthSFCT(double, ILcdLOSCoverageMatrix)
.
In some cases, the computed viewing angle might fall outside the viewing interval [0, 180]. The
implementation of this interface should handle these special cases correctly. The viewing angle
is usually clipped to 0
or 180
.
There are two cases when a viewing angle can fall outside the viewing interval. They are both
explained using the image below. Both drawings show on the topright part the viewing angles as
dotted lines for the azimuth aMaxRadarTiltAzimuth
and on the bottomleft part for
the azimuth aMaxRadarTiltAzimuth + 180
. The red lines correspond to the radar tilt
angle for the azimuth.
180
degrees. In
the left drawing, the radar tilt angle is chosen to make the maximum viewing angle fall on
the 180
degree line. A larger radar tilt angle makes the maximum viewing angle
fall outside the viewing interval [0, 180].0
degrees. In
the right drawing, the radar tilt angle is chosen to make the minimum viewing angle fall
on the 0
degree line. Larger radar tilt angles make the minimum viewing angle
fall outside the viewing interval [0, 180].
Note that these cases are only an issue when the corresponding azimuths lies inside the area on
which this radar propagation function will be applied. This area is defined by the lineofsight
coverage (TLcdLOSCoverage
).
Modifier and Type  Field and Description 

static int 
INVISIBLE
The resulting value for points where the object is invisible.

static int 
UNKNOWN
The resulting value for points where the visibility is unknown.

Modifier and Type  Method and Description 

TLcdCoverageAltitudeMode 
getAltitudeMode()
Returns the altitude mode indicating the definition of the resulting lineofsight values.

TLcdEarthRepresentationMode 
getEarthRepresentationMode()
Returns the earth representation mode used by this instance.

double 
getKFactor()
Returns the Kfactor indicating the reflection of radar waves on the atmosphere.

double 
getMaxRadarTiltAngle()
Returns the maximum radar tilt angle in degrees, starting from 0 at the horizontal
plane to 90 at zenith.

double 
getMaxRadarTiltAzimuth()
Returns the azimuth in degrees where the maximum radar tilt angle occurs.

double 
getMaxVerticalAngle()
Returns the maximum angle of the vertical extent in degrees, starting from 0 at
the ground to 180 at zenith.

double 
getMinVerticalAngle()
Returns the minimum angle of the vertical extent in degrees, starting from 0 at
the ground to 180 at zenith.

ALcdTerrainElevationProvider 
getTerrainElevationProvider()
Returns the elevation provider used to retrieve the terrain elevation data.

applyForAzimuthSFCT, createLOSCoverageMatrix, initialize
static final int INVISIBLE
static final int UNKNOWN
TLcdEarthRepresentationMode getEarthRepresentationMode()
TLcdCoverageAltitudeMode getAltitudeMode()
double getKFactor()
double getMaxVerticalAngle()
double getMinVerticalAngle()
double getMaxRadarTiltAngle()
double getMaxRadarTiltAzimuth()
ALcdTerrainElevationProvider getTerrainElevationProvider()