モザイク データセットのカラー調整（Color Balance Mosaic Dataset） (データの管理)
サマリ
モザイク データセットのカラー調整を実行して、タイルの継ぎ目を見えないようにします。
使用法
-
カラー調整は、データに次の条件が当てはまる場合にのみ行うことができます。
- すべてのバンドの統計情報が計算されている。
- すべてのバンドのヒストグラムが作成されている。
- すべてのラスタ データベースに同じ数のバンドがある。
- すべてのラスタ データベースに同じピクセル タイプとピクセル深度がある。符号なし 8 ビットと符号なし 16 ビットのビット深度のみサポートされます。
- どのラスタ データベースにもカラー マップが関連付けられていない。
-
[前処理のオプション] は、カラー調整が行われる前に実行されます。
-
調整アルゴリズムには、ドッジング、ヒストグラム、標準偏差の 3 種類があります。
-
ターゲット カラー サーフェスは、ドッジング バランシングを選択した場合のみ使用できます。ドッジング手法を使用する場合は、各ピクセルにターゲット カラーが必要で、これはターゲット カラー サーフェスから取得します。選択可能なターゲット カラー サーフェスには、単一色、カラー グリッド、一次平面、二次平面、三次平面の 5 つのタイプがあります。単一色、カラー グリッド、一次平面、二次平面、三次平面です。
-
[ターゲット ラスタ] を使用すると、ラスタを調整する対象を指定することができます。
- ドッジング バランシングの使用時 - 出力されるターゲット カラーは、選択されたターゲット カラー サーフェスのタイプによって異なります。単一色の場合、参照ターゲット イメージの平均値が使用されます。カラー グリッドの場合、参照ターゲット イメージを適切なグリッドにリサンプリングします。多次元多項式によるサーフェスの場合、多項式の係数は最小二乗フィッティングによって、参照ターゲット イメージから取得されます。
- ヒストグラム バランシングの使用時 - ターゲット ヒストグラムは参照ターゲット イメージから取得されます。
- 標準偏差バランシングの使用時 - ターゲットの標準偏差は参照ターゲット イメージから取得されます。
カラー補正を削除するには、ArcCatalog またはカタログ ウィンドウでモザイク データセットを右クリックし、[削除] → [カラー補正の削除] の順にクリックします。
構文
| パラメータ | 説明 | データ タイプ |
in_mosaic_dataset |
カラー調整を実行するモザイク データセットを入力するか、その場所にナビゲートします。 | Mosaic Layer; Mosaic Dataset |
balancing_method （オプション） |
使用する調整アルゴリズムを選択します。
| String |
color_surface_type （オプション） |
[カラー サーフェス タイプ] は、ドッジング バランシングを選択した場合のみ指定できます。ドッジング バランシングを使用する場合は、各ピクセルにターゲット カラーが必要です。ターゲット カラーは、どのサーフェス タイプを選択するかによって決定されます。
| String |
target_raster （オプション） |
ターゲット ラスタ イメージを使用すると、ラスタを調整する対象となるラスタを指定することができます。 ドッジング バランシングを使用する場合、出力されるターゲット カラーは、選択されたターゲット カラー サーフェス タイプによって異なります。単一色の場合は、参照ターゲット イメージの平均値が使用されます。カラー グリッドの場合は、参照ターゲット イメージが適切なグリッドにリサンプリングされます。多項式次数による平面の場合、多項式の係数は LSF（Least Square Fitting）によって参照ターゲット イメージから取得されます。 ヒストグラム バランシングを使用する場合、ターゲット ヒストグラムは参照ターゲット イメージから取得されます。 標準偏差バランシングを使用する場合、ターゲットの標準偏差は参照ターゲット イメージから取得されます。 | Raster Layer |
gamma （オプション） |
前処理のストレッチで使用するガンマ値のタイプ。このオプションは、事前ストレッチのタイプに [標準偏差] または [最小値-最大値] を選択した場合のみ指定できます。 ガンマ ストレッチを適用することで、画像の全体的な明るさを制御することができます。ガンマ係数を小さくしすぎると、中間トーンが非常に暗く表示されます。一方、ガンマ係数を大きくしすぎると、中間トーンが非常に明るく表示されます。ガンマは、明るさだけでなく、赤、緑、青の比率も変更します。 | Double |
exclude_raster （オプション） |
除外ラスタとして使用するラスタにナビゲートします。除外エリアの作成には、[除外エリアの生成 （Generate Exclude Area）] ツールを使用することができます。 除外エリアは、カラー調整が行われる前に考慮されます。 | Raster Layer |
stretch_type （オプション） |
カラー補正を実行する前に、各ラスタ カタログ アイテムに対して事前ストレッチを実行することができます。つまり、カラー補正処理において、元のラスタ カタログ アイテムが、未処理のピクセル値ではなく、ストレッチされたピクセル値を使用するようになります。カラー補正を適用する前に、期待される分布に色を変更する場合、このオプションを使用することをお勧めします。
| String |
コードのサンプル
これは ColorBalanceMosaicDataset（モザイク データセットのカラー調整）のための Python サンプルです。
import arcpy
ColorBalanceMosaicDataset_management("C:/workspace/fgdb.gdb/mosData","DODGING",\
"COLOR_GRID", "C:/workspace/target.tif",\
"C:/temp/excludeArea.tif","NONE","1", \
"BlockName")
これは ColorBalanceMosaicDataset（モザイク データセットのカラー調整）のための Python スクリプト サンプルです。
##===========================
##Color Balance Mosaic Dataset
##Usage: ColorBalanceMosaicDataset_management(in_mosaic_dataset, {DODGING |
## HISTOGRAM | STANDARD_DEVIATION},
## {SINGLE_COLOR | COLOR_GRID |
## FIRST_ORDER | SECOND_ORDER | THIRD_ORDER},
## {target_raster}, {exclude_raster},
## {NONE | STANDARD_DEVIATION | MINIMUM_MAXIMUM
## | ADAPTIVE}, {gamma}), {block_field}
try:
import arcpy
arcpy.env.workspace = "c:/workspace"
# Color Correction Mosaic Dataset with target layer
arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
"Aerial_photo.lyr", "#", "NONE", "#", "BlockName")
# Color Correction Mosaic Dataset with exclude area dataset and prestretch
arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc2", "DODGING", "COLOR_GRID",
"#", "excludearea.tif", "STANDARD_DEVIATION",
"3", "BlockName")
except:
print "Color Balance Mosaic Dataset example failed."
print arcpy.GetMessages()