Static Rings

获得 Business Analyst 许可后可用。

摘要

Creates a new feature class of ring trade area features using a set of radii

Learn more about how Static Rings works

插图

用法

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

• Valid numeric distances must be used when defining radii values. Negative distances cannot be used for ring radii.

• Selecting ALL in the Sites To Use parameter will create rings for each point feature in the store layer input feature class.

• The Remove Overlap parameter uses Thiessen polygons to remove overlap between output ring polygons.

• Donut rings create output polygons that are bands. For example, if three radii are entered with values of 1, 2, and 3 miles, three output bands would be created with 0–1-, 1–3-, and 3–5-mile rings.

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

语法

StaticRings_ba (InputFeatureLayer, IDField, All_Or_Single_Or_Selected, RingsCollection, {MeasureUnits}, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {RemoveOverlap}, {Donut})

参数	说明	数据类型
InputFeatureLayer	The input feature class containing center points for the rings. 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	Creates rings for points in the input feature layer. ALL —Rings are created for all points. SINGLE —Rings are created for a single point. SELECTED —Rings are created for all selected points in ArcMap.	String
RingsCollection [RingsCollection,...]	The distances, in ascending size, used to create rings around the input features.	Double
MeasureUnits [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. ID —Selects a single point using the store ID field. Name —Selects a single point using the store name field.	String
Single_Site (可选)	ID or name of store to be used as the single point.	String
RemoveOverlap (可选)	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
Donut (可选)	Creates 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. This is the default. FALSE —Creates concentric rings.	Boolean

代码示例

StaticRings example (stand-alone script)

# Name: StaticRings.py
# Description: Creates 1,2, and 3 mile ring trade areas around stores in San Francisco.
# Author: Esri

# Import system modules
import arcview
import arcpy

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

# Acquire extension license 
arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Static Rings tool
# Please note that your paths may be different.
InputFeatureLayer = "C:/temp/sf_stores.shp"
IdField = "STORE_ID"
All_Or_Single_Or_Selected = "ALL"
RingsCollection = "1;2;3"
MeasureUnits = "Miles"
OutputFeatureClass = "C:/temp/RingOutput.shp"
  
 
# Create static ring trade areas
arcpy.StaticRings_ba(InputFeatureLayer, 
						IdField, 
						All_Or_Single_Or_Selected, 
						RingsCollection, 
						MeasureUnits, 
						OutputFeatureClass)

# Release extension license 
arcpy.CheckInExtension("Business")

环境

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

许可信息

• ArcGIS Desktop Basic: 需要 Business Analyst
• ArcGIS Desktop Standard: 需要 Business Analyst
• ArcGIS Desktop Advanced: 需要 Business Analyst