概要
マルチパッチ フィーチャをラスター データセットに変換します。
図
![[マルチパッチ → ラスター (Multipatch to Raster)] の図](GUID-4E98765D-DB92-41DB-9277-BBA7C95345A7-web.png "[マルチパッチ → ラスター (Multipatch to Raster)] の図")
使用法
出力ラスターには、入力マルチパッチ フィーチャの、各セルの中心位置の Z 値が格納されます。各セルの Z 値を決定するために、入力マルチパッチ フィーチャと交差するように、セルの中心位置から垂直線が伸ばされます。それらの交点の最大 Z 値が、出力ラスターに割り当てられます。セルの中心が 1 つ以上の入力マルチパッチ フィーチャのフットプリント内にある場合、出力セルに値が割り当てられます。そうでない場合、出力セルには NoData が割り当てられます。
垂直な面の三角形 (基本的に屋根を持たない垂直の壁) は、ラスター化処理から除外されるため、出力ラスターには現れません。
[出力セル サイズ] は、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定済みであれば [セル サイズ] 環境から取得されます。パラメーター セル サイズも環境セル サイズも指定されていないが、[スナップ ラスター] 環境が設定されている場合は、スナップ ラスターのセル サイズが使用されます。何も指定されていない場合、セル サイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された [出力座標系] にあります。
セル サイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。
セル サイズがラスター データセットを使用して指定されている場合、パラメーターはセル サイズの値ではなくラスター データセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスター データセットのセル サイズが直接使用されます。データセットの空間参照が異なる場合は、選択された [セル サイズ投影法] に基づいて投影されます。
このツールを使用すると、都市空間内の 3D 建物フィーチャを (マルチパッチとして) デジタル標高モデル (DEM) に組み込むことができます。これを実行するには、最初にこのツールを使用してマルチパッチ フィーチャをラスターに変換します。次に、[モザイク (Mosaic)] ツールを使用して、建物ラスターを DEM ラスターにモザイク処理します。結果の標高ラスターに、ラスター データを操作する他のツールを使用して、都市空間内の問題を解析することができます。たとえば、[可視領域 (Viewshed)] ツールを使用して可視性を計算したり、日射量ツールを使用して都市環境における建物屋上の太陽エネルギーを計算したりできます。
デフォルトでは、このツールは複数コアのプロセッサを利用します。使用できるコアの最大数は 4 です。
ツールが使用するコア数を減らすには、並列処理ファクター環境設定を使用します。
構文
arcpy.conversion.MultipatchToRaster(in_multipatch_features, out_raster, {cell_size})| パラメーター | 説明 | データ タイプ |
in_multipatch_features | ラスターに変換する入力マルチパッチ フィーチャ。 | Feature Layer |
out_raster | 作成する出力ラスター データセット。 浮動小数点タイプです。 出力ラスターをジオデータベースに保存しない場合、TIFF ファイル形式には *.tif、CRF ファイル形式には *.CRF、ERDAS IMAGINE ファイル形式には *.img を指定します。Esri Grid ラスター形式には拡張子を指定しません。 | Raster Dataset |
cell_size (オプション) | 作成する出力ラスターのセル サイズ。 このパラメーターは、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセル サイズ値が使用されます。そうでない場合は、追加ルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。 | Analysis Cell Size |
コードのサンプル
この例は、マルチパッチ シェープファイルをラスターに変換し、出力ラスターを IMG 形式で保存します。
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MultipatchToRaster_conversion("buildings.shp",
"c:/output/outbuildings.img", 0.25)この例は、マルチパッチ シェープファイルをラスターに変換し、出力ラスターを TIFF 形式で保存します。
# Name: MultipatchToRaster_Ex_02.py
# Description: Converts multipatch 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 = "buildings.shp"
outRaster = "c:/output/outbuildings.tif"
cellSize = 0.5
# Execute MultipatchToRaster
arcpy.MultipatchToRaster_conversion(inFeatures, outRaster, cellSize)環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい