モザイク (データの管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

複数の入力ラスタを既存のラスタ データセットにモザイク化します。

ラスタ データセットのモザイク化の詳細

Mosaic illustration

使用法

構文

Mosaic_management (inputs, target, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod})
パラメータ説明データ タイプ
inputs
[input,...]

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

Mosaic Dataset ; Composite Layer ; Raster Dataset ; Raster Layer
target

ターゲット ラスタ データセット。

このラスタ データセットはすでに存在している必要があります。ターゲット レイヤは、入力ラスタのリスト内の最初のラスタと見なされます。

Raster Dataset
mosaic_type
(オプション)

オーバーラップ エリアのモザイク化に使用するメソッド。

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

ターゲット レイヤは、入力ラスタのリスト内の最初のラスタと見なされます。

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

String
colormap
(オプション)

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

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

ターゲット レイヤは、入力ラスタのリスト内の最初のラスタと見なされます。

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

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 ビットとして作成されるため、本来のラスタ データセットが表示されます。

  • NONE変換を実行しません。これがデフォルトです。
  • OneBitTo8Bit入力ラスタが変換されます。
Boolean
mosaicking_tolerance
(オプション)

モザイク化を実行したときに、ターゲット ピクセルとソース ピクセルの位置がいつも正確に揃うとは限りません。ピクセルの位置にずれがある場合は、リサンプリングを実行するかそれともデータをシフトするかを決める必要があります。ピクセルのリサンプリングを実行するか、それともピクセルをシフトするかは、モザイク化の許容値によって制御されます。

入力データセットとターゲット データセットのピクセル配置の差が許容値より大きければ、リサンプリングが実行されます。入力データセットとターゲット データセットのピクセル配置の差が許容範囲内であれば、リサンプリングは実行されません(代わりに、シフトが実行されます)。

許容値の単位はピクセルであり、有効な範囲は 0 ~ 0.5 です。許容値を 0.5 にすると、シフトが必ず発生します。ピクセルの位置にずれがある場合、許容値が 0 であれば、必ずリサンプリングが発生します。

たとえば、ソースおよびターゲット ピクセルのずれが 0.25 であるとします。モザイク化の許容値が 0.2 に設定されている場合は、ピクセルのずれが許容値より大きいため、リサンプリングが行われます。モザイク化の許容値が 0.3 に設定されていると、ピクセルがシフトします。

Double
MatchingMethod
(オプション)

ラスタに適用するカラー マッチング メソッドを選択します。

  • NONEこのオプションは、ラスタ データセットをモザイク化する際にカラー マッチング操作を使用しません。
  • STATISTICS_MATCHINGこのメソッドは、参照するオーバーラップ エリアとソースのオーバーラップ エリアの間の統計的な差異(最小、最大、平均)をマッチングしてから、ターゲット データセット全体に変換を適用します。
  • HISTOGRAM_MATCHINGこのメソッドは、参照するオーバーラップ エリアのヒストグラムをソースのオーバーラップ エリアとマッチングしてから、ターゲット全体に変換を適用します。
  • LINEARCORRELATION_MATCHINGこのメソッドは、重なり合うピクセルをマッチングして、残りのソースに内挿します。1 対 1 のリレーションシップを持たないピクセルには、加重平均を使用します。
String

コードのサンプル

Mosaic(モザイク)の例 1(Python ウィンドウ)

以下は、Mosaic(モザイク)ツールを実行する Python サンプルです。

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.Mosaic_management("land2.tif;land3.tif","land1.tif","LAST","FIRST",
                        "0", "9", "", "", "")
Mosaic(モザイク)の例 2(スタンドアロン スクリプト)

以下は、Mosaic(モザイク)ツールを実行する Python スクリプト サンプルです。

##==================================
##Mosaic
##Usage: Mosaic_management inputs;inputs... target {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}
try:
    import arcpy
    arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
    ##Mosaic two TIFF images to a single TIFF image
    ##Background value: 0
    ##Nodata value: 9
    arcpy.Mosaic_management("landsatb4a.tif;landsatb4b.tif","Mosaic\\landsat.tif","LAST","FIRST","0", "9", "", "", "")
    
    ##Mosaic several 3-band TIFF images to FGDB Raster Dataset with Color Correction
    ##Set Mosaic Tolerance to 0.3. Mismatch larget than 0.3 will be resampled
    arcpy.Mosaic_management("rgb1.tif;rgb2.tif;rgb3.tif", "Mosaic.gdb\\rgb","LAST","FIRST","", "", "", "0.3", "HISTOGRAM_MATCHING")
except:
    print "Mosaic example failed."
    print arcpy.GetMessages()

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
9/14/2013