生成排除区域 (Data Management)

摘要

您可以根据色彩掩膜或直方图百分比设置排除区域。此工具的输出常用于“平衡镶嵌数据集色彩”工具中。

用法

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

• 此工具的输出常用于“平衡镶嵌数据集色彩”工具中（但不是该工具所必需的），以便从镶嵌数据集色彩校正算法中排除一些像素（和色彩）。

语法

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	输入栅格的文件路径和文件名。输出将是一个栅格数据集。 随后可将输出用作平衡镶嵌数据集色彩工具中的排除区域栅格参数。	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()

环境

当前工作空间, 临时工作空间, 输出坐标系, 范围, 输出配置关键字, 压缩, 切片大小, 金字塔, 栅格统计, 重采样方法, NoData

许可信息

ArcGIS for Desktop Basic: 否

ArcGIS for Desktop Standard: 是

ArcGIS for Desktop Advanced: 是