Python ArcGIS aggregate_points用法及代碼示例

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

用法:

arcgis.features.analysis.aggregate_points(point_layer, polygon_layer=None, keep_boundaries_with_no_points=True, summary_fields=[], group_by_field=None, minority_majority=False, percent_points=False, output_name=None, context=None, gis=None, estimate=False, future=False, bin_type=None, bin_size=None, bin_size_unit=None)

返回：

result_layer：如果指定了output_name，則為 FeatureLayer ，否則為 FeatureCollection 。

聚合點任務使用一層點要素和一層麵要素。它首先確定哪些點落在每個多邊形的區域內。確定此point-in-polygon 空間關係後，將計算有關多邊形中所有點的統計數據並將其分配給該區域。最基本的統計數據是多邊形內的點數，但您也可以獲得其他統計數據。

例如，如果您的點代表咖啡店，並且每個點都有一個TOTAL_SALES 屬性，那麽您可以獲得多邊形內所有TOTAL_SALES 的總和，或最小或最大TOTAL_SALES 值或標準差等統計信息多邊形內的所有銷售。

Parameter	Description
point_layer	所需的點圖層。將聚合到polygon_layer 中的多邊形中的點要素。請參閱特征輸入。
polygon_layer	可選的多邊形層。將聚合輸入點的麵要素(區域)。看特征輸入.這polygon_layer是必需的如果bin_type,bin_size和bin_size_unit未指定。
keep_boundaries_with_no_points	可選的布爾值。一個布爾值，指定是否應在輸出中返回其中沒有點的多邊形。默認值為真。
summary_fields	可選的字符串列表。您希望為每個多邊形內的所有點計算的字段名稱和統計匯總類型的列表。請注意，始終返回每個多邊形內的點數。摘要類型是以下之一： Sum - 將每個多邊形中所有點的總值相加 平均值 - 計算每個多邊形中所有點的平均值。 Min - 查找每個多邊形中所有點的最小值。 Max - 查找每個多邊形中所有點的最大值。 Stddev - 找出每個多邊形中所有點的標準差。 示例 [fieldName1 summaryType1,fieldName2 summaryType2]。
group_by_field	可選字符串。 point_layer 中的字段名稱。分組依據字段具有相同值的點將具有自己的計數和匯總字段統計信息。您可以使用分析圖層中的屬性創建統計組。例如，如果您將犯罪聚集到社區邊界，您可能有一個屬性 Crime_type，其中包含五種不同的犯罪類型。每個獨特的犯罪類型形成一個組，您選擇的統計數據將針對 Crime_type 的每個唯一值進行計算。選擇分組屬性時，會創建兩個結果：結果圖層和包含統計信息的相關表。
minority_majority	可選的布爾值。此布爾參數僅在指定group_by_field 時適用。如果為真，則計算每個邊界內每個組字段的少數(最不占優勢)或多數(最占優勢)屬性值。 aggregated_layer 中添加了兩個新字段，前綴為 Majority_ 和 Minority_。默認值為假。
percent_points	可選的布爾值。此布爾參數僅在指定group_by_field 時適用。如果設置為 true，則計算每個唯一 group_by_field 值的點數百分比。一個新字段被添加到組匯總輸出表中，其中包含每個組內每個屬性值的百分比。 如果minority_majority 為真，則會向aggregated_layer 添加兩個附加字段，其中包含每個組中少數屬性值和多數屬性值的百分比。
output_name	可選字符串或 FeatureLayer 。現有要素圖層將導致新圖層附加到要素服務。如果 overwrite 在上下文中為 True，則新層將覆蓋現有層。如果未指示output_name，則創建新的 FeatureCollection 。
context	可選字典。其他設置，例如處理範圍和輸出空間參考。對於aggregate_points，有三個設置(需要overwrite)。 extent - 定義分析區域的邊界框。僅分析input_layer 中與邊界框相交的那些特征。 outSR - 輸出要素將投影到 wkid 引用的輸出空間參考中。 overwrite - 如果為 True，則 output_name 中的要素層將被新要素層覆蓋。適用於 ArcGIS Online 或 Enterprise 10.9.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	可選布爾值。如果為 True，將返回運行該操作的積分數。
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。
bin_type	可選字符串。將生成的 bin 類型和將聚合到的點。 Bin 選項如下：Hexagon 和 Square。正方形是默認值。生成 bin 時，對於 Square，指定的數量和單位決定了正方形的高度和長度。對於六邊形，指定的數量和單位確定平行邊之間的距離。必須指定bin_type 或polygon_layer。如果選擇bin_type，則必須包括指定箱大小的bin_size 和bin_size_unit。
bin_size	可選浮點數。 point_layer 將被聚合到的類型為 bin_type 的 bin 的距離。為 Square 生成 bin 時，指定的數量和單位決定了正方形的高度和長度。對於 Hexagon ，指定的數量和單位確定平行邊之間的距離。
bin_size_unit	可選字符串。與 bin_size 中指定的距離值一起使用的線性單位。值：Meters, Kilometers, Feet, Miles, NauticalMiles, or Yards

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

例子：

# USAGE EXAMPLE: To find number of permits issued in each zip code of US.

agg_result = aggregate_points(point_layer=permits,
                        polygon_layer=zip_codes,
                        keep_boundaries_with_no_points=False,
                        summary_fields=["DeclValNu mean","DeclValNu2 mean"],
                        group_by_field='Declared_V',
                        minority_majority=True,
                        percent_points=True,
                        output_name="aggregated_permits",
                        context={"extent":{"xmin":-8609738.077325115,"ymin":4743483.445485223,"xmax":-8594030.268012533,"ymax":4752206.821338257,"spatialReference":{"wkid":102100,"latestWkid":3857}}})