摘要
使图像与相邻图像之间的过渡无缝显示。
用法
仅当以下与数据有关的条件成立时,才可使用色彩平衡:
- 所有波段都已计算了统计数据。
- 所有波段都已建立了直方图。
- 仅支持 8 位无符号和 16 位无符号位深度。
- 所有栅格数据集都没有关联的色彩映射表。
目标栅格中的波段需按照输入镶嵌数据集中波段的顺序进行排列。理想情况下,波段数应完全一致。如果输入镶嵌数据集中的波段更多,则将按顺序再次使用目标栅格中的波段。
如果输入镶嵌数据集和目标栅格的位深度不同,则系统将自动调整像素值的比例,以使两者的位深度相同。
该操作由排除区域栅格、拉伸类型和 Gamma 参数(exclude_raster、stretch_type 和 Python 中的 gamma)参数所定义,并在进行任意色彩平衡之前执行。这三个参数位于工具对话框中的预处理选项参数类别中。
仅当选择匀光平衡方法时,目标颜色表面才可用。使用匀光方法时,每个像素都需要一个目标颜色,而目标颜色是从目标颜色表面中选取的。有五种类型的目标颜色表面可供您选取目标颜色:单色表面、颜色格网表面、一阶表面、二阶表面和三阶表面。
目标栅格是用于指导色彩平衡的栅格。
- 使用匀光平衡时,得出的目标颜色取决于当时所选择的目标颜色表面类型。对于单色表面,将使用参照目标图像的平均值。对于颜色格网表面,会将参照目标图像重采样为适合的格网。对于多项式阶表面,通过最小二乘拟合从参照目标图像获得多项式的系数。
- 使用直方图平衡时,将基于参照目标图像获得目标直方图。
- 使用标准差平衡时,将基于参照目标图像获得目标标准差。
要移除色彩校正,可右键单击 ArcCatalog 或目录窗口中的镶嵌数据集,然后单击移除 > 移除色彩平衡。
语法
ColorBalanceMosaicDataset_management (in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field})
参数 | 说明 | 数据类型 |
in_mosaic_dataset | 想要进行色彩平衡的镶嵌数据集。 | Mosaic Layer |
balancing_method (可选) | 要使用的平衡算法。
| String |
color_surface_type (可选) | 使用匀光平衡方法时,每个像素都需要一个目标颜色,而目标颜色是根据表面类型而确定的。
| String |
target_raster (可选) | 想要用于对其他图像进行色彩平衡的栅格。如果适用,将从该图像中获取平衡方法和颜色表面类型。 | Raster Layer; Internet Tiled Layer; Map Server Layer |
exclude_raster (可选) | 对镶嵌数据集进行色彩平衡之前应用掩膜。使用生成排除区域工具创建掩膜。 | Raster Layer |
stretch_type (可选) | 进行色彩平衡前,拉伸值的范围。选择以下选项之一:
| String |
gamma (可选) | 调整图像的整体亮度。值越小,显示越暗,中等值之间的对比度越低。值越大,显示越亮,对比度越高。 | Double |
block_field (可选) | 镶嵌数据集属性表中的字段名称,用于标识在执行某些计算和操作时应被视为单一项目的多个项目。 | String |
派生输出
名称 | 说明 | 数据类型 |
out_mosaic_dataset | 镶嵌图层 |
代码示例
ColorBalanceMosaicDataset 示例 1(Python 窗口)
这是 ColorBalanceMosaicDataset 工具的 Python 示例。
import arcpy
arcpy.ColorBalanceMosaicDataset_management(
"C:/workspace/CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
"C:/workspace/Aerial.lyr", "#", "STANDARD_DEVIATION", "3", "BLOCKNAME")
ColorBalanceMosaicDataset 示例 2(独立脚本)
这是 ColorBalanceMosaicDataset 工具的 Python 脚本。
#########*#########*##########*#########*#########*#########*#########*&&&&&&&&&&
# Color Correction Mosaic Dataset with target layer
import arcpy
arcpy.env.workspace = "C:/workspace"
mdname = "CC.gdb/cc1"
ccmethod = "DODGING"
dogesurface = "SINGLE_COLOR"
targetras = "C:/workspace/Aerial_photo.lyr"
excluderas = "#"
prestretch = "NONE"
gamma = "#"
blockfield = "#"
arcpy.ColorBalanceMosaicDataset_management(
mdname, ccmethod, dogesurface, targetras, excluderas,
prestretch, gamma, blockfield)
环境
许可信息
- ArcGIS Desktop Basic: 否
- ArcGIS Desktop Standard: 是
- ArcGIS Desktop Advanced: 是