Paarweise ausschneiden (Analyse)

Zusammenfassung

Extrahiert Eingabe-Features, die die Clip-Features überlagern.

Verwenden Sie dieses Werkzeug, wenn Sie einen Teil einer Feature-Class mithilfe eines oder mehrerer Features einer anderen Feature-Class ausschneiden möchten. Dies ist besonders nützlich beim Erstellen einer neuen Feature-Class (auch als Untersuchungsgebiet oder Interessenbereich bezeichnet), die eine geographische Teilmenge der Features einer anderen, größeren Feature-Class enthält.

Ausschneidevorgänge können auch mit dem Werkzeug Ausschneiden vorgenommen werden.

Abbildung

Werkzeugbild "Paarweise ausschneiden"

Verwendung

  • Je nach Geometrietyp des Parameterwerts Eingabe-Features können die Parameterwerte der Clip-Features Punkte, Linien und Polygone sein.

    • Wenn der Parameterwert Eingabe-Features ein Polygon ist, muss der Parameterwert Clip-Features ebenfalls ein Polygon sein.
    • Wenn der Parameterwert Eingabe-Features eine Linie ist, kann der Parameterwert Clip-Features eine Linie oder ein Polygon sein. Wenn Linien-Features mit Linien-Features ausgeschnitten werden, werden nur lagegleiche Linien oder Liniensegmente in die Ausgabe geschrieben, wie in der Abbildung unten dargestellt.
    • Wenn der Parameterwert Eingabe-Features ein Punkt ist, können die Clip-Features Punkte, Linien oder Polygone sein. Wenn Punkt-Features mit Punkt-Features ausgeschnitten werden, werden nur lagegleiche Punkte in die Ausgabe geschrieben, wie in der Abbildung unten dargestellt. Wenn Punkt-Features mit Linien-Features ausgeschnitten werden, werden nur die Punkte in die Ausgabe geschrieben, die mit den Linien-Features lagegleich sind.

  • Der Parameter Ausgabe-Feature-Class enthält alle Attribute des Parameters Eingabe-Features.

  • Linien-Features, die von Polygon-Features ausgeschnitten wurden:

    Linien-Features, die von Polygon-Features ausgeschnitten wurden

  • Punkt-Features, die von Polygon-Features ausgeschnitten wurden:

    Punkt-Features, die von Polygon-Features ausgeschnitten wurden

  • Linien-Features, die mit Linien-Features ausgeschnitten wurden:

    Linien-Features, die mit Linien-Features ausgeschnitten wurden

  • Punkt-Features, die mit Punkt-Features ausgeschnitten wurden:

    Punkt-Features, die mit Punkt-Features ausgeschnitten wurden

  • Wenn der Parameter Maximale Genauigkeit verwenden aktiviert ist, wendet das Werkzeug beim Verarbeiten von Daten ein Maß an Genauigkeit an, das größer ist als der Standardwert für den Eingaberaumbezug.

    Genauigkeit ist eine Kombination aus der XY-Auflösung und der XY-Toleranz, die während der Verarbeitung verwendet werden. Standardmäßig verwendet das Werkzeug diese Eigenschaften aus dem Raumbezug des ersten Parameterwerts Eingabe-Features.

    Wenn der Parameter Maximale Genauigkeit verwenden aktiviert ist, wird der maximal mögliche Genauigkeitswert für die Punktausgabe verwendet. Das Werkzeug verwendet die maximale Genauigkeit, die ihm zur Verfügung steht. Diese hängt vom absoluten Wert der Geometriekoordinaten und der Genauigkeit des Hardware-Gleitkommas ab. Eine grobe Schätzung der verwendeten maximalen Toleranz ist 0,002 Millimeter im Vergleich zum Standardwert 1 Millimeter.

    Beim Schreiben der Ausgabe kommt die Auflösung des Raumbezugs zur Anwendung, sodass es bei den Stützpunkten ggf. zu einer leichten Verschiebung kommt.

    Wenn die Eingabedaten nicht lineare Segmente (Kurven) enthalten, aktivieren Sie, um bestmögliche Ergebnisse zu erhalten, die Umgebung Kurvensegmente beibehalten, und legen Sie die Umgebung Kurvenverarbeitungsmethode auf Genau fest.

  • 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. Wird die Umgebung auf 0 festgelegt, wird die parallele Verarbeitung nicht aktiviert. 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 Features, die zugeschnitten werden.

Feature Layer
Clip-Features

Die Features, mit denen die Eingabe-Features zugeschnitten werden.

Feature Layer
Ausgabe-Feature-Class

Die Feature-Class, die erstellt wird.

Feature Class
XY-Toleranz
(optional)

Der Mindestabstand zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann.

Vorsicht:

Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft XY-Toleranz des Raumbezugs der Eingabe-Feature-Class verwendet.

Linear Unit
Maximale Genauigkeit verwenden
(optional)

Gibt das Maß an Genauigkeit an, das beim Verarbeiten der Daten verwendet wird.

  • Aktiviert: Bei der Verarbeitung wird die maximale Genauigkeit verwendet. Verwenden Sie diese Option, wenn Sie bei der Verarbeitung der Daten möchten, dass das Werkzeug ein Maß an Genauigkeit anwendet, das größer ist als der Standardwert für den Eingaberaumbezug.
  • Deaktiviert: Bei der Verarbeitung wird die Genauigkeit der ersten Eingabe-Feature-Class verwendet. Dies ist die Standardeinstellung.
Boolean

arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class, {cluster_tolerance}, {precision})
NameErläuterungDatentyp
in_features

Die Features, die zugeschnitten werden.

Feature Layer
clip_features

Die Features, mit denen die Eingabe-Features zugeschnitten werden.

Feature Layer
out_feature_class

Die Feature-Class, die erstellt wird.

Feature Class
cluster_tolerance
(optional)

Der Mindestabstand zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann.

Vorsicht:

Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft XY-Toleranz des Raumbezugs der Eingabe-Feature-Class verwendet.

Linear Unit
precision
(optional)

Gibt das Maß an Genauigkeit an, das beim Verarbeiten der Daten verwendet wird.

  • MAX_PRECISIONBeim Festlegen der Punktausgabe wird die maximale Genauigkeit verwendet. Verwenden Sie diese Option, wenn Sie bei der Verarbeitung der Daten möchten, dass das Werkzeug ein Maß an Genauigkeit anwendet, das größer ist als der Standardwert für den Eingaberaumbezug.
  • DEFAULT_PRECISIONBei der Verarbeitung wird die Genauigkeit der ersten Eingabe-Feature-Class verwendet. Dies ist die Standardeinstellung.
Boolean

Codebeispiel

PairwiseClip: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion PairwiseClip im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.PairwiseClip("majorrds.shp", "study_quads.shp", 
                            "C:/output/studyarea.shp")
PairwiseClip: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion PairwiseClip in einem eigenständigen Skript verwendet wird.

# Description: Clip major roads that fall within the study area. 

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"

# Run Pairwise Clip
arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class)

Lizenzinformationen

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

Verwandte Themen