除外エリアの生成(Generate Exclude Area) (データの管理)
サマリ
カラー マスクまたはヒストグラムのパーセント値に基づいて除外エリアを設定できます。このツールの出力は、[モザイク データセットのカラー調整(Color Balance Mosaic Dataset)] ツールで使用されます。
使用法
このツールは、水域、雲、特異地域など、カラー補正が困難なエリアを除外するために使用します。
このツールの出力は、[モザイク データセットのカラー調整(Color Balance Mosaic Dataset)] ツールで使用され(必須ではありません)、モザイク データセットのカラー補正に使用するアルゴリズムからピクセル(およびカラー)を除外するために使用されます。
構文
パラメータ | 説明 | データ タイプ |
in_raster |
入力ラスタのファイル パスおよびファイル名。有効な入力には、ラスタ レイヤやモザイク データセット レイヤがあります。 | Mosaic Dataset; Composite Layer; Raster Dataset; Raster Layer |
out_raster |
入力ラスタのファイル パスおよびファイル名。出力はラスタ データセットになります。 出力は、[モザイク データセットのカラー調整(Color Balance Mosaic Dataset)] ツールの [除外エリア ラスタ] パラメータとして使用できます。 | Raster Dataset |
pixel_type |
入力ラスタ データセットのピクセル深度を選択します。カラー マスクとヒストグラムの値の調整には 8 ビット以上のピクセル深度が必要になるため、このパラメータは重要です。
| String |
generate_method |
入力のエリアを除外するために使用する方式を選択します。
| String |
max_red (オプション) |
除外される赤の最大値を示します。デフォルトは 255 です。 | Double |
max_green (オプション) |
除外される緑の最大値を示します。デフォルトは 255 です。 | Double |
max_blue (オプション) |
除外される青の最大値を示します。デフォルトは 255 です。 | Double |
max_white (オプション) |
除外される白の最大値を示します。デフォルトは 255 です。 | Double |
max_black (オプション) |
除外される黒の最大値を示します。デフォルトは 0 です。 | Double |
max_magenta (オプション) |
除外されるマゼンタの最大値を示します。デフォルトは 255 です。 | Double |
max_cyan (オプション) |
除外されるシアンの最大値を示します。デフォルトは 255 です。 | Double |
max_yellow (オプション) |
除外される黄の最大値を示します。デフォルトは 255 です。 | Double |
percentage_low (オプション) |
除外されるヒストグラムの最小パーセント値を示します。デフォルトは 0 です。 極端なピクセル値(非常に小さいか大きいピクセル値)がある場合、これらの領域はカラー補正で問題が生じやすいため、この値を定義します。 | Double |
percentage_high (オプション) |
除外されるヒストグラムの最大パーセント値を示します。デフォルトは 100 です。 極端なピクセル値(非常に小さいか大きいピクセル値)がある場合、これらの領域はカラー補正で問題が生じやすいため、この値を定義します。 | Double |
コードのサンプル
GenerateExcludeArea(除外エリアの生成)の Python サンプルを次に示します。
import arcpy
GenerateExcludeArea_management("C:/workspace/fgdb.gdb/mosdata",
"C:/workspace/excludeArea.tif","8_BIT",
"COLOR_MASK","255","255","255","255","15",
"255","255","255","0","100")
GenerateExcludeArea(除外エリアの生成)の Python スクリプトのサンプルを次に示します。
##===========================
##Generate Exclude Area
##Usage: GenerateExcludeArea_management in_raster out_raster 8_BIT | 11_BIT |
## 12_BIT | 16_BIT COLOR_MASK | HISTOGRAM_PERCENTAGE
## {max_red} {max_green} {max_blue} {max_white}
## {max_black} {max_magenta} {max_cyan}
## {max_yellow} {percentage_low} {percentage_high}
try:
import arcpy
arcpy.env.workspace = "c:/workspace"
# Generate exclude area dataset from raster dataset with Histogram
arcpy.GenerateExcludeArea_management("srcimage.tif", "exarea.tif", "8_BIT",
"HISTOGRAM_PERCENTAGE", "", "", "", "",
"", "", "", "", "10", "100")
# Generate exclude area dataset from mosaic dataset with Color Mask
arcpy.GenerateExcludeArea_management("CC.gdb/srcmd", "exarea.tif", "8_BIT",
"COLOR_MASK", "255", "200", "50", "255",
"10", "210", "100", "255", "", "")
except:
print "Generate Exclude Area example failed."
print arcpy.GetMessages()