新規ラスターにモザイク (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)] ツールを使用することを検討してください。このツールを使用する前に入力ラスターをクリップすることも、あるいはこのツールの出力をクリップすることもできます。

構文

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_BIT1 ビット符号なし整数。値は 0 または 1 です。
  • 2_BIT2 ビット符号なし整数。サポートされる値は 0 ~ 3 です。
  • 4_BIT4 ビット符号なし整数。サポートされる値は 0 ~ 15 です。
  • 8_BIT_UNSIGNED8 ビット符号なしデータ タイプ。サポートされる値は 0 ~ 255 です。
  • 8_BIT_SIGNED8 ビット符号付きデータ タイプ。サポートされる値は -128 ~ 127 です。
  • 16_BIT_UNSIGNED16 ビット符号なしデータ タイプ。値の範囲は 0 〜 65,535 です。
  • 16_BIT_SIGNED16 ビット符号付きデータ タイプ。値の範囲は -32,768 〜 32,767 です。
  • 32_BIT_UNSIGNED32 ビット符号なしデータ タイプ。値の範囲は 0 〜 4,294,967,295 です。
  • 32_BIT_SIGNED32 ビット符号付きデータ タイプ。値の範囲は -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: はい
  • Standard: はい
  • Advanced: はい

関連トピック