| 标注 | 说明 | 数据类型 | 
 输入栅格   | 想要进行掩膜处理的栅格或镶嵌数据集图层。  | Mosaic Dataset; Raster Dataset; Raster Layer | 
 输出栅格数据集   | 要创建的数据集的名称、位置和格式。将栅格数据集存储到地理数据库时,请勿向栅格数据集的名称添加文件扩展名。将栅格数据集存储到 JPEG 文件、JPEG 2000 文件或地理数据库时,可在“环境设置”中指定压缩类型和压缩质量。  | Raster Dataset | 
 像素类型   | 选择输入栅格数据集的像素深度。默认设置为 8 位;但较大位深度的栅格数据集需要相应大小的色彩掩膜和直方图值。 
  | String | 
 Generate 方法   | 根据像素颜色或通过裁剪高低值创建掩膜。 
  | 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 位;但较大位深度的栅格数据集需要相应大小的色彩掩膜和直方图值。 
  | 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
arcpy.management.GenerateExcludeArea("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
import arcpy
arcpy.env.workspace = "c:/workspace"
# Generate exclude area dataset from raster dataset with Histogram
arcpy.management.GenerateExcludeArea("srcimage.tif", "exarea.tif", "8_BIT",
                                     "HISTOGRAM_PERCENTAGE", "", "", "", "",
                                     "", "", "", "", "10", "100")                                      
# Generate exclude area dataset from mosaic dataset with Color Mask
arcpy.management.GenerateExcludeArea("CC.gdb/srcmd", "exarea.tif", "8_BIT",
                                     "COLOR_MASK", "255", "200", "50", "255",
                                     "10", "210", "100", "255", "", "")