Resumen
Crea una clase de entidad que contiene entidades de parte simple generadas al separar entidades multiparte de entrada.
Ilustración
Uso
Los atributos de las entidades de entrada se mantendrán en la clase de entidad de salida. Se agregará un campo nuevo, ORIG_FID, a la clase de entidad de salida y se establecerá en los Id. de entidad de entrada.
Cada parte de una entidad multiparte se separará en entidades individuales en la clase de entidad de salida. Las entidades que ya son de parte simple no serán afectadas.
La mayoría de los tipos de entidades de salida serán iguales a los de entrada (los polígonos de entrada siguen siendo polígonos; las líneas de entrada siguen siendo líneas). La única excepción es que si las entidades de entrada son de tipo multipunto, la clase de entidad de salida será de tipo punto.
Para reconstruir entidades multiparte a partir de entidades de parte simple en función de un valor de campo común ORIG_FID, use la herramienta Disolver.
Una entidad multiparte se separará en las partes geométricas que la componen. Cada parte se puede definir mediante un conjunto de vértices que contienen coordenadas X, Y y Z organizadas como:
- Triángulos individuales que hacen referencia a 3 vértices.
- Franjas de triángulos definidas por varios triángulos que comparten sucesivamente un borde común.
- Abanicos triangulares definidos por varios triángulos con un punto de origen común.
- Anillos que representan una región coplanar cuyo límite viene definido por 4 o más vértices.
Sintaxis
MultipartToSinglepart_management (in_features, out_feature_class)
Parámetro | Explicación | Tipo de datos |
in_features | Entidades de entrada que pueden ser de cualquier tipo de entidad. | Feature Layer |
out_feature_class | Clase de entidad de salida que contiene entidades que varían según el tipo de entidad de entrada. | Feature Class |
Muestra de código
Ejemplo 1 de MultipartToSinglepart (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función MultipartToSinglepart en el modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.MultipartToSinglepart_management("landuse.shp",
"c:/output/output.gdb/landuse_singlepart")
Ejemplo 2 de MultipartToSinglepart (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente es un ejemplo simple de cómo aplicar la función MultipartToSinglepart en un entorno de secuencias de comandos.
# 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 this will be used as a unique identifier
arcpy.AddField_management(inFeatureClass, "tmpUID", "double")
# Determine what the name of the Object ID is
OIDFieldName = arcpy.Describe(inFeatureClass).OIDFieldName
# Calculate the tmpUID to the OID
arcpy.CalculateField_management(inFeatureClass, "tmpUID",
"!" + OIDFieldName + "!", "PYTHON")
# Run the tool to create a new fc with only singlepart features
arcpy.MultipartToSinglepart_management(inFeatureClass, outFeatureClass)
# Check if there is a different number of features in the output
# than there was in the input
inCount = int(arcpy.GetCount_management(inFeatureClass).getOutput(0))
outCount = int(arcpy.GetCount_management(outFeatureClass).getOutput(0))
if inCount != outCount:
# If there is a difference, print out the FID of the input
# features which were multipart
arcpy.Frequency_analysis(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])
Entornos
- Espacio de trabajo actual
- Espacio de trabajo temporal
- Valor Z de salida predeterminado
- Resolución M
- Tolerancia M
- Dominio M de salida
- Dominio Z de salida
- Sistema de coordenadas de salida
- Extensión
- La salida tiene valores M
- La salida tiene valores Z
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí