Zusammenfassen (innerhalb) (Analysis)

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.

Beispielszenarien mit Zusammenfassen (innerhalb):

• Anhand eines Layers mit Grenzen von Wassereinzugsgebieten und eines Layers mit Grenzen von Landnutzungsflächen nach Landnutzungstyp die Gesamtlandwirtschaftsfläche des Landnutzungstyps für jedes Wassereinzugsgebiet ermitteln.
• Den durchschnittlichen Grundstückswert unbebauter Flurstücke je Stadt anhand eines Flurstücks-Layers in einem Landkreis und eines Stadtgrenzen-Layers zusammenfassen.
• 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

• 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, 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 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 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.

Parameter

Dialogfeld

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. Aktiviert: Alle Eingabe-Polygone werden in die Ausgabe-Feature-Class kopiert. Dies ist die Standardeinstellung. Deaktiviert: Nur Eingabe-Polygone, die sich überschneiden oder mindestens ein Eingabe-Zusammenfassungs-Feature enthalten, werden in die Ausgabe-Feature-Class kopiert.	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: Summe: Der Gesamtwert aller Punkte in jedem Polygon wird berechnet. Mittelwert: Der Durchschnitt aller Punkte in jedem Polygon wird berechnet. Min: Der kleinste Wert aller Punkte in jedem Polygon wird bestimmt. Max: Der größte Wert aller Punkte in jedem Polygon wird bestimmt. StdAbw: Die Standardabweichung aller Punkte in jedem Polygon wird berechnet.	Value Table
Shape-Zusammenfassungsattribute hinzufügen (optional)	Gibt an, ob der Ausgabe 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. Aktiviert: Shape-Zusammenfassungsattribute werden der Ausgabe-Feature-Class hinzugefügt. Dies ist die Standardeinstellung. Deaktiviert: Shape-Zusammenfassungsattribute werden der Ausgabe-Feature-Class nicht hinzugefügt.	Boolean
Shape-Einheit (optional)	Die Einheit, 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. Meter—Die Einheit ist Meter. Kilometer—Die Einheit ist Kilometer. Fuß—Die Einheit ist Fuß. Yard—Die Einheit ist Yards. Meilen—Die Einheit ist Meilen. Acres—Die Einheit ist Acres. Hektar—Die Einheit ist Hektar. Quadratmeter—Die Einheit ist Quadratmeter. Quadratkilometer—Die Einheit ist Quadratkilometer. Quadratfuß—Die Einheit ist Quadratfuß. Quadratyard—Die Einheit ist Quadratyards. Quadratmeilen—Die Einheit ist Quadratmeilen.	String
Gruppenfeld (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. Deaktiviert: Der Ausgabe werden keine Minderheits- und Mehrheitsfelder hinzugefügt. Dies ist die Standardeinstellung. Aktiviert: Der Ausgabe werden Minderheits- und Mehrheitsfelder hinzugefügt.	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. Deaktiviert: Der Ausgabe wird kein Prozentsatz-Attributfeld hinzugefügt. Dies ist die Standardeinstellung. Aktiviert: Der Ausgabe wird ein Prozentsatz-Attributfeld hinzugefügt.	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: Join_ID: Eine ID, die einem ID-Feld entspricht, das der Ausgabe-Feature-Class hinzugefügt wurde. Das Gruppenfeld. Ein Shape-Zusammenfassungsfeld. Ein Feld für jedes der Zusammenfassungsfelder. Prozentsatz-Feld. Dieser Parameter ist erforderlich, wenn der Parameterwert Gruppenfeld angegeben ist.	Table

Python

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 einen Eingabe-Punkt enthalten, in die Ausgabe-Feature-Class kopiert werden. KEEP_ALL—Alle Eingabe-Polygone werden in die Ausgabe-Feature-Class kopiert. Dies ist die Standardeinstellung. ONLY_INTERSECTING—Nur Eingabe-Polygone, die sich überschneiden oder mindestens ein Eingabe-Zusammenfassungs-Feature enthalten, werden in die Ausgabe-Feature-Class kopiert.	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: Summe: Der Gesamtwert aller Punkte in jedem Polygon wird berechnet. Mittelwert: Der Durchschnitt aller Punkte in jedem Polygon wird berechnet. Min: Der kleinste Wert aller Punkte in jedem Polygon wird bestimmt. Max: Der größte Wert aller Punkte in jedem Polygon wird bestimmt. StdAbw: Die Standardabweichung aller Punkte in jedem Polygon wird berechnet.	Value Table
sum_shape (optional)	Gibt an, ob der Ausgabe 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. ADD_SHAPE_SUM—Shape-Zusammenfassungsattribute werden der Ausgabe-Feature-Class hinzugefügt. Dies ist die Standardeinstellung. NO_SHAPE_SUM—Shape-Zusammenfassungsattribute werden der Ausgabe-Feature-Class nicht hinzugefügt.	Boolean
shape_unit (optional)	Die Einheit, 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. METERS—Die Einheit ist Meter. KILOMETERS—Die Einheit ist Kilometer. FEET—Die Einheit ist Fuß. YARDS—Die Einheit ist Yards. MILES—Die Einheit ist Meilen. ACRES—Die Einheit ist Acres. HECTARES—Die Einheit ist Hektar. SQUAREMETERS—Die Einheit ist Quadratmeter. SQUAREKILOMETERS—Die Einheit ist Quadratkilometer. SQUAREFEET—Die Einheit ist Quadratfuß. SQUAREYARDS—Die Einheit ist Quadratyards. SQUAREMILES—Die Einheit ist Quadratmeilen.	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. NO_MIN_MAJ—Der Ausgabe werden keine Minderheits- und Mehrheitsfelder hinzugefügt. Dies ist die Standardeinstellung. ADD_MIN_MAJ—Der Ausgabe werden Minderheits- und Mehrheitsfelder hinzugefügt.	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. NO_PERCENT—Der Ausgabe wird kein Prozentsatz-Attributfeld hinzugefügt. Dies ist die Standardeinstellung. ADD_PERCENT—Der Ausgabe wird ein Prozentsatz-Attributfeld hinzugefügt.	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: Join_ID: Eine ID, die einem ID-Feld entspricht, das der Ausgabe-Feature-Class hinzugefügt wurde. Das Gruppenfeld. Ein Shape-Zusammenfassungsfeld. Ein Feld für jedes der Zusammenfassungsfelder. Prozentsatz-Feld. Dieser Parameter ist erforderlich, wenn der Parameterwert group_field angegeben ist.	Table

Codebeispiel

SummarizeWithin: Beispiel 1 (Python-Fenster)

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')

SummarizeWithin: Beispiel 2 (eigenständiges Skript)

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

Ausgabe-Koordinatensystem, Ausdehnung, Aktueller Workspace, Scratch-Workspace, Ausgabe hat Z-Werte, Z-Auflösung, Standard-Ausgabe-Z-Wert, Geographische Transformationen, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, XY-Auflösung, XY-Toleranz, Z-Toleranz

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja