Generate Range Fans From Features (Defense Tools)

Summary

Creates range fans with attributes derived from fields in a point feature class or shapefile.

Usage

Each row in the input feature class will create a range fan.
Each row in the input feature class contains a set of range fan creation values.
Range fans are created in a clockwise direction from the value in the Horizontal Start Angle Field parameter to the value in the Horizontal End Angle Field parameter.

Label	Explanation	Data type
Input Features	The point feature set that identifies the origin points of the range fans. The input must have at least one point.	Feature Layer
Output Range Fan Feature Class	The feature class that will contain the output range fan features.	Feature Class
Minimum Distance Field	The field that contains the values for the distance from the origin point to the start of the range fan.	Field
Maximum Distance Field	The field that contains the values for the distance from the origin point to the end of the range fan.	Field
Horizontal Start Angle Field	The field that contains the values for the angle from the origin point to the start of the range fan.	Field
Horizontal End Angle Field	The field that contains the values for the angle from the origin point to the end of the range fan.	Field
Distance Units (Optional)	Specifies the linear unit of measure 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 measure 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.GenerateRangeFansFromFeatures(in_features, output_feature_class, inner_radius_field, outer_radius_field, start_angle_field, end_angle_field, {distance_units}, {angle_units})

Name	Explanation	Data type
in_features	The point feature set that identifies the origin points of the range fans. The input must have at least one point.	Feature Layer
output_feature_class	The feature class that will contain the output range fan features.	Feature Class
inner_radius_field	The field that contains the values for the distance from the origin point to the start of the range fan.	Field
outer_radius_field	The field that contains the values for the distance from the origin point to the end of the range fan.	Field
start_angle_field	The field that contains the values for the angle from the origin point to the start of the range fan.	Field
end_angle_field	The field that contains the values for the angle from the origin point to the end of the range fan.	Field
distance_units (Optional)	Specifies the linear unit of measure 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 measure 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

GenerateRangeFansFromFeatures example 1 (Python window)

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

import arcpy
arcpy.env.workspace = r"C:/Data"
arcpy.defense.GenerateRangeFansFromFeatures("InputPoints.shp",
                                            "RangeFans",
                                            "min_range", "max_range",
                                            "left_az", "right_az")

GenerateRangeFansFromFeatures example 2 (stand-alone script)

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

# Description: Select sensors with a distance-based blind spot (a minimum distance greater than zero) and generate fans.

# Import system modules
import arcpy

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

# Select points from sensor layer
sensors = "RangeFanInputFeatures"
outputSensors = "Partial_View"
whereClause = "min_range > 0"
arcpy.analysis.Select(sensors, outputSensors, whereClause)

# Generate range fans from sensors
outputFans = "Fans"
arcpy.defense.GenerateRangeFansFromFeatures(outputSensors, outputFans,
                                            "min_range", "max_range",
                                            "left_az", "right_az")

Environments

Output Coordinate System, Current Workspace, Scratch Workspace

Licensing information