除外エリアの生成(Generate Exclude Area) (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

カラー マスクまたはヒストグラムのパーセント値に基づいて除外エリアを設定できます。このツールの出力は、[モザイク データセットのカラー調整(Color Balance Mosaic Dataset)] ツールで使用されます。

使用法

構文

GenerateExcludeArea_management (in_raster, out_raster, pixel_type, generate_method, {max_red}, {max_green}, {max_blue}, {max_white}, {max_black}, {max_magenta}, {max_cyan}, {max_yellow}, {percentage_low}, {percentage_high})
パラメータ説明データ タイプ
in_raster

入力ラスタのファイル パスおよびファイル名。有効な入力には、ラスタ レイヤやモザイク データセット レイヤがあります。

Mosaic Dataset; Composite Layer; Raster Dataset; Raster Layer
out_raster

入力ラスタのファイル パスおよびファイル名。出力はラスタ データセットになります。

出力は、[モザイク データセットのカラー調整(Color Balance Mosaic Dataset)] ツールの [除外エリア ラスタ] パラメータとして使用できます。

Raster Dataset
pixel_type

入力ラスタ データセットのピクセル深度を選択します。カラー マスクとヒストグラムの値の調整には 8 ビット以上のピクセル深度が必要になるため、このパラメータは重要です。

  • 8_BIT入力ラスタ データセットの値の範囲は 0 ~ 255 になります。これがデフォルトです。
  • 11_BIT入力ラスタ データセットの値の範囲は 0 ~ 2047 になります。
  • 12_BIT入力ラスタ データセットの値の範囲は 0 ~ 4095 になります。
  • 16_BIT入力ラスタ データセットの値の範囲は 0 ~ 65535 になります。
String
generate_method

入力のエリアを除外するために使用する方式を選択します。

  • COLOR_MASK出力で除外される最大カラー値を設定できます。これがデフォルトです。
  • HISTOGRAM_PERCENTAGEヒストグラムのピクセルの最小および最大パーセント値を設定できます。
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(除外エリアの生成)の例 1(Python ウィンドウ)

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(除外エリアの生成)の例 2(スタンドアロン スクリプト)

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()

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ×
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
7/28/2014