De Multiparte A Parte Simple (Administración de datos)

Resumen

Crea una clase de entidad que contiene entidades de parte simple generadas al separar entidades multiparte de entrada.

Ilustración

Ilustración de De multiparte a parte simple

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

arcpy.management.MultipartToSinglepart(in_features, out_feature_class)
ParámetroExplicaciónTipo 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])

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados