Python ArcGIS summarize_within用法及代碼示例

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

用法:

arcgis.features.analysis.summarize_within(sum_within_layer, summary_layer, sum_shape=True, shape_units=None, summary_fields=[], group_by_field=None, minority_majority=False, percent_shape=False, output_name=None, context=None, gis=None, estimate=False, future=False, bin_type='Square', bin_size=None, bin_size_unit=None)

返回：

result_layer : FeatureLayer 如果指定了 output_name，否則為 FeatureCollection 字典。

帶有以下鍵的dict：

“result_layer”：圖層(FeatureCollection)

“group_by_summary”：圖層(FeatureCollection)

summarize_within 方法查找位於另一層中的多邊形邊界內的點、線或多邊形要素(或這些要素的一部分)。例如：

• 給定一個流域邊界層和一個land-use類型的land-use邊界層，計算每個流域的land-use類型的總麵積。

• 給定一個縣的地塊圖層和城市邊界的圖層，總結每個城市邊界內的空地塊的平均值。

• 給定一層縣和一層道路，按道路類型匯總每個縣內道路的總裏程。

您可以將summarize_within 視為采用兩層並將它們堆疊在一起。其中一層，sum_within_layer 必須是一個多邊形層，並想象這些多邊形邊界都是紅色的。另一層 summary_layer 可以是任何要素類型的點、線或麵。將這些層堆疊在一起後，您向下查看堆棧並計算summary_layer 中落在具有紅色邊界的多邊形內的要素數量(sum_within_layer)。不僅可以統計特征的數量，還可以計算summary_layer中的特征屬性的簡單統計，例如sum、mean、minimum、maximum等。

Parameter	Description
sum_within_layer	必需 FeatureLayer 。多邊形特征。將匯總 summary_layer(如下)中落在這些多邊形邊界內的要素或要素部分。請參閱特征輸入。
summary_layer	必需 FeatureLayer 。將為 sum_within_layer 中的每個多邊形匯總的點、線或多邊形要素。請參閱特征輸入。
sum_shape	可選的布爾值。一個布爾值，指示任務根據 summary_layer 的形狀類型計算統計信息，例如 sum_within_layer 中每個多邊形內 summary_layer 的線的長度或多邊形的麵積。 默認值為真。
shape_units	可選字符串。當 sum_shape 設置為 true 時，指定單位以匯總長度或麵積。單位不需要匯總點。 當summary_layer 包含多邊形時：[‘Acres’, ‘Hectares’, ‘SquareMeters’, ‘SquareKilometers’, ‘SquareMiles’, ‘SquareYards’, ‘SquareFeet’] 當summary_layer 包含以下行時：[‘Meters’, ‘Kilometers’, ‘Feet’, ‘Yards’, ‘Miles’]
summary_fields	可選的字符串列表。您希望為 summary_layer 中的所有要素計算的字段名稱和統計匯總類型列表，這些要素位於 sum_within_layer 中的每個多邊形內。 示例：[“fieldname1 摘要”，“fieldname2 摘要”]
group_by_field	可選字符串。這是summary_layer 函數的一個字段，可用於分別計算每個唯一屬性值的統計數據。例如，假設 sum_within_layer 包含城市邊界，而 summary_layer 要素是地塊。包的字段之一是狀態，它包含兩個值：VACANT 和 OCCUPIED。要計算城市邊界內空置和占用地塊的總麵積，請使用狀態作為group_by_field 字段。
minority_majority	可選的布爾值。此布爾參數僅在指定 group_by_field 時適用。如果為真，則計算每個組字段的少數(最不占優勢)或多數(最占優勢)屬性值。 result_layer 中添加了兩個新字段，前綴為 Majority_ 和 Minority_。 默認值為假。
percent_shape	可選的布爾值。此布爾參數僅在指定 group_by_field 時適用。如果設置為 true，則會為每個 sum_within_layer 多邊形計算每個唯一 group_by_field 值的百分比。 默認值為假。
output_name	可選字符串或 FeatureLayer 。現有要素圖層將導致新圖層附加到要素服務。如果 overwrite 在上下文中為 True，則新層將覆蓋現有層。如果未指示output_name，則創建新的 FeatureCollection 。
context	可選字典。處理範圍和輸出空間參考等附加設置。對於summarize_within，有三個設置。 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}
estimate	可選的布爾值。如果為 True，將返回運行該操作的積分數。
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。
bin_type	必需的字符串。用於計算密度的 bin 類型。 選擇列表：[‘六邊形’，‘方形’]。
bin_size	所需的浮點數。將使用 input_layer 進行分析的 bin 的距離。生成 bin 時，對於 Square，指定的數量和單位決定了正方形的高度和長度。對於 Hexagon ，指定的數量和單位確定平行邊之間的距離。
bin_size_unit	必需的字符串。將為其計算密度的 bin 的距離單位。與 bin_size 中指定的值一起使用的線性單位。 默認值為“米”。

例子：

# USAGE EXAMPLE: To summarize traffic accidents within each county and group them by the day of accident.
acc_within_county = summarize_within(sum_within_layer=boundaries,
                                     summary_layer=collision_lyr,
                                     sum_shape=True,
                                     group_by_field='Day',
                                     minority_majority=True,
                                     percent_shape=True,
                                     output_name='summarize accidents within each county',
                                     context={"extent":{"xmin":-13160690.837046918,"ymin":4041586.5461609075,"xmax":-13132466.464352652,"ymax":4058001.397985127,"spatialReference":{"wkid":102100,"latestWkid":3857}}})