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

Zusammenfassen (innerhalb)

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})
ParameterErklärungDatentyp
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.

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

  • Summe: Addiert den Gesamtwert aller Punkte in jedem Polygon.
  • Mittelwert: Berechnet den Durchschnitt aller Punkte in jedem Polygon.
  • Min: Sucht den kleinsten Wert aller Punkte in jedem Polygon.
  • Max: Sucht den größten Wert aller Punkte in jedem Polygon.
  • Standardabw.: Sucht die Standardabweichung aller Punkte in jedem Polygon.

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.

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

  • METERSMeter
  • KILOMETERSKilometer
  • FEETFuß
  • YARDSYards
  • MILESMeilen
  • ACRESAcres
  • HECTARESHektar
  • SQUAREMETERSQuadratmeter
  • SQUAREKILOMETERSQuadratkilometer
  • SQUAREFEETQuadratfuß
  • SQUAREYARDSQuadratyard
  • SQUAREMILESQuadratmeilen
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.

  • NO_MIN_MAJDer Ausgabe werden weder Minderheits- noch Mehrheitsfelder hinzugefügt. Dies ist die Standardeinstellung.
  • ADD_MIN_MAJDer Ausgabe werden Minderheits- und Mehrheitsfelder hinzugefügt.
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.

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

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:

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

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.SummarizeWithin_analysis('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 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)

Lizenzinformationen

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

Verwandte Themen