平衡镶嵌数据集色彩 (数据管理)

摘要

对镶嵌数据集进行色彩平衡,以使切片无缝显示。

用法

语法

ColorBalanceMosaicDataset_management (in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {gamma}, {exclude_raster}, {stretch_type})
参数说明数据类型
in_mosaic_dataset

输入或导航到需要对其进行色彩校正的镶嵌数据集。

Mosaic Layer; Mosaic Dataset
balancing_method
(可选)

选择要使用的平衡算法。

  • DODGING这是传统的匀光摄影制图方法,其中每个像素值都向目标颜色过渡。这些值用于确定每个像素的输出值。如果选择“匀光”,则必须同时选择要使用的目标颜色表面类型,它将影响到目标颜色。多数情况下,匀光平衡会取得最佳的效果。
  • HISTOGRAM此方法将根据目标直方图更改各像素值。可基于所有栅格自动计算目标直方图,也可以指定一个目标栅格。当所有栅格的直方图形状都相似时,直方图平衡会取得较好的效果。
  • STANDARD DEVIATION此方法将根据计算出的标准差更改每个像素值。可基于所有栅格或指定的目标栅格自动计算标准差值。当所有栅格的正态值具有相同的直方图分布时,标准差平衡的效果最好。
String
color_surface_type
(可选)

仅当选择匀光平衡方法时,目标颜色表面类型才可用。使用匀光方法时,每个像素都需要一个目标颜色,而目标颜色是根据所选的表面类型确定的。

  • SINGLE_COLOR所有像素都参照一个单色点(即,平均值)进行匀光处理。如果仅存在很少量的栅格,且这些栅格只具有少数不同类型的地面物体,则单色表面会取得良好的效果。如果存在过多的栅格或过多类型的地表面,则输出颜色可能会变得模糊。
  • COLOR_GRID所有输入像素都参照分布在整个镶嵌数据集中的多组点进行匀光处理。如果有大量的栅格或区域含有大量的多种地面物体,颜色格网会产生非常好的输出效果。
  • FIRST_ORDER所有输入像素都参照从二维多项式倾斜平面获取的多个点进行匀光处理。与“颜色格网”表面相比,多项式阶表面的颜色变化通常更为平滑,并且使用的辅助表存储空间更少,但往往需要花费更长的时间进行处理。
  • SECOND_ORDER所有输入像素都参照从二维多项式抛物线表面获取的一组多点进行匀光处理。与“颜色格网”表面相比,多项式阶表面的颜色变化通常更为平滑,并且使用的辅助表存储空间更少,但往往需要花费更长的时间进行处理。
  • THIRD_ORDER所有输入像素都参照从三次表面获取的多个点进行匀光处理。与“颜色格网”表面相比,多项式阶表面的颜色变化通常更为平滑,并且使用的辅助表存储空间更少,但往往需要花费更长的时间进行处理。
String
target_raster
(可选)

使用目标栅格影像可以指定用于平衡栅格的目标栅格。

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

使用直方图平衡时,将基于参照目标图像获得目标直方图。

使用标准差平衡时,将基于参照目标图像获得目标标准差。

Raster Layer
gamma
(可选)

输入将在预处理拉伸中使用的 gamma 值。只有选中了“标准差”或“最小值-最大值”预拉伸类型后,此参数才可用。

可通过应用 Gamma 拉伸来控制图像的整体亮度。如果 Gamma 系数设置得太低,中间色调将太暗;而如果 Gamma 系数设置得太高,中间色调又会太亮。Gamma 系数不仅会改变图像的亮度,还会改变红绿蓝之间的比率。

Double
exclude_raster
(可选)

导航到要用作排除图层的栅格。可以使用生成排除区域工具创建排除区域。

应在执行色彩平衡之前考虑排除区域。

Raster Layer
stretch_type
(可选)

在执行其他任何色彩校正之前,可对各个栅格目录项执行预拉伸。这意味着在色彩校正过程中,原始栅格目录项将使用拉伸后的像素值,而不是原始像素值。在应用色彩校正之前,最好使用此选项将颜色更改为所期望的分布形式。

  • NONE 不应用预拉伸。这是默认设置
  • ADAPTIVE 将在执行任何处理之前应用自适应预拉伸。
  • MINIMUM_MAXIMUM 将在执行任何处理之前应用最小值-最大值预拉伸。
  • STANDARD DEVIATION 将在执行任何处理之前应用标准差预拉伸。
String

代码示例

ColorBalanceMosaicDataset 示例 1(Python 窗口)

这是 ColorBalanceMosaicDataset 的 Python 示例。

import arcpy 
ColorBalanceMosaicDataset_management("C:/workspace/fgdb.gdb/mosData","DODGING",\
                                     "COLOR_GRID", "C:/workspace/target.tif",\
                                     "C:/temp/excludeArea.tif","NONE","1", \
                                     "BlockName")
ColorBalanceMosaicDataset 示例 2(独立脚本)

这是 ColorBalanceMosaicDataset 的 Python 脚本示例。

##===========================
##Color Balance Mosaic Dataset
##Usage: ColorBalanceMosaicDataset_management(in_mosaic_dataset, {DODGING |
##                                            HISTOGRAM | STANDARD_DEVIATION},
##                                            {SINGLE_COLOR | COLOR_GRID | 
##                                            FIRST_ORDER | SECOND_ORDER | THIRD_ORDER},
##                                            {target_raster}, {exclude_raster},
##                                            {NONE | STANDARD_DEVIATION | MINIMUM_MAXIMUM
##                                            | ADAPTIVE}, {gamma}), {block_field}

try:
    import arcpy
    arcpy.env.workspace = "c:/workspace"
    
    # Color Correction Mosaic Dataset with target layer
    arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
                                              "Aerial_photo.lyr", "#", "NONE", "#", "BlockName")                                      

    # Color Correction Mosaic Dataset with exclude area dataset and prestretch
    arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc2", "DODGING", "COLOR_GRID",
                                              "#", "excludearea.tif", "STANDARD_DEVIATION",
                                              "3", "BlockName") 
    
    
except:
    print "Color Balance Mosaic Dataset example failed."
    print arcpy.GetMessages()

环境

此工具不使用任何地理处理环境

相关主题

许可信息

ArcView: 否
ArcEditor: 是
ArcInfo: 是

7/10/2012