镶嵌至新栅格 (数据管理)

摘要

将多个栅格数据集合并到一个新的栅格数据集中。

使用情况

• 输入栅格数据集是要镶嵌在一起的所有栅格数据集。输入必须具有相同的波段数和相同的位深度；否则工具将退出，并显示错误消息。

• 将数据集合并到现有栅格时，镶嵌工具具有更多的可用参数，如用来忽略背景值和 NoData 值的选项。

• 必须设置像素类型使其与现有输入栅格数据集相匹配。如果不设置像素类型，将使用默认值 8 位，而输出结果可能会不正确。

• 可将输出结果保存为 BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF 格式或地理数据库栅格数据集。

• 将栅格数据集存储为 JPEG 格式文件、JPEG 2000 格式文件或地理数据库时，可在地理处理环境中指定压缩类型值和压缩质量值。

• GIF 格式仅支持单波段栅格数据集。

• 如果使用包含色彩映射表的栅格数据集进行镶嵌，应特别注意要镶嵌的各栅格数据集的色彩映射表之间的差异。 在此情况下，可针对包含不同色彩映射表的栅格使用镶嵌工具；但必须选择正确的镶嵌色彩映射表模式参数值。 如果选择了错误的色彩映射模式，则输出可能与预期不符。

• 本工具不支持企业级地理数据库的输出范围环境设置。如果要为输出栅格指定范围，可考虑使用裁剪工具。您可以在使用此工具之前裁剪输入栅格，也可以裁剪此工具的输出栅格。

参数

对话框

标注	说明	数据类型
输入栅格	待合并的栅格数据集。输入必须具有相同的波段数和相同的位深度。	Mosaic Dataset; Raster Dataset; Raster Layer
输出位置	用于存储栅格的文件夹或地理数据库。	Workspace
具有扩展名的栅格数据集名称	您正在创建的数据集名称。 以文件格式存储栅格数据集时，请指定文件扩展名，具体如下： .bil - Esri BIL .bip - Esri BIP .bmp - BMP .bsq - Esri BSQ .dat - ENVI DAT .gif - GIF .img - ERDAS IMAGINE .jpg - JPEG .jp2 - JPEG 2000 .png - PNG .tif - TIFF Esri Grid 无扩展名 将栅格数据集存储到地理数据库时，请勿向栅格数据集的名称添加文件扩展名。 将栅格数据集存储为 JPEG 格式文件、JPEG 2000 格式文件、TIFF 格式文件或地理数据库时，可在地理处理环境中指定压缩类型和压缩质量值。	String
栅格数据的空间参考 (可选)	输出栅格数据集的坐标系。	Coordinate System
像素类型 (可选)	镶嵌数据集的位深度或辐射分辨率。 如果不设置像素类型，将使用默认值 8 位，而输出结果可能会不正确。 1 位—像素类型为 1 位无符号整数。 值可以为 0 或 1。 2 位—像素类型为 2 位无符号整数。 受支持的值范围为 0 到 3。 4 位—像素类型为 4 位无符号整数。 受支持的值范围为 0 到 15。 8 位无符号—像素类型为 8 位无符号数据类型。 受支持的值范围为 0 到 255。 8 位有符号—像素类型为 8 位有符号数据类型。 受支持的值范围为 -128 到 127。 16 位无符号—像素类型为 16 位无符号数据类型。 取值范围为 0 到 65,535。 16 位有符号—像素类型为 16 位有符号数据类型。 取值范围为 -32,768 到 32,767。 32 位无符号—像素类型为 32 位无符号数据类型。 取值范围为 0 到 4,294,967,295。 32 位有符号—像素类型为 32 位有符号数据类型。 取值范围为 -2,147,483,648 到 2,147,483,647。 32 位浮点—像素类型为支持小数的 32 位数据类型。 64 位—像素类型为支持小数的 64 位数据类型。	String
像元大小 (可选)	将用于新建栅格数据集的像素大小。	Double
波段数	输出栅格将具有的波段数。	Long
镶嵌运算符 (可选)	用于镶嵌重叠的方法。 有关各镶嵌运算符的详细信息，请参阅“镶嵌运算符”帮助主题。 First—叠置区域的输出像元值为镶嵌到该位置的第一个栅格数据集中的值。 Last—叠置区域的输出像元值为镶嵌到该位置的最后一个栅格数据集中的值。这是默认设置。 Blend—叠置区域的输出像元值为叠置区域中各像元值的水平加权计算结果。 Mean—重叠区域的输出像元值为叠置像元的平均值。 最小值—重叠区域的输出像元值为叠置像元的最小值。 Maximum—重叠区域的输出像元值为叠置像元的最大值。 总和—重叠区域的输出像元值为叠置像元的总和。	String
镶嵌色彩映射表模式 (可选)	输入栅格数据集具有色彩映射表时应用。 指定对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。 有关各色彩映射表模式的详细信息，请参阅“镶嵌色彩映射表模式”帮助主题。 First—列表中第一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。 这是默认设置。 Last—列表中最后一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。 匹配—镶嵌时将考虑所有色彩映射表。 如果已经使用了所有可能的值（对于位深度），则该工具将与具有最接近的可用色彩的值进行匹配。 拒绝—仅镶嵌不具有关联色彩映射表的栅格数据集。	String

