ワークスペース → ラスター データセット (Workspace To Raster Dataset) (データ管理)

概要

フォルダー内のすべてのラスター データセットを 1 つのラスター データセットにマージします。

使用法

  • このツールを実行するには、ターゲット ラスター カタログがすでに存在している必要があります。

  • ターゲット ラスター データセットが存在しない場合は、[ラスター データセットの作成 (Create Raster Dataset)] ツールを使って新しいラスター データセットを作成します。

  • モザイク化が行われる場合、使用するモザイク方法とカラーマップ モードを指定する必要があります。

  • ターゲット ラスター データセットが空のラスター データセットである場合、最初の入力ラスター データセットのセル サイズと空間参照がモザイクに適用されます。

  • 可能な場合は常に、最後の [モザイク オペレーター] を使用して、ファイル ジオデータベースまたはエンタープライズ ジオデータベース内の既存のラスター データセットにラスター データセットをモザイク化するようにしてください。このモザイク化方法は、他の方法よりもはるかに効率的です。

  • 不連続データをモザイクする場合、[モザイク オペレーター][最初][最小値]、または [最大値] オプションを使用すると、最も有意な結果が得られます。[ブレンド] オプションと [平均値] オプションは、連続データに最適です。

  • カラー マッチング方式のドロップダウン矢印により、モザイク データセットをカラー マッチングするアルゴリズムを選択できます。

  • ファイルベースのラスターの場合は、背景値を除外するために、[背景値を除外]NoData と同じ値に設定する必要があります。ジオデータベース ラスターについては、この追加の処理を行う必要はありません。

  • 浮動小数点の入力ラスター データセット同士の解像度がそれぞれ異なる場合、あるいはセル同士が位置揃えされていない場合は、[モザイク (Mosaic)] を実行する前に、共一次内挿法または三次たたみ込み内挿法を使用して、すべてのデータをリサンプリングすることを推奨します。そうしないと、[モザイク (Mosaic)] の実行時に、連続データ タイプに適さない最近隣内挿法のリサンプリングを使用して、自動的にラスター データセットがリサンプリングされます。

構文

arcpy.management.WorkspaceToRasterDataset(in_workspace, in_raster_dataset, {include_subdirectories}, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod}, {colormap_to_RGB})
パラメーター説明データ タイプ
in_workspace

マージするラスター データセットを含むフォルダー。

Workspace
in_raster_dataset

入力ワークスペースからすべてのラスター データセットをマージする既存のラスター データセット。

Raster Dataset
include_subdirectories
(オプション)

サブディレクトリを含めるかどうかを指定します。

  • NONEサブディレクトリを含めません。これがデフォルトです。
  • INCLUDE_SUBDIRECTORIES読み込むときに、サブディレクトリ内のすべてのラスター データセットを含めます。
Boolean
mosaic_type
(オプション)

オーバーラップ エリアのモザイク化に使用する方法を指定します。

  • FIRSTオーバーラップ エリアの出力セル値は、その格納場所にモザイクされる最初のラスター データセットの値になります。
  • LASTオーバーラップ エリアの出力セル値は、その格納場所にモザイクされる最後のラスター データセットの値になります。これがデフォルトです。
  • BLENDオーバーラップ エリアの出力セル値は、オーバーラップ エリア内のセル値の横方向の加重計算値になります。
  • MEANオーバーラップ エリアの出力セル値は、重なり合うセル間の平均値になります。
  • MINIMUMオーバーラップ エリアの出力セル値は、重なり合うセル間の最小値になります。
  • MAXIMUMオーバーラップ エリアの出力セル値は、重なり合うセル間の最大値になります。
  • SUMオーバーラップ エリアの出力セル値は、重なり合うセル間の合計値になります。
String
colormap
(オプション)

モザイク出力に適用されるカラーマップを入力ラスターから選択する際に使用するメソッドを指定します。

  • FIRST一覧にある最初のラスター データセットのカラーマップを、出力ラスター モザイクに適用します。これがデフォルトです。
  • LAST一覧にある最後のラスター データセットのカラーマップを、出力ラスター モザイクに適用します。
  • MATCHモザイクの際に、すべてのカラーマップを考慮します。(ビット深度に対して) すべての許容値がすでに使用されている場合、ツールは対象の値とそれに最も近い有効な色をマッチングします。
  • REJECTカラーマップに関連付けられていないラスター データセットのみをモザイクします。
String
background_value
(オプション)

ラスター データの周囲に作成された不要な値を削除する場合に、このオプションを使用します。指定した値は、ラスター データセットの他の有用なデータと区別されます。たとえば、ラスター データセットの境界に沿ったゼロ値は、ラスター データセット内のゼロ値と区別されます。

指定したピクセル値は、出力ラスター データセットでは NoData に設定されます。

ファイルベースのラスターの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。エンタープライズおよびファイル ジオデータベース ラスターについては、この余分の処理を行う必要はありません。

Double
nodata_value
(オプション)

指定した値を持つすべてのピクセルが、出力ラスター データセットでは NoData に設定されます。

Double
onebit_to_eightbit
(オプション)

入力の 1 ビット ラスター データセットを 8 ビット ラスター データセットに変換するかどうかを選択します。この変換では、入力ラスター データセットの値 1 が出力ラスター データセットで 255 に変更されます。これは、1 ビット ラスター データセットをジオデータベースにインポートするときに便利です。1 ビット ラスター データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤーを持ちますが、ジオデータベースでは 1 ビット ラスター データセットは 1 ビット ピラミッド レイヤーしか持つことができず、そのために表示が不十分なものになります。このデータをジオデータベースの 8 ビットに変換すると、ピラミッド レイヤーが 1 ビットではなく 8 ビットとして作成されるため、本来のラスター データセットが表示されます。

  • NONE変換を実行しません。これがデフォルトです。
  • OneBitTo8Bit入力ラスターが変換されます。
Boolean
mosaicking_tolerance
(オプション)

モザイクを実行したときに、ターゲット ピクセルとソース ピクセルの位置がいつも正確に揃うとは限りません。ピクセルの位置にずれがある場合は、データをリサンプリングするかシフトするかを決める必要があります。ピクセルのリサンプリングを実行するか、それともピクセルをシフトするかは、モザイク化の許容値によって制御されます。

入力データセットとターゲット データセットのピクセル配置の差が許容値より大きければ、リサンプリングが実行されます。入力データセットとターゲット データセットのピクセル配置の差が許容範囲内であれば、リサンプリングは実行されず、シフトが実行されます。

許容値の単位はピクセルであり、有効な範囲は 0 〜 0.5 です。許容値を 0.5 にすると、シフトが必ず発生します。ピクセルの位置にずれがある場合、許容値が 0 であれば、必ずリサンプリングが発生します。

たとえば、ソースおよびターゲット ピクセルのずれが 0.25 であるとします。モザイクの許容値が 0.2 に設定されている場合は、ピクセルのずれが許容値より大きいため、リサンプリングが行われます。モザイク化の許容値が 0.3 に設定されていると、ピクセルがシフトします。

Double
MatchingMethod
(オプション)

ラスターに適用するカラー マッチング メソッド。

  • NONEこのオプションは、ラスター データセットをモザイク処理する際にカラー マッチング操作を使用しません。
  • STATISTIC_MATCHINGこの手法は、オーバーラップ エリアの記述的な統計情報を使用してから、ターゲット全体に変換を適用します。
  • HISTOGRAM_MATCHINGこのメソッドは、参照するオーバーラップ エリアのヒストグラムをソースのオーバーラップ エリアにマッチングさせてから、ターゲット データセット全体に変換を適用します。
  • LINEARCORRELATION_MATCHINGこの手法は、重なり合うピクセルをマッチングして、残りのソース データセットに内挿します。1 対 1 のリレーションシップがないピクセルには、加重平均を使用します。
String
colormap_to_RGB
(オプション)

入力ラスター データセットがカラーマップを持つ場合、出力ラスター データセットを 3 バンドの出力ラスター データセットに変換できます。これは、別のカラーマップでラスターをモザイクするときに役立ちます。

  • NONE変換は行われません。これがデフォルトです。
  • ColormapToRGB入力データセットが変換されます。
Boolean

派生した出力

名前説明データ タイプ
out_raster_dataset

更新後のラスター データセット。

ラスター データセット

コードのサンプル

WorkspaceToRasterDataset (ワークスペース → ラスター データセット) の例 1 (Python ウィンドウ)

以下は、WorkspaceToRasterDataset ツールを実行する Python サンプルです。

import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
                                          "INCLUDE_SUBDIRECTORIES", "LAST",
                                          "FIRST", "0", "9", "", "",
                                          "HISTOGRAM_MATCHING", "")
WorkspaceToRasterDataset (ワークスペース → ラスター データセット) の例 2 (スタンドアロン スクリプト)

以下は、WorkspaceToRasterDataset ツールを実行する Python スクリプト サンプルです。

##==================================
##Workspace To Raster Dataset
##Usage: WorkspaceToRasterDataset_management in_workspace in_raster_dataset {NONE | INCLUDE_SUBDIRECTORIES} 
##                                           {LAST | FIRST | BLEND | MEAN | MINIMUM | MAXIMUM} {FIRST | REJECT
##                                           | LAST | MATCH} {background_value} {nodata_value} {NONE | OneBitTo8Bit} 
##                                           {mosaicking_tolerance}  {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
##                                           | LINEARCORRELATION_MATCHING} {NONE | ColormapToRGB}

import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic images to File Geodatabase Raster Dataset with Background and Nodata setting and Color Correction
arcpy.WorkspaceToRasterDataset_management("WS2RD", "fgdb.gdb\\dataset", "INCLUDE_SUBDIRECTORIES", "LAST", \
                                          "FIRST", "0", "9", "", "", "HISTOGRAM_MATCHING", "")

##Mosaic Colormap image to RGB image
arcpy.WorkspaceToRasterDataset_management("WS2RD_clr","fgdb.gdb\\dataset2", "INCLUDE_SUBDIRECTORIES", "LAST",\
                                          "FIRST", "", "", "", "0.3", "", "ColormapToRGB")

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: はい
  • Standard: はい
  • Advanced: はい

関連トピック