Python ArcGIS find_hot_spots用法及代碼示例

本文簡要介紹 python 語言中 arcgis.features.analysis.find_hot_spots 的用法。

用法:

arcgis.features.analysis.find_hot_spots(analysis_layer, analysis_field=None, divided_by_field=None, bounding_polygon_layer=None, aggregation_polygon_layer=None, output_name=None, context=None, gis=None, estimate=False, shape_type=None, cell_size=None, cell_size_unit=None, distance_band=None, distance_band_unit=None, future=False)

返回：

FeatureLayer 如果指定了 output_name，否則是帶有 FeatureCollection 和處理消息的字典。

find_hot_spots 方法分析點數據(例如犯罪事件、交通事故或樹)或與點或區域要素相關的字段值(例如每個人口普查區域的人數或零售店的總銷售額)。它發現具有統計意義的高值(熱點)和低值(冷點)的空間集群。對於未指定字段的點數據，熱點是點多的位置，冷點是點少的位置。

結果Map圖層以紅色顯示熱點，以藍色顯示冷點。最深的紅色特征表示高值或點密度的最強聚類；您可以有 99% 的把握與這些特征相關聯的聚類不可能是隨機機會的結果。同樣，最深的藍色特征與最強的低值空間聚類或最低點密度相關聯。米色的特征不屬於具有統計意義的集群；與這些特征相關的空間模式很可能是隨機過程和隨機機會的結果。

Parameter	Description
analysis_layer(如果analysis_layer包含多邊形則為必需)	必需的層。將為其計算熱點的點或麵要素圖層。請參閱特征輸入。
analysis_field	可選字符串。將被分析的數字字段。您選擇的字段可能代表： 計數(例如交通事故的數量) 率(例如每平方英裏的犯罪數量) 平均值(例如平均數學考試成績) index (例如客戶滿意度得分) 如果未提供 analysis_field，則熱點結果僅基於點密度。
divided_by_field	可選字符串。 analysis_layer 中將用於規範化數據的數字字段。例如，如果您的分數代表犯罪，除以總人口將導致分析人均犯罪，而不是原始犯罪計數。 您可以使用 esriPopulation 使用最新的人口值對每個區域要素進行地理豐富，然後將其用作要除以的屬性。此選項將使用積分。
bounding_polygon_layer	可選層。當分析圖層為點且未指定 analysis_field 時，您可以提供定義可能發生事件的位置的麵要素。例如，如果您正在分析港口中的劃船事故，港口的輪廓可能會為可能發生事故的位置提供良好的邊界。如果未提供邊界區域，則分析中僅包含至少具有一個點的位置。請參閱特征輸入。
aggregation_polygon_layer	可選層。當 analysis_layer 包含點且未指定 analysis_field 時，您可以提供將聚合和分析點的麵要素，例如行政單位。計算落在每個多邊形內的點數，並分析每個多邊形內的點數。請參閱特征輸入。
output_name	可選字符串或 FeatureLayer 。現有要素圖層將導致新圖層附加到要素服務。如果 overwrite 在上下文中為 True，則新層將覆蓋現有層。如果未指示output_name，則創建新的 FeatureCollection 。
context	可選字典。處理範圍和輸出空間參考等附加設置。對於find_hot_spots，有三個設置。 extent - 定義分析區域的邊界框。僅分析input_layer 中與邊界框相交的那些特征。 outSR - 輸出要素將投影到 wkid 引用的輸出空間參考中。 overwrite - 如果為 True，則 output_name 中的要素層將被新要素層覆蓋。適用於 ArcGIS Online 和 ArcGIS Enterprise 11.1+。 # Example Usage context = {"extent": {"xmin": 3164569.408035, "ymin": -9187921.892449, "xmax": 3174104.927313, "ymax": -9175500.875353, "spatialReference":{"wkid":102100,"latestWkid":3857}}, "outSR": {"wkid": 3857}, "overwrite": True}
gis	可選，運行此工具的 GIS 。如果未指定，則使用活動 GIS。
estimate	可選布爾值。為真，運行操作所需的積分數將作為浮點數返回。
shape_type	可選字符串。輸入要素將聚合到的多邊形網格的形狀。 Fishnet - 輸入特征將被聚合到方形(漁網)單元格中。 Hexagon - 輸入特征將聚合成六邊形單元格。
cell_size	可選浮點數。用於聚合特征的網格單元的大小。當聚合成六邊形網格時，這個距離被用作構建六邊形多邊形的高度。
cell_size_unit	可選字符串。 cell_size 值的單位。如果已設置 cell_size，則必須提供一個值。 選擇列表：[“米”、“英裏”、“英尺”、“公裏”]
distance_band	可選浮點數。分析鄰域的空間範圍。此值確定一起分析哪些特征以評估局部聚類。
distance_band_unit	可選字符串。 distance_band 值的單位。如果已設置 distance_band，則必須提供一個值。
future	可選，如果為 True，將返回未來對象，並且進程不會等待任務完成。默認為False，表示等待結果。

如果 future = True ，則結果是 Future 對象。調用result() 獲取響應。

例子：

# USAGE EXAMPLE: To find significant hot ot cold spots of collisions involving a bicycle within a specific boundary.
collision_hot_spots = find_hot_spots(collisions,
                                     bounding_polygon_layer=boundry_lyr,
                                     output_name='collision_hexagon_hot_spots',
                                     shape_type='hexagon')