新規ラスターにモザイク (Mosaic To New Raster) (データ管理)

サマリー

複数のラスター データセットを新しいラスター データセットにマージします。

使用法

  • 入力ラスター データセットは、一括してモザイクされる対象のラスター データセットです。入力にはそれぞれ、同じバンド数および同じビット深度を指定する必要があります。そうしないと、ツールはエラーで終了します。

  • [モザイク (Mosaic)] ツールには、データセットを既存のラスターに結合するときに使用できるパラメーター (たとえば、背景値や NoData 値を無視するオプションなど) が比較的多く用意されています。

  • 既存の入力ラスター データセットに一致するピクセル タイプを設定する必要があります。ピクセル タイプを設定しない場合はデフォルト (8 ビット) が使用されますが、出力が不正確になることがあります。

  • 出力は、BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF、またはジオデータベース ラスター データセットに保存することができます。

  • ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。

  • GIF 形式がサポートするのは、シングルバンド ラスター データセットのみです。

  • カラーマップを含むラスター データセットをモザイク処理する際に重要となるのは、モザイクする各ラスター データセットのカラーマップ間の差分に注目することです。 このような場合、数種のカラーマップを含むラスターには [モザイク (Mosaic)] ツールを使用しますが、[モザイク カラーマップ モード] ドロップダウン リストから適切なパラメーター値を選択する必要があります。 選択したカラーマップ モードが適切なものでないと、期待した出力が得られないことがあります。

  • このツールでは、エンタープライズ ジオデータベースの出力範囲環境設定が考慮されません。出力ラスター用に特定の範囲を指定したい場合は、[クリップ (Clip)] ツールを使用することを検討してください。このツールを使用する前に入力ラスターをクリップすることも、あるいはこのツールの出力をクリップすることもできます。

パラメーター

ラベル説明データ タイプ
入力ラスター

マージするラスター データセット。入力には、同数のバンドおよび同じビット深度が必要です。

Mosaic Dataset; Raster Dataset; Raster Layer
出力場所

ラスターを格納されるフォルダーまたはジオデータベース。

Workspace
ラスター データセット名 (拡張子)

作成するデータセットの名前。

ラスター データセットをファイル形式で格納する場合は、次のようにファイル拡張子を指定します。

  • .bil(Esri BIL)
  • .bip(Esri BIP)
  • .bmp(BMP)
  • .bsq(Esri BSQ)
  • .dat(ENVI DAT)
  • .gif(GIF)
  • .img(ERDAS IMAGINE)
  • .jpg(JPEG)
  • .jp2(JPEG 2000)
  • .png(PNG)
  • .tif(TIFF)
  • 拡張子なし (Esri GRID)

ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。

ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、TIFF 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。

String
ラスターの空間参照
(オプション)

出力ラスター データセットの座標系。

Coordinate System
ピクセル タイプ
(オプション)

モザイク データセットのビット深度または放射量分解能。

ピクセル タイプを設定しない場合はデフォルト (8 ビット) が使用されますが、出力が不正確になることがあります。

  • 1 ビットピクセル タイプは 1 ビット符号なし整数になります。 値は 0 または 1 です。
  • 2 ビットピクセル タイプは 2 ビット符号なし整数になります。 サポートされる値の範囲は 0 〜 3 です。
  • 4 ビットピクセル タイプは 4 ビット符号なし整数になります。 サポートされる値の範囲は 0 〜 15 です。
  • 符号なし 8 ビットピクセル タイプは 8 ビット符号なしデータ タイプになります。 サポートされる値の範囲は 0 〜 255 です。
  • 符号付き 8 ビットピクセル タイプは 8 ビット符号付きデータ タイプになります。 サポートされる値の範囲は -128 〜 127 です。
  • 符号なし 16 ビットピクセル タイプは 16 ビット符号なしデータ タイプになります。 値の範囲は 0 ~ 65,535 です。
  • 符号付き 16 ビットピクセル タイプは 16 ビット符号付きデータ タイプになります。 値の範囲は -32,768 〜 32,767 です。
  • 符号なし 32 ビットピクセル タイプは 32 ビット符号なしデータ タイプになります。 値の範囲は 0 〜 4,294,967,295 です。
  • 符号付き 32 ビットピクセル タイプは 32 ビット符号付きデータ タイプになります。 値の範囲は -2,147,483,648 〜 2,147,483,647 です。
  • 32 ビット浮動小数点ピクセル タイプは小数点をサポートする 32 ビット データ タイプになります。
  • 64 ビットピクセル タイプは小数点をサポートする 64 ビット データ タイプになります。
String
セル サイズ
(オプション)

新しいラスター データセットに使用されるピクセル サイズ。

Double
バンド数

出力ラスターのバンド数。

Long
モザイク オペレーター
(オプション)

重なり合う領域をモザイク処理する際の方法。

各モザイク オペレーターの詳細については、「モザイク オペレーター」のヘルプ トピックをご参照ください。

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

入力ラスター データセットにカラーマップが含まれている場合に適用します。

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

