概要
犯罪や病気のインシデントなどのイベント データを加重ポイント データに変換します。
図
使用法
[イベントの集計 (Collect Events)] を実行すると、一致するポイントが結合され、入力フィーチャクラス内のすべての一意な場所を格納した出力フィーチャクラスが作成されます。次に、「ICOUNT」という名前のフィールドが追加され、それぞれの一意な場所でのすべてのインシデントの合計が格納されます。
このツールで結合されるのは、完全に同一の X と Y の重心座標をもつフィーチャだけです。[イベントの集計 (Collect Events)] ツールを実行する前に、[インテグレート] ツールで近隣のフィーチャをスナップするとよいかもしれません。
[ホット スポット分析 (Getis-Ord Gi*)]、[クラスター/外れ値分析 (Local Moran's I)]、[空間的自己相関分析 (Morans I)] などのツールでは、個々のインシデントではなく加重ポイントが必要です。[イベントの集計 (Collect Events)] は、一致するフィーチャが入力フィーチャクラスに格納されている状態でウェイトを作成する場合に使用できます。
このツールは、ポリゴンやライン データについて使用することもできますが、実際には、イベント、インシデント、またはその他の固定ポイント フィーチャ データでの使用にしか適していません。ラインとポリゴン フィーチャの場合、フィーチャの一致はフィーチャの真のジオメトリ重心に基づきます。マルチポイント、ポリライン、またはマルチパートを伴うポリゴンの場合は、すべてのフィーチャ パートの加重平均中心を使用して重心が計算されます。加重は、ポイント フィーチャの場合は 1、ライン フィーチャの場合は長さ、ポリゴン フィーチャの場合は面積です。
[入力フィーチャクラス] が投影されていない場合 (つまり、座標が、度、分、および秒で与えられた場合)、または出力座標系が地理座標系に設定された場合、弦の測定値を使用して距離が計算されます。弦距離の測定値が使用されるのは、少なくとも互いに約 30° の範囲内のポイントに対して、すばやく算出され、実際の測地距離に非常に近い推定値が得られるという理由からです。弦距離は、短回転楕円体に基づいています。地球の表面上の 2 点が与えられた場合、2 点間の弦の距離は、3 次元の地球内部を通過して 2 点を接続するラインの長さになります。弦距離は、メートル単位でレポートされます。
それぞれのポイント/マルチポイントのパート/マルチパート データをシングルパート フィーチャとして扱う場合は、[マルチパート → シングルパート (Multipart To Singlepart)] ツールを実行してから、シングルパート フィーチャクラスに対して [イベントの集計 (Collect Events)] を実行します。詳細については、「マルチポイント データの処理」をご参照ください。
この機能は、出力フィーチャクラスに加え、生成された出力値として、カウント フィールドの名前、および任意の 1 つの場所に生じる最大カウント値も渡します。生成されたこれらの出力値は、モデルやスクリプトでこのツールを使用する場合に有用です。
ArcMap でこのツールを実行すると、自動的に、コンテンツ ウィンドウに出力フィーチャクラスが、[ICOUNT] フィールドにデフォルトのレンダリングが適用された状態で追加されます。等級シンボルを使ったレンダリング方式は、<ArcGIS>/ArcToolbox/Templates/Layers 内のレイヤー ファイルで定義されています。必要に応じて、テンプレート レイヤー シンボルをインポートすれば、デフォルトのレンダリングを再適用できます。
構文
arcpy.stats.CollectEvents(Input_Incident_Features, Output_Weighted_Point_Feature_Class)
パラメーター | 説明 | データ タイプ |
Input_Incident_Features | イベントまたはインシデント データを表すフィーチャ。 | Feature Layer |
Output_Weighted_Point_Feature_Class | 重み付きポイント データを格納するための出力フィーチャクラス。 | Feature Class |
派生した出力
名前 | 説明 | データ タイプ |
Results_Field | カウント フィールドの名前 | フィールド |
Z_Max_Value | 1 つの位置に発生する最大カウント値。 | Double |
コードのサンプル
CollectEvents (イベントの集計) の例 1 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、CollectEvents (欠損値の補完) ツールの使用方法を示しています。
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")
CollectEvents (イベントの集計) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン Python スクリプトは、CollectEvents (欠損値の補完) ツールの使用方法を示しています。
# Analyze the spatial distribution of 911 calls in a metropolitan area
# using the Hot-Spot Analysis Tool (Local Gi*)
# Import system modules
import arcpy
# Set property to overwrite existing output, by default
arcpy.env.overwriteOutput = True
# Local variables...
workspace = "C:/Data"
try:
# Set the current workspace (to avoid having to specify the full path to the feature classes each time)
arcpy.env.workspace = workspace
# Copy the input feature class and integrate the points to snap
# together at 500 feet
# Process: Copy Features and Integrate
cf = arcpy.CopyFeatures_management("911Calls.shp", "911Copied.shp")
integrate = arcpy.Integrate_management("911Copied.shp #", "500 Feet")
# Use Collect Events to count the number of calls at each location
# Process: Collect Events
ce = arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")
# Add a unique ID field to the count feature class
# Process: Add Field and Calculate Field
af = arcpy.AddField_management("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",
"NON_NULLABLE", "NON_REQUIRED", "#",
"911Count.shp")
cf = arcpy.CalculateField_management("911Count.shp", "MyID", "!FID!", "PYTHON")
# Create Spatial Weights Matrix for Calculations
# Process: Generate Spatial Weights Matrix...
swm = arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS",
"#", "#", "#", 6,
"NO_STANDARDIZATION")
# Hot Spot Analysis of 911 Calls
# Process: Hot Spot Analysis (Getis-Ord Gi*)
hs = arcpy.HotSpots_stats("911Count.shp", "ICOUNT", "911HotSpots.shp",
"GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE",
"#", "#", "euclidean6Neighs.swm")
except arcpy.ExecuteError:
# If an error occurred when running the tool, print out the error message.
print(arcpy.GetMessages())
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい