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 | 潜在顧客レイヤー パラメーターで定義された地理エリアと競合店舗レイヤーにある店舗間の距離の計算方法を割り当てます。
| String |
OutputCalibrationFolder | ハフ モデル キャリブレーションの結果ファイルが格納される出力フォルダー | Folder |
AnalizeSelectedCustomersOnly (オプション) | 選択されたフィーチャだけを [実勢データでハフ モデルのキャリブレーション (Huff Model Calibration By Real Data)] の生成に使用します。
| Boolean |
ExcludeOutlyingCustomers (オプション) | 必要に応じて、制限距離を設定し、範囲外のポイントをモデルから除外します。
| Boolean |
CutoffDistance (オプション) | 範囲外の顧客を解析から除外するための閾値。 | Double |
MeasureUnits (オプション) | 距離の値として使用される単位。 デフォルトでは、Business Analyst の初期設定で定義されている単位が選択されます。
| String |
NeedReportOutput (オプション) | 実勢データに基づいてハフ モデル キャリブレーション レポートを作成します。
| Boolean |
ReportTitle (オプション) | キャリブレーション レポートのタイトル | String |
ReportFile (オプション) | キャリブレーション レポート ファイルの名前 | String |
ReportFormats [ReportFormats,...] (オプション) | 出力レポートの形式。 複数の形式を選択してもかまいません。
| 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