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

摘要

将文件夹中的所有栅格数据集合并为一个栅格数据集。

使用情况

  • 目标栅格数据集必须已经存在才能运行该工具。

  • 如果目标栅格数据集尚不存在,使用创建栅格数据集工具创建新的栅格数据集。

  • 由于要进行镶嵌,所以需指定所要使用的镶嵌方法和色彩映射表模式。

  • 如果目标栅格数据集是一个空的栅格数据集,则镶嵌将应用第一个输入栅格数据集的像元大小和空间参考。

  • 尽可能使用最后一个镶嵌运算符,将这些栅格数据集镶嵌到文件地理数据库或企业级地理数据库中的现有栅格数据集内;这是目前为止最有效的镶嵌方式。

  • 对于镶嵌离散数据,镶嵌运算符第一个值最小值最大值选项会提供最有意义的结果。而混合平均值选项则最适合连续数据。

  • 色彩匹配方法下拉箭头可用于选择镶嵌数据集的色彩匹配算法。

  • 对于基于文件的栅格,要忽略背景值,必须将其设置为与 NoData 相同的值。 地理数据库栅格无需经过此额外步骤即可忽略背景值。

  • 对于不同分辨率的浮点输入栅格数据集或像元未对齐时,建议在运行镶嵌工具之前使用双线性插值法或三次卷积插值法对所有数据进行重新采样。但是,镶嵌将使用最邻近重采样对栅格数据集进行自动重采样,这不适用于连续数据类型。

参数

标注说明数据类型
输入工作空间

包含要合并的栅格数据集的文件夹。

Workspace
目标栅格数据集

要在其中合并输入工作空间内所有栅格数据集的现有栅格数据集。

Raster Dataset
包括子目录
(可选)

指定是否包含子目录。

  • 未选中 - 不包括子目录。 这是默认设置。
  • 选中 - 加载时包括子目录中的所有栅格数据集。
Boolean
镶嵌运算符
(可选)

指定将用于镶嵌重叠区域的方法。

  • 第一个叠置区域的输出像元值为镶嵌到该位置的第一个栅格数据集中的值。
  • 最后一个叠置区域的输出像元值为镶嵌到该位置的最后一个栅格数据集中的值。这是默认设置。
  • 混合叠置区域的输出像元值为叠置区域中各像元值的水平加权计算结果。
  • 平均值重叠区域的输出像元值为叠置像元的平均值。
  • 最小值重叠区域的输出像元值为叠置像元的最小值。
  • 最大值重叠区域的输出像元值为叠置像元的最大值。
  • 总和重叠区域的输出像元值为叠置像元的总和。
String
镶嵌色彩映射表模式
(可选)

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

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

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

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

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

Double
NoData 值
(可选)

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

Double
将 1 位数据转换为 8 位
(可选)

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

  • 未选中 - 不执行任何转换。 这是默认设置。
  • 选中 - 将转换输入栅格。
Boolean
镶嵌容差
(可选)

发生镶嵌时,目标及源像素并不总是准确地排成直线。如果像素未对齐,则需要确定是重新采样还是平移数据。镶嵌容差可控制是否对像素执行重采样,或者是否平移像素。

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

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

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

Double
色彩匹配方法
(可选)

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

  • 当镶嵌栅格数据集时,此选项不会使用色彩匹配操作。
  • 匹配统计数据此方法将使用重叠区域中的描述统计;然后将变换应用于整个目标数据集。
  • 匹配直方图此方法将引用重叠区域与源重叠区域的直方图进行匹配;然后将变换应用于整个目标数据集。
  • 线性相关此方法将对重叠像素进行匹配,然后对源数据集的其余部分进行插值;不具有一对一关系的像素将使用加权平均值。
String
色彩映射表至 RGB
(可选)

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

  • 未选中 - 不发生任何转换。 这是默认设置。
  • 选中 - 将转换输入数据集。
Boolean

派生输出

标注说明数据类型
更新的目标栅格数据集

已更新的栅格数据集。

栅格数据集

arcpy.management.WorkspaceToRasterDataset(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重叠区域的输出像元值为叠置像元的最大值。
  • SUM重叠区域的输出像元值为叠置像元的总和。
String
colormap
(可选)

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

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

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

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

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

Double
nodata_value
(可选)

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

Double
onebit_to_eightbit
(可选)

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

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

发生镶嵌时,目标及源像素并不总是准确地排成直线。如果像素未对齐,则需要确定是重新采样还是平移数据。镶嵌容差可控制是否对像素执行重采样,或者是否平移像素。

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

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

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

Double
MatchingMethod
(可选)

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

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

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

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

派生输出

名称说明数据类型
out_raster_dataset

已更新的栅格数据集。

栅格数据集

代码示例

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}

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")

环境

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

许可信息

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

相关主题