Huff Model Calibration (Business Analyst)

Available with Business Analyst license.

Summary

Calculates exponent values for use in the Huff Model tool.

Usage

  • 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.

Parameters

LabelExplanationData Type
Input Facility Features

The input point feature class representing competitors or existing stores.

Feature Layer
Facility ID Field

A unique ID field representing a store or facility location.

Field
Input Customer Features

The input point feature class representing customer locations.

Feature Layer
Associated Facility ID Field

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

Field
Input Sales Potential Features

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

Feature Layer
Sales Potential ID Field

A unique ID field representing the sales potential area.

Field
Output 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

The fields that will be 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
(Optional)

A calculated weighted value field assigned to each customer.

Field
Distance Type
(Optional)

The method of travel that will be used to calculate distance. The default value is Straight Line.

String
Distance Units
(Optional)

The distance-measuring units that will be used when calculating distance.

String
Travel Direction
(Optional)

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

  • Toward Stores —The direction of travel will be from sales potential features to stores. This is the default.
  • Away from Stores —The direction of travel will be from stores to sales potential features.
String
Time of Day
(Optional)

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

Date
Time Zone
(Optional)

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

  • Time Zone at Location —The time zone in which the territories are located will be used. This is the default.
  • UTC —Coordinated universal time (UTC) will be used.
  • Time Zone at Location —The time zone in which the territories are located will be used. This is the default.
  • UTC —Coordinated universal time (UTC) will be used.
String

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})
NameExplanationData Type
in_facility_features

The input point feature class representing competitors or existing stores.

Feature Layer
facility_id_field

A unique ID field representing a store or facility location.

Field
in_customer_features

The input point feature class representing customer locations.

Feature Layer
link_field

The field that will be 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 field 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 that will be 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
(Optional)

A calculated weighted value field assigned to each customer.

Field
distance_type
(Optional)

The method of travel that will be used to calculate distance. The default value is Straight Line.

String
distance_units
(Optional)

The distance-measuring units that will be used when calculating distance.

String
travel_direction
(Optional)

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
(Optional)

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

Date
time_zone
(Optional)

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

Code sample

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")

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics