| Beschriftung | Erläuterung | Datentyp |
Eingabe-Polygone | Die Polygone, anhand derer die Features oder Teile von Features im Eingabe-Zusammenfassungs-Layer zusammengefasst werden. | Feature Layer |
Eingabe-Zusammenfassungs-Features | Die Punkt-, Linien- oder Polygon-Features, die für jedes Polygon in den Eingabe-Polygonen zusammengefasst werden. | Feature Layer |
Ausgabe-Feature-Class | Die Ausgabe-Polygon-Feature-Class, die dieselben Geometrien und Attribute wie die Eingabe-Polygone mit zusätzlichen neuen Attributen für die Anzahl von Punkten, die Länge von Linien und die Fläche von Polygonen in jedem Eingabe-Polygon sowie Statistiken zu diesen Features enthält. | Feature Class |
Alle Eingabe-Polygone beibehalten (optional) | Gibt an, ob alle Eingabe-Polygone oder nur diejenigen, die sich überschneiden oder mindestens ein Eingabe-Zusammenfassungs-Feature enthalten, in die Ausgabe-Feature-Class kopiert werden.
| Boolean |
Zusammenfassungsfelder (optional) | Eine Liste der Attributfeldnamen aus den Eingabe-Zusammenfassungs-Features sowie statistische Zusammenfassungstypen, die für diese Attributfelder für alle Punkte in jedem Polygon berechnet werden. Zusammenfassungsfelder müssen numerisch sein. Text und andere Attributfeldtypen werden nicht unterstützt. Es gibt folgende Statistiktypen:
| Value Table |
Shape-Zusammenfassungsattribute hinzufügen (optional) | Gibt an, ob der Ausgabe-Feature-Class Attribute für die Anzahl von Punkten, die Länge von Linien und die Fläche von Polygon-Features, die in jedem Eingabe-Polygon zusammengefasst werden, hinzufügt werden.
| Boolean |
Shape-Einheit (optional) | Gibt die Einheit an, die beim Berechnen der Shape-Zusammenfassungsattribute verwendet wird. 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 an. Wenn die Eingabe-Zusammenfassungs-Features Polygone sind, geben Sie eine Flächeneinheit an.
| String |
Gruppierungsfeld (optional) | Ein Attributfeld aus den Eingabe-Zusammenfassungs-Features, das für die Gruppierung verwendet wird. Features mit demselben Gruppenfeldwert werden kombiniert und mit anderen Features mit demselben Gruppenfeldwert zusammengefasst. Wenn ein Gruppenfeld angegeben wird, ist der Parameter Gruppierte Ausgabetabelle erforderlich. | Field |
Minderheits- und Mehrheitsattribute hinzufügen (optional) | Gibt an, ob der Ausgabe Minderheits- und Mehrheitsfelder hinzugefügt werden. Mit diesem Parameter können Sie ermitteln, welcher Gruppenfeldwert der Minderheit (geringste Dominanz) und welcher der Mehrheit (höchste Dominanz) in jedem Eingabe-Polygon entspricht. Dieser Parameter ist aktiv, wenn Sie einen Parameterwert für Gruppenfeld angegeben haben.
| Boolean |
Gruppenprozentsätze hinzufügen (optional) | Gibt an, ob der Ausgabe ein Prozentsatz-Attributfeld hinzugefügt wird. Mit diesem Parameter können Sie den Prozentsatz jedes Attributwertes in jeder Gruppe ermitteln. Dieser Parameter ist aktiv, wenn Sie einen Parameterwert für Gruppenfeld angegeben haben.
| Boolean |
Gruppierte Ausgabetabelle (optional) | 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:
Dieser Parameter ist erforderlich, wenn der Parameterwert Gruppenfeld angegeben ist. | Table |
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 der Polygone zu berechnen.
Es folgen Beispielszenarien mit Zusammenfassen (innerhalb):
- Wenn Sie über einen Layer mit Grenzen von Abflussgebieten und einen Layer mit Land-Use-Grenzen nach Land-Use-Typ verfügen, können Sie die Gesamtlandwirtschaftsfläche des Land-Use-Typs für jedes Abflussgebiet ermitteln.
- Wenn Sie über einen Layer mit Flurstücken in einem Landkreis und einen Layer mit Stadtgrenzen verfügen, können Sie den Durchschnittswert unbebauter Flurstücke innerhalb der Stadtgrenze zusammenfassen.
- Wenn Sie über einen Layer mit Landkreisen und einen Layer mit Straßen verfügen, können Sie die Gesamtzahl der Kilometer von Straßen nach Straßentyp in jedem Land zusammenfassen.
Abbildung
Verwendung
Stellen Sie sich die Option Zusammenfassen (innerhalb) als zwei Layer (die Eingabe-Polygone und die Eingabe-Zusammenfassungs-Features) vor, die übereinander gestapelt sind. Nachdem diese Layer gestapelt wurden, können Sie von oben durch den Stapel hindurchsehen und die Anzahl der Eingabe-Zusammenfassungs-Features, die sich in den Eingabe-Polygonen befinden, ermitteln. Sie können 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 sich konzeptuell ähnlich. Mit dem Werkzeug Zusammenfassen (innerhalb) können Features in vorhandenen Polygonen zusammengefasst werden. Mit dem Werkzeug Zusammenfassen (in der Nähe) können Sie Flächen um Punkte, Linien oder Polygone erstellen und Features in diesen abgeleiteten Flächen zusammenfassen.
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 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.
NULL-Werte sind von allen statistischen Berechnungen ausgeschlossen. Beispiel: Der Durchschnittswert von 10, 5 und einem NULL-Wert ist 7,5 ((10+5)/2).
Parameter
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})| Name | Erläuterung | 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 für die Anzahl von Punkten, die Länge von Linien und die Fläche von Polygonen in jedem Eingabe-Polygon sowie Statistiken zu diesen Features enthält. | Feature Class |
keep_all_polygons (optional) | Gibt an, ob alle Eingabe-Polygone oder nur diejenigen, die mindestens ein Eingabe-Zusammenfassungs-Feature 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 sowie statistische Zusammenfassungstypen, die für diese Attributfelder für alle Punkte in jedem Polygon berechnet werden. Zusammenfassungsfelder müssen numerisch sein. Text und andere Attributfeldtypen werden nicht unterstützt. Es gibt folgende Statistiktypen:
| Value Table |
sum_shape (optional) | Gibt an, ob der Ausgabe-Feature-Class Attribute für die Anzahl von Punkten, die Länge von Linien und die Fläche von Polygon-Features, die in jedem Eingabe-Polygon zusammengefasst werden, hinzufügt werden.
| Boolean |
shape_unit (optional) | Gibt die Einheit an, die beim Berechnen der Shape-Zusammenfassungsattribute verwendet wird. 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 an. Wenn die Eingabe-Zusammenfassungs-Features Polygone sind, geben Sie eine Flächeneinheit an.
| String |
group_field (optional) | Ein Attributfeld aus den Eingabe-Zusammenfassungs-Features, das für die Gruppierung verwendet wird. Features mit demselben Gruppenfeldwert werden kombiniert und mit anderen Features mit demselben Gruppenfeldwert zusammengefasst. Wenn ein Gruppenfeld angegeben wird, ist der Parameter out_grouped_table erforderlich. | Field |
add_min_maj (optional) | Gibt an, ob der Ausgabe Minderheits- und Mehrheitsfelder hinzugefügt werden. Mit diesem Parameter können Sie ermitteln, welcher Gruppenfeldwert der Minderheit (geringste Dominanz) und welcher der Mehrheit (höchste Dominanz) in jedem Eingabe-Polygon entspricht. Dieser Parameter ist aktiviert, wenn Sie einen Parameterwert für group_field angegeben haben.
| Boolean |
add_group_percent (optional) | Gibt an, ob der Ausgabe ein Prozentsatz-Attributfeld hinzugefügt wird. Mit diesem Parameter können Sie den Prozentsatz jedes Attributwertes in jeder Gruppe ermitteln. Dieser Parameter ist aktiviert, wenn Sie einen Parameterwert für group_field angegeben haben.
| Boolean |
out_group_table (optional) | 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:
Dieser Parameter ist erforderlich, wenn der Parameterwert group_field angegeben ist. | 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.analysis.SummarizeWithin('neighborhoods', 'crimes', 'neighborhood_crimes')Das folgende eigenständige Skript ist ein Beispiel für die Verwendung der Funktion SummarizeWithin in einer Skriptumgebung.
# 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.analysis.SummarizeWithin(polys, points, outFeatureClass, keepAll,
sumFields, addShapeSum, '', groupField,
addMinMaj, addPercents, outTable)Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja