ラインの接合 (Unsplit Line)—ヘルプ

サマリ
図
使用法
構文
コードのサンプル
環境
ライセンス情報

サマリ

一致する端点 (および、オプションで共通の属性値) を持つラインをマージします。

図

使用法

このツールによって集約されるフィーチャの属性は、さまざまな統計情報タイプを使って集計または定義できます。属性の集計に使用される統計情報タイプは、「統計情報タイプ + アンダースコア + 入力フィールド名」の名前規則に従って、単一フィールドとして出力フィーチャクラスに追加されます。たとえば、入力に POP という名前のフィールドがあり、これが集計される場合に、SUM 統計情報タイプを使うと、出力フィーチャクラスのフィールド名は SUM_POP となります。
物理メモリの使用可能な容量は、1 つの出力ラインフィーチャに処理および接合できる入力フィーチャの量 (および複雑さ) の制限となる場合があります。この制限のために、接合処理に使用可能以上のメモリを要求したことによるエラーが発生する可能性があります。これを防ぐために、[ライン接合 (Unsplit Line)] は適応型分割アルゴリズムを使用して入力フィーチャを分割処理する場合があります。分割されたフィーチャを判定するには、このツールの結果に [頻度 (Frequency)] ツールを実行し、[頻度フィールド] パラメーターに対して、[ディゾルブフィールド] パラメーターで使用したのと同じフィールドを指定します。頻度値が 2 のレコードが分割されています。ArcGIS で使用できないほど大きなフィーチャが作成されないように、タイル境界は出力フィーチャ内に保持されます。

注意:
適応型分割アルゴリズムを使用して入力を分割処理した接合の出力に対して、再び [ラインの接合 (Unsplit Line)] を実行しても、出力中のフィーチャの数はほとんど減りません。出力フィーチャの最大サイズは、実行時に使用可能なメモリサイズによって決まります。そのため、タイルを含む出力は、接合がこれ以上リソースを使用すると、メモリ不足や使用不可能なフィーチャなどを引き起こす恐れがあることを示しています。さらに、接合で作成された出力に対して、再び [ラインの接合 (Unsplit Line)] を実行すると、ほとんど成果を得られずに相当な性能低下を招くだけでなく、予期しない障害を引き起こす可能性さえあります。
すべての統計情報計算から NULL 値が除外されます。たとえば、10、5、および NULL の平均値は 7.5 です ((10+5)/2)。COUNT ツールは、統計情報計算に含まれている値の数を返しますが、この例では 2 を返します。
[ディゾルブフィールド] パラメーターの [フィールドの追加] ボタンは、ModelBuilder だけで使用されます。ModelBuilder では、先のツールが実行されていないか、出力データが存在しないために、[ディゾルブフィールド] パラメーターにフィールド名が表示されない場合があります。[フィールドの追加] ボタンで必要なフィールドを追加することで、ツールのダイアログボックスを完了して引き続きモデルを作成することができます。

構文

UnsplitLine_management (in_features, out_feature_class, {dissolve_field}, {statistics_fields})

パラメータ	説明	データタイプ
in_features	集約するラインフィーチャ。	Feature Layer
out_feature_class	集約されたフィーチャを含む、作成対象のフィーチャクラス。	Feature Class
dissolve_field [dissolve_field,...] (オプション)	フィーチャを集約するフィールド。 [フィールドの追加] ボタンは ModelBuilder だけで使用され、ダイアログボックスを完了してモデルの作成を続行できるように、必要なフィールドが追加されます。	Field
statistics_fields [[field, {statistic_type}],...] (オプション)	属性を集計するフィールドと統計情報。テキスト属性フィールドは、統計情報の [FIRST] または [LAST] を使用して集計されます。数値属性フィールドは、任意の統計情報を使用して集計されます。すべての統計情報計算から NULL が除外されます。 FIRST - 入力フィーチャの最初の値を検出し、その指定されたフィールドの値を使用します。 LAST - 入力フィーチャの最後の値を検出し、その指定されたフィールドの値を使用します。 SUM - 指定されたフィールドの値の合計を追加します。 MEAN - 指定されたフィールドの平均を計算します。 MIN - 指定されたフィールドのすべてのレコードの中で最も小さい値を検出します。 MAX - 指定されたフィールドのすべてのレコードの中で最も大きい値を検出します。 RANGE - 指定されたフィールドの値の範囲 (MAX-MIN) を検出します。 STD - 指定されたフィールドの値の標準偏差を検出します。 COUNT - 統計情報の計算に含まれる値の数を検出します。NULL 値以外の値の数がカウントされます。フィールドの NULL 値の数を特定するには、問題のフィールドで COUNT 統計情報を使用し、NULL を含まない異なるフィールド (ある場合は OID など) で COUNT 統計情報を使用して、2 つの値で減算を行います。	Value Table

コードのサンプル

UnsplitLine (ラインの接合) の例 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードで UnsplitLine (ラインの接合) ツールを使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.UnsplitLine_management("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])

UnsplitLine (ラインの接合) の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、UnsplitLine (ラインの接合) ツールの使用方法を示しています。

# Name: UnsplitLine_Example2.py
# Description: Unsplit line features based on common attributes
 
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
 
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/streets_unsplit"
dissolveFields = ["STREETNAME", "PREFIX"]
 
# Execute UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.UnsplitLine_management(inFeatures, outFeatureClass, dissolveFields)

ライセンス情報

ArcGIS for Desktop Basic: ×
ArcGIS for Desktop Standard: ×
ArcGIS for Desktop Advanced: ○

サマリ

図

使用法

構文

コードのサンプル

UnsplitLine (ラインの接合) の例 (Python ウィンドウ)

UnsplitLine (ラインの接合) の例 2 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

UnsplitLine (ラインの接合) の例 2 (スタンドアロンスクリプト)