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

サマリー

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

使用法

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

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

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

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

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

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

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

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

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

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ワークスペース	マージするラスター データセットを含むフォルダー。	Workspace
ターゲット ラスター データセット	入力ワークスペースからすべてのラスター データセットをマージする既存のラスター データセット。	Raster Dataset
サブディレクトリを含む (オプション)	サブディレクトリが含まれるかどうかを指定します。 オフ - サブディレクトリは含まれません。 これがデフォルトです。 オン - 読み込むときに、サブディレクトリ内のすべてのラスター データセットが含まれます。	Boolean
モザイク オペレーター (オプション)	オーバーラップ エリアのモザイク化に使用する方法を指定します。 最初—オーバーラップ エリアの出力セル値は、その格納場所にモザイクされる最初のラスター データセットの値になります。 最後—オーバーラップ エリアの出力セル値は、その格納場所にモザイクされる最後のラスター データセットの値になります。 これがデフォルトです。 ブレンド—オーバーラップ エリアの出力セル値は、オーバーラップ エリアのセルの値を水平に加重計算した値になります。 平均値—オーバーラップ エリアの出力セル値は、重なり合うセル間の平均値になります。 最小値—オーバーラップ エリアの出力セル値は、重なり合うセル間の最小値になります。 最大値—オーバーラップ エリアの出力セル値は、重なり合うセル間の最大値になります。 合計—オーバーラップ エリアの出力セル値は、重なり合うセル間の合計になります。	String
モザイク カラーマップ モード (オプション)	モザイク出力に適用されるカラーマップを入力ラスターから選択する際に使用するメソッドを指定します。 最初—一覧にある最初のラスター データセットのカラーマップを、出力ラスター モザイクに適用します。 これがデフォルトです。 最後—一覧にある最後のラスター データセットのカラーマップを、出力ラスター モザイクに適用します。 一致—モザイクの際に、すべてのカラーマップを考慮します。 (ビット深度に対して) すべての許容値がすでに使用されている場合、ツールは対象の値とそれに最も近い有効な色をマッチングします。 除外—カラー マップが関連付けられていないラスター データセットだけがモザイク処理されます。	String
背景値を除外 (オプション)	ラスター データの周囲に作成された不要な値を削除する場合に、このオプションを使用します。 指定した値は、ラスター データセットの他の有用なデータと区別されます。 たとえば、ラスター データセットの境界に沿ったゼロ値は、ラスター データセット内のゼロ値と区別されます。 指定したピクセル値は、出力ラスター データセットでは NoData に設定されます。 ファイルベースのラスターの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。エンタープライズおよびファイル ジオデータベース ラスターについては、この余分の処理を行う必要はありません。	Double
NoData 値 (オプション)	指定した値を持つすべてのピクセルが、出力ラスター データセットでは NoData に設定されます。	Double
1 ビット データを 8 ビットに変換 (オプション)	入力の 1 ビット ラスター データセットを 8 ビット ラスター データセットに変換するかどうかを指定します。 この変換では、入力ラスター データセットの値 1 が出力ラスター データセットで 255 に変更されます。 これは、1 ビット ラスター データセットをジオデータベースにインポートするときに便利です。 1 ビット ラスター データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤーを持ちますが、ジオデータベースでは 1 ビット ラスター データセットは 1 ビット ピラミッド レイヤーしか持つことができず、そのために表示品質が低下します。 このデータをジオデータベースの 8 ビットに変換すると、ピラミッド レイヤーが 1 ビットではなく 8 ビットとして作成されるため、本来のラスター データセットが表示されます。 オフ - 変換は行われません。 これがデフォルトです。 オン - 入力ラスターが変換されます。	Boolean
モザイク許容値 (オプション)	モザイクを実行したときに、ターゲット ピクセルとソース ピクセルの位置がいつも正確に揃うとは限りません。 ピクセルの位置にずれがある場合は、データをリサンプリングするかシフトするかを決める必要があります。 ピクセルのリサンプリングを実行するか、それともピクセルをシフトするかは、モザイク化の許容値によって制御されます。 入力データセットとターゲット データセットのピクセル配置の差が許容値より大きければ、リサンプリングが実行されます。 入力データセットとターゲット データセットのピクセル配置の差が許容範囲内であれば、リサンプリングは実行されず、シフトが実行されます。 許容値の単位はピクセルであり、有効な範囲は 0 〜 0.5 です。 許容値を 0.5 にすると、シフトが必ず発生します。 ピクセルの位置にずれがある場合、許容値が 0 であれば、必ずリサンプリングが発生します。 たとえば、ソースおよびターゲット ピクセルのずれが 0.25 であるとします。 モザイクの許容値が 0.2 に設定されている場合は、ピクセルのずれが許容値より大きいため、リサンプリングが行われます。 モザイク化の許容値が 0.3 に設定されていると、ピクセルがシフトします。	Double
カラー マッチング メソッド (オプション)	ラスターに適用するカラー マッチング メソッド。 なし—このオプションは、ラスター データセットをモザイク処理する際にカラー マッチング操作を使用しません。 統計情報のマッチング—この手法は、オーバーラップ エリアの記述的な統計情報を使用してから、ターゲット全体に変換を適用します。 ヒストグラムのマッチング—このメソッドは、参照するオーバーラップ エリアのヒストグラムをソースのオーバーラップ エリアにマッチングさせてから、ターゲット データセット全体に変換を適用します。 線形相関—この手法は、重なり合うピクセルをマッチングして、残りのソース データセットに内挿します。1 対 1 のリレーションシップがないピクセルには、加重平均を使用します。	String
カラーマップから RGB に変換 (オプション)	入力ラスター データセットにカラーマップが含まれる場合、入力ラスター データセットを 3 バンドの出力ラスター データセットに変換するかどうかを指定します。 これは、さまざまなカラーマップでラスターをモザイクするときに役立ちます。 オフ - 変換は行われません。 これがデフォルトです。 オン - 入力データセットが変換されます。	Boolean

派生した出力

ラベル	説明	データ タイプ
更新されたターゲット ラスター データセット	更新後のラスター データセット。	ラスター データセット

Python

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: Yes
• Standard: Yes
• Advanced: Yes