| ラベル | 説明 | データ タイプ |
入力フィーチャ | 集約対象のフィーチャ。 | Feature Layer |
出力フィーチャクラス | 集約されたフィーチャを含む、作成対象のフィーチャクラス。 | Feature Class |
ディゾルブ フィールド (オプション) | フィーチャが集約されるフィールド。 フィールドが指定されていない場合、ツールはすべてのフィーチャを一括でディゾルブします。 | Field |
統計フィールド (オプション) | 特定の統計の計算に使用される属性値を含むフィールド (複数可) を指定します。 複数の統計とフィールドの組み合わせを指定できます。 すべての計算から NULL 値が除外されます。 デフォルトでは、ツールはどの統計も計算しません。 テキスト属性フィールドは、最初と最後の統計を使用して集計されます。 数値属性フィールドは、任意の統計を使用して集計されます。 使用できる統計タイプは次のとおりです。
| Value Table |
マルチパート フィーチャの作成 (オプション) | マルチパート フィーチャが出力フィーチャクラスで許可されるかどうかを指定します。
| Boolean |
ラインの接合 (オプション) | ライン フィーチャのディゾルブ方法を指定します。
| Boolean |
連結区切り文字 (オプション) | [連結] オプションを [統計フィールド] パラメーターに使用した場合に、値の連結に使用する文字。 デフォルトでは、ツールは区切り文字なしで値を連結します。 | String |
サマリー
指定した属性に基づいてフィーチャを集約します。
ディゾルブ操作に代替ツールを使用できます。 詳細については、[ペアワイズ ディゾルブ (Pairwise Dissolve)] ツールのドキュメントをご参照ください。
図
使用法
このツールによって集約されるフィーチャの属性は、さまざまな統計情報を使用して、集計したり説明したりできます。 属性の集計に使用される統計情報は、統計タイプ + アンダースコア + 入力フィールド名という命名規則に従って名前が付けられ、出力フィーチャクラスに単一フィールドとして追加されます。 たとえば、POP という名前のフィールドに SUM の統計情報の種類が使用されている場合、出力には SUM_POP という名前のフィールドが含まれます。
[ディゾルブ (Dissolve)] は、出力フィーチャクラスに非常に大きなフィーチャを作成する可能性があります。特に、[ディゾルブ フィールド] パラメーターに個別値が少なかったり、すべてのフィーチャを 1 つのフィーチャにディゾルブする場合に起こりやすくなります。 非常に大きなフィーチャは、マップの描画時や編集時に、処理または表示上の問題や性能の低下を引き起こす可能性があります。 ディゾルブが 1 台のコンピューター上に最大サイズのフィーチャを出力し、この出力を使用可能なメモリの少ないコンピューターに移動した場合にも、問題が発生する可能性があります。 これらの問題を回避するには、[マルチパート フィーチャを作成] パラメーターを使用して、大きくなりそうなマルチパート フィーチャを多くの小さなフィーチャに分割する、シングルパート フィーチャを作成します。 [ディゾルブ (Dissolve)] ツールで作成された極端に大きなフィーチャについては、処理、表示、または性能の問題を解決するために、[フィーチャの分割 (Dice)] ツールの使用によるフィーチャの分割が可能です。
すべての統計計算から NULL 値が除外されます。 たとえば、10、5、NULL の平均は 7.5 (= (10 + 5) / 2) です。 カウントには、統計計算に含まれる値の数が返されます。つまり、この場合は 2 です。
パフォーマンスとスケーラビリティの向上のため、このツールは、タイル プロセスを使用して非常に大きなデータセットを処理します。 詳細については、「大きいデータセットのタイル化処理」をご参照ください。
物理メモリの使用可能な容量は、1 つの出力フィーチャに処理およびディゾルブできる入力フィーチャの量 (と複雑さ) の制限となる場合があります。 この制限のために、ディゾルブ処理に使用可能以上のメモリを要求したことによるエラーが発生する可能性があります。 これを防ぐために、[ディゾルブ (Dissolve)] は適応型分割アルゴリズムを使用して入力フィーチャを分割処理する場合があります。 分割されたフィーチャを判定するには、このツールの結果に [頻度 (Frequency)] ツールを実行し、[頻度フィールド] パラメーターに対して、ディゾルブ処理で使用したのと同じフィールドを指定します。 頻度値が 2 のレコードが分割されています。 ArcGIS で使用できないほど大きなフィーチャが作成されないように、タイル境界は出力フィーチャ内に保持されます。
注意:
適応型分割アルゴリズムを使用して入力を分割処理したディゾルブの出力に対して、再び [ディゾルブ (Dissolve)] を実行しても、出力中のフィーチャの数はほとんど減りません。 出力フィーチャの最大サイズは、実行時に使用可能なメモリ サイズによって決まります。タイルを含む出力は、ディゾルブがこれ以上リソースを使用すると、メモリ不足や使用不可能なフィーチャなどを引き起こす恐れがあることを示しています。 さらに、ディゾルブで作成された出力に対して、再び [ディゾルブ (Dissolve)] ツールを実行すると、ほとんど成果を得られずに性能低下を招くだけでなく、予期しない障害を引き起こす可能性さえあります。
[ラインの接合] パラメーターはライン入力に対してのみ適用されます。 デフォルトが指定された場合、ラインをシングル フィーチャにディゾルブします。そうでなければ、共通の端点 (疑似ノード) を持つ 2 つのラインだけが 1 つの連続したラインにマージされます。
[入力フィーチャ] パラメーター値のジオメトリ タイプがポイントまたはマルチポイントであり、[マルチパート フィーチャの作成] パラメーターがオンの場合は、出力がマルチポイント フィーチャクラスになります。 一方、[マルチパート フィーチャの作成] パラメーターがオフの場合は、出力がポイント フィーチャクラスになります。
パラメーター
arcpy.management.Dissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part}, {unsplit_lines}, {concatenation_separator})| 名前 | 説明 | データ タイプ |
in_features | 集約対象のフィーチャ。 | Feature Layer |
out_feature_class | 集約されたフィーチャを含む、作成対象のフィーチャクラス。 | Feature Class |
dissolve_field [dissolve_field,...] (オプション) | フィーチャが集約されるフィールド。 フィールドが指定されていない場合、ツールはすべてのフィーチャを一括でディゾルブします。 | Field |
statistics_fields [[field, {statistic_type}],...] (オプション) | 特定の統計の計算に使用される属性値を含むフィールド (複数可) を指定します。 複数の統計とフィールドの組み合わせを指定できます。 すべての計算から NULL 値が除外されます。 デフォルトでは、ツールはどの統計も計算しません。 テキスト属性フィールドは、最初と最後の統計を使用して集計されます。 数値属性フィールドは、任意の統計を使用して集計されます。 使用できる統計タイプは次のとおりです。
| Value Table |
multi_part (オプション) | マルチパート フィーチャが出力フィーチャクラスで許可されるかどうかを指定します。
| Boolean |
unsplit_lines (オプション) | ライン フィーチャのディゾルブ方法を指定します。
| Boolean |
concatenation_separator (オプション) | CONCATENATION オプションを statistics_fields パラメーターに使用した場合に、値の連結に使用する文字。 デフォルトでは、ツールは区切り文字なしで値を連結します。 | String |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Dissolve 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.management.Dissolve("taxlots", "C:/output/output.gdb/taxlots_dissolved",
["LANDUSE", "TAXCODE"], "", "SINGLE_PART",
"DISSOLVE_LINES")次のスタンドアロン スクリプトで、Dissolve 関数を使用する方法を示します。
# Name: Dissolve_Example2.py
# Description: Dissolve features based on common attributes
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
# Set local variables
inFeatures = "taxlots"
tempLayer = "taxlotsLyr"
expression = arcpy.AddFieldDelimiters(inFeatures, "LANDUSE") + " <> ''"
outFeatureClass = "C:/output/output.gdb/taxlots_dissolved"
dissolveFields = ["LANDUSE", "TAXCODE"]
# Run MakeFeatureLayer and SelectLayerByAttribute. This is only to exclude
# features that are not desired in the output.
arcpy.management.MakeFeatureLayer(inFeatures, tempLayer)
arcpy.management.SelectLayerByAttribute(tempLayer, "NEW_SELECTION", expression)
# Run Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.management.Dissolve(tempLayer, outFeatureClass, dissolveFields, "",
"SINGLE_PART", "DISSOLVE_LINES")