Multi-parties vers une partie (Gestion des données)

Résumé

Crée une classe d'entités qui contient des entités en une partie générée en séparant des entités multi-parties en entrée.

Illustration

Illustration de l'outil Multi-parties vers une partie

Utilisation

  • Les attributs des entités en entrée seront conservés dans la classe d'entités points en sortie. Un nouveau champ, ORIG_FID, sera ajouté à la classe d'entités en sortie et défini sur les identifiants d'entité en entrée.

  • Chaque partie d'une entité multi-parties est séparée en entités individuelles dans la classe d'entités en sortie. Les entités qui sont déjà en une seule partie ne seront pas affectées.

  • La plupart des types d'entité en sortie seront les mêmes qu'en entrée (les polygones en entrée restent des polygones, les lignes en entrée restent des lignes). La seule exception concerne les entités en entrée de type multi-points, pour lesquelles la classe d'entités en sortie sera de type point.

  • Pour reconstruire des entités multi-parties à partir d'entités en une partie en fonction d'une valeur de champ commun, comme ORIG_FID, utilisez l'outil Fusionner.

  • Une entité multipatch est séparée dans les différentes parties géométriques qui la composent. Chaque partie peut être définie par un ensemble de sommets contenant des coordonnées X, Y et Z dont l'organisation est la suivante :

    • Triangles individuels qui référencent 3 sommets.
    • Bandes de triangle qui sont définies par plusieurs triangles qui partagent successivement un tronçon commun.
    • Eventails de triangles qui sont définis par plusieurs triangles avec un point d'origine commun.
    • Anneaux qui représentent une région co-planaire dont la limite est définie par 4 sommets ou plus.

Syntaxe

MultipartToSinglepart(in_features, out_feature_class)
ParamètreExplicationType de données
in_features

Entités en entrée qui peuvent être de tout type.

Feature Layer
out_feature_class

Classe d'entités en sortie contenant des entités qui varient avec le type d'entité en entrée.

Feature Class

Exemple de code

Exemple 1 d'utilisation de l'outil MultipartToSinglepart (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser la fonction MultipartToSinglepart en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.MultipartToSinglepart_management("landuse.shp",
                                       "c:/output/output.gdb/landuse_singlepart")
Exemple 2 d'utilisation de l'outil MultipartToSinglepart (script autonome)

Le script autonome suivant dessous est un exemple d'application simple de la fonction MultipartToSinglepart dans un environnement de scripts.

# 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])

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes