Data Driven Rings

Disponible con licencia de Business Analyst.

Resumen

Creates a new feature class of ring trade area features. The radii are determined by a field in the ring center (store) layer.

Learn more about how Data Driven Rings works

Ilustración

Uso

• The spatial reference of the output feature class will be the same as the store layer.

• The input Store Layer must be point features.

• In most cases, the input Store Layerwill be a Business Analyst store layer.

• Selecting ALL in the Sites to use parameter will create rings for each point feature in the input Store Layer

• If Remove Overlap is checked, Thiessen polygons are used to remove overlap between output ring polygons.

• The Value per unit field determines the data value used to set the threshold for your rings, must be numeric, and cannot be negative.

• If your Store Layer contains a field that has actual radii for each store point, set the value per unit to one.

Sintaxis

arcpy.ba.DataDrivenRings(InputFeatureLayer, IDField, All_Or_Single_Or_Selected, RadiusFieldName, ValuePerUnit, {MeasureUnits}, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {RemoveOverlap}, {ExpValue})

Parámetro	Explicación	Tipo de datos
InputFeatureLayer	The input feature class containing center points for the rings. In most cases, this will be a Business Analyst store layer.	Feature Class
IDField	Unique ID field in the ring center (store) layer.	Field
All_Or_Single_Or_Selected	Creates rings for points in the input feature layer. ALL —Creates rings for all points. This is the default SINGLE —Creates rings for a single point. SELECTED —Creates rings for all selected points in ArcMap.	String
RadiusFieldName	Field used to determine radii of the rings.	Field
ValuePerUnit	Value entered proportional to one measured unit. For example, $450,000 in sales is equal to 1 mile.	Double
MeasureUnits (Opcional)	The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected. Decimal Degrees —Decimal degrees Feet —Feet Kilometers —Kilometers Meters —Meters Miles —Miles Nautical Miles —Nautical miles Yards —Yard	String
OutputFeatureClass	The feature class that will contain the ring features.	Feature Class
ByID_Or_ByName (Opcional)	Field used to select a single point. ID —Selects a single point using the store ID field. NAME —Selects a single point using the store name field.	String
Single_Site (Opcional)	ID or name of store used as the single point.	String
RemoveOverlap (Opcional)	Creates overlapping concentric rings or removes overlap. true —Uses Thiessen polygons to remove overlap between output ring polygons. false — Output ring features are created with overlap. This is the default.	Boolean
ExpValue (Opcional)	An exponent value to determine the size of the data-driven rings. This exponent is the same type of exponent used in the Huff Modeling.	Double

Muestra de código

DataDrivenRings example (stand-alone script)

# Name: DataDrivenRings.py
# Description: Creates ring based trade areas in San Francisco based on sales values in a store layer.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

# Acquire extension license 
arcpy.CheckOutExtension("Business")

# Define input and output parameters for the Data Driven Rings tool
InputFeatureLayer = "C:/temp/sf_store.shp"
IDField = "STORE_ID"
All_Or_Single_Or_Selected = "ALL"
RadiusFieldName = "SALES"
ValuePerUnit = "450000"
MeasureUnits = "Miles"
OutputFeatureClass = "C:/temp/RingOutput.shp"
ByID_Or_ByName=""
Single_Site=""
RemoveOverlap="false"
ExpValue="1"

 
# Create data driven rings trade areas    
arcpy.DataDrivenRings_ba(InputFeatureLayer, 
						IDField, 
						All_Or_Single_Or_Selected, 
						RadiusFieldName, 
						ValuePerUnit, 
						MeasureUnits, 
						OutputFeatureClass, 
						ByID_Or_ByName, 
						Single_Site, 
						RemoveOverlap, 
						ExpValue)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Requiere Business Analyst
• Standard: Requiere Business Analyst
• Advanced: Requiere Business Analyst