Generate Range Rings From Features (Defense)

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

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

  • IntervalRange rings will be generated based on the number of rings and distance between rings. This the default.
  • Minimum and maximumRange 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.

  • 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

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

  • INTERVALRange rings will be generated based on the number of rings and distance between rings. This the default.
  • MIN_MAXRange 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.

  • 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

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