Generate Threshold Rings (Business Analyst)—ArcGIS Pro

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 entered for a selected Threshold Variable 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 are created.

Parameters

Label	Explanation	Data Type
Input Features	The input point feature layer.	Feature Layer
Output Feature Class	The output feature class.	Feature Class
Threshold Variable	The selected Business Analyst dataset variable to which the threshold value will be applied.	String
Threshold Values	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)	An 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 is to be used for each drive time. Values—Uses a constant value (all trade areas will be the same size). This is the default. Expression—The values from a field or an expression (trade areas can be a different size).	String
Expression (Optional)	A fields-based expression to calculate the radii.	SQL Expression

arcpy.ba.GenerateThresholdRingTradeArea(in_features, out_feature_class, threshold_variable, threshold_values, {units}, {id_field}, {input_method}, {expression})

Name	Explanation	Data Type
in_features	The input point feature layer.	Feature Layer
out_feature_class	The output feature class.	Feature Class
threshold_variable	The selected Business Analyst dataset variable to which the threshold value will be applied.	String
threshold_values [threshold_values,...]	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)	An 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 is to be used for each drive time. VALUES—Uses a constant value (all trade areas will be the same size). This is the default. EXPRESSION—The values from a field or an expression (trade areas can be a different size).	String
expression (Optional)	A fields-based expression to calculate the radii.	SQL Expression

Code sample

GenerateThresholdRingTradeArea example (Python window)

The following Python window script demonstrates how to use the GenerateThresholdRingTradeArea tool.

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

Current Workspace, Data Source

Licensing information

Basic: Requires Business Analyst
Standard: Requires Business Analyst
Advanced: Requires Business Analyst