| 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 |
Zusammenfassungs-Polygone (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 |
Zusammenfassungsfelder – Standard
(optional) | Die Statistiken, die für bestimmte Felder berechnet werden.
| Value Table |
Zusammenfassungsfelder – Gewichtet
(optional) | Gibt die Statistiken an, die für bestimmte Felder berechnet werden.
| Value Table |
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 |
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 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.
Für Analysen mit Diskretisierung ist es erforderlich, dass Ihre Eingabe projiziert oder das Ausgabe-Koordinatensystem auf ein projiziertes Koordinatensystem festgelegt wird. Wenn Ihre Daten sich 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 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.
Die Eingabe-Punkt- und Eingabe-Polygon-Features (links) und die resultierenden Flächen-Features (rechts) werden angezeigt. 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 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}, {standard_summary_fields}, {weighted_summary_fields}, {group_by_field}, {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 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 |
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 |
group_by_summary (optional) | Die Ausgabetabelle, die die zusammengefassten Gruppen enthält. | Table |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs SummarizeWithin im Python-Fenster.
#-------------------------------------------------------------------------------
# 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
Sonderfälle
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja