| ラベル | 説明 | データ タイプ |
入力ラスター | 入力ラスター データセット。 ラスターは整数タイプでなければなりません。 | Raster Layer |
出力ポリライン フィーチャ | 変換されたポリラインの格納先となる出力フィーチャクラス | Feature Class |
背景値 (オプション) | 背景セルの識別値を指定します。ラスター データセットは、一連の前景セルおよび背景セルとして表示されます。ライン フィーチャは、前景セルから形成されます。
| String |
最小ダングル長 (オプション) | 保持されるダングル ポリラインの最小長。デフォルトは 0 です。 | Double |
ポリラインの単純化 (オプション) | ラインの基本的な形状を維持しながら細かな変動や外側の曲げを取り除くことによってラインを単純化します。
| Boolean |
フィールド (オプション) | 入力ラスター内のセルから取得した値を出力データセット内のポリライン フィーチャに割り当てるために用いられるフィールド。 整数または文字列のフィールドを使用できます。 | Field |
サマリー
ラスター データセットをポリライン フィーチャに変換します。
使用法
入力ラスターには、0 より大きい有効なセル サイズを指定できます。また、有効な整数ラスター データセットであればどのようなものでもかまいません。
[フィールド] パラメーターを使用すると、出力フィーチャクラスの属性に変換される入力ラスター データセットの属性フィールドを選択できます。フィールドが指定されていない場合、入力ラスターのセル値 (VALUE フィールド) は、出力フィーチャクラスの属性テーブル内で見出しが Grid_code の列の値になります。
出力ポリライン フィーチャに変換する際の入力ラスターをベクター変換する方法を次の図に示します。この結果は [単純化] パラメーターのどちらの設定にも表示されます。
![それぞれの [単純化] オプションによる出力の図](GUID-E851414D-F011-4408-A42F-4233B3A42C8F-web.png "それぞれの [単純化] オプションによる出力の図")
それぞれの [単純化] オプションによる出力の比較 環境設定で [範囲] が指定され、出力範囲の左下隅が入力ラスターのどのセルの隅にも一致しない場合、処理では、指定された範囲に一致するように入力ラスターのセル配置のシフトが実行されます。このシフトにより、最近隣内挿法を使用した入力ラスターのリサンプリングが開始されます。したがって、出力フィーチャもシフトされるため、結果として、出力フィーチャが元の入力ラスターを正確にオーバーレイしない場合があります。このシフトが実行されないようにするには、環境内で入力ラスターを [スナップ対象ラスター] として使用します。
パラメーター
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 (オプション) | 背景セルの識別値を指定します。ラスター データセットは、一連の前景セルおよび背景セルとして表示されます。ライン フィーチャは、前景セルから形成されます。
| String |
minimum_dangle_length (オプション) | 保持されるダングル ポリラインの最小長。デフォルトは 0 です。 | Double |
simplify (オプション) | ラインの基本的な形状を維持しながら細かな変動や外側の曲げを取り除くことによってラインを単純化します。
| Boolean |
raster_field (オプション) | 入力ラスター内のセルから取得した値を出力データセット内のポリライン フィーチャに割り当てるために用いられるフィールド。 整数または文字列のフィールドを使用できます。 | Field |
コードのサンプル
ラスター データセットをポリライン フィーチャに変換します。
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.RasterToPolyline_conversion("flowstr", "c:/output/streams.shp", "ZERO",
50, "SIMPLIFY")ラスター データセットをポリライン フィーチャに変換します。
# Name: RasterToPolyline_Ex_02.py
# Description: Converts a raster dataset to polyline features.
# Requirements: None
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "flowstr"
outLines = "c:/output/flowstream.shp"
backgrVal = "ZERO"
dangleTolerance = 50
field = "VALUE"
# Execute RasterToPolygon
arcpy.RasterToPolyline_conversion(inRaster, outLines, backgrVal,
dangleTolerance, "SIMPLIFY", field)環境
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes