获得 Business Analyst 许可后可用。
描述
Creates a centroid (new store location) in the mean geographic center of your customer points.
插图
使用方法
In most cases, the input Customer Layer will be a Business Analyst customer layer.
The Customer Layer must be point features.
In ArcMap, the mean store center will be determined based only on the customer points that are within the active study area or analysis extent. If you want to create the store center based on all customer points, make sure all customers are within the analysis extent.
You can use this tool to compare the geographic centroid of your customers to your actual store location. Significant distances between the customer center output and actual store location can illustrate problems with existing store locations.
You can create a centroid calculated by a weighted value. If you use a Customer Weight Field, , the geographic center is weighted based on the value of each customer point.
Use the Make Clusters option if you wish to create simulated store locations based on the distribution of your customers.This allows you to evaluate existing store locations versus optimal locations by being able to visualize your existing store locations versus the possible locations based on your customer distribution.
The output created when using Make Clusters option is an excellent input for the Territory Design tool, where a market may contain customers but doesn't contain seed points. This allows virtual seed points to be generated based on customer distribution.
The Make Clusters option uses the K-means algorithm for calculating centroids of clusters.
语法
arcpy.ba.MeanStoreCenter(CustomerLayer, LinkField, CustomerWeightField, OutputFeatureClass, {UseSelectedFeatures}, {InNeedReportOutput}, {InputFeatureLayer}, {IDField}, {DistanceCalculateMethod}, {MeasureUnits}, {InReportTitle}, {ReportFile}, {InMakeClusters}, {InClustersCount}, {ReportFormats}, {Use constant mean points})
参数 | 说明 | 数据类型 |
CustomerLayer | The input feature layer. This point layer is usually a customer layer. | Feature Layer |
LinkField | The store ID field in the customer layer that assigns each customer to a store location. | Field |
CustomerWeightField | The numeric field used in the calculation to determine the mean store center. | Field |
OutputFeatureClass | The new feature class that will contain the mean center for customer locations. | Feature Class |
UseSelectedFeatures (可选) | The features used to generate the mean centers.
| Boolean |
InNeedReportOutput (可选) | The option to output a mean store center report.
| Boolean |
InputFeatureLayer (可选) | The input feature layer containing the center points (typically store points) that will be used in calculating the distance from the mean store center. | Feature Layer |
IDField (可选) | Field used to uniquely identify each store. | Field |
DistanceCalculateMethod (可选) | The method used to calculate the distance between existing stores and the mean store center.
| String |
MeasureUnits (可选) | The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected.
| String |
InReportTitle (可选) | Title for the Mean Store Center report. | String |
ReportFile (可选) | The directory that the Mean Store Center report will be saved to. | Folder |
InMakeClusters (可选) | Will use a K-means algorithm to generate mean store centers based on customer file.
| Boolean |
InClustersCount (可选) | Determines the number of clusters generated based on customer file. The default is 10. | Long |
ReportFormats [ReportFormats,...] (可选) | Select the desired report output format
| String |
Use constant mean points (可选) | Use constant mean points. | Feature Layer |
代码示例
MeanStoreCenter example (stand-alone script)
# Name: MeanStoreCenter.py
# Description: Spatially locates a new store location in the San Francisco market based on customer sales.
# 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")
try:
# Acquire extension license
arcpy.CheckOutExtension("Business")
# Define input and output parameters for the Mean Store Center tool
CustomerLayer = "C:/temp/sf_cust.shp"
LinkField = "STORE_ID"
CustomerWeightField = "SALES"
OutputFeatureClass = "C:/temp/Mean_Store.shp"
# Create Mean Store Center output file
arcpy.MeanStoreCenter_ba(CustomerLayer,
LinkField,
CustomerWeightField,
OutputFeatureClass)
# Release extension license
arcpy.CheckInExtension("Business")
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 需要 Business Analyst
- Standard: 需要 Business Analyst
- Advanced: 需要 Business Analyst