各カラーマップ モードの詳細については、「モザイク カラーマップ モード」のヘルプ トピックをご参照ください。

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

派生した出力

ラベル説明データ タイプ
出力ラスター データセット

出力ラスター データセット。

ラスター データセット

arcpy.management.MosaicToNewRaster(input_rasters, output_location, raster_dataset_name_with_extension, {coordinate_system_for_the_raster}, {pixel_type}, {cellsize}, number_of_bands, {mosaic_method}, {mosaic_colormap_mode})
名前説明データ タイプ
input_rasters
[input_raster,...]

マージするラスター データセット。入力には、同数のバンドおよび同じビット深度が必要です。

Mosaic Dataset; Raster Dataset; Raster Layer
output_location

ラスターを格納されるフォルダーまたはジオデータベース。

Workspace
raster_dataset_name_with_extension

作成するデータセットの名前。

ラスター データセットをファイル形式で格納する場合は、次のようにファイル拡張子を指定します。

  • .bil(Esri BIL)
  • .bip(Esri BIP)
  • .bmp(BMP)
  • .bsq(Esri BSQ)
  • .dat(ENVI DAT)
  • .gif(GIF)
  • .img(ERDAS IMAGINE)
  • .jpg(JPEG)
  • .jp2(JPEG 2000)
  • .png(PNG)
  • .tif(TIFF)
  • 拡張子なし (Esri GRID)

ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。

ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、TIFF 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。

String
coordinate_system_for_the_raster
(オプション)

出力ラスター データセットの座標系。

Coordinate System
pixel_type
(オプション)

モザイク データセットのビット深度または放射量分解能。

ピクセル タイプを設定しない場合はデフォルト (8 ビット) が使用されますが、出力が不正確になることがあります。

  • 1_BITピクセル タイプは 1 ビット符号なし整数になります。 値は 0 または 1 です。
  • 2_BITピクセル タイプは 2 ビット符号なし整数になります。 サポートされる値の範囲は 0 〜 3 です。
  • 4_BITピクセル タイプは 4 ビット符号なし整数になります。 サポートされる値の範囲は 0 〜 15 です。
  • 8_BIT_UNSIGNEDピクセル タイプは 8 ビット符号なしデータ タイプになります。 サポートされる値の範囲は 0 〜 255 です。
  • 8_BIT_SIGNEDピクセル タイプは 8 ビット符号付きデータ タイプになります。 サポートされる値の範囲は -128 〜 127 です。
  • 16_BIT_UNSIGNEDピクセル タイプは 16 ビット符号なしデータ タイプになります。 値の範囲は 0 ~ 65,535 です。
  • 16_BIT_SIGNEDピクセル タイプは 16 ビット符号付きデータ タイプになります。 値の範囲は -32,768 〜 32,767 です。
  • 32_BIT_UNSIGNEDピクセル タイプは 32 ビット符号なしデータ タイプになります。 値の範囲は 0 〜 4,294,967,295 です。
  • 32_BIT_SIGNEDピクセル タイプは 32 ビット符号付きデータ タイプになります。 値の範囲は -2,147,483,648 〜 2,147,483,647 です。
  • 32_BIT_FLOATピクセル タイプは小数点をサポートする 32 ビット データ タイプになります。
  • 64_BITピクセル タイプは小数点をサポートする 64 ビット データ タイプになります。
String
cellsize
(オプション)

新しいラスター データセットに使用されるピクセル サイズ。

Double
number_of_bands

出力ラスターのバンド数。

Long
mosaic_method
(オプション)

重なり合う領域をモザイク処理する際の方法。

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

各モザイク オペレーターの詳細については、「モザイク オペレーター」のヘルプ トピックをご参照ください。

String
mosaic_colormap_mode
(オプション)

入力ラスター データセットにカラーマップが含まれている場合に適用します。

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

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

派生した出力

名前説明データ タイプ
output_raster_dataset

出力ラスター データセット。

ラスター データセット

コードのサンプル

MosaicToNewRaster (新規ラスターにモザイク) の例 1 (Python ウィンドウ)

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

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MosaicToNewRaster_management("land1.tif;land2.tif", "Mosaic2New", \
                                   "landnew.tif", "World_Mercator.prj",\
                                   "8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
MosaicToNewRaster (新規ラスターにモザイク) の例 2 (スタンドアロン スクリプト)

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

##==================================
##Mosaic To New Raster
##Usage: MosaicToNewRaster_management inputs;inputs... output_location raster_dataset_name_with_extension 
##                                    {coordinate_system_for_the_raster} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT 
##                                    | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_FLOAT | 32_BIT_UNSIGNED 
##                                    | 32_BIT_SIGNED | | 64_BIT {cellsize} number_of_bands {LAST | FIRST | BLEND  | MEAN 
##                                    | MINIMUM | MAXIMUM} {FIRST | REJECT | LAST | MATCH}                               

import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"

##Mosaic several TIFF images to a new TIFF image
arcpy.MosaicToNewRaster_management("landsatb4a.tif;landsatb4b.tif","Mosaic2New", "landsat.tif", "World_Mercator.prj",\
                                   "8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック