| Beschriftung | Erläuterung | Datentyp |
Zusammenfassungs-Layer |
Die Punkt-, Linien- oder Polygon-Features, die entweder nach Polygonen oder Abschnitten zusammengefasst werden. | Feature Layer |
Ausgabe-Feature-Class | Der Name der Ausgabe-Feature-Class, die die sich schneidenden Geometrien und Attribute enthält. | Feature Class |
Polygon oder Abschnitt | Legt fest, ob der Zusammenfassungs-Layer nach Polygonen oder Abschnitten zusammengefasst wird.
| String |
Abschnittstyp | Gibt die Abschnittsform an, die zur Zusammenfassung von Features generiert wird.
| String |
Abschnittsgröße (optional) | Das Entfernungsintervall, das die Abschnittsgröße und die Einheiten darstellt, mit der die Eingabe-Features zusammengefasst werden. | Linear Unit |
Zusammenfassungspolygone (optional) | Die Polygone, mit denen die Features im Eingabe-Zusammenfassungs-Layer zusammengefasst werden. | Feature Layer |
Shape-Zusammenfassungsattribute hinzufügen | Gibt an, ob die Länge von Linien oder die Fläche von Polygonen innerhalb des Zusammenfassungs-Layers (Polygon oder Abschnitt) berechnet wird. Die Anzahl der Punkte, Linien und Polygone, die das Zusammenfassungs-Shape schneiden, werden immer einbezogen.
| Boolean |
Shape-Einheiten (optional) | Gibt die Einheit an, in der Shape-Zusammenfassungsattribute berechnet werden. Wenn die Eingabe-Zusammenfassungs-Features Punkte sind, ist eine Shape-Einheit nicht erforderlich, da nur die Anzahl der Punkte in jedem Eingabe-Polygon addiert 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 |
Nach Feld gruppieren (optional) | Ein Feld aus den Eingabe-Zusammenfassungs-Features, mit dem Statistiken für jeden eindeutigen Attributwert berechnet werden. Angenommen, die Eingabe-Zusammenfassungs-Features enthalten Punktpositionen von Unternehmen, die Gefahrgüter lagern, und es ist das Feld HazardClass vorhanden, das den Code für den Typ des gelagerten Gefahrguts enthält. Um Zusammenfassungen für alle Einzelwerte von HazardClass zu berechnen, verwenden Sie dieses Feld als Feld für die Gruppierung. | Field |
Standardzusammenfassungsfelder (optional) | Die Statistiken, die für bestimmte Felder berechnet werden. Gibt an, ob ein Feld eine Anzahl oder einen Anteil darstellt.
| Value Table |
Gewichtete Zusammenfassung – Felder (optional) | Gibt die Statistiken an, die für bestimmte Felder berechnet werden. Gibt an, ob ein Feld eine Anzahl oder einen Anteil darstellt.
| Value Table |
Minderheits- und Mehrheitsattribute hinzufügen (optional) | Gibt an, ob die Attributwerte für die Minderheit (geringste Dominanz) oder die Mehrheit (höchste Dominanz) für alle Gruppenfelder in allen Grenzen hinzugefügt werden. Falls ja, werden dem Ausgabe-Layer zwei neue Felder mit dem Präfix "Mehrheit_" und "Minderheit_" hinzugefügt. Dieser Parameter gilt nur, wenn der Parameter Nach Feld gruppieren verwendet wird.
| Boolean |
Gruppenprozentsätze hinzufügen (optional) | Gibt an, ob Felder mit Prozentsätzen hinzugefügt werden. Ist dies der Fall, wird für jedes Eingabe-Polygon der Prozentsatz für jede einzelne Gruppe berechnet. Dieser Parameter gilt nur, wenn die Parameter Nach Feld gruppieren und Minderheits- und Mehrheitsattribute hinzufügen verwendet werden.
| Boolean |
Tabelle "Gruppieren nach Zusammenfassung" (optional) | Die Ausgabetabelle, die die zusammengefassten Gruppen enthält. | 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 berechnet Attributfeldstatistiken zu den Features innerhalb des Polygons.
Es folgen Beispielszenarien mit Zusammenfassen (innerhalb):
- Anhand von Grenzen von Abflussgebieten und von Grenzen von Landnutzungsflächen nach Landnutzungstyp die Gesamtlandwirtschaftsfläche des Landnutzungstyps für jedes Abflussgebiet ermitteln.
- Anhand von Flurstücken in einem Landkreis und Stadtgrenzen den Durchschnittswert unbebauter Flurstücke innerhalb der Stadtgrenze zusammenfassen.
- Die Gesamtzahl der Kilometer von Straßen nach Straßentyp in jedem Land anhand von Landkreisen und Straßen zusammenfassen.
Abbildung
Verwendung
Sie können sich die Option Zusammenfassen (innerhalb) einfach 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 auch einfache Statistiken zu Attributen der Eingabe-Punkt-Features wie "Summe", "Durchschnitt", "Minimum", "Maximum" und "Standardabweichung" berechnen.
Mit der Option Zusammenfassen (innerhalb) können Sie Standardstatistiken und geographisch gewichtete Statistiken berechnen. Standardstatistiken fassen die statistischen Werte ohne Gewichtung zusammen. Gewichtete Statistiken berechnen Werte anhand der geographisch gewichteten Attribute von Linien innerhalb eines Polygons oder der Attribute von Polygonen innerhalb eines Polygons. Gewichtete Statistiken gelten nicht für Punkte innerhalb von Polygonen.
Für Attribute, die eine Anzahl oder einen Anteil darstellen, können Standardstatistiken und geographisch gewichtete Statistiken berechnet werden. Diese sind wie folgt definiert:
- Anzahl: Attribute, die eine Summe oder Menge einer Entität an einer Punktposition, entlang einer Linie oder innerhalb eines Polygons darstellen. Beispiele für Attribute vom Typ "Anzahl" sind die Bevölkerung eines Landes, die Häufigkeit, mit der Taxis in einem Zählblock genutzt werden, und die Anzahl der Dämme entlang eines Flusses. Bei Linien- und Polygon-Features wird die Anzahl vor dem Berechnen von Standardstatistiken oder gewichteten Statistiken proportioniert.
- Anteil: Attribute, die ein Verhältnis oder einen Index an einer Punktposition, entlang einer Linie oder innerhalb eines Polygons darstellen. Beispiele für Attribute vom Typ "Anteil" sind die Bevölkerungsdichte eines Landes, die für eine Straße geltende Geschwindigkeitsbegrenzung oder die Bewertung der fußläufigen Erreichbarkeit in einem Stadtviertel. Anteile werden nicht proportioniert.
Bei Attributen vom Typ "Anzahl" werden Werte vor dem Berechnen von Statistiken entsprechend dem Anteil der Linie innerhalb eines Polygons oder dem Anteil des Polygon innerhalb eines anderen Polygons proportioniert. Wenn es sich bei den Zusammenfassungs-Features um Punkte handelt, werden Statistiken für Attribute vom Typ "Anzahl" und für Attribute vom Typ "Anteil" gleich berechnet.
Sie können die Längen und Flächen der Zusammenfassungs-Layer in den einzelnen Polygonen mithilfe der Optionen in der folgenden Tabelle berechnen. Welche Optionen verfügbar sind, hängt von der Geometrie des Zusammenfassungs-Layers ab.
Eingabe-Features Beschreibung Option Punkte
Die Anzahl der zusammengefassten Punkte in den einzelnen Polygonen
Keine
Linien
Die Länge der zusammengefassten Linien in den einzelnen Polygonen
- Meilen
- Yard
- Fuß
- Kilometer
- Meter
Flächen
Die Fläche der zusammengefassten Polygone in den einzelnen Polygonen
- Quadratmeilen
- Quadratyards
- Quadratfuß
- Quadratkilometer
- Quadratmeter
- Hektar
- Acres
Für Linien und Flächen werden sämtliche gewichteten Statistiken berechnet. Für die standardmäßigen Zusammenfassungsfeldstatistiken wie auch die gewichteten Zusammenfassungsfeldstatistiken gilt: Die Anwendung erfolgt auf Daten für die Features im Parameter Zusammenfassungs-Layer, die den Layer Zusammenfassungspolygone schneiden. Die gewichteten Zusammenfassungsfeldstatistiken werden mit einer Gewichtung multipliziert, die auf der Proportion der Features im Parameter Zusammenfassungspolygone basiert, die die einzelnen Features im Parameter Zusammenfassungs-Layer schneiden.
Für Standardstatistiken sind acht Optionen verfügbar: "Anzahl", "Summe", "Mittelwert", "Minimum", "Maximum", "Bereich", "Standardabweichung" und "Varianz". Für Zeichenfolgenstatistiken werden zwei Optionen bereitgestellt: "Anzahl" und "Alle". Für numerische Felder in dem Layer, der zusammengefasst werden soll, werden drei gewichtete Statistiken berechnet: "Mittelwert", "Standardabweichung" und "Varianz".
Gewichtete Statistiken werden nicht für Zeichenfolgendaten berechnet. Jedes Mal, wenn die Werte Feld und Statistik angegeben werden, wird dem Werkzeugbereich eine Zeile hinzugefügt, sodass mehrere Statistiken berechnet werden können. Die zusammengefassten Ergebnisse werden in der Tabelle oder den Pop-ups des Ergebnis-Layers angezeigt. Standardmäßig wird stets die Anzahl der Features, die die Werte Zusammenfassungspolygone schneiden, berechnet.
Für Analysen mit Diskretisierung ist es erforderlich, dass die Eingabe projiziert oder das Ausgabe-Koordinatensystem auf ein projiziertes Koordinatensystem festgelegt wird. Wenn sich die Daten nicht in einem projizierten Koordinatensystem befinden und Sie keines einrichten, wird eine Projektion anhand der Ausdehnung der analysierten Daten verwendet.
Optional kann ein Nach Feld gruppieren-Wert ausgewählt werden, damit Statistiken für jeden einzelnen Attributwert separat berechnet werden. Wenn ein Nach Feld gruppieren-Wert ausgewählt wurde, wird eine Summentabelle erstellt, in der jedes Feature und jede Statistik nach dem Wert im Feld zum Nach Feld gruppieren aufgelistet ist.
Die Parameter Minderheits- und Mehrheitsattribute hinzufügen und Gruppenprozentsätze hinzufügen sind verfügbar, wenn ein Gruppieren nach-Wert ausgewählt wurde. Die Minderheit und Mehrheit ist jeweils der geringste bzw. dominanteste Wert des Parameters Nach Feld gruppieren, wobei die Dominanz mittels der Anzahl der Punkte, der Gesamtlänge oder der Gesamtfläche jedes Wertes bestimmt wird.
Wenn der Parameter Minderheits- und Mehrheitsattribute hinzufügen aktiviert ist, werden dem Ergebnis-Layer zwei Felder hinzugefügt. In den Feldern werden die Werte aus dem Parameter Nach Feld gruppieren aufgelistet, die die Minderheit und Mehrheit für jedes Ergebnis-Feature darstellen.
Der Parameter Gruppenprozentsätze hinzufügen ist nur verfügbar, wenn Minderheits- und Mehrheitsattribute hinzufügen aktiviert ist. Wenn der Parameter Gruppenprozentsätze hinzufügen aktiviert ist, werden dem Ergebnis-Layer zwei Felder hinzugefügt, in denen der Prozentsatz der Punktanzahl, der Gesamtlänge oder der Gesamtfläche aufgelistet ist, die zu den Minderheits- oder Mehrheitswerten für jedes Feature gehören. Der Ergebnistabelle wird außerdem ein Prozentsatzfeld hinzugefügt, in dem der Prozentsatz der Punktanzahl, der Gesamtlänge oder der Gesamtfläche aufgelistet ist, der zu allen Werten aus dem Parameter Nach Feld gruppieren des jeweiligen Features gehört.
Der Ausgabe-Feature-Layer ist immer ein Polygon-Layer. Es werden nur Polygone zurückgegeben, die einen Zusammenfassungs-Layer überschneiden. Andere Polygone werden vollständig aus dem Ergebnis-Layer entfernt.
Es werden die Eingabepunkt- und Polygon-Features (erste Abbildung) und die resultierenden Flächen-Features (zweite Abbildung) gezeigt. Folgende Felder sind in den Ausgabe-Polygon-Features enthalten:
Feldname Beschreibung count Die Anzahl der zusammengefassten Features, die die einzelnen Polygon-Layer überschneiden.
sum_length_<linearunit>oder sum_area_<areaunit>
Die Gesamtlänge der Linien im Polygon oder die Gesamtfläche der zusammengefassten Polygone in den einzelnen Polygonen. Diese Werte werden in der angegebenen Einheit zurückgegeben, wenn Shape-Zusammenfassungsattribute hinzufügen aktiviert ist.
statistic_<fieldname>
Für angegebene Statistiken wird jeweils ein Attributfeld erstellt, für das ein Name im folgenden Format festgelegt wird: <Statistik>_<Feldname>. Die maximale Abweichung und die Standardabweichung des id-Feldes lauten MAX_id bzw. SD_id.
pstatistic_<fieldname>
Für angegebene gewichtete Statistiken wird jeweils ein Attributfeld erstellt, für das ein Name im folgenden Format festgelegt wird: p<Statistik>_<Feldname>. Das gewichtete Maximum für das Feld id lautet beispielsweise pMAX_id.
minority_<fieldname>
Dieser Wert wird zurückgegeben, wenn Sie eine Gruppieren-nach-Tabelle erstellen und Minderheits- und Mehrheitsattribute hinzufügen aktiviert ist. Er stellt die Werte für das angegebene Feld dar, das der Minderheit in den einzelnen Polygonen entspricht. In einem Polygon sind fünf Punkte mit einem Feld namens color und den Werten "Rot", "Blau", "Blau", "Grün", "Grün" vorhanden. Wenn Sie eine Gruppe nach dem Feld color erstellen, lautet der Wert für das Feld minority_color "Rot".
majority_<fieldname>
Dieser Wert wird zurückgegeben, wenn Sie eine Gruppieren-nach-Tabelle erstellen und Minderheits- und Mehrheitsattribute hinzufügen aktiviert ist. Er stellt die Werte für das angegebene Feld dar, das der Mehrheit in den einzelnen Polygonen entspricht. In einem Polygon sind fünf Punkte mit einem Feld namens color und den Werten "Rot", "Blau", "Blau", "Grün", "Grün" vorhanden. Wenn Sie eine Gruppe nach dem Feld color erstellen, lautet der Wert für das Feld minority_color "Blau;Grün".
minority_<fieldname>_percent
Dieser Wert wird zurückgegeben, wenn Sie eine Gruppieren-nach-Tabelle erstellen und Gruppenprozentsätze hinzufügen aktiviert ist. Er stellt die Prozentsätze der Anzahl für das angegebene Feld dar, das der Minderheit in den einzelnen Polygonen entspricht. In einem Polygon sind fünf Punkte mit einem Feld namens color und den Werten "Rot", "Blau", "Blau", "Grün", "Grün" vorhanden. Wenn Sie eine Gruppe nach dem Feld color erstellen, lautet der Wert für das Feld minority_color_percent "20" (berechnet als 1/5).
majority_<fieldname>_percent
Dieser Wert wird zurückgegeben, wenn Sie eine Gruppieren-nach-Tabelle erstellen und Gruppenprozentsätze hinzufügen aktiviert ist. Er stellt die Prozentsätze der Anzahl für das angegebene Feld dar, das der Mehrheit in den einzelnen Polygonen entspricht. In einem Polygon sind fünf Punkte mit einem Feld namens color und den Werten "Rot", "Blau", "Blau", "Grün", "Grün" vorhanden. Wenn Sie eine Gruppe nach dem Feld color erstellen, lautet der Wert für das Feld majority_color_percent "40" (berechnet als 2/5).
join_id
Dieser Wert wird zurückgegeben, wenn Sie eine Gruppieren-nach-Tabelle erstellen. Hierbei handelt es sich um eine ID zum Verknüpfen von Features mit der Gruppieren-nach-Tabelle. Jedes join_id-Feld entspricht mindestens einer Zeile in der Gruppieren-nach-Tabelle.
Die Gruppieren-nach-Ausgabetabelle enthält die folgenden Felder:
Feldname Beschreibung join_id
Hierbei handelt es sich um eine ID zum Verknüpfen von Features mit dem Polygon-Layer. Jedes Polygon enthält mindestens ein Feature mit derselben ID, die alle Gruppieren-nach-Werte darstellt. In einem Polygon sind fünf Punkte mit einem Feld namens color und den Werten "Rot", "Blau", "Blau", "Grün", "Grün" vorhanden. Die Gruppieren-nach-Tabelle enthält drei Zeilen, die dieses Polygon darstellen (dieselbe Join-ID), jeweils eine Zeile für die Farben Rot, Blau und Grün.
count
Die Anzahl der angegebenen Gruppen im verbundenen Polygon. Rot ist beispielsweise 1 für das ausgewählte Polygon.
<statistic>_<fieldname>
Eine angegebene Statistik, die für jede Gruppe berechnet wird.
p<statistic>_<fieldname>
Eine angegebene gewichtete Statistik, die für jede Gruppe berechnet wird.
percentcount
Der Prozentsatz, den jede Gruppe zur Gesamtzahl im Polygon beiträgt. Im obigen Beispiel trägt Rot 1/5 = 20, Blau 2/5 = 40 und Grün 2/5 = 20 bei.
Mithilfe der folgenden Angaben können Sie die Performance des Werkzeugs Zusammenfassen (innerhalb) verbessern:
- Legen Sie die Ausdehnungsumgebung fest, sodass nur Daten von Interesse analysiert werden.
- Größere Abschnitte sind leistungsfähiger als kleinere Abschnitte. Wenn Sie Abschnitte verwenden, sich hinsichtlich der Größe jedoch nicht sicher sind, beginnen Sie mit einem größeren Abschnitt.
- Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.
Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Bei Analysen auf Ihrem Desktop-Computer werden mehrere Kerne parallel verwendet. Weitere Informationen über die Ausführung der Analyse finden Sie unter Überlegungen zu GeoAnalytics Desktop-Werkzeugen.
Bei der Ausführung von GeoAnalytics Desktop-Werkzeugen wird die Analyse auf Ihrem Desktop-Computer durchgeführt. Für eine optimale Performance sollten die Daten auf Ihrem Desktop verfügbar sein. Wenn Sie einen gehosteten Feature-Layer verwenden, wird empfohlen, ArcGIS GeoAnalytics Server zu verwenden. Wenn Ihre Daten nicht lokal verfügbar sind, dauert die Ausführung eines Werkzeugs bedeutend länger. Informationen zur Verwendung von ArcGIS GeoAnalytics Server für Analysen finden Sie unter GeoAnalytics Tools.
Eine ähnliche Analyse ist auch mit dem Werkzeug Zusammenfassen (innerhalb) in der Toolbox "Standard Feature Analysis" von ArcGIS Pro möglich.
Parameter
arcpy.gapro.SummarizeWithin(summarized_layer, out_feature_class, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {group_by_field}, {standard_summary_fields}, {weighted_summary_fields}, {add_minority_majority}, {add_percentages}, {group_by_summary})| Name | Erläuterung | Datentyp |
summarized_layer |
Die Punkt-, Linien- oder Polygon-Features, die entweder nach Polygonen oder Abschnitten zusammengefasst werden. | Feature Layer |
out_feature_class | Der Name der Ausgabe-Feature-Class, die die sich schneidenden Geometrien und Attribute enthält. | Feature Class |
polygon_or_bin | Legt fest, ob der summarized_layer nach Polygonen oder Abschnitten zusammengefasst wird.
| String |
bin_type | Gibt die Abschnittsform an, die zur Zusammenfassung von Features generiert wird.
| String |
bin_size (optional) | Das Entfernungsintervall, das die Abschnittsgröße und die Einheiten darstellt, mit der die Eingabe-Features zusammengefasst werden. | Linear Unit |
summary_polygons (optional) | Die Polygone, mit denen die Features im Eingabe-Zusammenfassungs-Layer zusammengefasst werden. | Feature Layer |
sum_shape | Gibt an, ob die Länge von Linien oder die Fläche von Polygonen innerhalb des Zusammenfassungs-Layers (Polygon oder Abschnitt) berechnet wird. Die Anzahl der Punkte, Linien und Polygone, die das Zusammenfassungs-Shape schneiden, werden immer einbezogen.
| Boolean |
shape_units (optional) | Gibt die Einheit an, in der Shape-Zusammenfassungsattribute berechnet werden. Wenn der Eingabewert summarized_layer Punkte enthält, ist keine Shape-Einheit erforderlich, da nur die Anzahl der Punkte in jedem Eingabe-Polygon addiert 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_by_field (optional) | Ein Feld aus den Eingabe-Zusammenfassungs-Features, mit dem Statistiken für jeden eindeutigen Attributwert berechnet werden. Angenommen, die Eingabe-Zusammenfassungs-Features enthalten Punktpositionen von Unternehmen, die Gefahrgüter lagern, und es ist das Feld HazardClass vorhanden, das den Code für den Typ des gelagerten Gefahrguts enthält. Um Zusammenfassungen für alle Einzelwerte von HazardClass zu berechnen, verwenden Sie dieses Feld als Feld für die Gruppierung. | Field |
standard_summary_fields [standard_summary_fields,...] (optional) | Die Statistiken, die für bestimmte Felder berechnet werden.
Gibt an, ob ein Feld eine Anzahl oder einen Anteil darstellt.
| Value Table |
weighted_summary_fields [weighted_summary_fields,...] (optional) | Gibt die Statistiken an, die für bestimmte Felder berechnet werden.
Gibt an, ob ein Feld eine Anzahl oder einen Anteil darstellt.
| Value Table |
add_minority_majority (optional) | Gibt an, ob die Attributwerte für die Minderheit (geringste Dominanz) oder die Mehrheit (höchste Dominanz) für alle Gruppenfelder in allen Grenzen hinzugefügt werden. Falls ja, werden dem Ausgabe-Layer zwei neue Felder mit dem Präfix "Mehrheit_" und "Minderheit_" hinzugefügt. Dieser Parameter gilt nur, wenn der Parameter group_by_field verwendet wird.
| Boolean |
add_percentages (optional) | Gibt an, ob Felder mit Prozentsätzen hinzugefügt werden. Ist dies der Fall, wird für jedes Eingabe-Polygon der Prozentsatz für jede einzelne Gruppe berechnet. Dieser Parameter gilt nur, wenn die Parameter group_by_field und add_minority_majority verwendet werden.
| Boolean |
group_by_summary (optional) | Die Ausgabetabelle, die die zusammengefassten Gruppen enthält. | Table |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion SummarizeWithin verwenden.
#-------------------------------------------------------------------------------
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
# Set local variables
summarizedLayer = "Rivers"
summaryPolys = "Basins"
summaryStatistics = [["Width", "MEAN"]]
weighedSummaryStatistics = [["DOC", "SUM"]]
out = 'SummarizedRivers'
# Execute SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
None, summaryPolys, "ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics)Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja