生成排除区域 (数据管理)

摘要

根据像素颜色或通过裁剪值范围进行掩膜。此工具的输出被用作平衡镶嵌数据集色彩工具的输入,用于消除云和水体等能够影响所用统计信息的区域,以便对多个影像进行色彩平衡处理。

使用情况

  • 该工具用于排除难于进行色彩校正的区域(如水体、云和异常区域)。

  • 此工具的输出可用于平衡镶嵌数据集色彩工具中,以便从镶嵌数据集色彩校正算法中排除一些像素(和色彩)。

参数

标注说明数据类型
输入栅格

想要进行掩膜处理的栅格或镶嵌数据集图层。

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
Generate 方法

根据像素颜色或通过裁剪高低值创建掩膜。

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