Data Driven Rings (Business Analyst)

汇总

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

图示

DDR Wide

用法

语法

DataDrivenRings_ba (InputFeatureLayer, IDField, All_Or_Single_Or_Selected, RadiusFieldName, ValuePerUnit, {MeasureUnits}, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {RemoveOverlap}, {ExpValue})
参数说明数据类型
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.

  • ALLCreates rings for all points. This is the default
  • SINGLECreates rings for a single point.
  • SELECTEDCreates 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, $50,000 in sales is equal to 1 mile.

Double
MeasureUnits
(可选)

The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected.

  • Decimal Degrees
  • Feet
  • Kilometers
  • Meters
  • Miles
  • Nautical Miles
  • Yards
String
OutputFeatureClass

The feature class that will contain the ring features.

Feature Class
ByID_Or_ByName
(可选)

Field used to select a single point.

  • IDSelects a single point using the store ID field.
  • NAMESelects a single point using the store name field.
String
Single_Site
(可选)

ID or name of store used as the single point.

String
RemoveOverlap
(可选)

Creates overlapping concentric rings or removes overlap.

  • trueUses Thiessen polygons to remove overlap between output ring polygons.
  • false Output ring features are created with overlap. This is the default.
Boolean
ExpValue
(可选)

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

代码示例

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.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 Data Driven Rings tool
  sStorePath = "C:/temp/sf_store.shp"
  sIdFld = "STORE_ID"
  sOutPath = "C:/temp/RingOutput.shp"
  sRadiusFld = "SALES"
 
  # Create data driven rings trade areas    
  arcpy.DataDrivenRings_ba(StorePath, IdFld, "ALL", RadiusFld, "500000", "Miles", OutPath)
 
  # Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

环境

此工具不使用任何地理处理环境

相关主题

许可信息

ArcView: 需要 Business Analyst
ArcEditor: 需要 Business Analyst
ArcInfo: 需要 Business Analyst

10/4/2010