Label | Explanation | Data Type |
Input Features
| The input point feature layer. | Feature Layer |
Output Feature Class
| The output feature class containing the threshold rings. | Feature Class |
Threshold Variable
| The selected Business Analyst dataset variable to which the threshold value will be applied. | String |
Threshold Values
| The threshold variable value that will determine the size of the output rings. The rings will expand until they contain the threshold value of the selected variable. | Double |
Distance Units
(Optional) | The distance units to be used with the threshold values. | String |
ID Field
(Optional) | The ID that uniquely identifies each input point and is included in the output as an attribute. | Field |
Input Method
(Optional) | Specifies the type of value that will be used for each drive time.
| String |
Expression
(Optional) | A fields-based expression that will be used to calculate the radii. | SQL Expression |
Minimum Step
(Optional) | The minimum distance between one threshold area candidate and the next as the model approaches the threshold value to prevent infinite iterations. | Double |
Threshold Percent Difference
(Optional) | The maximum percentage difference between the target value and threshold value that will be used when determining the threshold drive time, for example, 5 percent. The default value is 5. | Double |
Available with Business Analyst license.
Summary
Creates a feature class of ring trade areas that expand around point features until the threshold value is reached.
Usage
The size of the output rings is determined by Threshold Values parameter value provided for a selected Threshold Variable parameter value from the active Business Analyst dataset.
Multiple threshold rings can be created around each input by typing individual values into separate threshold value text boxes.
The ID Field parameter value uniquely identifies the point location around which threshold rings will be created.
Parameters
arcpy.ba.GenerateThresholdRingTradeArea(in_features, out_feature_class, threshold_variable, threshold_values, {units}, {id_field}, {input_method}, {expression}, {minimum_step}, {target_percent_diff})
Name | Explanation | Data Type |
in_features | The input point feature layer. | Feature Layer |
out_feature_class | The output feature class containing the threshold rings. | Feature Class |
threshold_variable | The selected Business Analyst dataset variable to which the threshold value will be applied. | String |
threshold_values [threshold_values,...] | The threshold variable value that will determine the size of the output rings. The rings will expand until they contain the threshold value of the selected variable. | Double |
units (Optional) | The distance units to be used with the threshold values. | String |
id_field (Optional) | The ID that uniquely identifies each input point and is included in the output as an attribute. | Field |
input_method (Optional) | Specifies the type of value that will be used for each drive time.
| String |
expression (Optional) | A fields-based expression that will be used to calculate the radii. | SQL Expression |
minimum_step (Optional) | The minimum distance between one threshold area candidate and the next as the model approaches the threshold value to prevent infinite iterations. | Double |
target_percent_diff (Optional) | The maximum percentage difference between the target value and threshold value that will be used when determining the threshold drive time, for example, 5 percent. The default value is 5. | Double |
Code sample
The following Python window script demonstrates how to use the GenerateThresholdRingTradeArea function.
import arcpy
arcpy.ba.GenerateThresholdRingTradeArea("SF_Custs",r"C:\Project1.gdb\SF_Custs_GenerateThresholdRingTradeArea","populationtotals.totpop_cy",[50000,
100000], "MILES", "STORE_ID", Values, None)
Environments
Licensing information
- Basic: Requires Business Analyst
- Standard: Requires Business Analyst
- Advanced: Requires Business Analyst