LineOfSightOperator.SampleInterval Property
Gets or sets the distance between sample points, when the observer feature is a line.
Syntax
public AttributeVariable< System.Double > SampleInterval { get; set; }Property Value
Default: Differs depending on type. See the table below.
The distance between sample points, in meters.
Default values
| Class | Default value |
|---|---|
| AirspaceCoverageOperator | 200.0 |
| LineOfSightOperator | 200.0 |
| TargetLineOfSightOperator | Not used. |
Remarks
When the ObserverInput gives a line feature, you will get the total viewshed of an observer moving from its first to its second point. This is computed by combining the viewsheds from sample points on the route. The property SampleInterval gives the interval between the sample points, measured in meters. Each sample point will be above the center of a cell in the finest available elevation raster, so the sample points cannot become closer together than those cells. But if you set sampleInterval to, say, 2 − 5 times the cell size, you will get quicker results that are only slightly less accurate.
Both the start point and the end point of the route will be sample points, regardless of the SampleInterval.
When the ObserverInput gives a point feature, the SampleInterval has no effect.
Note also that line features from ObserverInput are not supported if a CustomPropagation is used.
Example
// Increase the SampleInterval by 100m
public static void IncreaseSampleIntervalBy100m(LineOfSightOperator lineOfSightOperator)
{
// Get the current SampleInterval value
double currentSampleInterval = 0.0;
lineOfSightOperator.SampleInterval.TryGetValue(new AttributeSet(), out currentSampleInterval);
// This property is a member of a type that might be referred to by a View
// or a GlobeView, either directly or indirectly through other objects, which means
// that you must use the Guard class to take the global configuration lock when it
// is modified to synchronize access with any running Carmenta Engine threads.
using (Guard guard = new Guard())
{
// Increase the current SampleInterval by 100m
lineOfSightOperator.SampleInterval = currentSampleInterval + 100;
}
}
Platforms
Windows, Linux, Android