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.
| 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.
| String |
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
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.
| 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.
| String |
Code sample
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")
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
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes