Ausschneiden (Analysis)

Zusammenfassung

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

Verwenden Sie dieses Werkzeug, wenn Sie einen Teil eines Datasets mithilfe eines oder mehrerer Features in einem anderen Dataset (wie mit einer "Ausstechform") ausschneiden möchten. Dies ist besonders nützlich beim Erstellen eines neuen Datasets (auch als Untersuchungsgebiet oder Interessenbereich bezeichnet), das eine geographische Teilmenge der Features in einem anderen, größeren Dataset enthält.

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

Abbildung

Abbildung des Werkzeugs "Ausschneiden"

Verwendung

  • Je nach Parametertyp, der für Eingabe-Features oder -Dataset festgelegt wurde, können die Parameterwerte der Clip-Features Punkte, Linien und Polygone sein.

    • Wenn die Werte für Eingabe-Features oder -Dataset Polygone sind, müssen die Clip-Features ebenfalls Polygone sein.
    • Wenn die Werte für Eingabe-Features oder -Dataset 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 Werte für Eingabe-Features oder -Dataset 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.
    • Wenn der Wert für Eingabe-Features oder -Dataset ein Szenen-Layer bzw. Szenen-Layer-Paket mit integrierten Meshes, Punkten, Gebäuden, 3D-Objekten oder einer Punktwolke ist, müssen die Werte für Clip-Features Polygone sein.

  • Der Parameter Ausgabe-Features oder -Dataset enthält alle Attribute des Parameters Eingabe-Features oder -Dataset, wenn es sich bei der Ausgabe um eine Feature-Class handelt.

  • Für Szenen-Layer-Pakete und Szenenservices, die integrierte Meshes, Punkte, Gebäude oder 3D-Objekte enthalten, muss I3S der Version 1.6 oder höher verwendet werden, damit es als Eingabe verwendet werden kann. Verwenden Sie das Werkzeug Szenen-Layer-Upgrade durchführen, um ein Upgrade von Version 1.5 und niedrigeren Szenen-Layer-Paketen durchzuführen. Das Ausgabe-Szenen-Layer-Paket weist die aktuelle I3S-Version auf.

  • Szenen-Services müssen die Funktion zum Extrahieren aufweisen, damit sie zugeschnitten werden können. Services ohne diese Funktion werden als Eingabe blockiert.

  • Wenn es sich bei der Eingabe um einen Gebäude-Szenen-Layer handelt, werden alle Kategorie- und Disziplin-Layer ausgeschnitten. Wenn es sich bei der Eingabe um einen Kategorie-Layer handelt, ist das Ausgabe-Szenen-Layer-Paket ein 3D-Objekt-Szenen-Layer-Paket, das nur den ausgewählten Eingabe-Layer enthält.

  • Dieses Werkzeug wendet einen Kachelungsvorgang an, um beim Verarbeiten großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter Gekachelte Verarbeitung großer Datasets.

  • 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

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features oder -Dataset

Die Features, die zugeschnitten werden.

Feature Layer; Scene Layer; File; Building Scene Layer
Clip-Features

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

Feature Layer
Ausgabe-Features oder -Dataset

Das erstellte Dataset.

Feature Class; File
XY-Toleranz
(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 Daten mit sehr hoher Genauigkeit einen niedrigeren.

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

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

Die Features, die zugeschnitten werden.

Feature Layer; Scene Layer; File; Building Scene Layer
clip_features

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

Feature Layer
out_feature_class

Das erstellte Dataset.

Feature Class; File
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 Daten mit sehr hoher Genauigkeit einen niedrigeren.

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.analysis.Clip("majorrds.shp", "study_quads.shp", 
                    "C:/output/studyarea.shp")
Clip: Beispiel 2 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion Clip mit einem Szenen-Layer verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Clip("campus.slpk", "building_footprint.shp", 
                    "C:/output/AreaOfInterest.slpk")
Clip: Beispiel 3 (eigenständiges Skript)

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


# 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 Clip
arcpy.analysis.Clip(in_features, clip_features, out_feature_class)
Clip: Beispiel 4 (eigenständiges Skript)

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


# Description: Clip a scene service. 

# Import system modules
import arcpy

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

# Set local variables
scene_service = "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/2021_02_04_Frankfurt/SceneServer"
mesh_layer_name = "mesh_layer"
clip_features = "AOI.shp"
out_feature_class = "C:/output/studyarea.shp"

# Create a layer of a scene service
mesh_layer = arcpy.management.MakeSceneLayer(scene_service,
                                             mesh_layer_name)

# Run Clip
arcpy.analysis.Clip(mesh_layer, clip_features, out_feature_class)

Umgebungen

Sonderfälle

Faktor für parallele Verarbeitung

Dieses Werkzeug berücksichtigt die Umgebung "Faktor für parallele Verarbeitung". Wenn die Umgebung nicht festgelegt ist (Standardeinstellung) oder auf 0 festgelegt ist, ist die parallele Verarbeitung deaktiviert. Die parallele Verarbeitung wird nicht verwendet; die Verarbeitung erfolgt stattdessen sequenziell. Durch Festlegen der Umgebung auf 100 wird die parallele Verarbeitung aktiviert. Die Verarbeitung erfolgt dann parallel. Es werden bis zu 10 Kerne verwendet, wenn die parallele Verarbeitung aktiviert ist.

Die parallele Verarbeitung wird derzeit für Überlagerungsvorgänge vom Typ "Polygon auf Polygon", "Linie auf Polygon" und "Punkt auf Polygon" unterstützt.

Lizenzinformationen

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

Verwandte Themen