工作空间转栅格数据集 (数据管理)

摘要

将存储在指定工作空间的全部栅格数据集镶嵌至一个栅格数据集。

用法

语法

WorkspaceToRasterDataset_management (in_workspace, in_raster_dataset, {include_subdirectories}, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {matchingMethod}, {colormap_to_RGB})
参数说明数据类型
in_workspace

包含要镶嵌到栅格数据集的所有栅格数据集的工作空间。

Workspace
in_raster_dataset

要镶嵌所有来自工作空间的栅格的栅格数据集。该栅格数据集必须已经存在。

Raster dataset
include_subdirectories
(可选)

指定是否包含子目录。

  • NONE不包括子目录。这是默认设置。
  • INCLUDE_SUBDIRECTORIES加载时包括子目录中的所有栅格数据集。
Boolean
mosaic_type
(可选)

用于镶嵌重叠的方法。

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

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

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.9999。一个像素可能偏移的最大值为 0.5,因此您设置任意大于 0.5 的值都会保证执行平移。存在像素偏差时,容差为零会保证执行重采样。

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

Double
matchingMethod
(可选)

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

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

如果输入栅格数据集具有色彩映射表,则可将输出栅格数据集转换为三波段输出栅格数据集。这在镶嵌包含不同色彩映射表的栅格时很有用。

  • NONE不发生任何转换。这是默认设置。
  • ColormapToRGB将转换输入数据集。
Boolean

代码示例

WorkspaceToRasterDataset 示例 1(Python 窗口)

这是 WorkspaceToRasterDataset 工具的 Python 示例。

import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
                                          "INCLUDE_SUBDIRECTORIES", "LAST",
                                          "FIRST", "0", "9", "", "",
                                          "HISTOGRAM_MATCHING", "")
WorkspaceToRasterDataset 示例 2(独立脚本)

这是 WorkspaceToRasterDataset 工具的 Python 脚本示例。

##==================================
##Workspace To Raster Dataset
##Usage: WorkspaceToRasterDataset_management in_workspace in_raster_dataset {NONE | INCLUDE_SUBDIRECTORIES} {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} {NONE | ColormapToRGB}
try:
    import arcpy
    arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
    ##Mosaic images to File Geodatabase Raster Dataset with Background and Nodata setting and Color Correction
    arcpy.WorkspaceToRasterDataset_management("WS2RD", "fgdb.gdb\\dataset", "INCLUDE_SUBDIRECTORIES", "LAST", "FIRST", "0", "9", "", "", "HISTOGRAM_MATCHING", "")
    
    ##Mosaic Colormap image to RGB image
    arcpy.WorkspaceToRasterDataset_management("WS2RD_clr","fgdb.gdb\\dataset2", "INCLUDE_SUBDIRECTORIES", "LAST", "FIRST", "", "", "", "0.3", "", "ColormapToRGB")
except:
    print "Workspace To Raster Dataset example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcView: 是
ArcEditor: 是
ArcInfo: 是

7/10/2012