オーバーラップ測定 (Measure Cannibalization)

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

概要

2 つ以上の商圏のオーバーラップの量を計算します。

[オーバーラップ測定 (Measure Cannibalization)] の詳細

図

使用法

• 出力フィーチャクラスの空間参照は、商圏レイヤーと同じになります。

• 商圏レイヤーをポリゴン フィーチャクラスにする必要があります。

• このツールの主な使用目的は、2 つ以上の商圏間のオーバーラップ量を求めることです。

• ほとんどの場合、商圏レイヤーは Business Analyst で作成された商圏になります。

• オーバーラップしている商圏だけがこのツールへの入力として有効です。

• 出力フィーチャクラスは、商圏フィーチャで実際にオーバーラップしているエリアから作成されます。

• 商圏がオーバーラップしていない場合、出力フィーチャクラスは商圏の入力フィーチャクラスと同じになります。

構文

arcpy.ba.MeasureCannibalization(InputLayer, IDField, NameField, OutputFeatureClass, {UseSelectedFeatures}, {ReportName}, {ReportTitle}, {ReportOutputDirectory}, {ReportFormats})

パラメーター	説明	データ タイプ
InputLayer	オーバーラップ量の算出に使用される商圏が格納される入力フィーチャクラス	Feature Layer
IDField	商圏レイヤー内の [個別値] フィールド。	Field
NameField	商圏レイヤー内で一意の名前フィールド	Field
OutputFeatureClass	オーバーラップしているフィーチャが格納される出力フィーチャクラス	Feature Class
UseSelectedFeatures (オプション)	オーバーラップの測定に使用されるフィーチャ TRUE —選択されたフィーチャに対してオーバーラップを測定します。 FALSE —すべてのフィーチャに対してオーバーラップを測定します。これがデフォルトです。	Boolean
ReportName (オプション)	レポートの名前	String
ReportTitle (オプション)	レポートのタイトル	String
ReportOutputDirectory (オプション)	この出力フォルダーにレポートが作成されます。	Folder
ReportFormats [ReportFormats,...] (オプション)	レポートの出力先の 1 つまたは複数の形式 Python 関数呼び出しを使用する場合は、"FirstFormat; SecondFormat; ThirdFormat; ..." の形式で値を文字列として入力します。例: "html;pdf;s.xlsx;s.xml;xlsx" (セミコロンで区切られた希望の出力形式名の文字列) Simple XML —Simple XML は "s.xml" と入力する PDF —PDF は "pdf" と入力する HTML —HTML は "html" と入力する CSV —CSV は "csv" と入力する ZIP —ZIP は "zip" と入力する XLSX —XLSX は "xlsx" と入力する Stripped XLSX —Stripped XLSX は "s.xlsx" と入力する	String

コードのサンプル

MeasureCannibalzation (オーバーラップ測定) の例 (スタンドアロン スクリプト)

# Name: MeasureCannibalization.py
# Description: Measures cannibalization between two trade areas.
# 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")
 
# Acquire extension license 
arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Measure Cannibalization tool
InputLayer = "C:/temp/DetailedCustomerTA.shp"
IDField = "AREA_ID"
NameField = "AREA_DESC"
OutputFeatureClass = "C:/temp/Reports/Cannibalization.shp"
ReportName = "Cannibalization_Name"
ReportTitle = "Cannibalization_Report"
ReportOutputDirectory = "C:/temp/Reports"
ReportFormats="html;pdf;s.xlsx;s.xml;xlsx"
 
# Create a Measure Cannibalization output
arcpy.MeasureCannibalization_ba(InputLayer, 
						IDField, 
						NameField, 
						OutputFeatureClass, 
						UseSelectedFeatures, 
						ReportName, 
						ReportTitle, 
						ReportOutputDirectory, 
						ReportFormats)
 
# Release extension license   
arcpy.CheckInExtension("Business")

環境

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

ライセンス情報

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