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.

Es folgen Beispielszenarien mit Zusammenfassen (innerhalb):

  • Ermitteln Sie anhand eines Layers mit Grenzen von Abflussgebieten und eines Layers mit Land-Use-Grenzen nach Land-Use-Typ die Gesamtlandwirtschaftsfläche des Land-Use-Typs für jedes Abflussgebiet.
  • Fassen Sie anhand eines Layers mit Flurstücken in einem Landkreis und eines Layers mit Stadtgrenzen den Durchschnittswert unbebauter Flurstücke innerhalb der Stadtgrenzen zusammen.
  • Fassen Sie anhand eines Layers mit Landkreisen und eines Layers mit Straßen die Gesamtzahl der Kilometer von Straßen nach Straßentyp in jedem Landkreis zusammen.

Abbildung

Abbildung des Werkzeugs "Zusammenfassen (innerhalb)"

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.

  • Polygon-Zusammenfassungs-Features werden anhand der Flächenproportionen der Eingabe-Features zusammengefasst. Angenommen, ein Eingabe-Polygon überlagert ein Zusammenfassungspolygon um 1 Quadratkilometer. Wenn das Zusammenfassungspolygon 100 Quadratkilometer groß ist, fasst das Werkzeug 1/100 der numerischen Werte des Zusammenfassungspolygons zusammen. Um sicherzustellen, dass proportionale Berechnungen gültig sind, verwenden Sie Felder mit Anzahlen und Mengen statt mit Anteilen oder Verhältnissen.

  • 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

BeschriftungErläuterungDatentyp
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 enthält. Die Feature-Class enthält zusätzliche Attribute 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.

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 oder Mittelwert 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-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.

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

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.

  • MeterDie Einheit ist Meter.
  • KilometerDie Einheit ist Kilometer.
  • FußDie Einheit ist Fuß.
  • YardDie Einheit ist Yards.
  • MeilenDie Einheit ist Meilen.
  • AcresDie Einheit ist Acres.
  • HektarDie Einheit ist Hektar.
  • QuadratmeterDie Einheit ist Quadratmeter.
  • QuadratkilometerDie Einheit ist Quadratkilometer.
  • QuadratfußDie Einheit ist Quadratfuß.
  • QuadratyardDie Einheit ist Quadratyards.
  • QuadratmeilenDie 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 Parameterwert 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 Zusammenfassungsfeld
  • Ein Prozentsatz-Feld.

Dieser Parameter ist erforderlich, wenn der Parameterwert Gruppenfeld angegeben ist.

Table

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})
NameErläuterungDatentyp
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 enthält. Die Feature-Class enthält zusätzliche Attribute 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.

Feature Class
keep_all_polygons
(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.

  • KEEP_ALLAlle Eingabe-Polygone werden in die Ausgabe-Feature-Class kopiert. Dies ist die Standardeinstellung.
  • ONLY_INTERSECTINGNur 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 oder Mittelwert 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-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.

  • ADD_SHAPE_SUMShape-Zusammenfassungsattribute werden der Ausgabe-Feature-Class hinzugefügt. Dies ist die Standardeinstellung.
  • NO_SHAPE_SUMShape-Zusammenfassungsattribute werden der Ausgabe-Feature-Class nicht hinzugefügt.
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.

  • METERSDie Einheit ist Meter.
  • KILOMETERSDie Einheit ist Kilometer.
  • FEETDie Einheit ist Fuß.
  • YARDSDie Einheit ist Yards.
  • MILESDie Einheit ist Meilen.
  • ACRESDie Einheit ist Acres.
  • HECTARESDie Einheit ist Hektar.
  • SQUAREMETERSDie Einheit ist Quadratmeter.
  • SQUAREKILOMETERSDie Einheit ist Quadratkilometer.
  • SQUAREFEETDie Einheit ist Quadratfuß.
  • SQUAREYARDSDie Einheit ist Quadratyards.
  • SQUAREMILESDie 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 Parameterwert 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_MAJDer Ausgabe werden keine Minderheits- und Mehrheitsfelder hinzugefügt. Dies ist die Standardeinstellung.
  • ADD_MIN_MAJDer 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_PERCENTDer Ausgabe wird kein Prozentsatz-Attributfeld hinzugefügt. Dies ist die Standardeinstellung.
  • ADD_PERCENTDer 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 Zusammenfassungsfeld
  • Ein 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)

Lizenzinformationen

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

Verwandte Themen