Grafikpuffer (Analyse)

Zusammenfassung

Erstellt Pufferpolygone mit einem festgelegten Abstand um Eingabe-Features. Für Puffer-Enden (Abschlüsse) und -Ecken (Verbindungen) sind mehrere kartografische Shapes verfügbar, wenn der Puffer um das Feature erstellt wird.

Für Puffervorgänge gibt es alternative Werkzeuge. Weitere Informationen finden Sie in den Dokumentationen für die Werkzeuge Paarweise puffern und Puffer.

Abbildung

Abbildung "Grafikpuffer"

Verwendung

    Hinweis:

    Die Ausgabe dieses Werkzeugs ist nur für die kartografische Anzeige vorgesehen. Sie ist nicht für die Verwendung in weiteren Analysen gedacht. Eine derartige Verwendung führt zu falschen Ergebnissen.

  • Bei den Eingabe-Features kann es sich um einen Punkt, eine Linie oder ein Polygon handeln. Die für die Enden (Abschlüsse) und Ecken (Verbindungen) der Ausgabe des Puffers verfügbaren Optionen hängen vom Eingabe-Feature-Typ ab.

    • Abschlusstyp: Nur Punkte und Linien
    • Verbindungstyp: Nur Polygone und Linien
  • Die Ausgabe-Feature-Class 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 es in der Eingabe ein Feld mit dem Namen BUFF_DIST gibt, werden die zugehörigen Werte in der Ausgabe überschrieben.

  • Die Ausgabe-Puffer-Features sind immer euklidisch. Geodätische Puffer-Features werden nicht unterstützt. Weitere Informationen zum Unterschied zwischen euklidischen und geodätischen Puffern finden Sie unter Funktionsweise des Werkzeugs "Puffer" (Analyse).

  • 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.

  • 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.

    Verwenden eines Pufferfeldes für Pufferabstände
  • 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.

Parameter

BeschriftungErläuterungDatentyp
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
Abschlusstyp
(optional)

Gibt den Typ der Abschlüsse (Enden) der Eingabe-Features an, die gepuffert werden. Dieser Parameter wird nur für Punkt- und Polygon-Features unterstützt.

  • SquareDer Ausgabe-Puffer hat einen eckigen Abschluss um das Ende des Eingabe-Segments. Dies ist die Standardeinstellung.
  • StumpfDer Ausgabe-Puffer hat einen Abschluss rechtwinklig zum Ende des Eingabe-Segments.
  • RundDer Ausgabe-Puffer hat einen runden Abschluss am Ende des Eingabe-Segments.
String
Verbindungstyp
(optional)

Das Shape des Puffers an Ecken, an denen zwei Segmente verbunden werden. Dieser Parameter wird nur für Linien- und Polygon-Features unterstützt.

  • SpitzDies führt zu einem Ausgabe-Puffer-Feature, der ein quadratisches oder scharfes Shape um die Ecken hat. Ein quadratisches Eingabe-Polygon-Feature hat beispielsweise ein quadratisches Puffer-Feature. Dies ist die Standardeinstellung.
  • SchrägDer Ausgabe-Puffer-Feature für innere Ecken ist quadratisch, während die äußere Ecke rechtwinklig zum entferntesten Punkt der Ecke abgeschnitten wird.
  • RundDer Ausgabe-Puffer-Feature für innere Ecken ist quadratisch, während die äußere Ecke rund ist.
String
Gehrungsgrenze
(optional)

Mit diesem Parameter kann gesteuert werden, wie scharfe Ecken in der Puffer-Ausgabe einen Punkt erreichen, wenn sich die Liniensegmente in einem spitzen Winkel treffen und SPITZ für den Verbindungstyp angegeben wurde. In manchen Fällen ist der äußere Winkel, wo sich zwei Linien verbinden, ziemlich groß, wenn SPITZ als Verbindungstyp verwendet wird. Dadurch kann der Punkt der Ecke stärker als vorgesehen erweitert werden.

Double
Maximale Abweichung bei Versatz
(optional)

