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.

Für Ausschneidevorgänge gibt es ein alternatives Werkzeug. Weitere Informationen finden Sie im Werkzeug Paarweise 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.

• Dieses Werkzeug verwendet einen Kachelvorgang, um beim Verarbeiten sehr großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter Geoverarbeitung mit großen Datasets.

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

  

• Die Attributwerte der Eingabe-Feature-Classes werden in die Ausgabe-Feature-Class kopiert. Wenn es sich bei der Eingabe jedoch um Layer handelt, die mit dem Werkzeug Feature-Layer erstellen erstellt wurden, und die Option Verhältnismethode verwenden eines Feldes aktiviert ist, wird ein Verhältnis zum Eingabe-Attributwert berechnet. Ist die Option Verhältnismethode verwenden aktiviert, stellen die Attribute des resultierenden Features bei jeder Teilung eines Features in einem Überlagerungsvorgang ein Verhältnis des Attributwertes des Eingabe-Features dar. Der Ausgabewert basiert auf dem Verhältnis, in dem die Eingabe-Feature-Geometrie geteilt wurde. Wenn die Geometrie beispielsweise in gleiche Teile geteilt wurde, wird dem Attributwert jedes neuen Features der halbe Wert des Attributwertes des Eingabe-Features zugewiesen. Verhältnismethode verwenden gilt nur für numerische Feldtypen.

  Vorsicht:

  Geoverarbeitungswerkzeuge berücksichtigen die Teilungsmethoden von Geodatabase-Feature-Class- oder -Tabellenfeldern nicht.

• Dieses Werkzeug berücksichtigt die Umgebung Faktor für parallele Verarbeitung. Wenn die Umgebung nicht (Standard) oder auf "0" festgelegt ist, ist die parallele Verarbeitung deaktiviert. Durch Festlegen der Umgebung auf den Wert "100" wird die parallele Verarbeitung aktiviert.

Syntax

arcpy.analysis.Clip(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

Clip – Beispiel 1 (Python-Fenster)

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

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

Clip – Beispiel 2 (eigenständiges Skript)

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

# Name: Clip_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 Clip
arcpy.Clip_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

Lizenzinformationen

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