ArcMap

镶嵌至新栅格

描述

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

使用方法

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

  • 处理大量栅格数据集时，栅格目录转栅格数据集工具的执行效率更高。

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

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

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

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

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

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

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

语法

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,...]

待合并的栅格数据集。输入必须具有相同的波段数和相同的位深度。

Composite Layer; Mosaic Dataset; Raster Dataset; Raster Layer
output_location

指向栅格数据集存放位置的路径。该路径可以指向某个文件夹或地理数据库。

Workspace; Raster Catalog
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")

环境

许可信息

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

相关主题