TerrainAlongLineComputeObstructionMetric Method (Cartographic, Cartographic, TerrainProvider, Boolean, Boolean)

Computes a metric value indicating the amount of obstruction from the line of sight between the target and observer positions and the direction to the point on terrain with the highest elevation angle. The metric value is determined from the perspective of the position closest to the Shape. The DefaultMinimumTerrainHeight and DefaultMaximumTerrainHeight are used for the computation.

Namespace: AGI.Foundation.Terrain
Assembly: AGI.Foundation.TerrainAnalysis (in AGI.Foundation.TerrainAnalysis.dll) Version: 25.1.421.0 (25.1.421.0)

Syntax

C++

Copy

public static double ComputeObstructionMetric(
	Cartographic observerPosition,
	Cartographic targetPosition,
	TerrainProvider terrainProvider,
	bool findWorstObstruction,
	bool findIndicatedExtremaPrecisely
)

Public Shared Function ComputeObstructionMetric ( 
	observerPosition As Cartographic,
	targetPosition As Cartographic,
	terrainProvider As TerrainProvider,
	findWorstObstruction As Boolean,
	findIndicatedExtremaPrecisely As Boolean
) As Double

public:
static double ComputeObstructionMetric(
	Cartographic observerPosition, 
	Cartographic targetPosition, 
	TerrainProvider^ terrainProvider, 
	bool findWorstObstruction, 
	bool findIndicatedExtremaPrecisely
)

static member ComputeObstructionMetric : 
        observerPosition : Cartographic * 
        targetPosition : Cartographic * 
        terrainProvider : TerrainProvider * 
        findWorstObstruction : bool * 
        findIndicatedExtremaPrecisely : bool -> float

Parameters

observerPosition: Type: AGI.Foundation.CoordinatesCartographic
The planetodetic position of the observer object, expressed as a longitude, latitude, and altitude relative to the ellipsoid specified by the Shape property of the terrainProvider.
targetPosition: Type: AGI.Foundation.CoordinatesCartographic
The planetodetic position of the target object, expressed as a longitude, latitude, and altitude relative to the ellipsoid specified by the Shape property of the terrainProvider.
terrainProvider: Type: AGI.Foundation.TerrainTerrainProvider
The terrain provider describing the terrain that is potentially obscuring the path between the two objects.
findWorstObstruction: Type: SystemBoolean
Indicates whether the metric value associated with the worst amount of obstruction is sought.
findIndicatedExtremaPrecisely: Type: SystemBoolean
Determines whether all extrema indicated from sampling should be found precisely.

Return Value

Type: Double
The metric value indicating obstruction from the line of sight between the target and observer positions and the direction to the point on terrain with the highest elevation angle. The metric value is determined from the perspective of the position closest to the Shape. Positive numbers indicate that the line of sight between the objects is not obscured by terrain. Negative numbers indicate that it is obscured.

Exceptions

Exception	Condition
ArgumentNullException	Thrown if terrainProvider is .

Reference

TerrainAlongLine Class

ComputeObstructionMetric Overload

AGI.Foundation.Terrain Namespace

TerrainAlongLineAddLanguageSpecificTextSet("LSTD426313F_0?cpp=::|nu=.");ComputeObstructionMetric Method (Cartographic, Cartographic, TerrainProvider, Boolean, Boolean)

Parameters

Return Value

Reference

TerrainAlongLineComputeObstructionMetric Method (Cartographic, Cartographic, TerrainProvider, Boolean, Boolean)