Generate Range Fans From Features (Defense)

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.

Parameters

LabelExplanationData 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.

  • MetersThe unit will be meters. This is the default.
  • KilometersThe unit will be kilometers.
  • MilesThe unit will be miles.
  • Nautical milesThe unit will be nautical miles.
  • FeetThe unit will be feet.
  • US survey feetThe unit will be U.S. survey feet.
String
Angular Units
(Optional)

Specifies the angular unit of measure for start and end angles.

  • DegreesThe angle will be degrees. This is the default.
  • MilsThe angle will be mils.
  • RadiansThe angle will be radians.
  • GradiansThe 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})
NameExplanationData 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.

  • METERSThe unit will be meters. This is the default.
  • KILOMETERSThe unit will be kilometers.
  • MILESThe unit will be miles.
  • NAUTICAL_MILESThe unit will be nautical miles.
  • FEETThe unit will be feet.
  • US_SURVEY_FEETThe unit will be U.S. survey feet.
String
angle_units
(Optional)

Specifies the angular unit of measure for start and end angles.

  • DEGREESThe angle will be degrees. This is the default.
  • MILSThe angle will be mils.
  • RADSThe angle will be radians.
  • GRADSThe 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.GenerateRangeFansFromFeatures_defense("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.Select_analysis(sensors, outputSensors, whereClause)

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

Licensing information

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

Related topics