Threshold Data Driven Ring (Business Analyst)

Resumen

Creates rings around stores. The radii of the rings are determined by expanding from the store location until they meet the criteria included in the store layer.

Learn more about how Threshold Data-Driven Ring works

Ilustración

Uso

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

• The store layer input feature class must be point features.

• In most cases, the store layer input feature layer will be a Business Analyst store layer.

• Selecting all sites to use will create rings for each point feature in the ring centers (stores) input feature class.

• In ArcMap, trade areas will only be created for features that are within the active study area or analysis extent.

• Threshold values can only be created based on numeric data.

• The threshold layer must be a point or polygon feature class and be set up as a Business Analyst Dataset (BDS) layer. In most cases, you should select the block group or block points layer.

Sintaxis

ThresholdDataDrivenRing_ba (InputFeatureLayer, IDField, All_Or_Single_Or_Selected, ThresholdFeatureLayer, ThresholdPopulationField, RadiusFieldName, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {Donut})

Parámetro	Explicación	Tipo de datos
InputFeatureLayer	The input feature class containing center points for the drive-time trade areas. In most cases, this will be a Business Analyst store layer.	Feature Layer
IDField	Unique ID field in the ring center (store) layer.	Field
All_Or_Single_Or_Selected	Option defining how to create rings for points in the input feature layer: All —Creates rings for all points. Single —Creates rings for a single point. Selected —Creates rings for all selected points in ArcMap.	String
ThresholdFeatureLayer	The input feature class containing the threshold data that will determine the radii.	Feature Layer
ThresholdPopulationField	The threshold value field contained in the threshold layer.	Field
RadiusFieldName	The field containing the thresholds for each store point.	Field
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 to be used as the single point.	String
Donut (Opcional)	Defines whether to create nonoverlapping concentric rings, or donut bands. True —Creates output polygons that are donut rings. For example, if three radii (1, 2, and 3 miles) are entered, three output bands would be created with 0–1-, 1–3-, and 3–5-mile rings. False —Creates concentric rings.	Boolean

Ejemplo de código

ThresholdDataDrivenRing Example (Stand-alone Script)

# Name: ThresholdDataDrivenRing.py
# Description: Creates thresholds rings around stores.
# Author: ESRI

# Import system modules
import arcview
import arcpy

arcpy.AddToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Threshold Data Driven Ring tool
StorePath = "C:/temp/sf_stores.shp"
IdFld = "STORE_ID"
ThresholdLayer = "C:/Program Files/ArcGIS/Desktop10.0/Business Analyst/Data/BDS/esri_bg.bds"
FieldThreshold = "TOTPOP_CY"
OutPath = "C:/temp/ThresholdDataRings.shp"
 
# Create Threshold Data Driven Ring areas
arcpy.ThresholdDataDrivenRing_ba(StorePath, IdFld, "ALL", ThresholdLayer, FieldThreshold, "SALES", OutPath)
 
# Release extension license 
arcpy.CheckInExtension("Business")
 
except:
  print arcpy.GetMessages(2)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento

Información de licencia

ArcView: Requiere Business Analyst

ArcEditor: Requiere Business Analyst

ArcInfo: Requiere Business Analyst