ワークスペース → ラスタ データセット（Workspace To Raster Dataset） (データの管理)
サマリ
指定したワークスペース内に格納されているすべてのラスタ データセットを、1 つのラスタ データセットにモザイク化します。
使用法
-
このツールを実行するには、ターゲット ラスタ カタログがすでに存在している必要があります。
-
ターゲット ラスタ データセットが存在しない場合は、[ラスタ データセットの作成（Create Raster Dataset）] ツールを使って新しいラスタ データセットを作成します。
-
モザイク化が行われる場合、使用するモザイク方法とカラーマップ モードを指定する必要があります。
-
ターゲット ラスタ データセットが空のラスタ データセットである場合、最初の入力ラスタ データセットのセル サイズと空間参照がモザイクに適用されます。
-
可能な場合は常に、最後の [モザイク オペレータ] を使用して、ファイル ジオデータベースまたは ArcSDE ジオデータベース内の既存のラスタ データセットにラスタ データセットをモザイク化するようにしてください。このモザイク化方法は、他の方法よりもはるかに効率的です。
-
不連続データをモザイク化する場合、[モザイク オペレータ] オプションに、[FIRST]、[MINIMUM]、または [MAXIMUM] を使用すると、最も有意な結果が得られます。連続データを扱う場合、最適な [モザイク オペレータ] オプションは、[BLEND] と [MEAN] です。
-
カラー マッチング方式のドロップダウン矢印により、モザイク データセットをカラー マッチングするアルゴリズムを選択できます。
-
ファイルベースのラスタおよびパーソナル ジオデータベース ラスタの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。ファイル ジオデータベース ラスタと ArcSDE ラスタについては、この余分の処理を行う必要はありません。
-
浮動小数点の入力ラスタ データセット同士の解像度がそれぞれ異なる場合、あるいはセル同士が位置揃えされていない場合は、[モザイク（Mosaic）] を実行する前に、共一次内挿法または三次たたみ込み内挿法を使用して、すべてのデータをリサンプリングすることをお勧めします。そうしないと、[モザイク（Mosaic）] の実行時に、連続データ タイプに適さない最近隣内挿法のリサンプリングを使用して、自動的にラスタ データセットがリサンプリングされます。
構文
| パラメータ | 説明 | データ タイプ |
in_workspace |
ラスタ データセットにモザイク化するすべてのラスタ データセットを含むワークスペース。 | Workspace |
in_raster_dataset |
モザイク化されたワークスペースのすべてのラスタ データセットを格納するラスタ データセット。このラスタ データセットはすでに存在している必要があります。 | Raster Dataset |
include_subdirectories (オプション) |
サブディレクトリを含めるかどうかを指定します。
| Boolean |
mosaic_type (オプション) |
オーバーラップ エリアのモザイク化に使用するメソッド。
各モザイク オペレータの詳細については、「モザイク オペレータ」をご参照ください。 | String |
colormap (オプション) |
モザイク出力に適用されるカラーマップを入力ラスタから選択する際に使用するメソッド。
各カラーマップ モードの詳細については、「モザイク カラーマップ モード」をご参照ください。 | String |
background_value (オプション) |
ラスタ データの周囲に作成された不要な値を削除する場合に、このオプションを使用します。指定した値は、ラスタ データセットの他の有用なデータと区別されます。たとえば、ラスタ データセットの境界に沿ったゼロ値は、ラスタ データセット内のゼロ値と区別されます。 指定したピクセル値は、出力ラスタ データセットでは NoData に設定されます。 ファイルベースのラスタおよびパーソナル ジオデータベース ラスタの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。ArcSDE およびファイル ジオデータベース ラスタについては、この余分の処理を行う必要はありません。 | Double |
nodata_value (オプション) |
指定した値を持つすべてのピクセルが、出力ラスタ データセットでは NoData に設定されます。 | Double |
onebit_to_eightbit (オプション) |
入力の 1 ビット ラスタ データセットを 8 ビット ラスタ データセットに変換するかどうかを選択します。この変換では、入力ラスタ データセットの値 1 が出力ラスタ データセットの 255 に変更されます。これは、1 ビット ラスタ データセットを ArcSDE にインポートするときに便利です。1 ビット ラスタ データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤを持ちますが、ArcSDE では 1 ビット ラスタ データセットは 1 ビット ピラミッド レイヤしか持つことができず、そのために表示が不十分なものになります。このデータを ArcSDE の 8 ビットに変換すると、ピラミッド レイヤが 1 ビットではなく 8 ビットとして作成されるため、本来のラスタ データセットが表示されます。
| Boolean |
mosaicking_tolerance (オプション) |
モザイク化を実行したときに、ターゲット ピクセルとソース ピクセルの位置がいつも正確に揃うとは限りません。ピクセルの位置にずれがある場合は、リサンプリングを実行するかそれともデータをシフトするかを決める必要があります。ピクセルのリサンプリングを実行するか、それともピクセルをシフトするかは、モザイク化の許容値によって制御されます。 入力データセットとターゲット データセットのピクセル配置の差が許容値より大きければ、リサンプリングが実行されます。入力データセットとターゲット データセットのピクセル配置の差が許容範囲内であれば、リサンプリングは実行されません（代わりに、シフトが実行されます）。 許容値の単位はピクセルであり、有効な範囲は 0 ～ 0.5 です。許容値を 0.5 にすると、シフトが必ず発生します。ピクセルの位置にずれがある場合、許容値が 0 であれば、必ずリサンプリングが発生します。 たとえば、ソースおよびターゲット ピクセルのずれが 0.25 であるとします。モザイク化の許容値が 0.2 に設定されている場合は、ピクセルのずれが許容値より大きいため、リサンプリングが行われます。モザイク化の許容値が 0.3 に設定されていると、ピクセルがシフトします。 | Double |
MatchingMethod (オプション) |
ラスタに適用するカラー マッチング メソッドを選択します。
| String |
colormap_to_RGB (オプション) |
入力ラスタ データセットがカラーマップを持つ場合、出力ラスタ データセットを 3 バンドの出力ラスタ データセットに変換できます。これは、別のカラーマップでラスタをモザイク化するときに役立ちます。
| Boolean |
コードのサンプル
これは WorkspaceToRasterDataset（ワークスペース → ラスタ データセット）ツールを表す Python サンプルです。
import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
"INCLUDE_SUBDIRECTORIES", "LAST",
"FIRST", "0", "9", "", "",
"HISTOGRAM_MATCHING", "")
これは 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}
try:
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")
except:
print "Workspace To Raster Dataset example failed."
print arcpy.GetMessages()