Der maximale Abstand der Polygongrenze des Ausgabe-Puffers weicht von der idealen Grenze des echten Puffers ab. Die Grenze des echten Puffers ist eine Kurve, und die Ausgabe-Polygongrenze ist eine verdichtete Polylinie. Mit diesem Parameter können Sie die Annäherung der Ausgabe-Polygongrenze an die Grenze des echten Puffers steuern.

Wenn der Parameter nicht oder auf 0 festgelegt ist, wird die maximale Abweichung vom Werkzeug ermittelt. Es empfiehlt sich, den Standardwert zu verwenden. Die Verwendung eines zu kleinen maximalen Abweichungswertes für den Versatz kann zu Performance-Einbußen im Werkzeug oder bei nachfolgenden Analysen führen.

Weitere Informationen zum Parameter Maximale Abweichung bei Versatz finden Sie in der Dokumentation zum Werkzeug Verdichten.

Linear Unit

arcpy.analysis.GraphicBuffer(in_features, out_feature_class, buffer_distance_or_field, {line_caps}, {line_joins}, {miter_limit}, {max_deviation})
NameErläuterungDatentyp
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
line_caps
(optional)

Gibt den Typ der Abschlüsse (Enden) der Eingabe-Features an, die gepuffert werden. Dieser Parameter wird nur für Punkt- und Polygon-Features unterstützt.

  • SQUAREDer Ausgabe-Puffer hat einen eckigen Abschluss um das Ende des Eingabe-Segments. Dies ist die Standardeinstellung.
  • BUTTDer Ausgabe-Puffer hat einen Abschluss rechtwinklig zum Ende des Eingabe-Segments.
  • ROUNDDer Ausgabe-Puffer hat einen runden Abschluss am Ende des Eingabe-Segments.
String
line_joins
(optional)

Das Shape des Puffers an Ecken, an denen zwei Segmente verbunden werden. Dieser Parameter wird nur für Linien- und Polygon-Features unterstützt.

  • MITERDies führt zu einem Ausgabe-Puffer-Feature, der ein quadratisches oder scharfes Shape um die Ecken hat. Ein quadratisches Eingabe-Polygon-Feature hat beispielsweise ein quadratisches Puffer-Feature. Dies ist die Standardeinstellung.
  • BEVELDer Ausgabe-Puffer-Feature für innere Ecken ist quadratisch, während die äußere Ecke rechtwinklig zum entferntesten Punkt der Ecke abgeschnitten wird.
  • ROUNDDer Ausgabe-Puffer-Feature für innere Ecken ist quadratisch, während die äußere Ecke rund ist.
String
miter_limit
(optional)

Mit diesem Parameter kann gesteuert werden, wie scharfe Ecken in der Puffer-Ausgabe einen Punkt erreichen, wenn sich die Liniensegmente in einem spitzen Winkel treffen und line_joins für den MITER angegeben wurde. In manchen Fällen ist der äußere Winkel, wo sich zwei Linien verbinden, ziemlich groß, wenn MITER als line_joins verwendet wird. Dadurch kann der Punkt der Ecke stärker als vorgesehen erweitert werden.

Double
max_deviation
(optional)

Der maximale Abstand der Polygongrenze des Ausgabe-Puffers weicht von der idealen Grenze des echten Puffers ab. Die Grenze des echten Puffers ist eine Kurve, und die Ausgabe-Polygongrenze ist eine verdichtete Polylinie. Mit diesem Parameter können Sie die Annäherung der Ausgabe-Polygongrenze an die Grenze des echten Puffers steuern.

Wenn der Parameter nicht oder auf 0 festgelegt ist, wird die maximale Abweichung vom Werkzeug ermittelt. Es empfiehlt sich, den Standardwert zu verwenden. Die Verwendung eines zu kleinen maximalen Abweichungswertes für den Versatz kann zu Performance-Einbußen im Werkzeug oder bei nachfolgenden Analysen führen.

Nähere Einzelheiten finden Sie in den Informationen zum Parameter max_deviation der Dokumentation zum Werkzeug Verdichten.

Linear Unit

Codebeispiel

GraphicBuffer – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion GraphicBuffer verwenden.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.GraphicBuffer("roads", "C:/output/majorrdsBuffered", "100 Feet", 
                             "SQUARE", "MITER")

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen