TerrainMobilityOperator.RestrictedAreaInput Property
Gets or sets an operator that gives restricted areas that normally cannot be passed.
Syntax
public Operator RestrictedAreaInput { get; set; }Property Value
Remarks
The features from this input represent restricted areas that normally cannot be passed. In a TerrainRouteOperator, they may be passed with some reluctance if their safety is positive, see TerrainRouteOperator.RestrictedAreaSafety. They can be areas that are dangerous or unsuitable in some way, even if they are trafficable according to the slope, terrain type and road network. The restricted areas can also be used to adjust the trafficability information with more current data. For example, the RoadInput may read from a static dataset of roads that says that a certain road exists - but if you know that this road was recently destroyed in a landslide, you can cover the road with a restricted feature. So the restricted features would usually come from a MemoryDataSet containing editable data.
Vector and raster input
This input may give both vector features (points, lines or polygons) and raster features.
Vector features will be rasterized for more efficient lookup. A restricted point may not very useful, but it does work: its rasterization will cover a square of three-by-three terrain cells centered on the cell that contains the point. A restricted line will be rasterized to a sequence of terrain cells that need only be eight-connected (two adjacent cells need to touch each other only at a corner), but a vehicle will not be able to sneak diagonally across a northeast-bound restriction line by going southeast. A restricted polygon will be rasterized so that both fully and partially covered terrain cells will become restricted.
A raster feature must contain integers, and the simplest encoding would let 1 represent restricted areas and 0 represent allowed areas, provided that 1 is not the undefined raster value. More generally, the operator will interpret any positive well-defined cell value as restricted, and a negative, zero, or undefined cell value as allowed.
Example
Suppose you want the viewshed from hostile artillery to be restricted. Then you can send the output from a LineOfSightOperator to RestrictedAreaInput, but you must reclassify the LOS cell values with a RasterReclassificationOperator. If your terrain vehicles are 4 meters high, you may assume that they are safe where the hostile artillery cannot see the ground or anything that is up to 4 meters higher than ground. So, let LineOfSightOperator.MinVisibilityHeightType = AboveGround, let LOS cell values in the range 0 to 4 be reclassified to 1 (dangerous), and let LOS cell values of 5 or higher be reclassified to 0 (safe).
Platforms
Windows, Linux, Android