Teilen (Analysis)

Mit der Advanced-Lizenz verfügbar.

Zusammenfassung

Teilt eine Eingabe mit überlagernden Features, um eine Teilmenge von Ausgabe-Feature-Classes zu erstellen.

Abbildung

Die Eingabe-Features werden basierend auf vier von sechs überlagernden Teilen-Features in vier Ausgabe-Feature-Classes geteilt. Diese sechs Teilen-Features entsprechen sechs Einzelwerten des Split-Feldes.

Verwendung

• Die Einzelwerte des Parameters Teilungsfeld bilden die Namen für die Ausgabe-Feature-Classes. Diese werden im Ziel-Workspace gespeichert.

• Das Dataset Teilen-Features muss aus Polygonen bestehen.

• Der Datentyp des Split-Feldes muss als "Zeichen" angegeben werden. Seine Einzelwerte bilden die Namen der Ausgabe-Feature-Classes.

• Die Einzelwerte des Split-Feldes müssen mit einem gültigen Zeichen beginnen. Wenn der Ziel-Workspace eine Geodatabase ist, müssen die Werte des Feldes mit einem Buchstaben beginnen. Feldwerte, die mit einer Zahl (Beispiel: 350 Grad) beginnen, verursachen einen Fehler. Shapefile-Namen können jedoch mit einer Zahl beginnen, und ein Ordner als Ziel-Workspace lässt Feldwerte zu, die mit einer Zahl beginnen.

• Der Ziel-Workspace muss bereits vorhanden sein.

• Die Gesamtzahl der Ausgabe-Feature-Classes entspricht der Anzahl der Einzelwerte für das Split-Feld und dem Umfang der Überlagerung der Eingabe-Features-Werte mit den Teilen-Features-Werten.

• Die Feature-Attributtabelle der einzelnen Ausgabe-Feature-Classes enthält die gleichen Felder wie die Attributtabelle der Eingabe-Features.

• Annotation-Features werden anhand des Teilen-Features-Polygons geteilt und in der Ausgabe-Feature-Class gespeichert, in dem sich der linke untere Anfangspunkt der Annotationszeichenfolge befindet.

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

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die zu teilenden Features.	Feature Layer
Teilen-Features	Polygon-Features mit einem Tabellenfeld, dessen Einzelwerte für die Teilung der Eingabe-Features verwendet und für die Benennung der Ausgabe-Feature-Classes herangezogen werden.	Feature Layer
Teilungs-Feld	Das Zeichenfeld, das zum Teilen der Eingabe-Features verwendet wird. Die Werte dieses Feldes stehen für die Teilen-Features, mit denen die einzelnen Ausgabe-Feature-Classes erstellt werden. Die Einzelwerte des Teilungsfeldes bilden die Namen für die Ausgabe-Feature-Classes.	Field
Ziel-Workspace	Der vorhandene Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden.	Workspace ; Feature Dataset
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. Geben Sie für Daten mit einer geringeren Koordinatengenauigkeit einen höheren Wert als für Datasets mit sehr hoher Genauigkeit an. 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

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierter Ziel-Workspace	Der Workspace mit den durch Teilung der Eingabe erstellten Feature-Classes.	Workspace; Feature Dataset

Python

arcpy.analysis.Split(in_features, split_features, split_field, out_workspace, {cluster_tolerance})

Name	Erläuterung	Datentyp
in_features	Die zu teilenden Features.	Feature Layer
split_features	Polygon-Features mit einem Tabellenfeld, dessen Einzelwerte für die Teilung der Eingabe-Features verwendet und für die Benennung der Ausgabe-Feature-Classes herangezogen werden.	Feature Layer
split_field	Das Zeichenfeld, das zum Teilen der Eingabe-Features verwendet wird. Die Werte dieses Feldes stehen für die Teilen-Features, mit denen die einzelnen Ausgabe-Feature-Classes erstellt werden. Die Einzelwerte des Teilungsfeldes bilden die Namen für die Ausgabe-Feature-Classes.	Field
out_workspace	Der vorhandene Workspace, in dem die Ausgabe-Feature-Classes gespeichert werden.	Workspace ; Feature Dataset
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. Geben Sie für Daten mit einer geringeren Koordinatengenauigkeit einen höheren Wert als für Datasets mit sehr hoher Genauigkeit an. 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

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_workspace2	Der Workspace mit den durch Teilung der Eingabe erstellten Feature-Classes.	Workspace; Feature Dataset

Codebeispiel

Teilen – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion Split verwenden.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.analysis.Split("Habitat_Analysis.gdb/vegtype", "climate.shp", "Zone", 
                     "C:/output/Output.gdb", "1 Meters")

Teilen – Beispiel 2 (eigenständiges Skript)

Ein Vegetations-Layer soll in separate Feature-Classes für jede Klimazone geteilt werden.

# Name: Split.py
# Description: Split vegetation layer into separate feature classes 
# for each climate zone

# import system modules 
import arcpy 

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

# Split vegetation layer by climate zones, write to Output.gdb
veg = "Habitat_Analysis.gdb/vegtype"
splitFeatures = "climate.shp"
splitField = "Zone"
outWorkspace = "C:/output/Output.gdb"
clusterTol = "1 Meters"

arcpy.analysis.Split(veg, splitFeatures, splitField, outWorkspace, 
                     clusterTol)

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

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: Nein
• Standard: Nein
• Advanced: Ja