平衡镶嵌数据集色彩

描述

使图像与相邻图像之间的过渡无缝显示。

使用方法

• 仅当以下与数据有关的条件成立时，才可使用色彩平衡：

  • 所有波段都已计算了统计数据。
  • 所有波段都已建立了直方图。
  • 仅支持 8 位无符号和 16 位无符号位深度。
  • 所有栅格数据集都没有关联的色彩映射表。

• 目标栅格中的波段需按照输入镶嵌数据集中波段的顺序进行排列。理想情况下，波段数应完全一致。如果输入镶嵌数据集中的波段更多，则将按顺序再次使用目标栅格中的波段。

• 如果输入镶嵌数据集和目标栅格的位深度不同，则系统将自动调整像素值的比例，以使两者的位深度相同。

• 该操作由排除区域栅格、拉伸类型和 Gamma 参数（exclude_raster、stretch_type 和 Python 中的 gamma）参数所定义，并在进行任意色彩平衡之前执行。这三个参数位于工具对话框中的预处理选项参数类别中。

• 仅当选择匀光平衡方法时，目标颜色表面才可用。使用匀光方法时，每个像素都需要一个目标颜色，而目标颜色是从目标颜色表面中选取的。有五种类型的目标颜色表面可供您选取目标颜色：单色表面、颜色格网表面、一阶表面、二阶表面和三阶表面。

• 目标栅格是用于指导色彩平衡的栅格。

  • 使用匀光平衡时，得出的目标颜色取决于当时所选择的目标颜色表面类型。对于单色表面，将使用参照目标图像的平均值。对于颜色格网表面，会将参照目标图像重采样为适合的格网。对于多项式阶表面，通过最小二乘拟合从参照目标图像获得多项式的系数。
  • 使用直方图平衡时，将基于参照目标图像获得目标直方图。
  • 使用标准差平衡时，将基于参照目标图像获得目标标准差。

• 要移除色彩校正，可右键单击 ArcCatalog 或目录窗口中的镶嵌数据集，然后单击移除 > 移除色彩平衡。

语法

arcpy.management.ColorBalanceMosaicDataset(in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field})

参数	说明	数据类型
in_mosaic_dataset	想要进行色彩平衡的镶嵌数据集。	Mosaic Layer
balancing_method （可选）	要使用的平衡算法。 DODGING —将每个像素的值更改为目标颜色。使用该技术也必须选择目标颜色表面的类型，该类型将对目标颜色产生影响。多数情况下，匀光会取得最佳的效果。 HISTOGRAM —根据每个像素值与目标直方图的关系更改像素值。从所有的栅格中均可获得目标直方图，也可以指定栅格以从中获得目标直方图。当所有栅格的直方图形状都相似时，该技术会取得较好的效果。 STANDARD_DEVIATION —根据像素值与其目标栅格直方图的关系，在标准方差的范围内更改每个像素的值。标准差可由所有镶嵌数据集的栅格计算获得，也可指定目标栅格来计算标准差。当所有栅格均为正态分布时，该技术取得的效果最佳。	String
color_surface_type （可选）	使用匀光平衡方法时，每个像素都需要一个目标颜色，而目标颜色是根据表面类型而确定的。 SINGLE_COLOR —在栅格数据集数量少且地面物体种类少时使用。如果存在过多的栅格数据集或过多类型的地表，则输出颜色可能会变得模糊。所有像素均基于一个单色点 - 即所有像素的平均值进行更改。 COLOR_GRID — 在栅格数据集数量很多或区域内的地面物体种类很多时使用。像素根据多目标颜色进行改变，这些目标颜色分布在镶嵌数据集中。 FIRST_ORDER — 与颜色格网表面相比，该技术所创建的颜色改变更为平滑，而且使用的辅助表存储空间更少，但可能需要花费更长时间进行处理。所有像素都根据从二维多项式倾斜平面获取的多个点进行更改。 SECOND_ORDER — 与颜色格网表面相比，该技术所创建的颜色改变更为平滑，而且使用的辅助表存储空间更少，但可能需要花费更长时间进行处理。所有输入像素都根据从二维多项式抛物线表面获取的一组多点进行更改。 THIRD_ORDER — 与颜色格网表面相比，该技术所创建的颜色改变更为平滑，而且使用的辅助表存储空间更少，但可能需要花费更长时间进行处理。所有输入像素都根据从三次表面获取的多个点进行更改。	String
target_raster （可选）	想要用于对其他图像进行色彩平衡的栅格。如果适用，将从该图像中获取平衡方法和颜色表面类型。	Raster Dataset; Raster Layer; Internet Tiled Layer; Map Server Layer
exclude_raster （可选）	对镶嵌数据集进行色彩平衡之前应用掩膜。使用生成排除区域工具创建掩膜。	Raster Layer
stretch_type （可选）	进行色彩平衡前，拉伸值的范围。选择以下选项之一: NONE — 使用原始像素值。这是默认设置。 ADAPTIVE — 将在执行任何处理之前应用自适应预拉伸。 MINIMUM_MAXIMUM — 在实际最小值和最大值之间拉伸值。 STANDARD_DEVIATION — 在默认标准差数之间拉抻值。	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)

环境

• 并行处理因子

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是