ArcMap

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

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

概要

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

使用法

  • ハフ モデルの結果は、次の目的に使用できます。

    • 市場ポテンシャルを推測、定義、および解析する。
    • 新店舗の経済的影響の評価
    • 既存の店舗および小売店の売上および潜在市場の予測
    • 小売店のパフォーマンスにおける競合および環境変化の影響の評価

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

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

  • 調査データを使用すると、それぞれの回答者が分析範囲内の店舗に買い物に出かける頻度が求められます。 店頭アンケートは、この情報を収集する効果的な手段になります。

  • 各区画がサンプルの中で適切に示されていることを確認します。

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

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

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

  • [目標物検索] の詳細

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

構文

arcpy.ba.HuffModelCalibrationBySurveyData(CustomerLayer, CustomerIDField, StoreLayer, StoreIDField, StoreAttractionFields, PatronizeTable, FormatOfSurveyData, SelectPatronizeTableFields, DistanceCalculationMethod, OutputFileName, {NeedReportOutput}, {ReportTitle}, {ReportFile}, {ReportFormats})
パラメーター説明データ タイプ
CustomerLayer

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

Feature Layer
CustomerIDField

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

Field
StoreLayer

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

Feature Layer
StoreIDField

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

Field
StoreAttractionFields
[StoreAttractionFields,...]

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

Field
PatronizeTable

顧客調査結果を含むテーブル。

Table
FormatOfSurveyData

調査データの形式を定義します。

  • SEVERAL_LINES_PER_CUSTOMER —複数の質問に対する顧客の回答を表示します。 これがデフォルトです。
  • ONE_LINE_PER_GEOUNIT —顧客の回答を区画単位別に集計します (たとえば、1 つの質問に対する回答の数をブロック グループ別に集計する)。
  • ONE_LINE_PER_CUSTOMER —顧客 1 人につき 1 つの回答を使用します (顧客が各店舗を訪れた回数など)。
String
SelectPatronizeTableFields

調査対象の店舗に顧客を関連付けるフィールドを選択します。

  • Survey Data Customer Group ID Field —[1 人の顧客につき複数のレコード]、[1 人の顧客につき 1 つのレコード]、および [1 つの区画につき 1 つのレコード] 調査形式から顧客 ID を選択します。
  • Survey Data Store ID Field —各顧客に関連付けられた店舗 ID を [1 人の顧客につき複数のレコード] および [1 つの区画につき 1 つのレコード] 調査形式から選択します。
  • Survey Data Total Visits Field —調査対象の店舗への各顧客の訪問頻度を [1 人の顧客につき複数のレコード] 調査形式から読み取ります。
String
DistanceCalculationMethod

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

  • STRAIGHT_LINE_DISTANCE —ユークリッド法 (直線距離)。 これがデフォルトです。
  • DRIVE DISTANCE —距離単位で計測される運転距離。
  • DRIVE_TIME —到達圏を時間単位で測定。
String
OutputFileName

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

Folder
NeedReportOutput
(オプション)

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

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

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

String
ReportFile
(オプション)

レポート ファイルの名前。

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

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

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

コードのサンプル

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

# Name: HuffModelCalibrationBySurveyData.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 Survey Data tool
  Cust = "C:/temp/sf_cust.shp"
  CustId = "CUST_ID"
  Store = "C:/temp/sf_stores.shp"
  StoreId = "STORE_ID"
  AttractionField = "SALES"
  Patronage = "C:/ArcGIS/Business Analyst/US_2022/Datasets/Tutorial/sf_stores.dbf"
  SurveyFormat = "ONE_LINE_PER_CUSTOMER"
  SelectFields = "STORE_ID"
  DistanceCalc = "DRIVE_TIME"
  OutPath = "C:/temp/Calibration_Surveydata"
 
# Create Huff Model Calibration by Survey Data
  arcpy.HuffModelCalibrationBySurveyData_ba(Cust,
	  CustId,
	  Store,
	  StoreId,
	  AttractionField,
	  Patronage,
	  SurveyFormat,
	  SelectFields,
	  DistanceCalc,
	  OutPath)
 
# Release extension license 
arcpy.CheckInExtension("Business")
  arcpy.CheckInExtension("Network")

環境

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

ライセンス情報

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

関連トピック