Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Die Punkt-, Polylinien- oder Polygon-Features, die gepuffert werden sollen. | Feature Layer |
Ausgabe-Feature-Class |
Die neue Feature-Class mit den Puffer-Ergebnissen. | Feature Class |
Methode | Gibt die Methode an, die zum Erstellen der Puffer wird.
| String |
Puffertyp (optional) | Gibt an, wie der Pufferabstand definiert wird.
| String |
Pufferfeld (optional) | Das Feld, das den Pufferabstand für jedes Feature enthält. Wenn ein Feldwert aus einer Zahl besteht, wird davon ausgegangen, dass die Entfernung in der linearen Einheit des Raumbezugs des Eingabe-Layers angegeben ist, außer wenn sich der Eingabe-Layer in einem geographischen Koordinatensystem befindet, dann wird ein Wert in Metern angenommen. Falls die in den Feldwerten angegebene lineare Einheit ungültig ist oder nicht erkannt wird, wird standardmäßig die lineare Einheit des Raumbezugs der Eingabe-Features verwendet. | Field |
Pufferabstand (optional) | Die Entfernung um die Eingabe-Features, die gepuffert werden. | Linear Unit |
Pufferausdruck (optional) | Eine Gleichung mit Feldern und mathematischen Operatoren, die auf jedes Feature als Puffer angewendet wird. Die Felder müssen numerisch sein, und der Ausdruck kann die Operatoren [+ - * / ] und mehrere Felder enthalten. Wenn nicht anders angegeben, werden berechnete Werte in Metern angewendet. Als Beispiel soll ein Puffer angewendet werden, der das numerische Feld "distance" in Kilometer mit 2 multipliziert und 15 Meter addiert. Verwenden Sie einen Arcade-Ausdruck wie as_kilometers($feature["distance"]) * 2 + as_meters(15). Wenn der Layer der Karte hinzugefügt wird, können die Filter Felder und Helper zum Erstellen eines Ausdrucks verwendet werden. | Calculator Expression |
Dissolve-Option (optional) | Gibt die Zusammenführungsoption (Dissolve) an, die zum Entfernen von Pufferüberlappungen verwendet werden soll.
| String |
Dissolve-Felder (optional) | Eine Liste mit einem oder mehreren Feldern aus den Eingabe-Features, anhand derer die Ausgabepuffer zusammengeführt werden. Alle Puffer, die Attributwerte in den aufgelisteten Feldern gemeinsam nutzen, werden zusammengeführt. Dieser Parameter ist nur erforderlich, wenn als Dissolve-Option die Option Liste verwendet wird. | Field |
Zusammenfassungsfelder (optional) | Gibt Statistiken an, die auf numerische und Zeichenfolgefelder angewendet werden. Wenn das Feld leer ist, wird nur die Anzahl berechnet. Diese Statistik wird nur angewendet, wenn Dissolve-Option Liste oder Alle lautet.
| Value Table |
Multipart (optional) | Gibt an, ob Multipart-Features erstellt werden.
| Boolean |
Zusammenfassung
Erstellt Puffer mit einem festgelegten Abstand um Eingabe-Features.
Verwendung
Der Parameter Methode gibt an, wie Puffer erstellt werden. Es gibt zwei grundlegende Methoden für die Erstellung von Puffern: euklidisch und geodätisch.
- Euklidische Puffer messen den Abstand in einer zweidimensionalen kartesischen Ebene, in der geradlinige oder euklidische Abstände zwischen zwei Punkten auf der flachen Oberfläche (kartesische Ebene) berechnet werden. Euklidische Puffer sind der gängigere Puffertyp. Sie eignen sich zum Analysieren von Abständen um Features in einem projizierten Koordinatensystem, die in einem relativ kleinen Bereich (z. B. einer UTM-Zone) konzentriert sind. Euklidische Puffer werden als planare Puffer bezeichnet.
- Geodätische Puffer berücksichtigen die tatsächliche Form der Erde (ein Ellipsoid oder genauer ein Geoid). Abstände werden zwischen zwei Punkten auf einer geschwungenen Oberfläche (Geoid) im Gegensatz zu zwei Punkten auf einer flachen Oberfläche (kartesische Ebene) berechnet. In folgenden Fällen wird die Erstellung geodätischer Puffer empfohlen:
- Die Eingabe-Features sind verteilt (decken mehrere UTM-Zonen, große Regionen oder den gesamten Globus ab).
- Der Raumbezug (Kartenprojektion) der Eingabe-Features verzerrt Abstände, um andere Eigenschaften wie Fläche beizubehalten.
Geodätische Puffer werden möglicherweise auf einer ebenen Karte ungewohnt dargestellt, aber bei der Anzeige auf einem Globus sehen diese Puffer richtig aus.
Mit dem Parameter Methode wird festgelegt, wie Puffer erstellt werden.
- Die planare Methode identifiziert automatisch die Methode, die basierend auf dem Koordinatensystem der Eingabe-Features verwendet werden soll.
- Wenn die Eingabe-Features über ein projiziertes Koordinatensystem verfügen, werden euklidische Puffer erstellt.
- Wenn die Eingabe-Features über ein geographisches Koordinatensystem verfügen, werden geodätische Puffer erstellt.
- Die Standardeinstellung ist "Geodätisch". Die geodätische Methode erstellt unabhängig vom Eingabe-Koordinatensystem einen geodätischen Puffer, der die Form beibehält. Der formbeibehaltende geodätische Puffer, verdichtet die Eingabe-Features vor der Erstellung von geodätischen Ausgabe-Features. Dadurch entsteht ein geodätischer Puffer, der sich enger an der Form der Eingabe-Features orientiert. Falls Sie sich über die Form der Puffer bzw. darüber Sorgen machen, wie sehr ihre Form mit den ursprünglichen Eingabe-Features übereinstimmt, wird diese Option empfohlen, insbesondere dann, wenn Ihre Eingabedaten sich in einem geographischen Koordinatensystem befinden. Dies kann mehr Zeit in Anspruch nehmen als die Erstellung des geodätischen Puffers mit der Option "Planar". Das Ergebnis ist jedoch ein Puffer, der besser mit der Form des Eingabe-Features übereinstimmt.
- Die planare Methode identifiziert automatisch die Methode, die basierend auf dem Koordinatensystem der Eingabe-Features verwendet werden soll.
Durch die Verwendung der planaren Methode können Sie die Genauigkeit von Puffern verbessern, die mit projizierten Eingaben erstellt wurden, indem Sie eine Projektion verwenden, die die Entfernungsverzerrung minimiert (z. B. eine äquidistante Kegelprojektion oder eine azimutale äquidistante Projektion) und die für Ihre Eingabe geographisch geeignet ist.
Beim Puffern von Polygon-Features können auch negative Pufferabstände verwendet werden, um Puffer innerhalb der Polygon-Features zu erstellen. Wenn Sie einen negativen Pufferabstand verwenden, werden die Grenzen des Polygons um den angegebenen Abstand verkleinert.
Hinweis:
Wenn der negative Pufferabstand groß genug ist, um das Polygon ganz auszublenden, wird eine NULL-Geometrie generiert. Es wird eine Warnmeldung angezeigt, und kein Feature mit NULL-Geometrie wird in das Ausgabe-Dataset geschrieben.
Die Größe des Puffers kann mit einer der folgenden drei Optionen eingegeben werden:
- Entfernung: Verwendet einen konstanten Wert (alle Puffer mit derselben Größe)
- Feld: Verwendet Werte aus einem Feld (verschiedene Features können unterschiedlich große Puffer aufweisen)
- Ausdruck: Wendet einen Ausdruck auf jedes Feature an (verschiedene Features können je nach Ausdruck verschiedene Werte aufweisen)
Das Werkzeug Puffer erstellen erstellt standardmäßig überlappende Puffer, wenn die Pufferflächen aufeinandertreffen. Wenn es sich bei den Eingabe-Features um Flächen handelt, wird die Eingabefläche in den Puffer einbezogen. Sie können die Parameter "Zusammenführen" und "Multipart" verwenden, um festzulegen, wie überlappende Puffer behandelt werden sollen. Die folgenden drei Zusammenführungsoptionen sind verfügbar:
- Keine: Puffer überlappen sich, wo Pufferflächen aufeinandertreffen. Dies ist die Standardeinstellung.
- Alle: Alle Features werden zusammengeführt. Mithilfe des Multipart-Parameters wird festgelegt, ob alle Features zu einem Feature zusammengeführt (Multipart ist "true") oder nur überlappende Features zusammengeführt (Multipart ist "false") werden.
- Felder: Features werden auf Feldwerten basierend zusammengeführt. Sie können ein oder mehrere Felder auswählen, wobei ähnliche Werte zusammengeführt werden. Mithilfe des Multipart-Parameters wird festgelegt, ob alle übereinstimmenden Feld-Features zu einem Feature zusammengeführt (Multipart ist "true") oder nur überlappende übereinstimmende Features zusammengeführt (Multipart ist "false") werden.
Wenn ein Feld aus dem Parameter Eingabe-Layer verwendet wird, um Pufferabstände abzurufen, kann der Wert des Feldes entweder eine Zahl (z. B. 5) oder eine Zahl mit einer gültigen linearen Einheit (z. B. 5 Kilometer) sein. Wenn ein Feldwert nur aus einer Zahl besteht, wird davon ausgegangen, dass die Entfernung in der linearen Einheit des Raumbezugs des Parameters Eingabe-Layers angegeben ist (außer wenn sich der Eingabe-Layer in einem geographischen Koordinatensystem befindet; dann wird ein Wert in Meter angenommen). Falls die im Feldwert angegebene lineare Einheit ungültig ist oder nicht erkannt wird, wird standardmäßig die lineare Einheit des Raumbezugs der Eingabe-Features verwendet.
Wenn Sie Alle oder Felder für die Zusammenführung verwenden, können Sie Statistiken berechnen. Die Statistiken werden nur zum Zusammenführen aller Features oder Feldwerte verwendet, sie werden nicht geographisch (mit dem Multipart-Parameter) angewendet. In der folgenden Tabelle wird die Funktionsweise dieser Optionen anhand der sechs Features erläutert, die in der folgenden Abbildung gezeigt werden. Die Farbe gibt die Feldwerte (Blau oder Orange) an, die für die Zusammenführung nach Feldern herangezogen werden.
Dissolve-Option Multipart ist "false" (Standard) Multipart ist "true" Keine Es werden sechs Features erstellt, wenn keine Zusammenführung auf gepufferte Features angewendet wird. Dies ist die Standardeinstellung. Dies entspricht der Option Überlappen des WerkzeugsStandardanalyse.
Multipart darf nicht auf "true" gesetzt sein, wenn die Option zum Zusammenführen auf Keine gesetzt ist.
Alle Wenn alle Werte zusammengeführt werden und Multipart auf "false" festgelegt ist, werden drei Features erstellt. Es werden nur überlappende Features zusammengeführt. Dies entspricht der Option Zusammenführen des Werkzeugs Standardanalyse.
Wenn alle Werte zusammengeführt werden und Multipart auf "true" festgelegt ist, wird ein Feature erstellt. Bei Auswahl dieser Option ist das Ergebnis immer ein Feature.
Felder Wenn die Option "Zusammenführen" basierend auf dem Feld angewendet wird (hier ist das Feld die Farbe der Eingabepunkte), werden vier Features erstellt. Es werden nur überlappende Features mit demselben Wert der angegebenen Felder zusammengeführt.
Wenn die Option "Zusammenführen" basierend auf dem Feld angewendet wird (hier ist das Feld die Farbe der Eingabepunkte) und Multiparts zulässig sind, werden zwei Features erstellt. Features mit demselben Feldwert sind immer einzelne Features.
Sie können mit einem Pufferausdruck eine Gleichung aus numerischen Feldern und mathematischen Operatoren erstellen. Weitere Informationen finden Sie unter Arcade-Ausdrücke in der Toolbox "GeoAnalytics Desktop". Wenn nicht anders angegeben, wird vorausgesetzt, dass numerische Werte in einem Pufferausdruck in Meter angeben sind.
Ähnliche Analysen können auch mit Folgendem durchgeführt werden:
- dem ArcGIS Pro-Geoverarbeitungswerkzeug Puffer in der Toolbox "Analysis",
- dem ArcGIS Pro-Geoverarbeitungswerkzeug Puffer erstellen in der Toolbox "Feature Analysis".
Das Ausgabe-Dataset umfasst das Feld BUFF_DIST. Es enthält den Pufferabstand, um jedes Feature in der linearen Einheit des Koordinatensystems der Eingabe-Features zu puffern. Wenn ein Ausgabe-Koordinatensystem festgelegt ist, befinden sich die Einheiten von BUFF_DIST in diesem Koordinatensystem. Feldern, die in der Ausgabe bereits vorhanden sind, wird eine Zahl angefügt, damit der Feldname eindeutig ist (z. B. BUFF_DIST1).
Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Puffer erstellen verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Verwenden Sie einen planaren Puffer.
- Führen Sie die Pufferergebnisse nicht zusammen.
- 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.
Parameter
arcpy.gapro.CreateBuffers(input_layer, out_feature_class, method, {buffer_type}, {buffer_field}, {buffer_distance}, {buffer_expression}, {dissolve_option}, {dissolve_fields}, {summary_fields}, {multipart})
Name | Erläuterung | Datentyp |
input_layer | Die Punkt-, Polylinien- oder Polygon-Features, die gepuffert werden sollen. | Feature Layer |
out_feature_class |
Die neue Feature-Class mit den Puffer-Ergebnissen. | Feature Class |
method | Gibt die Methode an, die zum Erstellen der Puffer wird.
| String |
buffer_type (optional) | Gibt an, wie der Pufferabstand definiert wird.
| String |
buffer_field (optional) | Das Feld, das den Pufferabstand für jedes Feature enthält. Wenn ein Feldwert aus einer Zahl besteht, wird davon ausgegangen, dass die Entfernung in der linearen Einheit des Raumbezugs von input_layer angegeben ist, außer wenn sich der Wert von input_layer in einem geographischen Koordinatensystem befindet, dann wird ein Wert in Metern angenommen. Falls die in den Feldwerten angegebene lineare Einheit ungültig ist oder nicht erkannt wird, wird standardmäßig die lineare Einheit des Raumbezugs der Eingabe-Features verwendet. | Field |
buffer_distance (optional) | Die Entfernung um die Eingabe-Features, die gepuffert werden. | Linear Unit |
buffer_expression (optional) | Eine Gleichung mit Feldern und mathematischen Operatoren, die auf jedes Feature als Puffer angewendet wird. Die Felder müssen numerisch sein, und der Ausdruck kann die Operatoren [+ - * / ] und mehrere Felder enthalten. Wenn nicht anders angegeben, werden berechnete Werte in Metern angewendet. Als Beispiel soll ein Puffer angewendet werden, der das numerische Feld "distance" in Kilometer mit 2 multipliziert und 15 Meter addiert. Verwenden Sie einen Arcade-Ausdruck wie as_kilometers($feature["distance"]) * 2 + as_meters(15). | Calculator Expression |
dissolve_option (optional) | Gibt die Zusammenführungsoption (Dissolve) an, die zum Entfernen von Pufferüberlappungen verwendet werden soll.
| String |
dissolve_fields [dissolve_fields,...] (optional) | Eine Liste mit einem oder mehreren Feldern aus den Eingabe-Features, anhand derer die Ausgabepuffer zusammengeführt werden. Alle Puffer, die Attributwerte in den aufgelisteten Feldern gemeinsam nutzen, werden zusammengeführt. Dieser Parameter ist nur erforderlich, wenn für dissolve_option die Option LIST ausgewählt ist. | Field |
summary_fields [summary_fields,...] (optional) | Gibt Statistiken an, die auf numerische und Zeichenfolgefelder angewendet werden. Wenn das Feld leer ist, wird nur die Anzahl berechnet. Diese Statistik wird nur angewendet, wenn dissolve_option LIST oder ALL lautet.
| Value Table |
multipart (optional) | Gibt an, ob Multipart-Features erstellt werden.
| Boolean |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion CreateBuffers verwenden.
#-------------------------------------------------------------------------------
# Name: CreateBuffers.py
# Description: Buffer damaged building by 300 meters
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/DamageSurvey.gdb"
# Set local variables
inFeatures = "DamageAssessment"
out = "DangerousAreas"
# Run Create Buffers
arcpy.gapro.CreateBuffers(inFeatures, out, "GEODESIC", "DISTANCE",
None, "300 Meters", None, "ALL", None, None,
"SINGLE_PART")
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja