Huff Model Calibration (Business Analyst)

获得 Business Analyst 许可后可用。

描述

Calculates exponent values for use in the Huff Model tool.

使用方法

  • The output exponents are based on attractiveness values of the existing facilities and their spatial relationship to customer points.

  • Customer point data is a required input.

  • The Huff Model Calibration output is stored in the Business Analyst container in the Catalog pane.

  • Exponent values are correlated to the market defined by the inputs. Although they can be applied to additional markets, they may be less reliable in those scenarios.

  • The Huff Model Calibration output can be applied to the Huff Model tool.

语法

arcpy.ba.HuffModelCalibration(in_facility_features, facility_id_field, in_customer_features, link_field, in_sales_potential_features, sales_potential_id_field, out_calibration, attractiveness_variables, {customer_weight_field}, {distance_type}, {distance_units}, {travel_direction}, {time_of_day}, {time_zone})
参数说明数据类型
in_facility_features

The input point feature class representing competitors or existing stores.

Feature Layer
facility_id_field

A unique ID representing a store or facility location.

Field
in_customer_features

The input point feature class representing customer locations.

Feature Layer
link_field

The field used as an ID to assign individual customers to a facility or store.

Field
in_sales_potential_features

The input polygon feature class used to determine the potential sales market.

Feature Layer
sales_potential_id_field

A unique ID representing the sales potential area.

Field
out_calibration

The output calibration file that will contain the calibrated Huff model results, which is the exponent values for the attractiveness variables and distance. The output file extension will be *.huffmodel.

File
attractiveness_variables
[attractiveness_variables,...]

The fields used to determine the attractiveness of each competitor. In many cases, the size of the store is used as a substitute for attractiveness.

Value Table
customer_weight_field
(可选)

A calculated weighted value assigned to each customer.

Field
distance_type
(可选)

Defines how distance is calculated based on method of travel. The default value is Straight Line.

String
distance_units
(可选)

The distance-measuring units to be used when calculating distance.

String
travel_direction
(可选)

Specifies the direction of travel that will be used between stores and sales potential features.

  • TOWARD_STORESThe direction of travel will be from sales potential features to stores. This is the default.
  • AWAY_FROM_STORESThe direction of travel will be from stores to sales potential features.
String
time_of_day
(可选)

The time and date that will be used when calculating distance.

Date
time_zone
(可选)

Specifies the time zone that will be used for the Time of Day parameter.

  • TIME_ZONE_AT_LOCATIONThe time zone in which the territories are located will be used. This is the default.
  • UTCCoordinated universal time (UTC) will be used.
String

代码示例

HuffModelCalibration example (Python window)

The following Python window script demonstrates how to use the HuffModelCalibration function.

import arcpy
arcpy.ba.HuffModelCalibration("starbucks_layer", "IDField", "potential_store_layer", "IDField", "HuffModelTestData.gdb\CT", "IDField", "TOTPOP_CY", "Starbucks_HuffModel", "SALES # 1", -1.5, "STRAIGHT_LINE_DISTANCE", "MILES", None, "TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION")

许可信息

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

相关主题