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

サマリー

色に基づいて、または値の範囲をクリップして、ピクセルをマスクします。このツールの出力は、[モザイク データセットのカラー調整 (Color Balance Mosaic Dataset)] ツールへの入力として使用され、複数の画像のカラー調整に使用する統計情報を歪める可能性のある雲や水域などのエリアを除外するために使用されます。

使用法

  • このツールは、水域、雲、特異地域など、カラー補正が困難なエリアを除外するために使用します。

  • このツールの出力は、[モザイク データセットのカラー調整 (Color Balance Mosaic Dataset)] ツールで使用され、モザイク データセットのカラー補正に使用するアルゴリズムからピクセル (およびカラー) を除外するために使用されます。

パラメーター

ラベル説明データ タイプ
入力ラスター

マスクするラスターまたはモザイク データセット レイヤー。

Mosaic Dataset; Raster Dataset; Raster Layer
出力ラスター データセット

作成するデータセットの名前、場所、および形式。ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。ラスター データセットを JPEG ファイル、JPEG 2000 ファイル、またはジオデータベースに格納するときに、環境設定で [圧縮] タイプと [圧縮品質] を指定できます。

Raster Dataset
ピクセル タイプ

入力ラスター データセットのピクセル深度を選択します。デフォルト値は 8 ビットですが、カラー マスクとヒストグラムの値を調整するには、ビット深度の大きいラスター データセットが必要になります。

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

ピクセルの色に基づいて、または高い値と低い値をクリップして、マスクを作成します。

  • COLOR_MASK出力に含める色の最大値を設定します。これがデフォルトです。
  • HISTOGRAM_PERCENTAGE高いピクセル値と低いピクセル値のパーセンテージを削除します。
String
赤の最大値
(オプション)

除外される赤の最大値。デフォルトは 255 です。

Double
緑の最大値
(オプション)

除外される緑の最大値。デフォルトは 255 です。

Double
青の最大値
(オプション)

除外される青の最大値。デフォルトは 255 です。

Double
白の最大値
(オプション)

除外される白の最大値。デフォルトは 255 です。

Double
黒の最大値
(オプション)

除外される黒の最大値。デフォルトは 0 です。

Double
マゼンダの最大値
(オプション)

除外されるマゼンダの最大値。デフォルトは 255 です。

Double
シアンの最大値
(オプション)

除外されるシアンの最大値。デフォルトは 255 です。

Double
イエローの最大値
(オプション)

除外される黄色の最大値。デフォルトは 255 です。

Double
低いパーセンテージ
(オプション)

最小ピクセル値のこのパーセンテージを除外します。デフォルトは 0 です。

Double
高いパーセンテージ
(オプション)

最大ピクセル値のこのパーセンテージを除外します。デフォルトは 100 です。

Double

arcpy.management.GenerateExcludeArea(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; Raster Dataset; Raster Layer
out_raster

作成するデータセットの名前、場所、および形式。ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。ラスター データセットを JPEG ファイル、JPEG 2000 ファイル、またはジオデータベースに格納するときに、環境設定で [圧縮] タイプと [圧縮品質] を指定できます。

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
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}

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", "", "")