派生输出

标注	说明	数据类型
输出栅格数据集	输出栅格数据集。	栅格数据集

Python

arcpy.management.MosaicToNewRaster(input_rasters, output_location, raster_dataset_name_with_extension, {coordinate_system_for_the_raster}, {pixel_type}, {cellsize}, number_of_bands, {mosaic_method}, {mosaic_colormap_mode})

名称	说明	数据类型
input_rasters [input_raster,...]	待合并的栅格数据集。输入必须具有相同的波段数和相同的位深度。	Mosaic Dataset; Raster Dataset; Raster Layer
output_location	用于存储栅格的文件夹或地理数据库。	Workspace
raster_dataset_name_with_extension	您正在创建的数据集名称。 以文件格式存储栅格数据集时，请指定文件扩展名，具体如下： .bil - Esri BIL .bip - Esri BIP .bmp - BMP .bsq - Esri BSQ .dat - ENVI DAT .gif - GIF .img - ERDAS IMAGINE .jpg - JPEG .jp2 - JPEG 2000 .png - PNG .tif - TIFF Esri Grid 无扩展名 将栅格数据集存储到地理数据库时，请勿向栅格数据集的名称添加文件扩展名。 将栅格数据集存储为 JPEG 格式文件、JPEG 2000 格式文件、TIFF 格式文件或地理数据库时，可在地理处理环境中指定压缩类型和压缩质量值。	String
coordinate_system_for_the_raster (可选)	输出栅格数据集的坐标系。	Coordinate System
pixel_type (可选)	镶嵌数据集的位深度或辐射分辨率。 如果不设置像素类型，将使用默认值 8 位，而输出结果可能会不正确。 1_BIT—像素类型为 1 位无符号整数。 值可以为 0 或 1。 2_BIT—像素类型为 2 位无符号整数。 受支持的值范围为 0 到 3。 4_BIT—像素类型为 4 位无符号整数。 受支持的值范围为 0 到 15。 8_BIT_UNSIGNED—像素类型为 8 位无符号数据类型。 受支持的值范围为 0 到 255。 8_BIT_SIGNED—像素类型为 8 位有符号数据类型。 受支持的值范围为 -128 到 127。 16_BIT_UNSIGNED—像素类型为 16 位无符号数据类型。 取值范围为 0 到 65,535。 16_BIT_SIGNED—像素类型为 16 位有符号数据类型。 取值范围为 -32,768 到 32,767。 32_BIT_UNSIGNED—像素类型为 32 位无符号数据类型。 取值范围为 0 到 4,294,967,295。 32_BIT_SIGNED—像素类型为 32 位有符号数据类型。 取值范围为 -2,147,483,648 到 2,147,483,647。 32_BIT_FLOAT—像素类型为支持小数的 32 位数据类型。 64_BIT—像素类型为支持小数的 64 位数据类型。	String
cellsize (可选)	将用于新建栅格数据集的像素大小。	Double
number_of_bands	输出栅格将具有的波段数。	Long
mosaic_method (可选)	用于镶嵌重叠的方法。 FIRST—叠置区域的输出像元值为镶嵌到该位置的第一个栅格数据集中的值。 LAST—叠置区域的输出像元值为镶嵌到该位置的最后一个栅格数据集中的值。这是默认设置。 BLEND—叠置区域的输出像元值为叠置区域中各像元值的水平加权计算结果。 MEAN—重叠区域的输出像元值为叠置像元的平均值。 MINIMUM—重叠区域的输出像元值为叠置像元的最小值。 MAXIMUM—重叠区域的输出像元值为叠置像元的最大值。 SUM—重叠区域的输出像元值为叠置像元的总和。 有关各镶嵌运算符的详细信息，请参阅“镶嵌运算符”帮助主题。	String
mosaic_colormap_mode (可选)	输入栅格数据集具有色彩映射表时应用。 指定对输入栅格中应用于镶嵌输出的色彩映射表进行选择的方法。 FIRST—列表中第一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。 这是默认设置。 LAST—列表中最后一个栅格数据集中的色彩映射表将应用于输出栅格镶嵌。 MATCH—镶嵌时将考虑所有色彩映射表。 如果已经使用了所有可能的值（对于位深度），则该工具将与具有最接近的可用色彩的值进行匹配。 REJECT—仅镶嵌不具有关联色彩映射表的栅格数据集。	String

派生输出

名称	说明	数据类型
output_raster_dataset	输出栅格数据集。	栅格数据集

代码示例

MosaicToNewRaster 示例 1（Python 窗口）

这是 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 示例 2（独立脚本）

这是 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}                               

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

环境

压缩, 范围, NoData, 输出配置关键字, 并行处理因子, 金字塔, 栅格统计, 重采样方法, 切片大小

特殊情况

范围

对于企业级地理数据库无效

许可信息

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