ラスター → ポリライン (Raster to Polyline) (変換)

サマリー

ラスター データセットをポリライン フィーチャに変換します。

使用法

  • 入力ラスターには、0 より大きい有効なセル サイズを指定できます。また、有効な整数ラスター データセットであればどのようなものでもかまいません。

  • [フィールド] パラメーターを使用すると、出力フィーチャクラスの属性に変換される入力ラスター データセットの属性フィールドを選択できます。 フィールドが指定されていない場合、入力ラスターのセル値 (VALUE フィールド) は、出力フィーチャクラスの属性テーブル内で見出しが Grid_code のカラムの値になります。

  • 出力ポリライン フィーチャに変換する際の入力ラスターをベクター変換する方法を次の図に示します。 この結果は [単純化] パラメーターのどちらの設定にも表示されます。

    それぞれの単純化オプションによる出力の図
    それぞれの単純化オプションによる出力の比較
  • 環境設定で [範囲] が指定され、出力範囲の左下隅が入力ラスターのどのセルの隅にも一致しない場合、処理では、指定された範囲に一致するように入力ラスターのセル配置のシフトが実行されます。 このシフトにより、最近隣内挿法を使用した入力ラスターのリサンプリングが開始されます。 したがって、出力フィーチャもシフトされるため、結果として、出力フィーチャが元の入力ラスターを正確にオーバーレイしない場合があります。 このシフトが実行されないようにするには、環境内で入力ラスターを [スナップ対象ラスター] として使用します。

パラメーター

ラベル説明データ タイプ
入力ラスター

入力ラスター データセット。

ラスターは整数タイプでなければなりません。

Raster Layer
出力ポリライン フィーチャ

変換されたポリラインの格納先となる出力フィーチャクラス

Feature Class
背景値
(オプション)

背景セルの識別値を指定します。 ラスター データセットは、一連の前景セルおよび背景セルとして表示されます。 ライン フィーチャは、前景セルから形成されます。

  • ゼロ背景を、0 以下の値あるいは NoData が格納されたセルから構成します。 ゼロより大きい値が格納されたセルはすべて、前景値と見なされます。
  • NoData背景を NoData セルから構成します。 有効な値が格納されているセルはすべて、前景に属します。
String
最小ダングル長
(オプション)

保持されるダングル ポリラインの最小長。 デフォルトは 0 です。

Double
ポリラインの単純化
(オプション)

ラインの基本的な形状を維持しながら細かな変動や外側の曲げを取り除くことによってラインを単純化します。

  • オン - 各ポリラインを、含まれるセグメントの数が最小になるような形状に単純化します。 これがデフォルトです。
  • オフ - ポリラインを単純化しません。
Boolean
フィールド
(オプション)

入力ラスター内のセルから取得した値を出力データセット内のポリライン フィーチャに割り当てるために用いられるフィールド。

整数または文字列のフィールドを使用できます。

Field

arcpy.conversion.RasterToPolyline(in_raster, out_polyline_features, {background_value}, {minimum_dangle_length}, {simplify}, {raster_field})
名前説明データ タイプ
in_raster

入力ラスター データセット。

ラスターは整数タイプでなければなりません。

Raster Layer
out_polyline_features

変換されたポリラインの格納先となる出力フィーチャクラス

Feature Class
background_value
(オプション)

背景セルの識別値を指定します。 ラスター データセットは、一連の前景セルおよび背景セルとして表示されます。 ライン フィーチャは、前景セルから形成されます。

  • ZERO背景を、0 以下の値あるいは NoData が格納されたセルから構成します。 ゼロより大きい値が格納されたセルはすべて、前景値と見なされます。
  • NODATA背景を NoData セルから構成します。 有効な値が格納されているセルはすべて、前景に属します。
String
minimum_dangle_length
(オプション)

保持されるダングル ポリラインの最小長。 デフォルトは 0 です。

Double
simplify
(オプション)

ラインの基本的な形状を維持しながら細かな変動や外側の曲げを取り除くことによってラインを単純化します。

  • SIMPLIFY各ポリラインを、含まれるセグメントの数が最小になるような形状に単純化します。 これがデフォルトです。
  • NO_SIMPLIFYポリラインを単純化しません。
Boolean
raster_field
(オプション)

入力ラスター内のセルから取得した値を出力データセット内のポリライン フィーチャに割り当てるために用いられるフィールド。

整数または文字列のフィールドを使用できます。

Field

コードのサンプル

RasterToPolyline (ラスター → ポリライン) の例 (Python ウィンドウ)

ラスター データセットをポリライン フィーチャに変換します。

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToPolyline("flowstr", "c:/output/streams.shp", "ZERO",
                                  50, "SIMPLIFY")
RasterToPolyline (ラスター → ポリライン) の例 (スタンドアロン スクリプト)

ラスター データセットをポリライン フィーチャに変換します。

# Name: RasterToPolyline_Ex_02.py
# Description: Converts a raster dataset to polyline features.
# Requirements: None

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inRaster = "flowstr"
outLines = "c:/output/flowstream.shp"
backgrVal = "ZERO"
dangleTolerance = 50
field = "VALUE"

# Run RasterToPolygon
arcpy.conversion.RasterToPolyline(inRaster, outLines, backgrVal, 
                                  dangleTolerance, "SIMPLIFY", field)

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック