描述
将文件夹中的所有栅格数据集合并为一个栅格数据集。
使用方法
目标栅格数据集必须已经存在才能运行该工具。
如果目标栅格数据集尚不存在,使用创建栅格数据集工具创建新的栅格数据集。
由于要进行镶嵌,所以需指定所要使用的镶嵌方法和色彩映射表模式。
如果目标栅格数据集是一个空的栅格数据集,则镶嵌将应用第一个输入栅格数据集的像元大小和空间参考。
尽可能使用最后一个镶嵌运算符,将这些栅格数据集镶嵌到文件地理数据库或企业级地理数据库中的现有栅格数据集内;这是目前为止最有效的镶嵌方式。
对于镶嵌离散数据,镶嵌运算符的“第一个值”、“最小值”和“最大值”选项会提供最有意义的结果。镶嵌运算符的“混合”和“平均值”选项最适合连续数据。
色彩匹配方法下拉箭头可用于选择镶嵌数据集的色彩匹配算法。
对于基于文件的栅格,要忽略背景值,必须将其设置为与 NoData 相同的值。地理数据库栅格无需经过此额外步骤即可忽略背景值。
对于不同分辨率的浮点型输入栅格数据集或像元不对齐的情况,建议在运行镶嵌之前,使用双线性插值法或三次卷积插值法对所有数据进行重采样;否则,镶嵌将会使用最邻近重采样法自动对栅格数据集进行重采样(该方法不适用于连续数据类型)。
语法
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 (可选) | 指定是否包含子目录。
| Boolean |
mosaic_type (可选) | 用于镶嵌重叠的方法。
| String |
colormap (可选) | 对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。
| 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 位,从而在显示画面中生成适合的栅格数据集。
| Boolean |
mosaicking_tolerance (可选) | 发生镶嵌时,目标及源像素并不总是准确地排成直线。当存在像素偏差时,需要决定是否执行重采样,或是否应当平移数据。镶嵌容差可控制是否对像素执行重采样,或者是否应当平移像素。 如果(传入的数据集与目标数据集之间的)像素偏差大于该容差,则执行重采样。如果(传入的数据集与目标数据集之间的)像素偏差小于该容差,则不执行重采样(而是执行平移)。 容差的单位为像素,有效值范围为 0 到 0.5。容差为 0.5 会保证发生平移。存在像素偏差时,容差为零会保证执行重采样。 例如,源像素和目标像素的偏差值为 0.25。如果将镶嵌容差设置为 0.2,由于像素偏差大于该容差,因此将执行重采样。如果将镶嵌容差设置为 0.3,则会平移像素。 | Double |
MatchingMethod (可选) | 应用于栅格的色彩匹配方法。
| String |
colormap_to_RGB (可选) | 如果输入栅格数据集具有色彩映射表,则可将输出栅格数据集转换为三波段输出栅格数据集。这在镶嵌包含不同色彩映射表的栅格时很有用。
| 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: 是