镶嵌至新栅格 (Data Management)
摘要
将多个栅格数据集镶嵌到一个新的栅格数据集中。
用法
-
输入栅格数据集是要镶嵌在一起的所有栅格数据集。输入必须具有相同的波段数和相同的位深度；否则工具将退出，并显示错误消息。
-
处理大量栅格数据集时，栅格目录转栅格数据集工具的执行效率更高。
-
将数据集合并到现有栅格时，镶嵌工具具有更多的可用参数，如用来忽略背景值和 nodata 值的选项。
-
必须设置像素类型使其与现有输入栅格数据集相匹配。如果不设置像素类型，将使用默认值 8 位，而输出结果可能会不正确。
-
可将输出结果保存为 BIL、BIP、BMP、BSQ、DAT、GIF、Esri Grid、IMG、JPEG、JPEG 2000、PNG、TIFF 格式或任意地理数据库栅格数据集。
-
将栅格数据集存储到 JPEG 文件、JPEG 2000 文件或地理数据库时，可在“环境设置”中指定压缩类型和压缩质量。
-
GIF 格式仅支持单波段栅格数据集。
-
如果使用包含色彩映射表的栅格数据集进行镶嵌，应特别注意选择要镶嵌的各栅格数据集的色彩映射表之间的差异。在此情况下，可针对包含不同色彩映射表的栅格使用镶嵌工具；但必须选择正确的镶嵌色彩映射表模式运算符。如果选择了错误的色彩映射模式，则可能会返回意外的输出结果。
-
本工具不支持 ArcSDE 的输出范围环境设置。如果要为输出栅格指定范围，可考虑使用裁剪工具。您可以在使用此工具之前裁剪输入栅格，也可以裁剪此工具的输出栅格。
语法
| 参数 | 说明 | 数据类型 |
input_rasters [input_raster,...] |
输入栅格数据集。 | Mosaic Dataset; Composite Layer; Raster Dataset; Raster layer |
output_location |
指向栅格数据集存放位置的路径。该路径可以指向某个文件夹或地理数据库。 | Workspace; Raster Catalog |
raster_dataset_name_with_extension |
要创建的栅格数据集的名称和扩展名。 以文件格式存储栅格数据集时，需要指定文件扩展名，具体如下：
以地理数据库形式存储栅格数据集时，不应向栅格数据集的名称添加文件扩展名。 将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时，可以指定压缩类型和压缩质量。 | String |
coordinate_system_for_the_raster (可选) |
指定输出栅格镶嵌的地图投影。 | Coordinate System |
pixel_type (可选) |
指定输出栅格数据集的位深度。 必须设置像素类型使其与现有输入栅格数据集相匹配。如果不设置像素类型，将使用默认值 8 位，而输出结果可能会不正确。
| String |
cellsize (可选) |
新栅格数据集的像元大小。 | Double |
number_of_bands |
栅格数据集中包含的波段数。 | Long |
mosaic_method (可选) |
用于镶嵌重叠的方法。
有关各镶嵌运算符的详细信息，请参阅镶嵌运算符。 | String |
mosaic_colormap_mode (可选) |
输入栅格数据集具有色彩映射表时应用。 对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。
有关各色彩映射表模式的详细信息，请参阅镶嵌色彩映射表模式。 | String |
代码实例
这是 MosaicToNewRaster 工具的 Python 示例。
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MosaicToNewRaster_management("land1.tif;land2.tif", "Mosaic2New", \
"landnew.tif", "World_Mercator.prj",\
"8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
这是 MosaicToNewRaster 工具的 Python 脚本示例。
##==================================
##Mosaic To New Raster
##Usage: MosaicToNewRaster_management inputs;inputs... output_location raster_dataset_name_with_extension
## {coordinate_system_for_the_raster} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT
## | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_FLOAT | 32_BIT_UNSIGNED
## | 32_BIT_SIGNED | | 64_BIT {cellsize} number_of_bands {LAST | FIRST | BLEND | MEAN
## | MINIMUM | MAXIMUM} {FIRST | REJECT | LAST | MATCH}
try:
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic several TIFF images to a new TIFF image
arcpy.MosaicToNewRaster_management("landsatb4a.tif;landsatb4b.tif","Mosaic2New", "landsat.tif", "World_Mercator.prj",\
"8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
except:
print "Mosaic To New Raster example failed."
print arcpy.GetMessages()