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

Advanced のライセンスで利用可能。

概要

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

ポリライン → ラスター (Polyline to Raster) ツールの機能の詳細

使用法

  • ポリライン フィーチャが格納されているフィーチャクラス (ジオデータベース、シェープファイル、カバレッジ) は、ラスター データセットに変換することが可能です。

  • 入力フィールドのタイプによって、出力ラスターのタイプが決まります。フィールドが整数の場合、出力ラスターは整数になり、フィールドが浮動小数点の場合、出力は浮動小数点になります。

    入力フィールドに文字列値が含まれている場合、出力ラスターには整数値フィールドと文字列フィールドが含まれます。

  • [セル サイズ] は、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定済みであれば [セル サイズ] 環境から取得されます。パラメーター セル サイズも環境セル サイズも指定されていないが、[スナップ ラスター] 環境が設定されている場合は、スナップ ラスターのセル サイズが使用されます。何も指定されていない場合、セル サイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された [出力座標系] にあります。

  • セル サイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。

    セル サイズがラスター データセットを使用して指定されている場合、パラメーターはセル サイズの値ではなくラスター データセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスター データセットのセル サイズが直接使用されます。データセットの空間参照が異なる場合は、選択された [セル サイズ投影法] に基づいて投影されます。

  • このツールは、ラスターをポリライン フィーチャクラスに変換する [ラスター → ポリライン (Raster to Polyline)] ツールと相補関係にあります。

  • このツールは、[フィーチャ → ラスター (Feature to Raster)] ツールと比べて、出力セル内に複数のフィーチャが存在するときのセル値の割り当てをより厳密に制御できます。

  • NULL 値をサポートするデータ形式 (ファイル ジオデータベース フィーチャクラスなど) では、入力として使用すると、NULL 値は無視されます。

  • このツールには、特定のラスター格納環境が適用されます。

    • ピラミッド環境では、[ピラミッド構築] の設定のみが使用されます。その他のピラミッド環境の設定は無視されます。以降の手順で [ピラミッド構築 (Build Pyramids)] ツールを使用して、ピラミッドの性質をさらに制御できます。

    • 圧縮環境では、圧縮のタイプのみが使用されます。これは、Esri Grid 以外のラスター形式に該当します。

構文

arcpy.conversion.PolylineToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
パラメーター説明データ タイプ
in_features

ラスターに変換するポリライン入力フィーチャ データセット。

Feature Layer
value_field

出力ラスターに値を割り当てるために使用するフィールド。

これは、入力フィーチャ データセットの属性テーブルの任意のフィールドになります。

Field
out_rasterdataset

作成する出力ラスター データセット。

出力ラスターをジオデータベースに保存しない場合、TIFF ファイル形式には *.tif、CRF ファイル形式には *.CRF、ERDAS IMAGINE ファイル形式には *.img を指定します。Esri Grid ラスター形式には拡張子を指定しません。

Raster Dataset
cell_assignment
(オプション)

セル内に複数のフィーチャが存在するときのセル値の割り当て方法を決定する手法。

  • MAXIMUM_LENGTHセル範囲を占有する最も丈長のフィーチャに基づいて、セルに割り当てる値を特定します。
  • MAXIMUM_COMBINED_LENGTHセル内に同じ値のフィーチャが複数ある場合、それらのフィーチャの長さを結合します。セル内の結合されているフィーチャのうちの最も長いフィーチャに基づいて、セルに割り当てる値を特定します。
String
priority_field
(オプション)

このフィールドに基づいて、セル上にある他のフィーチャよりも優先すべきフィーチャが決定されます。このフィールドを使用すると、[集約タイプ] の選択にかかわらず、変換には最大の優先度を持つフィーチャが必ず選択されます。

Field
cellsize
(オプション)

作成する出力ラスターのセル サイズ。

このパラメーターは、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセル サイズ値が使用されます。そうでない場合は、追加ルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。

Analysis Cell Size
build_rat
(オプション)

出力ラスターに、ラスター属性テーブルが含まれるかどうかを指定します。

このパラメーターの適用対象となるのは、整数ラスターだけです。

  • BUILD出力ラスターには、ラスター属性テーブルが含まれます。これがデフォルトです。
  • DO_NOT_BUILD出力ラスターには、ラスター属性テーブルが含まれません。
Boolean

コードのサンプル

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

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

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.PolylineToRaster_conversion("roads.shp", "CLASS", "c:/output/roads.img",
                                   "MAXIMUM_COMBINED_LENGTH", "LENGTH", 30)
PolylineToRaster (ポリライン → ラスター) の例 2 (スタンドアロン スクリプト)

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

# Name: PolylineToRaster_Ex_02.py
# Description: Converts polyline features to a raster dataset.

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inFeatures = "roads.shp"
valField = "CLASS"
outRaster = "c:/output/roads.tif"
assignmentType = "MAXIMUM_COMBINED_LENGTH"
priorityField = "LENGTH"
cellSize = 30

# Execute PolylineToRaster
arcpy.PolylineToRaster_conversion(inFeatures, valField, outRaster, 
                                  assignmentType, priorityField, cellSize)

ライセンス情報

  • Basic: 次のものが必要 Spatial Analyst または 3D Analyst
  • Standard: 次のものが必要 Spatial Analyst または 3D Analyst
  • Advanced: はい

関連トピック