ホット スポットの検索 (Find Hot Spots) (GeoAnalytics Desktop)

サマリー

1 組のフィーチャに対して、Getis-Ord Gi* 統計値を使用して、統計的に有意なホット スポットとコールド スポットを特定します。

ホット スポット分析 (Hot Spot Analysis (Getis-Ord Gi*)) ツールの詳細

ホット スポットの検索 ツールの図

使用法

  • このツールは、統計的に有意な多いフィーチャおよび少ないフィーチャの空間クラスター (ホット スポットとコールド スポット) を特定します。また、入力の各フィーチャの Z スコア、p 値、および信頼度ビン (Gi_Bin) を含む出力フィーチャクラスを作成します。

  • 解析時に、入力ポイント (インシデント) が、指定されたサイズのビンに集約されてから、ホット スポットを決定するために解析されます。集約されるビンには、さまざまな値が含まれている必要があります (ビン内のポイントの数は高度に可変である必要があります)。

  • Z スコアと p 値は、集約されるビンを使用した、帰無仮説を棄却すべきかどうかを判断する統計的有意性の尺度です。すなわち、観測された高い値または低い値の空間クラスタリングが、ランダム分布でこれらの値に期待されるものより顕著かどうかを示します。 Z スコアおよび p 値のフィールドは、どの種類の FDR (False Discovery Rate) 補正も反映しません。

  • フィーチャの Z スコアが高く p 値が小さいことは、ポイント インシデントが集中して存在していることを示します。Z スコアが負の低い値で p 値が小さいことは、ポイント インシデントが存在しないことを示します。Z スコアが高く (または低く) なるほど、クラスタリングの程度は高くなります。Z スコアがゼロに近いことは、明白な空間クラスタリングがないことを示します。

  • Z スコアは、無作為化帰無仮説計算に基づいています。スコアの詳細については、「Z スコアと p 値とは」をご参照ください。

  • ビニングによる解析では、入力が投影されているか、出力座標系投影座標系に設定されている必要があります。 データが投影座標系内になく、投影座標系を設定していない場合、解析するデータの範囲に基づいて投影法が使用されます。

  • 時間ステップを使用して入力フィーチャを解析した場合、各時間ステップは、時間ステップ外部にあるフィーチャとは独立して解析されます。

  • [時間ステップの基準] パラメーターには、日時の値または日付のみの値を指定できますが、時間のみの値を指定することはできません。

  • ジオプロセシング ツールは、Spark を活用しています。 解析は、デスクトップ コンピューターで複数のコアを並列に使用して行われます。 解析の実行の詳細については、「GeoAnalytics Desktop ツールの考慮事項」をご参照ください。

  • GeoAnalytics Desktop ツールを実行する際、解析はデスクトップ コンピューターで行われます。 最適なパフォーマンスを得るために、データがデスクトップで利用できる必要があります。 ホスト フィーチャ レイヤーを使用している場合は、ArcGIS GeoAnalytics Server を使用することをお勧めします。 データがローカルではない場合は、ツールの実行時間は長くなります。 ArcGIS GeoAnalytics Server を使用して解析を実行する方法については、GeoAnalytics Tools をご参照ください。

  • 次のツールを使用して、類似の解析を実行することもできます。

パラメーター

ラベル説明データ タイプ
ポイント レイヤー

ホット スポット分析を実行するポイント フィーチャクラス。

Feature Layer
出力フィーチャクラス

Z スコアと p 値の結果を持つ出力フィーチャクラス。

Feature Class
ビン サイズ
(オプション)

[ポイント レイヤー] を集約するビン サイズおよび単位を表す距離間隔。距離間隔は、距離単位である必要があります。

Linear Unit
近傍サイズ
(オプション)

分析対象の近傍の空間範囲。この値は、ローカル クラスタリングを評価する場合に一緒に分析されるフィーチャを決定します。

Linear Unit
時間ステップ間隔
(オプション)

時間ステップに使用する間隔。 このパラメーターは、 [ポイント レイヤー] で時間が有効化されている場合にのみ使用されます。

Time Unit
時間ステップの配列
(オプション)

時関ステップの配列方法を指定します。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。

  • 終了時間時間ステップは最後の時間イベントに揃えられ、前の時間が集約されます。
  • 開始時間時間ステップは最初の時間イベントに揃えられ、後の時間が集約されます。 これがデフォルトです。
  • 基準時間時間ステップは、指定された日付または時間に揃えられます。 入力フィーチャ内のすべてのポイントのタイムスタンプが、指定した基準時間より大きい値の場合 (または入力フィーチャの開始時間である場合)、時間ステップ間隔はその基準時間から開始され、([開始時間] の配列のように) 後の時間が集約されます。 入力フィーチャ内のすべてのポイントのタイムスタンプが、指定した基準時間より小さい場合 (または、入力フィーチャの終了時間である場合)、時間ステップ間隔はその基準時間で終了し、([終了時間] の配列のように) 前の時間が集約されます。 指定した [基準時間] がデータの時間範囲の中間にある場合、時間ステップ間隔は、([終了時間] の配列のように) 指定した基準時間で終了して作成されます。データの全時間範囲がカバーされるまで、基準時間の前と後にさらに時間ステップ間隔が作成されます。
String
時間ステップの基準
(オプション)

時間ステップと時間間隔の配列に使用する時間。このパラメーターは、 [ポイント レイヤー] で時間が有効化されている場合にのみ使用されます。

Date

arcpy.geoanalytics.FindHotSpots(point_layer, out_feature_class, {bin_size}, {neighborhood_size}, {time_step_interval}, {time_step_alignment}, {time_step_reference})
名前説明データ タイプ
point_layer

ホット スポット分析を実行するポイント フィーチャクラス。

Feature Layer
out_feature_class

Z スコアと p 値の結果を持つ出力フィーチャクラス。

Feature Class
bin_size
(オプション)

point_layer を集約するビン サイズおよび単位を表す距離間隔。距離間隔は、距離単位である必要があります。

Linear Unit
neighborhood_size
(オプション)

分析対象の近傍の空間範囲。この値は、ローカル クラスタリングを評価する場合に一緒に分析されるフィーチャを決定します。

Linear Unit
time_step_interval
(オプション)

時間ステップに使用する間隔。 このパラメーターは、 [point_layer] で時間が有効化されている場合にのみ使用されます。

Time Unit
time_step_alignment
(オプション)

時関ステップの配列方法を指定します。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。

  • END_TIME時間ステップは最後の時間イベントに揃えられ、前の時間が集約されます。
  • START_TIME時間ステップは最初の時間イベントに揃えられ、後の時間が集約されます。 これがデフォルトです。
  • REFERENCE_TIME時間ステップは、指定された日付または時間に揃えられます。 入力フィーチャ内のすべてのポイントのタイムスタンプが、指定した基準時間より大きい値の場合 (または入力フィーチャの開始時間である場合)、時間ステップ間隔はその基準時間から開始され、([開始時間] の配列のように) 後の時間が集約されます。 入力フィーチャ内のすべてのポイントのタイムスタンプが、指定した基準時間より小さい場合 (または、入力フィーチャの終了時間である場合)、時間ステップ間隔はその基準時間で終了し、([終了時間] の配列のように) 前の時間が集約されます。 指定した [基準時間] がデータの時間範囲の中間にある場合、時間ステップ間隔は、([終了時間] の配列のように) 指定した基準時間で終了して作成されます。データの全時間範囲がカバーされるまで、基準時間の前と後にさらに時間ステップ間隔が作成されます。
String
time_step_reference
(オプション)

時間ステップと時間間隔の配列に使用する時間。このパラメーターは、 [point_layer] で時間が有効化されている場合にのみ使用されます。

Date

コードのサンプル

FindHotSpots の例 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、FindHotSpots 関数を使用する方法を示します。

# Name: FindHotSpots.py
# Description: Find Hots Spots of 311 calls for bins of 500 meters looking at 
# neighbors within 1 kilometer. Complete the analysis for each month. 

# Import system modules
import arcpy

arcpy.env.workspace = "C:/data/Calls311.gdb"

# Enable time on the input features using an .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties 
# and enable time. Then right-click the layer and select Share As Layer File.
input_lyrx = r'C:\data\SanFrancisco_311calls.lyrx'

# MakeFeatureLayer converts the .lyrx to features
SF311CallsInputLayer = arcpy.management.MakeFeatureLayer(input_lyrx, "SF_311Calls_layer")

# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(SF311CallsInputLayer, input_lyrx)

# Set local variables
bins = "500 Meters"
neighborhood = "1 Kilometers"
timeStep = "1 Months"
out = "HotSpotsOf311Data"

# Run Find Hot Spots
arcpy.gapro.FindHotSpots(SF311CallsInputLayer, out, bins, neighborhood, timeStep)