工作空间转栅格数据集 (数据管理)
摘要
将存储在指定工作空间的全部栅格数据集镶嵌至一个栅格数据集。
用法
-
目标栅格数据集必须已经存在才能运行该工具。
-
如果目标栅格数据集尚不存在，使用创建栅格数据集工具创建新的栅格数据集。
-
由于要进行镶嵌，所以需指定所要使用的镶嵌方法和色彩映射表模式。
-
如果目标栅格数据集是一个空的栅格数据集，则镶嵌将应用第一个输入栅格数据集的像元大小和空间参考。
-
尽可能使用最后一个镶嵌运算符，将这些栅格数据集镶嵌到文件地理数据库或 ArcSDE 地理数据库中的现有栅格数据集内；这是目前为止最有效的镶嵌方式。
-
对于镶嵌离散数据，镶嵌运算符的“第一个值”、“最小值”和“最大值”选项会提供最有意义的结果。镶嵌运算符的“混合”和“平均值”选项最适合连续数据。
-
色彩匹配方法下拉箭头可用于选择镶嵌数据集的色彩匹配算法。
-
对于基于文件的栅格和个人地理数据库栅格，为了忽略背景值，忽略背景值必须设置为与 NoData 相同的值。文件地理数据库栅格和 ArcSDE 栅格无需经过此额外步骤即可忽略背景值。
-
对于不同分辨率的浮点型输入栅格数据集或像元不对齐的情况，建议在运行镶嵌之前，使用双线性插值法或三次卷积插值法对所有数据进行重采样；否则，镶嵌将会使用最邻近重采样法自动对栅格数据集进行重采样（该方法不适用于连续数据类型）。
语法
| 参数 | 说明 | 数据类型 |
in_workspace |
包含要镶嵌到栅格数据集的所有栅格数据集的工作空间。 | Workspace |
in_raster_dataset |
要镶嵌所有来自工作空间的栅格的栅格数据集。该栅格数据集必须已经存在。 | Raster dataset |
include_subdirectories （可选） |
指定是否包含子目录。
| Boolean |
mosaic_type （可选） |
用于镶嵌重叠的方法。
有关各镶嵌运算符的详细信息，请参阅镶嵌运算符。 | String |
colormap （可选） |
对输入栅格数据中应用于镶嵌输出的色彩映射表的选择方法。
有关各色彩映射表模式的详细信息，请参阅镶嵌色彩映射表模式。 | 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 位，从而在显示画面中生成独特的栅格数据集。
| Boolean |
mosaicking_tolerance （可选） |
发生镶嵌时，目标及源像素并不总是准确地排成直线。当存在像素偏差时，需要决定是否执行重采样，或是否应当平移数据。镶嵌容差可控制是否对像素执行重采样，或者是否应当平移像素。 如果（传入的数据集与目标数据集之间的）像素偏差大于该容差，则执行重采样。如果（传入的数据集与目标数据集之间的）像素偏差小于该容差，则不执行重采样（而是执行平移）。 容差的单位为像素；有效值范围为 0 到 0.9999。一个像素可能偏移的最大值为 0.5，因此您设置任意大于 0.5 的值都会保证执行平移。存在像素偏差时，容差为零会保证执行重采样。 例如，源像素和目标像素的偏差值为 0.25。如果将镶嵌容差设置为 0.2，由于像素偏差大于该容差，因此将执行重采样。如果将镶嵌容差设置为 0.3，则会平移像素。 | Double |
matchingMethod （可选） |
选择应用于栅格的色彩匹配方法。
| String |
colormap_to_RGB （可选） |
如果输入栅格数据集具有色彩映射表，则可将输出栅格数据集转换为三波段输出栅格数据集。这在镶嵌包含不同色彩映射表的栅格时很有用。
| Boolean |
代码示例
这是 WorkspaceToRasterDataset 工具的 Python 示例。
import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
"INCLUDE_SUBDIRECTORIES", "LAST",
"FIRST", "0", "9", "", "",
"HISTOGRAM_MATCHING", "")这是 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()