Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Eingabe-Features können jedes beliebige unterstützte Format aufweisen. | Feature Layer |
Ausgabe-Feature-Class | Die Ausgabe-Feature-Class, die Features enthält, die sich je nach Eingabe-Feature-Typ ändern. | Feature Class |
Zusammenfassung
Erstellt eine Feature-Class aus Singlepart-Features, indem Multipart-Eingabe-Features getrennt werden.
Abbildung
Verwendung
Die Attribute der Eingabe-Features werden in der Ausgabe-Feature-Class beibehalten. Ein neues Feld, ORIG_FID, wird der Ausgabe-Feature-Class hinzugefügt und auf die IDs des Eingabe-Features gesetzt.
Die einzelnen Teile des Multipart-Features werden in der Ausgabe-Feature-Class in einzelne Features getrennt. Features, die bereits Singlepart sind, sind davon nicht betroffen.
Die meisten Ausgabe-Feature-Typen sind mit den Eingabetypen identisch (Eingabepolygone bleiben Polygone; Eingabelinien bleiben Linien). Wenn die Eingabe-Features vom Typ "Multipoint" sind, ist die Ausgabe-Feature-Class vom Typ "Point".
Mit dem Werkzeug Zusammenführen lassen sich aus Singlepart-Features mit einem gemeinsamen Feldwert, z. B. ORIG_FID, Multipart-Features erstellen.
Ein Multipatch-Feature wird in seine konstituierenden Geometrieteile getrennt. Jeder Teil kann durch eine Sammlung von Stützpunkten mit X-, Y- und Z-Koordinaten definiert werden, die wie folgt angeordnet sind:
- Einzelne Dreiecke, die drei Stützpunkte referenzieren.
- Dreiecksstreifen, die durch mehrere Dreiecke definiert werden, die aufeinanderfolgend eine gemeinsame Kante aufweisen.
- Dreiecksfächer, die durch mehrere Dreiecke mit einem gemeinsamen Ursprungspunkt definiert sind.
- Ringe, die eine koplanare Region darstellen, deren Grenze durch mindestens vier Stützpunkte definiert ist.
Parameter
arcpy.management.MultipartToSinglepart(in_features, out_feature_class)
Name | Erläuterung | Datentyp |
in_features | Die Eingabe-Features können jedes beliebige unterstützte Format aufweisen. | Feature Layer |
out_feature_class | Die Ausgabe-Feature-Class, die Features enthält, die sich je nach Eingabe-Feature-Typ ändern. | Feature Class |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion MultipartToSinglepart im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.MultipartToSinglepart("landuse.shp",
"c:/output/output.gdb/landuse_singlepart")
Das folgende eigenständige Skript ist ein einfaches Beispiel für die Anwendung der Funktion MultipartToSinglepart in einer Skriptumgebung.
# Name: MultipartToSinglepart_Example2.py
# Description: Break all multipart features into singlepart features,
# and report which features were separated.
# Import system modules
import arcpy
# Create variables for the input and output feature classes
inFeatureClass = "c:/data/gdb.gdb/vegetation"
outFeatureClass = "c:/data/gdb.gdb/vegetation_singlepart"
try:
# Create list of all fields in inFeatureClass
fieldNameList = [field.name for field in arcpy.ListFields(inFeatureClass)]
# Add a field to the input that will be used as a unique identifier
arcpy.management.AddField(inFeatureClass, "tmpUID", "double")
# Determine what the name of the Object ID is
OIDFieldName = arcpy.Describe(inFeatureClass).OIDFieldName
# Calculate the tmpUID to the OID
arcpy.management.CalculateField(inFeatureClass, "tmpUID",
f"!{OIDFieldName}!", "PYTHON3")
# Run the tool to create a new fc with only singlepart features
arcpy.management.MultipartToSinglepart(inFeatureClass, outFeatureClass)
# Check if there is a different number of features in the output
# than there was in the input
inCount = int(arcpy.management.GetCount(inFeatureClass)[0])
outCount = int(arcpy.management.GetCount(outFeatureClass)[0])
if inCount != outCount:
# If there is a difference, print the FID of the input
# features that were multipart
arcpy.analysis.Frequency(outFeatureClass,
outFeatureClass + "_freq", "tmpUID")
# Use a search cursor to go through the table, and print the tmpUID
print("Multipart features from {0}".format(inFeatureClass))
for row in arcpy.da.SearchCursor(outFeatureClass + "_freq",
["tmpUID"], "FREQUENCY > 1"):
print(int(row[0]))
else:
print("No multipart features were found")
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err.args[0])