Generate Range Fans (Defense Tools)

Summary

Creates range fans originating from a starting point given a horizontal start angle, horizontal end angle, minimum distance, and maximum distance.

Usage

Range fans are created in a clockwise direction from the value in the Horizontal Start Angle parameter to the value in the Horizontal End Angle parameter.

Label	Explanation	Data type
Input Points	The input point feature set that identifies the origin points of the range fans. The input must have at least one point.	Feature Set
Output Range Fan Feature Class	The feature class that will contain the output range fan features.	Feature Class
Minimum Distance	The distance from the origin point to the start of the range fan.	Double
Maximum Distance	The distance from the origin point to the end of the range fan.	Double
Horizontal Start Angle	The angle from the origin point to the start of the range fan.	Double
Horizontal End Angle	The angle from the origin point to the end of the range fan.	Double
Distance Units (Optional)	Specifies the linear unit of measurement for minimum and maximum distance. Meters—The unit will be meters. This is the default. Kilometers—The unit will be kilometers. Miles—The unit will be miles. Nautical miles—The unit will be nautical miles. Feet—The unit will be feet. US survey feet—The unit will be U.S. survey feet.	String
Angular Units (Optional)	Specifies the angular unit of measurement for start and end angles. Degrees—The angle will be degrees. This is the default. Mils—The angle will be mils. Radians—The angle will be radians. Gradians—The angle will be gradians.	String

arcpy.defense.GenerateRangeFans(in_features, out_range_fan_feature_class, inner_radius, outer_radius, horizontal_start_angle, horizontal_end_angle, {distance_units}, {angle_units})

Name	Explanation	Data type
in_features	The input point feature set that identifies the origin points of the range fans. The input must have at least one point.	Feature Set
out_range_fan_feature_class	The feature class that will contain the output range fan features.	Feature Class
inner_radius	The distance from the origin point to the start of the range fan.	Double
outer_radius	The distance from the origin point to the end of the range fan.	Double
horizontal_start_angle	The angle from the origin point to the start of the range fan.	Double
horizontal_end_angle	The angle from the origin point to the end of the range fan.	Double
distance_units (Optional)	Specifies the linear unit of measurement for minimum and maximum distance. `METERS`—The unit will be meters. This is the default. `KILOMETERS`—The unit will be kilometers. `MILES`—The unit will be miles. `NAUTICAL_MILES`—The unit will be nautical miles. `FEET`—The unit will be feet. `US_SURVEY_FEET`—The unit will be U.S. survey feet.	String
angle_units (Optional)	Specifies the angular unit of measurement for start and end angles. `DEGREES`—The angle will be degrees. This is the default. `MILS`—The angle will be mils. `RADS`—The angle will be radians. `GRADS`—The angle will be gradians.	String

Code sample

GenerateRangeFans example 1 (Python window)

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

import arcpy
arcpy.env.workspace = r"C:\Data.gdb"
arcpy.defense.GenerateRangeFans("RLOS_Observers",
                                "Range_Fan_out",
                                100, 2000, 45, 180,
                                "METERS",
                                "DEGREES")

GenerateRangeFans example 2 (stand-alone script)

The following example uses the GenerateRangeRings function in an example workflow script.

# Description: Generate range rings around active airports

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\Data.gdb"
arcpy.env.overwriteOutput = True

# Select points from airports from input
airports = "Airports"
active = "Active_Airports"
whereClause = "Active = 'Yes'"
arcpy.analysis.Select(airports, active, whereClause)

# Generate Range Fans from selected airports
outputFans = "Range_Fans"
distType = "KILOMETERS"
angleUnits = "DEGREES"
arcpy.defense.GenerateRangeFans(active,
                                outputFans,
                                10,
                                100,
                                90,
                                180,
                                distType,
                                angleUnits)

Environments

Output Coordinate System, Current Workspace, Scratch Workspace

Licensing information