マルチパッチ → ラスター (Multipatch to Raster) (変換)

サマリー

マルチパッチ フィーチャをラスター データセットに変換します。

[マルチパッチ → ラスター (Multipatch to Raster)] ツールの図

使用法

  • 出力ラスターには、入力マルチパッチ フィーチャの、各セルの中心位置の Z 値が格納されます。 各セルの Z 値を決定するために、入力マルチパッチ フィーチャと交差するように、セルの中心位置から垂直線が伸ばされます。 それらの交点の最大または最小 Z 値が出力ラスターに割り当てられます。 セルの中心が 1 つ以上の入力マルチパッチ フィーチャのフットプリント内にある場合、出力セルに値が割り当てられます。そうでない場合、出力セルには NoData が割り当てられます。

  • 垂直な面の三角形 (基本的に屋根を持たない垂直の壁) は、ラスター化処理から除外されるため、出力ラスターには現れません。

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

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

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

  • このツールを使用すると、都市空間内の 3D 建物フィーチャを (マルチパッチとして) デジタル標高モデル (DEM) に組み込むことができます。 これを実行するには、最初にこのツールを使用してマルチパッチ フィーチャをラスターに変換します。 次に、[モザイク (Mosaic)] ツールを使用して、建物ラスターを DEM ラスターにモザイク処理します。 結果の標高ラスターに、ラスター データを操作する他のツールを使用して、都市空間内の問題を解析することができます。 たとえば、[可視領域 (Viewshed)] ツールを使用して可視性を計算したり、日射量ツールを使用して都市環境における建物屋上の太陽エネルギーを計算したりできます。

  • デフォルトでは、このツールは複数コアのプロセッサを利用します。使用できるコアの最大数は 4 です。

    ツールが使用するコア数を減らすには、並列処理ファクター環境設定を使用します。

パラメーター

ラベル説明データ タイプ
入力マルチパッチ フィーチャ

ラスターに変換する入力マルチパッチ フィーチャ。

Feature Layer
出力ラスター

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

浮動小数点タイプです。

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

Raster Dataset
出力セル サイズ
(オプション)

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

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

Analysis Cell Size
集約方法
(オプション)

入力マルチパッチ フィーチャと交差するように、セルの中心位置から垂直線が伸ばされる際に、セルの中心位置で Z 値が複数検出された場合に、セルに最大または最小 Z 値を使用するかどうかを指定します。

  • 最大高さ最大 Z 値がセルに割り当てられます。 これがデフォルトです。
  • 最小高さ最小 Z 値がセルに割り当てられます。
String

arcpy.conversion.MultipatchToRaster(in_multipatch_features, out_raster, {cell_size}, {cell_assignment_method})
名前説明データ タイプ
in_multipatch_features

ラスターに変換する入力マルチパッチ フィーチャ。

Feature Layer
out_raster

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

浮動小数点タイプです。

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

Raster Dataset
cell_size
(オプション)

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

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

Analysis Cell Size
cell_assignment_method
(オプション)

入力マルチパッチ フィーチャと交差するように、セルの中心位置から垂直線が伸ばされる際に、セルの中心位置で Z 値が複数検出された場合に、セルに最大または最小 Z 値を使用するかどうかを指定します。

  • MAXIMUM_HEIGHT最大 Z 値がセルに割り当てられます。 これがデフォルトです。
  • MINIMUM_HEIGHT最小 Z 値がセルに割り当てられます。
String

コードのサンプル

MultipatchToRaster (マルチパッチ → ラスター) の例 1 (Python ウィンドウ)

この例は、マルチパッチ シェープファイルをラスターに変換し、出力ラスターを IMG 形式で保存します。

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.MultipatchToRaster("buildings.shp",
                                    "c:/output/outbuildings.img", 0.25)
MultipatchToRaster (マルチパッチ → ラスター) の例 2 (スタンドアロン スクリプト)

この例は、マルチパッチ シェープファイルをラスターに変換し、出力ラスターを TIFF 形式で保存します。

# Name: MultipatchToRaster_Ex_02.py
# Description: Converts multipatch features to a raster dataset.

# Import system modules
import arcpy

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

# Set local variables
inFeatures = "buildings.shp"
outRaster = "c:/output/outbuildings.tif"
cellSize = 0.5

# Run MultipatchToRaster
arcpy.conversion.MultipatchToRaster(inFeatures, outRaster, cellSize)

関連トピック