Paarweise ausschneiden (Analysis)

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 (wie mit einer "Ausstechform") 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 für Vektordaten werden mit einem alternativen Werkzeug ausgeführt. Weitere Informationen finden Sie in den Werkzeugen zum Ausschneiden.

Abbildung

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:

  

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

  

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

  

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

  

• 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

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die auszuschneidenden Features.	Feature Layer
Clip-Features	Die Features zum Ausschneiden der Eingabe-Features.	Feature Layer
Ausgabe-Feature-Class	Die zu erstellende Feature-Class.	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

Python

arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class, {cluster_tolerance})

Name	Erläuterung	Datentyp
in_features	Die auszuschneidenden Features.	Feature Layer
clip_features	Die Features zum Ausschneiden der Eingabe-Features.	Feature Layer
out_feature_class	Die zu erstellende Feature-Class.	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

Codebeispiel

PairwiseClip – Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseClip_analysis("majorrds.shp", "study_quads.shp", 
                            "C:/output/studyarea.shp")

PairwiseClip – Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion PairwiseClip in einem eigenständigen Skript.

# Name: PairwiseClip_Example2.py
# 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"

# Execute Pairwise Clip
arcpy.PairwiseClip_analysis(in_features, clip_features, out_feature_class)

Umgebungen

Standard-Ausgabe-Z-Wert, M-Auflösung, M-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Ausdehnung, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Faktor für parallele Verarbeitung, Kurvensegmente beibehalten, Felddomänen, Subtypes und Attributregeln übertragen

Sonderfälle

Lizenzinformationen

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