マルチパート → シングルパート (Multipart To Singlepart) (データ管理)

サマリー

マルチパート入力フィーチャを分割し、シングルパート フィーチャのフィーチャクラスを作成します。

マルチパート → シングルパートの図

使用法

  • 入力フィーチャの属性は、出力フィーチャクラス内に保持されます。その出力フィーチャクラスに追加された新しいフィールド ORIG_FID は、入力フィーチャ ID に設定されます。

  • マルチパート フィーチャの各パートは、出力フィーチャクラス内の個々のフィーチャに分割されます。 すでにシングルパートになっているフィーチャは、影響を受けません。

  • 出力フィーチャ タイプのほとんどは、入力と同じになります (入力ポリゴンはポリゴンのままで、入力ラインはラインのままです)。 入力フィーチャがマルチポイント タイプのときは、出力フィーチャクラスがポイント タイプになります。

  • ORIG_FID などの共通のフィールド値に基づいてシングルパート フィーチャからマルチパート フィーチャを再構成するには、[ディゾルブ (Dissolve)] ツールを使用します。

  • マルチパッチ フィーチャは、ジオメトリ パートに分割されます。 各パートは、次のように配置された X、Y、Z 座標を含む頂点のコレクションによって定義できます。

    • 3 つの頂点を参照する個々の三角形。
    • 1 つの共通のエッジを連続的に共有する複数の三角形によって定義される三角形ストリップ。
    • 原点を共有する複数の三角形によって定義される三角形ファン。
    • 4 つ以上の頂点によって境界が定義される同一平面上の領域を表すリング。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

入力フィーチャには、任意のフィーチャ タイプを指定できます。

Feature Layer
出力フィーチャクラス

入力フィーチャ タイプに応じて異なるフィーチャを格納する出力フィーチャクラス。

Feature Class

arcpy.management.MultipartToSinglepart(in_features, out_feature_class)
名前説明データ タイプ
in_features

入力フィーチャには、任意のフィーチャ タイプを指定できます。

Feature Layer
out_feature_class

入力フィーチャ タイプに応じて異なるフィーチャを格納する出力フィーチャクラス。

Feature Class

コードのサンプル

MultipartToSinglepart の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで MultipartToSinglepart 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.MultipartToSinglepart("landuse.shp",
                                       "c:/output/output.gdb/landuse_singlepart")
MultipartToSinglepart 例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、MultipartToSinglepart 関数をスクリプティング環境で適用する方法を示した単純な例です。

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

関連トピック