Zusammenfassung
Überlagert einen Polygon-Layer mit einem anderen Layer, um die Anzahl der Punkte, die Länge der Linien oder die Fläche der Polygone in jedem Polygon zusammenzufassen und Attributfeldstatistiken zu den Features innerhalb des Polygons zu berechnen.
Beispielszenarien mit Zusammenfassen (innerhalb):
- Anhand eines Layers mit Grenzen von Abflussgebieten und eines Layers mit Grenzen von Landnutzungsflächen nach Landnutzungstyp die Gesamtlandwirtschaftsfläche des Landnutzungstyps für jedes Abflussgebiet ermitteln.
- Fassen Sie anhand eines Flurstücks-Layers in einem Landkreis und eines Stadtgrenzen-Layers den durchschnittlichen Grundstückswert unbebauter Flurstücke je Stadt zusammen.
- Die Gesamtzahl der Kilometer von Straßen nach Straßentyp in jedem Land anhand eines Layers mit Landkreisen und eines Layers mit Straßen zusammenfassen.
Abbildung
Verwendung
Sie können sich die Option Zusammenfassen (innerhalb) als zwei Layer, die Eingabe-Polygone und die Eingabe-Zusammenfassungs-Features, vorstellen, die übereinander gestapelt sind. Nachdem diese Layer gestapelt wurden, sehen Sie von oben durch den Stapel hindurch und ermitteln die Anzahl der Eingabe-Zusammenfassungs-Features, die sich in den Eingabe-Polygonen befinden. Sie können nicht nur die Anzahl der Features ermitteln, sondern auch einfache Statistiken zu den Attributen der Eingabe-Zusammenfassungs-Features berechnen, z. B. "Summe", "Mittelwert", "Minimum", "Maximum" usw.
Die Werkzeuge Zusammenfassen (innerhalb) und Zusammenfassen (in der Nähe) sind konzeptuell ähnlich. Mit dem Werkzeug Zusammenfassen (innerhalb) können Features in vorhandenen Polygonen zusammengefasst werden, wohingegen mit dem Werkzeug Zusammenfassen (in der Nähe) Flächen um Punkte, Linien oder Polygone erstellt und Features in diesen abgeleiteten Flächen zusammengefasst werden können.
Sie können Gruppen erstellen, indem Sie ein Gruppenfeld aus den Eingabepunkten festlegen. Wenn Sie beispielsweise Straftaten innerhalb von Nachbarschaftsgrenzen zusammenfassen, verfügen Sie möglicherweise über das Attribut Crime_type mit fünf verschiedenen Arten von Straftaten. Jede Art von Straftat bildet eine Gruppe und die Statistiken, die Sie auswählen, werden für jeden Einzelwert von Crime_type berechnet.
Syntax
arcpy.analysis.SummarizeWithin(in_polygons, in_sum_features, out_feature_class, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {out_group_table})| Parameter | Erklärung | Datentyp |
in_polygons | Die Polygone, anhand derer die Features oder Teile von Features im Eingabe-Zusammenfassungs-Layer zusammengefasst werden. | Feature Layer |
in_sum_features | Die Punkt-, Linien- oder Polygon-Features, die für jedes Polygon in den Eingabe-Polygonen zusammengefasst werden. | Feature Layer |
out_feature_class | Die Ausgabe-Polygon-Feature-Class, die dieselben Geometrien und Attribute wie die Eingabe-Polygone mit zusätzlichen neuen Attributen zu der Anzahl von Punkten, der Länge von Linien und der Fläche von Polygonen in jedem Eingabe-Polygon sowie Statistiken zu diesen Features enthält. | Feature Class |
keep_all_polygons (optional) | Legt fest, ob alle Eingabe-Polygone oder nur diejenigen, die mindestens einen Eingabe-Punkt enthalten, in die Ausgabe-Feature-Class kopiert werden.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (optional) | Eine Liste der Attributfeldnamen aus den Eingabe-Zusammenfassungs-Features und statistische Zusammenfassungstypen, die Sie für diese Attributfelder für alle Punkte in jedem Polygon berechnen möchten. Zusammenfassungsfelder müssen numerisch sein. Text und andere Attributfeldtypen werden nicht unterstützt. Zu den Statistiktypen zählen die folgenden:
| Value Table |
sum_shape (optional) | Legt fest, ob die Ausgabe-Feature-Class Attribute für die Anzahl von Punkten, die Länge von Linien oder die Fläche von Polygon-Features enthält, die in jedem Polygon zusammengefasst werden.
| Boolean |
shape_unit (optional) | Die Einheit, in der Shape-Zusammenfassungsattribute berechnet werden. Wenn die Eingabe-Zusammenfassungs-Features Punkte sind, ist keine Shape-Einheit erforderlich, da nur die Anzahl der Punkte in jedem Eingabe-Polygon hinzugefügt wird. Wenn die Eingabe-Zusammenfassungs-Features Linien sind, geben Sie eine lineare Einheit ein. Wenn die Eingabe-Zusammenfassungs-Features Polygone sind, geben Sie eine Flächeneinheit ein.
| String |
group_field (optional) | Attributfelder aus den Eingabe-Zusammenfassungs-Features, die für die Gruppierung verwendet werden. Features mit demselben Gruppenfeldwert werden kombiniert und mit anderen Features mit demselben Gruppenfeldwert zusammengefasst. Wenn Sie ein Gruppenfeld auswählen, wird eine zusätzliche gruppierte Ausgabetabelle erstellt, deren Speicherort im Parameter out_grouped_table angegeben werden muss. | Field |
add_min_maj (optional) | Diese Option ist nur aktiviert, wenn Sie ein Gruppenfeld ausgewählt haben. Sie ermöglicht es Ihnen, zu ermitteln, welcher Gruppenfeldwert der Minderheit (geringste Dominanz) und welcher der Mehrheit (höchste Dominanz) in jedem Eingabe-Polygon entspricht.
| Boolean |
add_group_percent (optional) | Diese Option ist nur aktiviert, wenn Sie ein Gruppenfeld ausgewählt haben. Sie ermöglicht es Ihnen, den Prozentsatz jedes Attributwertes in jeder Gruppe zu ermitteln.
| Boolean |
out_group_table (optional) | Wenn ein Gruppenfeld angegeben wird, ist eine gruppierte Ausgabetabelle erforderlich. Eine Ausgabetabelle, die alle Zusammenfassungsfelder für jede Gruppe von Zusammenfassungs-Features für jedes Eingabe-Polygon enthält. Die Tabelle enthält die folgenden Attributfelder:
| Table |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion SummarizeWithin verwenden.
import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.SummarizeWithin_analysis('neighborhoods', 'crimes', 'neighborhood_crimes')Das folgende eigenständige Skript ist ein Beispiel für die Verwendung der Funktion SummarizeWithin in einer Scripting-Umgebung.
# Description: Use SummarizeWithin to summarize the crimes in each city neighborhood
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data/city.gdb'
# Set local variables
polys = 'neighborhoods'
points = 'crimes'
outFeatureClass = 'crimes_aggregated'
keepAll = 'KEEP_ALL'
sumFields = [['Damages', 'SUM'], ['VICTIM_AGE', 'MEAN']]
addShapeSum = 'ADD_SHAPE_SUM'
groupField = 'Crime_type'
addMinMaj = 'ADD_MIN_MAJ'
addPercents = 'ADD_PERCENT'
outTable = 'crimes_aggregated_groups'
arcpy.SummarizeWithin_analysis(polys, points, outFeatureClass, keepAll,
sumFields, addShapeSum, '', groupField,
addMinMaj, addPercents, outTable)Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja