ArcMap

実勢データでハフ モデルのキャリブレーション (Huff Model Calibration By Real Data)

Business Analyst ライセンスで利用できます。

概要

分析範囲内の店舗ロケーションごとに観測された顧客データを使用してハフ モデルを統計的にキャリブレーションします。

[実勢データでハフ モデルのキャリブレーション (Huff Model Calibration By Real Data)] の詳細

使用法

  • このツールを実行するにあたり、まず分析対象となるすべての競合店舗の商圏を含む分析範囲を定義する必要があります。

  • このツールで生成されるキャリブレーション出力はアドバンス ハフ モデルへの入力に使用されます。

  • 顧客データには、分析範囲内の区画ごとの世帯数サンプルの情報を含める必要があります。 分析範囲内の既存の店舗ロケーションと競合店舗ロケーションごとに顧客データが必要となります。 区画ごとにモデル内で顧客情報が比率に変換されます。

  • [潜在顧客の区画レベル] パラメーターの値は通常、潜在顧客が居住するサブエリアを表すポリゴン フィーチャになります。 関連する人口統計データを含むポイント フィーチャ (ブロック ポイントなど) を入力することもできます。

  • [競合店舗レイヤー] には、特定の分析範囲内の競合店舗をすべて含める必要があります。 また、このレイヤーには、分析範囲内にある自社の既存店舗もすべて含める必要があります。これらの既存店舗の位置が新規店舗にとっては、競合店舗の位置としてみなされるからです。 ほとんどの場合、[競合店舗レイヤー] は Business Analyst の店舗レイヤーになります。

  • 競合店舗ロケーションは、Business Analyst の [目標物検索] 機能から抽出できます。[目標物検索] 機能の詳細

  • [店舗の魅力度フィールド] は予測変数とも呼ばれ、ほとんどの場合に売場面積、駐車スペースの数、広告、営業時間、商品の価格、築年数、外観、看板、アクセスのしやすさなどの店舗の属性が入力されます。

構文

arcpy.ba.HuffModelCalibrationByRealData(PotenCustGeogLevel, GeogIDField, CustomersWithAssignedStoreID, AssociatedStoreID, StoreLayer, StoreIDField, StoreAttractionFields, DistanceCalculationMethod, OutputCalibrationFolder, {AnalizeSelectedCustomersOnly}, {ExcludeOutlyingCustomers}, {CutoffDistance}, {MeasureUnits}, {NeedReportOutput}, {ReportTitle}, {ReportFile}, {ReportFormats})
パラメーター説明データ タイプ
PotenCustGeogLevel

潜在顧客が居住するサブエリアを表すポリゴン フィーチャ。 関連する人口統計データを含むポイント フィーチャ (ブロック ポイントなど) を使用することもできます。

Feature Layer
GeogIDField

潜在顧客の区画レベルに一意の ID。

Field
CustomersWithAssignedStoreID

顧客データと関連する店舗 ID を含むポイント フィーチャ (通常は、Business Analyst 顧客ファイル)。

Feature Layer
AssociatedStoreID

各顧客を店舗に割り当てる、顧客レイヤー内の店舗 ID フィールド。

Field
StoreLayer

分析範囲全体の売上高への影響と売上高の分布を求める場合に使用される競合ポイント (通常は店舗) が格納されるレイヤー。

Feature Layer
StoreIDField

競合店舗レイヤーの一意な ID。

Field
StoreAttractionFields
[StoreAttractionFields,...]

消費者にとっての店舗の魅力度を測定する値。

Field
DistanceCalculationMethod

潜在顧客レイヤー パラメーターで定義された地理エリアと競合店舗レイヤーにある店舗間の距離の計算方法を割り当てます。

  • STRAIGHT_LINE_DISTANCE —ユークリッド法 (直線距離)。
  • DRIVE_DISTANCE —距離単位で計測される運転距離。
  • DRIVE_TIME —到達圏を時間単位で測定。
String
OutputCalibrationFolder

ハフ モデル キャリブレーションの結果ファイルが格納される出力フォルダー

Folder
AnalizeSelectedCustomersOnly
(オプション)

選択されたフィーチャだけを [実勢データでハフ モデルのキャリブレーション (Huff Model Calibration By Real Data)] の生成に使用します。

  • True —顧客レイヤー内の選択されたフィーチャに対してハフ モデル キャリブレーションを生成します。
  • False —顧客レイヤー内のすべてのフィーチャに対してハフ モデル キャリブレーションを生成します。
Boolean
ExcludeOutlyingCustomers
(オプション)

必要に応じて、制限距離を設定し、範囲外のポイントをモデルから除外します。

  • True —範囲外の顧客を除外します。
  • False —すべての顧客を解析の対象とします。
Boolean
CutoffDistance
(オプション)

範囲外の顧客を解析から除外するための閾値。

Double
MeasureUnits
(オプション)

距離の値として使用される単位。 デフォルトでは、Business Analyst の初期設定で定義されている単位が選択されます。

  • Minutes
  • Decimal Degrees
  • Feet
  • Kilometers
  • Meters
  • Miles
  • Nautical Miles
  • Yards
String
NeedReportOutput
(オプション)

実勢データに基づいてハフ モデル キャリブレーション レポートを作成します。

  • True —ハフ モデル キャリブレーション レポートを作成します。
  • False —ハフ モデル キャリブレーション レポートを作成しません。
Boolean
ReportTitle
(オプション)

キャリブレーション レポートのタイトル

String
ReportFile
(オプション)

キャリブレーション レポート ファイルの名前

String
ReportFormats
[ReportFormats,...]
(オプション)

出力レポートの形式。 複数の形式を選択してもかまいません。

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSX
  • Stripped XLSX
String

コードのサンプル

HuffModelCalibrationByRealData (実勢データでハフ モデルのキャリブレーション) の例 (スタンドアロン スクリプト)

# Name: HuffModelCalibrationByRealData.py
# Description: Generates a calibrated model around two San Francisco stores using Sales as a predictor.
# 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")
  arcpy.CheckOutExtension("Network") 
 
 
# Define input and output parameters for the Huff Model Calibration by Real Data tool
  Potential = "C:/ArcGIS/Business Analyst/US_2022/Data/BDS/BlockGroups_bg.bds"
  SalesId = "ID"
  Cust = "C:/temp/sf_cust.shp"
  AssocStoreId = "STORE_ID"
  Store = "C:/temp/sf_stores.shp"
  StoreId = "STORE_ID"
  AttractionField = "SALES"
  DistanceCalc = "DRIVE_TIME"
  OutPath = "C:/temp/Calibration_Realdata"
 
# Create Huff Model Calibration by Real Data
  arcpy.HuffModelCalibrationByRealData_ba(Potential,
	  SalesId,
	  Cust,
	  AssocStoreId,
	  Store,
	  StoreId,
	  AttractionField,
	  DistanceCalc,
	  OutPath)
 
# Release extension license 
arcpy.CheckInExtension("Business")
  arcpy.CheckInExtension("Network")
 
except:
  print arcpy.GetMessages(2)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: 次のものが必要 Business Analyst
  • Standard: 次のものが必要 Business Analyst
  • Advanced: 次のものが必要 Business Analyst

関連トピック