ArcMap

ハフ モデル (Original Huff Model)

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

概要

距離と魅力度となる変数に基づいて地域のセールス ポテンシャルを予測するための確率サーフェスを作成します。

[ハフ モデル (Original Huff Model)] の詳細

使用法

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

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

  • ハフ モデルの出力には、区画ごとの確率と予想売上高が生成されます。

    出力された確率は、新店舗の主要な商圏の定義に使用できます。たとえば、新規の店舗ロケーションの調査で確率が 40 パーセントを上回る区画をすべて含む 1 次市場エリアを作成するために、[属性によるディゾルブ (Dissolve By Attribute Range)] ツールを使用して商圏を作成することができます。

  • 複数の魅力度を使用する場合は、[アドバンス ハフ モデル (Advanced Huff Model)] ツールを使用する必要があります。

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

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

    [目標物検索] の詳細

  • [距離の抵抗係数] が高いほど、距離が消費者の行動に与える影響が大きくなります。たとえば、消費者は食料品などの低次財よりも、自動車や家具などの高次財のためのほうが長い距離を移動することに積極的です。

  • 出力フィーチャクラスの空間参照は、セールス ポテンシャル レイヤーと同じになります。

構文

arcpy.ba.HuffModelOriginal(SalesPotentialLayer, PotentialSalesFldName, StoreLayer, AttractivenessField, WayToDefineStoreLocation, RadiusOfCovering, {MeasureUnits}, DistanceCoefficient, Attractiveness, OutputFeatureClass, {Longitude}, {Latitude}, {PotentialStoreLayer}, {PotentialStoreOID})
パラメーター説明データ タイプ
SalesPotentialLayer

ハフ モデルのセールス ポテンシャルの計算に使用されるフィーチャ

Feature Layer
PotentialSalesFldName

ハフ モデルのセールス ポテンシャルの計算に使用される値が格納されるフィールド

Field
StoreLayer

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

Feature Layer
AttractivenessField

各競合店舗の魅力度を求める属性フィールド。多くの場合、店舗の規模が魅力度の代わりに使用されます。

Field
WayToDefineStoreLocation

ポテンシャル レイヤーの選択方法を決定します。

  • BY_COORDINATES —緯度と経度の座標をポテンシャル レイヤーの中心点として入力します。
  • FROM_LAYER —既存のレイヤーからポイント レイヤーを候補地として選択します。
String
RadiusOfCovering

ハフ モデルの半径を設定します。モデル出力が候補地からこの距離に広げられます。

Double
MeasureUnits
(オプション)

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

  • Minutes
  • Decimal Degrees
  • Feet
  • Kilometers
  • Meters
  • Miles
  • Nautical Miles
  • Yards
String
DistanceCoefficient

移動距離が顧客に与える影響度を決定する値。

Double
Attractiveness

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

Double
OutputFeatureClass

ハフ モデルの結果が格納される出力フィーチャクラス

Feature Class
Longitude
(オプション)

出店候補地の X 座標 (経度)。

Double
Latitude
(オプション)

出店候補地の Y 座標 (緯度)。

Double
PotentialStoreLayer
(オプション)

潜在店舗ロケーションの定義に使用される既存のポイント フィーチャクラス

Feature Layer
PotentialStoreOID
(オプション)

出店候補地の一意な ID。

Long

コードのサンプル

HuffModelOriginal (ハフ モデル) の例 (スタンドアロン スクリプト)

# Name: HuffModelOriginal.py
# Description: Creates a Huff Model to estimate dollars spent on vehicle maintenance in the San Francisco Market 
# 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") 
 
# Define input and output parameters for the Original Huff Model tool
  SalesLayer = "C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/BlockGroups_bg.bds"
  SalesFieldName = "X6015_X"
  CompLayer = "C:/temp/sf_stores.shp"
  AttractiveField = "SALES"
  DefineStoreLayer = "BY_COORDINATES"
  Radius = "5"
  Coefficient = "-1.5"
  Attractiveness = "50000"
  OutPath = "C:/temp/Huff_Model.shp"
 
# Create Original Huff Model  
  arcpy.HuffModelOriginal_ba(SalesLayer,
	  SalesFieldName,
	  CompLayer,
	  AttractiveField,
	  DefineStoreLayer,
	  Radius,
	  Coefficient,
	  Attractiveness,
	  OutPath)
 
# Release extension license 
arcpy.CheckInExtension("Business")

環境

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

ライセンス情報

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

関連トピック