Label | Explanation | Data Type |
Input Features
| The input features containing the center points for the rings. | Feature Layer |
Output Feature Class
| The feature class that will contain the output ring features. | Feature Class |
Distances
(Optional) | The distances, in ascending size, used to create rings around the input features. | Double |
Distance Units
(Optional) | The linear unit to be used with the distance values. | String |
ID Field
(Optional) | A unique ID field in the ring center layer. | Field |
Remove Overlap
(Optional) | Creates overlapping concentric rings or removes overlap.
| Boolean |
Dissolve Option
(Optional) | Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified.
| String |
Input Method
(Optional) | Specifies the type of value that is to be used for each drive time.
| String |
Distance Expression
(Optional) | A fields-based expression to calculate the radii. | SQL Expression |
Available with Business Analyst license.
Summary
Creates rings around point locations.
Illustration
Usage
Valid numeric distances must be used when defining distance values. Negative distances cannot be used for rings.
The Remove Overlap parameter uses Thiessen polygons to remove overlap between output ring polygons.
Parameters
arcpy.ba.GenerateTradeAreaRings(in_features, out_feature_class, {radii}, {units}, {id_field}, {remove_overlap}, {dissolve_option}, {input_method}, {expression})
Name | Explanation | Data Type |
in_features | The input features containing the center points for the rings. | Feature Layer |
out_feature_class | The feature class that will contain the output ring features. | Feature Class |
radii [radii,...] (Optional) | The distances, in ascending size, used to create rings around the input features. | Double |
units (Optional) | The linear unit to be used with the distance values. | String |
id_field (Optional) | A unique ID field in the ring center layer. | Field |
remove_overlap (Optional) | Creates overlapping concentric rings or removes overlap.
| Boolean |
dissolve_option (Optional) | Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified.
| String |
input_method (Optional) | Specifies the type of value that is to be used for each drive time.
| String |
expression (Optional) | A fields-based expression to calculate the radii. | SQL Expression |
Code sample
The following Python window script demonstrates how to use the GenerateTradeAreaRings tool.
import arcpy
arcpy.ba.GenerateTradeAreaRings("sales_locations.shp",r"sales_locations_GenerateTrad.shp", [1, 3, 5],"MILES", "ID", "KEEP_OVERLAP", Values, None)
Environments
Licensing information
- Basic: Requires Business Analyst
- Standard: Requires Business Analyst
- Advanced: Requires Business Analyst