Generate Range Rings From Features (Defense)

Summary

Creates range rings with attributes derived from fields in a point feature class.

Usage

• If the Radial Count Field parameter is set, the Output Feature Class (Radials) parameter will be automatically populated with a value. If you remove the value in either parameter, you must clear both.

• The Range Ring Type parameter is used to determine whether rings will be created from an interval and number of rings or a minimum and maximum distance.

Syntax

arcpy.defense.GenerateRangeRingsFromFeatures(in_features, output_feature_class, range_rings_type, {out_feature_class_radials}, {radial_count_field}, {min_range_field}, {max_range_field}, {ring_count_field}, {ring_interval_field}, {distance_units})

Parameter	Explanation	Data Type
in_features	The point feature set that identifies the center of the range ring. The input must have at least one point.	Feature Layer
output_feature_class	The feature class that will contain the output ring features.	Feature Class
range_rings_type	Specifies how range rings will be generated.. INTERVAL —Range rings will be generated based on the number of rings and distance between rings. This the default. MIN_MAX —Range rings will be generated based on a minimum and maximum distance.	String
out_feature_class_radials (Optional)	The feature class that will contain the output radial features.	Feature Class
radial_count_field (Optional)	The field that contains the number of radials to be created.	Field
min_range_field (Optional)	The field that contains the values for the distance from the origin point to the inner ring.	Field
max_range_field (Optional)	The field that contains the values for the distance from the origin point to the outer ring.	Field
ring_count_field (Optional)	The field that contains the values for the number of rings to generate.	Field
ring_interval_field (Optional)	The field that contains the values for the interval between rings.	Field
distance_units (Optional)	Specifies the linear unit of measure for the value in the ring_interval_field parameter or the values in the min_range_field and max_range_field parameters. 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

Code sample

GenerateRangeRingsFromFeatures example 1 (Python window)

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.GenerateRangeRingsFromFeatures_defense("points",
                                             "RangeRings",
                                             "INTERVAL",
                                             None, None, None, None,
                                             "number_of_rings", "interval")

GenerateRangeRingsFromFeatures example 2 (stand-alone script)

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

# Description: Select all points that have a minimum ring distance of at least 
#              6 then create rings and radials around those points.

# Import modules
import arcpy

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

# Select points from the input
pointsToCreate = "all_points"
hasMinimumDist = "Min6"
whereClause = "min_range >= 6"
arcpy.Select_analysis(pointsToCreate, hasMinimumDist, whereClause)

# Generate rings and radials around selected points
outputRings = "Rings"
ringType = "MIN_MAX"
outputRadials = "Radials"
arcpy.GenerateRangeRingsFromFeatures_defense(hasMinimumDist,
                                             outputRings,
                                             ringType,
                                             outputRadials,
                                             "Radials",
                                             "min_range", "max_range")

Environments

Output Coordinate System, Current Workspace, Scratch Workspace

Licensing information

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