Generate Range Rings From Features (Defense Tools)

Summary

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

Usage

Use the Range Ring Type parameter to specify whether rings will be created from an interval and number of rings or a minimum and maximum distance.

Parameters

Dialog
Python

Label	Explanation	Data type
Input Features	The point feature set that identifies the center of the range ring. The input must have at least one point.	Feature Layer
Output Range Ring Feature Class	The feature class that will contain the output ring features.	Feature Class
Range Ring 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. Minimum and maximum—Range rings will be generated based on a minimum and maximum distance.	String
Output 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
Minimum Range Field (Optional)	The field that contains the values for the distance from the origin point to the inner ring.	Field
Maximum 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 of the Ring Interval Field parameter or the values of the Minimum Range Field and Maximum 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

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})

Name	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 of the `ring_interval_field` parameter or the values of 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.defense.GenerateRangeRingsFromFeatures("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.analysis.Select(pointsToCreate, hasMinimumDist, whereClause)

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

Environments

Output Coordinate System, Current Workspace, Scratch Workspace

Licensing information