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

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

サマリー
使用法
構文
コードのサンプル
環境
ライセンス情報

サマリー

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

使用法

ハフモデルの結果は、次の目的に使用できます。
- 市場ポテンシャルを推測、定義、および解析する。
- 新店舗の経済的影響の評価
- 既存の店舗および小売店の売上および潜在市場の予測
- 小売店のパフォーマンスにおける競合および環境変化の影響の評価
このツールを実行するにあたって、まず解析対象となるすべての競合店舗のすべての商圏を含む分析範囲を定義する必要があります。
このツールで生成されるキャリブレーション出力は「アドバンスハフモデル (Advanced Huff Model) 」ツールへの入力に使用されます。
調査データを使用すると、それぞれの回答者が分析範囲内の店舗に買い物に出かける頻度が求められます。店頭アンケートは、この情報を収集する効果的な手段になります。
各区画がサンプルの中で適切に示されていることを確認します。
[潜在顧客の区画レベル] は通常、潜在顧客が居住するサブエリアを表すポリゴンフィーチャになります。このレイヤーは、関連する人口統計データを含むポイントフィーチャレイヤー (ブロックポイントなど) になることもあります。
[競合店舗レイヤー] には、特定の分析範囲内の競合店舗をすべて含める必要があります。また、このレイヤーには、分析範囲内にある自社の既存店舗もすべて含める必要があります。これらの既存店舗の位置が新規店舗にとっては、競合店舗の位置としてみなされるからです。ほとんどの場合、このレイヤーは Business Analyst の店舗レイヤーになります。
競合店舗ロケーションは、ESRI Business Analyst の [目標物検索] 機能から抽出できます。
[目標物検索] の詳細
[店舗の魅力度フィールド] は予測変数とも呼ばれ、ほとんどの場合に売場面積、駐車スペースの数、広告、営業時間、商品の価格、築年数、外観、看板、アクセスのしやすさなどの店舗の属性が入力されます。

構文

HuffModelCalibrationBySurveyData_ba (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.7\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_2018/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")

except:
  print arcpy.GetMessages(2)

環境

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

ライセンス情報

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

ArcMap

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

サマリー

使用法

構文

コードのサンプル

環境

ライセンス情報

関連トピック