Radial Line Of Sight And Range (Defense Tools)

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.

Label	Explanation	Data 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})

Name	Explanation	Data 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)

Environments

Output Coordinate System, Current Workspace, Scratch Workspace

Licensing information