镶嵌 (Data Management)

许可等级:BasicStandardAdvanced

摘要

将多个输入栅格镶嵌到现有栅格数据集。

了解有关镶嵌栅格数据集的详细信息

插图

Mosaic illustration

用法

语法

Mosaic_management (inputs, target, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod})
参数说明数据类型
inputs
[input,...]

输入栅格数据集。

Mosaic Dataset ; Composite Layer ; Raster Dataset ; Raster Layer
target

目标栅格数据集。

此栅格数据集必须已经存在。“目标”图层被视为“输入栅格”列表中的第一个栅格。

Raster Dataset
mosaic_type
(可选)

用于镶嵌重叠的方法。

  • FIRST叠置区域的输出像元值为镶嵌到该位置的第一个栅格数据集中的值。
  • LAST叠置区域的输出像元值为镶嵌到该位置的最后一个栅格数据集中的值。这是默认设置。
  • BLEND叠置区域的输出像元值为叠置区域中各像元值的水平加权计算结果。
  • MEAN重叠区域的输出像元值为叠置像元的平均值。
  • MINIMUM重叠区域的输出像元值为叠置像元的最小值。
  • MAXIMUM重叠区域的输出像元值为叠置像元的最大值。
  • SUM重叠区域的输出像元值为叠置像元的总和。

“目标”图层被视为“输入栅格”列表中的第一个栅格。

有关各镶嵌运算符的详细信息,请参阅镶嵌运算符

String
colormap
(可选)

对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。

  • FIRST列表中第一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。这是默认设置。
  • LAST列表中最后一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。
  • MATCH镶嵌时会考虑所有色彩映射表。如果已经使用了所有可能的值(对于位深度),则会尝试与具有最接近的可用色彩的值进行匹配。
  • REJECT仅对那些不包含关联色彩映射表的栅格数据集进行镶嵌。

“目标”图层被视为“输入栅格”列表中的第一个栅格。

有关各色彩映射表模式的详细信息,请参阅镶嵌色彩映射表模式

String
background_value
(可选)

使用此选项移除在栅格数据周围创建的不需要的值。指定的值与栅格数据集中的其他有用数据不同。例如,栅格边界上为零的值不同于栅格数据集内的零值。

指定的像素值在输出栅格数据集中将被设置为 NoData。

对于基于文件的栅格和个人地理数据库栅格,为了忽略背景值,“忽略背景值”必须设置为与 NoData 相同的值。ArcSDE 和文件地理数据库栅格无需经过此额外步骤即可忽略背景值。

Double
nodata_value
(可选)

具有指定值的所有像素将在输出栅格数据集中被设置为 NoData。

Double
onebit_to_eightbit
(可选)

选择是否将输入 1 位栅格数据集转换为 8 位栅格数据集。使用这种转换方法时,输入栅格数据集中的值 1 将在输出栅格数据集中更改为 255。这在将 1 位栅格数据集导入 ArcSDE 时很有帮助。1 位栅格数据集存储在文件系统中时包含 8 位金字塔图层,但在 ArcSDE 中,1 位栅格数据集只能包含 1 位金字塔图层,这使得显示画面看起来没有吸引力。通过在 ArcSDE 中将数据转换为 8 位,可将金字塔图层构建为 8 位而非 1 位,从而在显示画面中生成适合的栅格数据集。

  • NONE不执行任何转换。这是默认设置。
  • OneBitTo8Bit将转换输入栅格。
Boolean
mosaicking_tolerance
(可选)

发生镶嵌时,目标及源像素并不总是准确地排成直线。当存在像素偏差时,需要决定执行重采样,还是应当平移数据。镶嵌容差可控制是对像素执行重采样,还是应当平移像素。

如果(传入的数据集与目标数据集之间的)像素偏差大于该容差,则执行重采样。如果(传入的数据集与目标数据集之间的)像素偏差小于该容差,则不执行重采样(而是执行平移)。

容差的单位为像素,有效值范围为 0 到 0.5。容差为 0.5 会保证发生平移。存在像素偏差时,容差为零会保证执行重采样。

例如,源像素和目标像素的偏差值为 0.25。如果将镶嵌容差设置为 0.2,由于像素偏差大于该容差,因此将执行重采样。如果将镶嵌容差设置为 0.3,则会平移像素。

Double
MatchingMethod
(可选)

选择应用于栅格的色彩匹配方法。

  • NONE当镶嵌栅格数据集时,此选项不会使用色彩匹配操作。
  • STATISTICS_MATCHING对参考重叠区域与源重叠区域间的统计差异(最小值、最大值和平均值)进行匹配;然后将变换应用于整个目标数据集。
  • HISTOGRAM_MATCHING此方法会将参考重叠区域中的直方图与源重叠区域进行匹配;然后将变换应用于整个目标数据集。
  • LINEARCORRELATION_MATCHING此方法是对重叠像素进行匹配,然后插值到源数据集的其余部分;不具有一对一关系的像素将使用加权平均值。
String

代码实例

镶嵌示例 1(Python 窗口)

这是“镶嵌”工具的 Python 示例。

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.Mosaic_management("land2.tif;land3.tif","land1.tif","LAST","FIRST",
                        "0", "9", "", "", "")
镶嵌示例 2(独立脚本)

这是“镶嵌”工具的 Python 脚本示例。

##==================================
##Mosaic
##Usage: Mosaic_management inputs;inputs... target {LAST | FIRST | BLEND | MEAN | MINIMUM | MAXIMUM} {FIRST | REJECT | LAST | MATCH} 
##                         {background_value} {nodata_value} {NONE | OneBitTo8Bit} {mosaicking_tolerance}  
##                         {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING 
##                         | LINEARCORRELATION_MATCHING}
try:
    import arcpy
    arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
    ##Mosaic two TIFF images to a single TIFF image
    ##Background value: 0
    ##Nodata value: 9
    arcpy.Mosaic_management("landsatb4a.tif;landsatb4b.tif","Mosaic\\landsat.tif","LAST","FIRST","0", "9", "", "", "")
    
    ##Mosaic several 3-band TIFF images to FGDB Raster Dataset with Color Correction
    ##Set Mosaic Tolerance to 0.3. Mismatch larget than 0.3 will be resampled
    arcpy.Mosaic_management("rgb1.tif;rgb2.tif;rgb3.tif", "Mosaic.gdb\\rgb","LAST","FIRST","", "", "", "0.3", "HISTOGRAM_MATCHING")
except:
    print "Mosaic example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcGIS for Desktop Basic: 是
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014