概要
複数のラスター データセットを新しいラスター データセットにマージします。
使用法
入力ラスター データセットは、一括してモザイクされる対象のラスター データセットです。入力にはそれぞれ、同じバンド数および同じビット深度を指定する必要があります。そうしないと、ツールはエラーで終了します。
[モザイク (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 | 作成するデータセットの名前。 ラスター データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。
ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 ラスター データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納するときに、ジオプロセシング環境で [圧縮タイプ] と [圧縮品質] を指定できます。 | String |
coordinate_system_for_the_raster (オプション) | 出力ラスター データセットの座標系。 | Coordinate System |
pixel_type (オプション) | モザイク データセットのビット深度または放射量分解能。 ピクセル タイプを設定しない場合はデフォルト (8 ビット) が使用されますが、出力が不正確になることがあります。
| String |
cellsize (オプション) | 新しいラスター データセットのセル サイズ。 | Double |
number_of_bands | 出力ラスターのバンド数。 | Long |
mosaic_method (オプション) | 重なり合う領域をモザイク処理する際の方法。
各モザイク オペレーターの詳細については、「モザイク オペレーター」のヘルプ トピックをご参照ください。 | String |
mosaic_colormap_mode (オプション) | 入力ラスター データセットにカラーマップが含まれている場合に適用します。 モザイク出力に適用されるカラーマップを入力ラスターから選択する際に使用するメソッドを指定します。
| String |
派生した出力
| 名前 | 説明 | データ タイプ |
| output_raster_dataset | 出力ラスター データセット。 | ラスター データセット |
コードのサンプル
以下は、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 ツールを実行する 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: はい