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 Werte der Proportion von Linien innerhalb eines Polygon oder der Proportion von Polygonen innerhalb eines Polygons. Gewichtete Statistiken gelten nicht für Punkte innerhalb von Polygonen.
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
- Quadratyard
- Quadratfuß
- Quadratkilometer
- Quadratmeter
- Hektar
- Acres
Sie können optional Standardstatistiken berechnen. 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 Zusammenfassungs-Layer, die den Layer Zusammenfassungspolygone schneiden. Die gewichteten Zusammenfassungsfeldstatistiken werden mit einer Gewichtung multipliziert, die auf der Proportion der Zusammenfassungspolygone basiert, die die einzelnen Features im 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". Es gibt sechs gewichtete Statistiken, die für numerische Felder im zusammenzufassenden Layer berechnet werden: "Anzahl", "Summe", "Minimum", "Maximum" und "Bereich".
Gewichtete Statistiken werden nicht für Zeichenfolgendaten berechnet. Jedes Mal, wenn ein Wert für Feld und Statistik angegeben wird, 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 Zusammenfassungspolygone schneiden, berechnet.
Ab ArcGIS Enterprise 10.6.1 können Sie eine Gruppe mit dem Parameter Nach Feld gruppieren berechnen. Damit erstellen Sie neben dem zusammengefassten Polygon-Layer eine tabellarische Ausgabe.
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 aus 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 Sie Minderheits- und Mehrheitsattribute hinzufügen auswählen. 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.
Für gewichtete Statistiken werden Linien-Layer nur anhand der Proportionen der Linien-Features zusammengefasst, die sich innerhalb der Zusammenfassungspolygone befinden. Standardstatistiken (nicht gewichtet) fassen alle Linien zusammen, die die Zusammenfassungs-Polygone schneiden. Verwenden Sie beim Zusammenfassen von Linien mit gewichteten Statistiken Anzahl und Mengen (statt Verhältnisse oder Indizes), sodass proportionale Berechnungen in Ihrer Analyse logisch sinnvoll sind.
Gewichtete Statistiken für Zusammenfassungsgebiet-Layer basieren auf den Proportionen der Zusammenfassungspolygon-Features, die innerhalb des Zusammenfassungs-Layers liegen. Verwenden Sie beim Zusammenfassen von Flächen Anzahl oder Mengen (statt Verhältnisse oder Indizes), sodass proportionale Berechnungen in Ihrer Analyse logisch sinnvoll sind.
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.
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 Sie Shape-Zusammenfassungsattribute hinzufügen auswählen.
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 Felds id lautet 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 auswählen. 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 auswählen. 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 auswählen. 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 hinzufügen. 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 Tipps können Sie die Performance des Werkzeugs Zusammenfassen (innerhalb) verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Bei Verwendung von Abschnitten sind größere Abschnitte leistungsfähiger als kleinere Abschnitte. Wenn Sie nicht sicher sind, welche Größe Sie verwenden sollen, 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 ArcGIS GeoAnalytics Server. Die Analyse wird auf dem GeoAnalytics Server ausgeführt, und die Ergebnisse werden in den eigenen Inhalten in ArcGIS Enterprise gespeichert.
Bei der Ausführung von GeoAnalytics Server-Werkzeugen wird die Analyse auf dem GeoAnalytics Server abgeschlossen. Für eine optimale Performance sollten die Daten dem GeoAnalytics Server über Feature-Layer zur Verfügung stehen, die auf Ihrem ArcGIS Enterprise-Portal gehostet werden. Alternativ können Big-Data-Dateifreigaben verwendet werden. Daten, auf die der GeoAnalytics Server nicht lokal zugreifen kann, werden vor Analysebeginn auf den GeoAnalytics Server verschoben. Dadurch dauert die Ausführung eines Werkzeugs länger. Es kann zudem vorkommen, dass das Verschieben der Daten von ArcGIS Pro zum GeoAnalytics Server fehlschlägt. Die Wahrscheinlichkeit eines Fehlers hängt dabei von der Netzwerkgeschwindigkeit sowie der Größe und Komplexität der Daten ab. Daher wird empfohlen, dass Sie Ihre Daten stets freigeben oder eine Big-Data-Dateifreigabe erstellen.
Weitere Informationen zum Freigeben von Daten in Ihrem Portal
Weitere Informationen zum Erstellen einer Big-Data-Dateifreigabe über Server Manager
Eine ähnliche Analyse ist auch mit dem Werkzeug Zusammenfassen (innerhalb) in der Toolbox "Standard Feature Analysis" von ArcGIS Pro möglich.
Syntax
arcpy.geoanalytics.SummarizeWithin(summarized_layer, output_name, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {data_store}, {group_by_field}, {add_minority_majority}, {add_percentages})
Parameter | Erklärung | Datentyp |
summarized_layer | Die Punkt-, Linien- oder Polygon-Features, die entweder nach Polygonen oder Abschnitten zusammengefasst werden. | Feature Set |
output_name | Der Name des Ausgabe-Polygon-Feature-Service, der die sich schneidenden Geometrien und Attribute enthält. | String |
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 Set |
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 Eingabe-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 |
standard_summary_fields [standard_summary_fields,...] (optional) | Die Statistiken, die für bestimmte Felder berechnet werden.
| Value Table |
weighted_summary_fields [weighted_summary_fields,...] (optional) | Gibt die Statistiken an, die für bestimmte Felder berechnet werden.
| Value Table |
data_store (optional) | Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardeinstellung ist SPATIOTEMPORAL_DATA_STORE. Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei.
| 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 |
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 |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
output | Die Zusammenfassung der Anzahl an Punkten, der Länge der Linien oder der Fläche der Polygone in jedem Polygon. | Feature Set |
group_by_summary | Wenn die Gruppierung nach Zusammenfassung bereitgestellt wurde, gibt das Werkzeug eine Tabelle mit der berechneten Statistik für jede einzelne Gruppe aus. | Datensatz |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs SummarizeWithin im Python-Fenster.
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
summarizedLayer = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Water/BigDataCatalogServer/Rivers"
summaryPolys = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Boundaries/BigDataCatalogServer/Counties"
summaryStatistics = ["Width", "MEAN"]
weighedSummaryStatistics = ["DOC", "SUM"]
outFS = 'SummarizedRivers'
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute SummarizeWithin
arcpy.geoanalytics.SummarizeWithin(summarizedLayer, outFS, "POLYGON", None,
None, summaryPolys,"ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics, dataStore)
Umgebungen
- Ausgabe-Koordinatensystem
Das Koordinatensystem, das für die Analyse verwendet wird. Die Analyse wird im Eingabe-Koordinatensystem ausgeführt, sofern nicht anders durch diesen Parameter angegeben. Für GeoAnalytics Tools werden die Endergebnisse im Data Store vom Typ "spatiotemporal" in WGS84 gespeichert.
Lizenzinformationen
- Basic: Erfordert ArcGIS GeoAnalytics Server
- Standard: Erfordert ArcGIS GeoAnalytics Server
- Advanced: Erfordert ArcGIS GeoAnalytics Server