| Beschriftung | Erläuterung | Datentyp |
Eingabe-Features |
Die Eingabe-Punkt-, -Linien- oder -Polygon-Features, die gepuffert werden sollen. | Feature Layer |
Ausgabe-Feature-Class |
Die Feature-Class, die die Ausgabepuffer enthält. | Feature Class |
Abstand [Wert oder Feld] |
Die Entfernung um die Eingabe-Features, die gepuffert werden. Entfernungen können folgendermaßen angegeben werden: als Wert, der eine lineare Entfernung angibt, oder als Feld der Eingabe-Features, das die Entfernung zum Puffern der einzelnen Features enthält. Wenn lineare Einheiten nicht angegeben oder als "Unbekannt" eingegeben werden, wird die lineare Einheit des Raumbezugs der Eingabe-Features verwendet. | Linear Unit; Field |
Dissolve-Typ (optional) | Gibt an, welche Art von Zusammenführungsvorgang zum Entfernen von Pufferüberlappungen ausgeführt wird.
| String |
Dissolve-Feld(er) (optional) |
Die Liste der Felder aus den Eingabe-Features, in denen Ausgabe-Puffer zusammengeführt werden. Alle Puffer, die Attributwerte in den aufgelisteten Feldern (übertragen aus den Eingabe-Features) gemeinsam nutzen, werden zusammengeführt. | Field |
Methode (optional) | Gibt an, ob die planare oder geodätische Methode zur Erstellung der Puffer verwendet wird.
| String |
Maximale Abweichung bei Versatz (optional) |
Die maximale Entfernung der Polygongrenze des resultierenden Ausgabe-Puffers weicht von der Grenze des echten Puffers ab. Die Grenze des echten Puffers ist eine Kurve. Die sich daraus ergebende Polygongrenze ist jedoch eine verdichtete Polylinie. Mit diesem Parameter können Sie die Annäherung der Ausgabe-Polygongrenze an die Grenze des echten Puffers steuern. Wenn dieser Parameter nicht oder auf 0 festgelegt ist, wird die maximale Abweichung vom Werkzeug identifiziert. Es empfiehlt sich, den Standardwert zu verwenden. Die Verwendung einer zu kleinen maximalen Abweichung für den Versatz kann zu Performance-Einbußen im Werkzeug und bei nachfolgenden Analysen führen. Weitere Informationen zum Parameter Maximale Abweichung bei Versatz finden Sie in der Dokumentation zum Werkzeug Verdichten. | Linear Unit |
Zusammenfassung
Erstellt Pufferpolygone mit einem festgelegten Abstand um Eingabe-Features mittels eines parallelen Verarbeitungsansatzes.
Für Puffervorgänge gibt es alternative Werkzeuge. Weitere Informationen finden Sie in den Dokumentationen für die Werkzeuge Puffer und Grafikpuffer.
Abbildung
Verwendung
Dieses Werkzeug berücksichtigt die Umgebung Faktor für parallele Verarbeitung. Wenn die Umgebungsvariable nicht (Standardeinstellung) oder auf 100 festgelegt ist, wird die vollständige parallele Verarbeitung aktiviert und das Werkzeug versucht, die Arbeit auf alle logischen Kerne auf dem Computer zu verteilen. Durch Festlegen der Umgebung auf 0 wird die parallele Verarbeitung deaktiviert. Wenn ein Faktor zwischen 1 und 99 festgelegt wird, identifiziert das Werkzeug den Prozentsatz der zu verwendenden logischen Kerne, indem die Formel (Faktor für parallele Verarbeitung / 100 * logische Kerne) auf die nächste ganze Zahl aufgerundet angewendet wird. Wenn das Ergebnis dieser Formel 0 oder 1 ist, wird die parallele Verarbeitung nicht aktiviert.
Dieses Werkzeug basiert auf den Eingabe-Features, die einen räumlichen Index aufweisen. Verwenden Sie das Werkzeug Räumlichen Index hinzufügen, um einen Index zu erstellen (insbesondere für Shapefiles) oder einen vorhandenen Index neu zu erstellen, falls Zweifel hinsichtlich seiner Korrektheit bestehen.
Wie unter Funktionsweise des Werkzeugs "Puffer" beschrieben, ist der Parameter Methode eine wichtige Funktion des Werkzeugs Puffer. Damit wird festgelegt, wie Puffer erstellt werden. Die zwei grundlegenden Methoden für die Erstellung von Puffern – euklidisch und geodätisch – lassen sich wie folgt beschreiben:
- Euklidische Puffer messen den Abstand in einer zweidimensionalen kartesischen Ebene, wo Entfernungen zwischen zwei Punkten auf einer flachen Oberfläche berechnet werden. Euklidische Puffer eignen sich zum Analysieren von Entfernungen um Features in einem projizierten Koordinatensystem, die in einem relativ kleinen Bereich (z. B. einer UTM-Zone) konzentriert sind.
- Geodätische Puffer berücksichtigen die Form der Erde (ein Ellipsoid oder genauer ein Geoid). Entfernungen werden zwischen zwei Punkten auf einer gekrümmten Oberfläche (dem Geoid) berechnet. In folgenden Fällen sollten Sie geodätische Puffer erstellen:
- Die Eingabe-Features sind verteilt (decken mehrere UTM-Zonen, große Regionen oder sogar den gesamten Globus ab).
- Der Raumbezug (Kartenprojektion) Ihrer Eingabe-Features verzerrt Abstände, um andere Eigenschaften wie Fläche beizubehalten.
Mit dem Parameter Methode wird festgelegt, wie Puffer erstellt werden.
- Die Standardeinstellung ist die Option Planar. Mit dieser Option wird basierend auf dem Koordinatensystem der Eingabe automatisch bestimmt, welche Methode 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 und Sie einen Pufferabstand-Wert in linearen Einheiten (Meter, Fuß usw. im Gegensatz zu Winkeleinheiten wie Grad) angeben, werden geodätische Puffer erstellt.
- Mit dieser Option erhalten Sie dasselbe Ergebnis wie mit dem Werkzeug Puffer, das in den Versionen vor ArcGIS 10.3 enthalten war.
- Die Option Geodätisch erstellt in einem beliebigen Eingabe-Koordinatensystem einen geodätischen Puffer, der die Form beibehält. Die Eingabe-Features werden verdichtet, um Puffer zu erstellen, die genauer mit der Form der Eingabe-Features übereinstimmen. In einigen Fällen kann diese Option mehr Zeit in Anspruch nehmen als die Erstellung eines geodätischen Puffers mit der Option Planar. Das Ergebnis ist jedoch ein Puffer, der exakter mit der Form des Eingabe-Features übereinstimmt.
Hinweis:
Sie können das Koordinatensystem einer Feature-Class mit dem Werkzeug Projizieren ändern. Alternativ können Sie die Umgebungseinstellung Ausgabe-Koordinatensystem vor der Ausführung des Werkzeugs Puffer festlegen. Dieses Koordinatensystem wird dann bei der Erstellung von Puffern verwendet.
Durch die Verwendung der Methode Planar 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.
Wenn es sich bei der Eingabe um ein projiziertes Koordinatensystem und bei der Ausgabe um eine Geodatabase-Feature Class handelt, enthält die Ausgabe u. U. Kreisbogensegmente. Wenn es sich bei der Eingabe um eine Point-Feature-Class handelt, werden stets Kreisbögen ausgegeben. Wenn Kreisbögen in ein anderes Koordinatensystem projiziert werden, werden Position und Größe der ursprünglichen Puffer transformiert. Die Form der Puffer verändert sich nicht, sodass die projizierten Puffer keine genaue Darstellung der vom ursprünglichen Puffer abgedeckten Fläche bieten. Wenn Sie Kreisbögen projizieren möchten, verwenden Sie zunächst das Werkzeug Verdichten, um die Kreisbögen in gerade Linien zu konvertieren. Projizieren Sie dann die verdichteten Puffer.
-
Die Ausgabe-Feature-Class umfasst das Feld BUFF_DIST. Es enthält den Pufferabstand für jedes Feature in der linearen Einheit des Eingabe-Koordinatensystems. Wenn Puffer mit der Methode Geodätisch erstellt werden, wird der eingegebene Pufferabstand in Meter konvertiert.
Wenn es in der Eingabe ein Feld mit dem Namen BUFF_DIST gibt, werden die zugehörigen Werte in der Ausgabe überschrieben. Wenn für Dissolve-Typ der Wert Alle oder Liste verwendet wird, enthält die Ausgabe dieses Feld nicht.
Die Ausgabe-Feature-Class enthält das Feld ORIG_FID mit der Feature-ID des Eingabe-Features, für das der Puffer erstellt wurde. Wenn es in der Eingabe ein Feld mit dem Namen ORIG_FID gibt, werden die zugehörigen Werte in der Ausgabe überschrieben. Wenn für Dissolve-Typ der Wert Alle oder Liste verwendet wird, enthält die Ausgabe dieses Feld nicht.
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 der Polygone um den angegebenen Abstand verkleinert.
Vorsicht:
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 die Ausgabe-Feature-Class geschrieben.
Wenn ein Feld aus der Eingabe verwendet wird, um Pufferabstände abzurufen, können die Werte 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 aus einer Zahl besteht, wird davon ausgegangen, dass die Entfernung in der linearen Einheit des Raumbezugs der Eingabe angegeben ist (außer wenn sich die Eingabe in einem geographischen Koordinatensystem befindet; in diesem Fall wird ein Meterwert 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 verwendet.
-
Die Schaltfläche Feld hinzufügen im Parameter Dissolve-Feld(er) wird nur in ModelBuilder verwendet. Der Parameter Dissolve-Feld(er) enthält in ModelBuilder keine Feldnamen, wenn das vorherige Werkzeug nicht ausgeführt wurde oder die abgeleiteten Daten nicht vorhanden sind. Mit der Schaltfläche Feld hinzufügen können Sie erwartete Felder zur Liste Dissolve-Feld(er) hinzufügen, wenn Sie das Dialogfeld des Werkzeugs Puffer ausfüllen.
In Puffervorgängen wird die Übertragung von z-Werten aus den Eingabe- in die Ausgabe-Puffer-Features nicht unterstützt.
In Puffervorgängen wird die Übertragung von m-Werten aus den Eingabe- in die Ausgabe-Puffer-Features nicht unterstützt.
Parameter
arcpy.analysis.PairwiseBuffer(in_features, out_feature_class, buffer_distance_or_field, {dissolve_option}, {dissolve_field}, {method}, {max_deviation})| Name | Erläuterung | Datentyp |
in_features |
Die Eingabe-Punkt-, -Linien- oder -Polygon-Features, die gepuffert werden sollen. | Feature Layer |
out_feature_class |
Die Feature-Class, die die Ausgabepuffer enthält. | Feature Class |
buffer_distance_or_field |
Die Entfernung um die Eingabe-Features, die gepuffert werden. Entfernungen können folgendermaßen angegeben werden: als Wert, der eine lineare Entfernung angibt, oder als Feld der Eingabe-Features, das die Entfernung zum Puffern der einzelnen Features enthält. Wenn lineare Einheiten nicht angegeben oder als "Unbekannt" eingegeben werden, wird die lineare Einheit des Raumbezugs der Eingabe-Features verwendet. Wenn bei der Angabe eines Abstands bei der Skripterstellung die gewünschte lineare Einheit zwei Wörter umfasst, wie im Englischen "Decimal Degrees", fassen Sie die zwei Wörter zu einem Wort zusammen (z. B. 20 DecimalDegrees). | Linear Unit; Field |
dissolve_option (optional) | Gibt an, welche Art von Zusammenführungsvorgang zum Entfernen von Pufferüberlappungen ausgeführt wird.
| String |
dissolve_field [dissolve_field,...] (optional) |
Die Liste der Felder aus den Eingabe-Features, in denen Ausgabe-Puffer zusammengeführt werden. Alle Puffer, die Attributwerte in den aufgelisteten Feldern (übertragen aus den Eingabe-Features) gemeinsam nutzen, werden zusammengeführt. | Field |
method (optional) |
Gibt an, ob die planare oder geodätische Methode zur Erstellung der Puffer verwendet wird.
| String |
max_deviation (optional) |
Die maximale Entfernung der Polygongrenze des resultierenden Ausgabe-Puffers weicht von der Grenze des echten Puffers ab. Die Grenze des echten Puffers ist eine Kurve. Die sich daraus ergebende Polygongrenze ist jedoch eine verdichtete Polylinie. Mit diesem Parameter können Sie die Annäherung der Ausgabe-Polygongrenze an die Grenze des echten Puffers steuern. Wenn dieser Parameter nicht oder auf 0 festgelegt ist, wird die maximale Abweichung vom Werkzeug identifiziert. Es empfiehlt sich, den Standardwert zu verwenden. Die Verwendung einer zu kleinen maximalen Abweichung für den Versatz kann zu Performance-Einbußen im Werkzeug und bei nachfolgenden Analysen führen. Nähere Einzelheiten finden Sie bei den Informationen zum Parameter max_deviation in der Dokumentation zum Werkzeug Verdichten. | Linear Unit |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion PairwiseBuffer verwenden.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseBuffer_analysis("roads", "C:/output/majorrdsBuffered", "100 Feet",
"LIST", "Distance")Suche nach Flächen mit geeigneter Vegetation, in denen sich keine Bereiche befinden, auf die sich die Einflüsse von Hauptstraßen auswirken.
# Name: PairwiseBuffer.py
# Description: Find areas of suitable vegetation that exclude areas heavily
# impacted by major roads.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1"
arcpy.Select_analysis(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveType = "LIST"
dissolveField = "Distance"
arcpy.PairwiseBuffer_analysis(roads, roadsBuffer, distanceField, dissolveType,
dissolveField)
# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
xyTol = "1 Meters"
arcpy.Erase_analysis(suitableVeg, roadsBuffer, eraseOutput, xyTol)Umgebungen
Sonderfälle
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja