Radial Line Of Sight And Range (Defense)

Available with 3D Analyst license.

Summary

Shows areas visible to one or more observer locations given a specified distance and viewing angle.

Usage

  • When added to the map, the output areas visible to the observer will be green, and areas not visible will be red.

  • The tool generates a range fan polygon feature class representing the entire area covered by observer parameters.

Parameters

LabelExplanationData Type
Input Observer

The input observer points.

Feature Set
Input Surface

The input elevation raster surface. The elevation surface must be projected.

Raster Layer; Mosaic Dataset; Mosaic Layer
Output Viewshed Feature Class

The output polygon feature class showing visible and nonvisible areas.

Feature Class
Output Field of View Outline Feature Class

The output polygon feature class containing the field of view range fan.

Feature Class
Output Range

The output polygon feature class containing the viewing sector created by the range radius, start angle, and end angle.

Feature Class
Observer Height Offset (meters)
(Optional)

The height added to the surface elevation of the observer. The default is 2.

Double
Minimum Distance (meters)
(Optional)

The minimum (nearest) distance from observers to consider for analysis in meters. The default is 1000.

Double
Maximum Distance (meters)
(Optional)

The maximum (farthest) distance from observers to consider for analysis in meters. The default is 3000.

Double
Horizontal Start Angle (degrees)
(Optional)

The left bearing limit in degrees. The default is 0.

Double
Horizontal End Angle (degrees)
(Optional)

The right bearing limit in degrees. The default is 360.

Double

arcpy.defense.RadialLineOfSightAndRange(in_observer_features, in_surface, out_viewshed_feature_class, out_fov_feature_class, out_range_radius_feature_class, {observer_height_offset}, {inner_radius}, {outer_radius}, {horizontal_start_angle}, {horizontal_end_angle})
NameExplanationData Type
in_observer_features

The input observer points.

Feature Set
in_surface

The input elevation raster surface. The elevation surface must be projected.

Raster Layer; Mosaic Dataset; Mosaic Layer
out_viewshed_feature_class

The output polygon feature class showing visible and nonvisible areas.

Feature Class
out_fov_feature_class

The output polygon feature class containing the field of view range fan.

Feature Class
out_range_radius_feature_class

The output polygon feature class containing the viewing sector created by the range radius, start angle, and end angle.

Feature Class
observer_height_offset
(Optional)

The height added to the surface elevation of the observer. The default is 2.

Double
inner_radius
(Optional)

The minimum (nearest) distance from observers to consider for analysis in meters. The default is 1000.

Double
outer_radius
(Optional)

The maximum (farthest) distance from observers to consider for analysis in meters. The default is 3000.

Double
horizontal_start_angle
(Optional)

The left bearing limit in degrees. The default is 0.

Double
horizontal_end_angle
(Optional)

The right bearing limit in degrees. The default is 360.

Double

Code sample

RadialLineOfSightAndRange example 1 (Python window)

The following Python window script demonstrates how to use the RadialLineOfSightAndRange function.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.defense.RadialLineOfSightAndRange("LLOS_Tar", "n36.dt2",
                                        "Viewshed", "FieldOfView",
                                        "Range",
                                        2, 1000, 3000, 0, 360)
RadialLineOfSightAndRange example 2 (stand-alone script)

The following example uses the RadialLineOfSightAndRange function in a sample workflow script.

# Description: Create Radial Line of Sight and Range to test siting of an antenna 
# antennas

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:/Data.gdb"

# Select antenna to test
antenna_layer = "antennas"
whereClause = "antenna_call_sign = 'KJT'"
test_ant_layer = arcpy.management.MakeFeatureLayer(antenna_layer, whereClause)

# Inputs
input_surface = "n36.dt2"

# Create radial line of sight for antennas
arcpy.defense.RadialLineOfSightAndRange(test_obs_layer, input_surface, 
                                        "Viewshed", "FieldOfView", "Range", 
                                        2, 1000, 3000, 0, 360)

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics