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 Parametertyp der Eingabe-Features können die Parameterwerte der Clip-Features Punkte, Linien und Polygone sein.

  • Wenn die Eingabe-Features Polygone sind, müssen die Clip-Features ebenfalls Polygone sein.
  • Wenn die Eingabe-Features Linien sind, können die Clip-Features Linien oder Polygone 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 die Eingabe-Features Punkte sind, 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.

Syntax

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

Parameter	Erklärung	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 sowie die Strecke, um die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) bewegt werden kann. Legen Sie für Daten mit einer geringeren Koordinatengenauigkeit einen höheren Wert fest und für Datasets mit sehr hoher Genauigkeit einen niedrigen. 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-Werte, 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

Lizenzinformationen

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