添加栅格至镶嵌数据集 (数据管理)

摘要

将文件、文件夹、表或 Web 服务等多种来源的栅格数据集添加到镶嵌数据集。

使用情况

• 所添加的栅格数据处于非托管状态；如果删除或移动栅格数据，镶嵌数据集将受到影响。

• 栅格数据仅可添加到包含在地理数据库中的镶嵌数据集。 在地理数据库外部创建的镶嵌数据集仅可包含先前创建的镶嵌数据集的内容。

• 栅格类型参数确定了将数据加载到镶嵌数据集时所需的元数据。

  了解有关栅格类型的详细信息

  栅格类型特定于影像产品。 它与栅格格式一起标识元数据信息，例如地理配准、采集日期和传感器类型。

• 处理模板选项包含将应用于要添加到镶嵌数据集的各项目的函数，以及应用函数的方式或顺序。

• 为加快显示和处理速度，可在选择启用像素缓存选项后生成镶嵌数据集的像素缓存。

参数

对话框

标注	说明	数据类型
镶嵌数据集	要添加栅格数据的镶嵌数据集的路径和名称。	Mosaic Layer
栅格类型	将添加的栅格类型。 栅格类型特定于影像产品。 它与栅格格式一起标识元数据信息，例如地理配准、采集日期和传感器类型。 如果要使用 LAS、LAS 数据集或 Terrain 栅格类型，则必须在栅格类型属性页面上指定像元大小。 处理模板下拉列表中包含将应用于添加到镶嵌数据集的各项目的函数，以及应用函数的方式或顺序。 可以使用单个函数（例如拉伸函数），也可以将多个函数链接到一起以创建更高级的产品。 大多数镶嵌类型具有多个预先存在的关联函数。 可以使用此下拉列表来编辑现有函数，或将新函数添加到要添加到镶嵌数据集的项目。 要编辑模板，请在处理模板下拉列表中选择模板，然后单击编辑 。 完成模板编辑后，单击保存 更新模板，或单击另存为 将其另存为下拉列表中的新项目。 要将模板导出到磁盘，以与其他镶嵌数据集配合使用，请单击导出按钮 。 要创建模板，请在处理模板下拉列表中单击创建新模板 。 有关详细信息，请参阅栅格函数。 要从磁盘或栅格函数窗格导入函数链，请在处理模板下拉列表中单击导入 。 如果未使用栅格类型模板编辑器创建模板，则需要将主要输入栅格变量的名称更改为 Dataset。 为此，请双击链中的第一个函数，然后单击变量选项卡。 将栅格参数的 Name 字段中的值更改为 Dataset。	Raster Type
输入数据	指定输入文件、文件夹、栅格数据集、镶嵌数据集、表或服务的路径和名称。 并非所有输入选项都可用。 所选栅格类型将确定可用选项。 数据集—ArcGIS 地理数据集（例如地理数据库或表中的栅格或镶嵌数据集）将被用作输入。 工作空间—包含多个栅格数据集的文件夹将被用作输入。 该文件夹可包含子文件夹。此选项受包括子文件夹和输入数据过滤器参数的影响。 文件—一个或多个存储于磁盘的文件夹、影像服务定义文件 (.ISDef) 或栅格处理定义文件 (.RPDef) 中的栅格数据集将被用作输入。文件列表将忽略与添加的栅格类型不对应的文件。此选项不得与栅格数据集文件格式（如 TIFF 或 MrSID 文件）配合使用，请改为使用数据集输入类型。 服务—WCS、地图、影像服务或 web 服务图层文件将被用作输入。	File; Image Service; LAS Dataset Layer; Layer File; Map Server; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace
更新像元大小范围 (可选)	指定是否计算镶嵌数据集中每个栅格的像元大小范围。 这些值将写入 minPS 和 maxPS 字段中的属性表。 选中 - 计算镶嵌数据集中所有栅格的像元大小范围。 这是默认设置。 取消选中 - 不会计算像元大小范围。	Boolean
更新边界 (可选)	指定是否生成或更新镶嵌数据集的边界面。 默认情况下，边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。 选中 - 生成或更新边界。 这是默认设置。 未选中 - 不会生成或更新边界。	Boolean
更新概视图 (可选)	指定是否定义和生成镶嵌数据集的概视图。 选中 - 将定义和生成概览。 取消选中 - 将不会定义或生成概视图。 这是默认设置。	Boolean
最大级别 (可选)	将在镶嵌数据集中使用的最大金字塔等级数。 例如，值 2 表示仅使用源栅格的前两个金字塔等级。 将此参数留空或输入值 -1 将会构建所有等级的金字塔。 该值可影响显示及将要生成的概视图数。	Long
最大像元大小 (可选)	将在镶嵌数据集中使用的最大金字塔像元大小。	Double
最小行数或列数 (可选)	将在镶嵌数据集中使用的栅格金字塔的最小尺寸。	Long
输入数据的坐标系 (可选)	输入数据的空间参考系统。 如果数据没有坐标系，则应指定此参数；否则，将使用镶嵌数据集的坐标系。 它还可用于覆盖输入数据的坐标系。	Spatial Reference
输入数据过滤器 (可选)	将被添加到镶嵌数据集的数据的过滤器。 可以使用 SQL 表达式来创建数据过滤器。 过滤器的通配符适用于输入数据的完整路径。 以下 SQL 语句将用于选择与以下对象 ID 相匹配的行： OBJECTID IN (19745, 19680, 19681, 19744, 5932, 5931, 5889, 5890, 14551, 14552, 14590, 14591) 要仅添加一个 TIFF 图像，可以在文件扩展名前添加一个星号。 *.TIF 要添加文件路径或文件名中包含单词 sensor 的图像，则需要在单词 sensor 前后都填加一个星号。 *sensor2009* 您还可以使用 PERL 语法来创建数据过滤器。 REGEX:.*1923.*|.*1922.* REGEX:.*192[34567].*|.*194.*|.*195.* 不支持以下将多个词汇分组作为表达式一部分的 PERL 语法： REGEX:.* map_mean_.*(?:(?:[a-z0-9]*)_pptPct_(?:[0-9]|1[0-2]*?)_2[0-9]_*\w*).img 或者也可以使用以下语法： REGEX:.*map_mean_*[a-z0-9]*_pptPct_([0-9]|1[0-2])_2[0-9]*_\w*.img	String
包括子文件夹 (可选)	指定是否递归搜索子文件夹。 选中 - 在所有子文件夹中搜索数据。 这是默认设置。 取消选中 - 仅浏览顶级文件夹以查找数据。	Boolean
仅添加新数据集 (可选)	指定如何处理重复栅格。 将使用原始路径和文件名来执行检查，以确定是否已添加各个栅格。 选择在发现重复路径和文件名后执行的操作。 允许副本—将添加所有栅格，即使它们已经存在于镶嵌数据集中。 这是默认设置。 排除副本—不会添加重复的栅格。 覆盖副本—重复的栅格将覆盖现有的栅格。	String
构建栅格金字塔 (可选)	指定是否为每个源栅格构建金字塔。 未选中 - 不构建金字塔。 这是默认设置。 选中 - 将构建金字塔。	Boolean
计算统计数据 (可选)	指定是否为每个源栅格计算统计数据。 未选中 - 不计算统计数据。 这是默认设置。 选中 - 计算统计数据。	Boolean
构建缩略图 (可选)	制定是否为每个源栅格构建缩略图。 未选中 - 不构建缩略图。 这是默认设置。 选中 - 构建缩略图。	Boolean
操作描述 (可选)	用于介绍栅格数据添加操作的描述。 它将添加到可用作搜索的一部分或在其他时间作为引用的栅格类型表。	String
强制使用输入数据的坐标系 (可选)	将数据加载到镶嵌数据集中时，指定是否将输入数据的坐标系参数值用于所有栅格。 此选项不会重新投影数据；而是使用在工具中定义的坐标系构建镶嵌数据集中的项目。 将会使用影像的范围，但会覆盖投影。 未选中 - 加载数据时，将使用各个栅格数据的坐标系。 这是默认设置。 如果未选中此选项，并且输入图像不具备坐标系（即坐标系未知），则会在构建镶嵌数据集项目时使用镶嵌数据集坐标系。 如果图像具备坐标系，则将使用此坐标系。 选中 - 加载数据时，将输入数据的坐标系参数中指定的坐标系用于各个栅格数据集。	Boolean
估算镶嵌数据集统计数据 (可选)	指定是否在镶嵌数据集级别对镶嵌数据集估算统计数据，以便更快地进行渲染和处理。 未选中 - 不估算统计数据。 将使用每个项目在镶嵌数据集中生成的统计数据进行显示和处理。 这是默认设置。 选中 - 将在镶嵌数据集级别估算统计数据。 将会使用用于显示镶嵌数据集的像素分布，而非镶嵌数据集中的源项目分布。	Boolean
辅助输入 (可选)	栅格类型设置，可在栅格类型属性页面中进行定义。 此参数中的设置将覆盖在栅格类型属性页面中定义的设置。	Value Table
启用像素缓存 (可选)	指定是否生成像素缓存，以便更快地显示和处理镶嵌数据集。 未选中 - 不生成像素缓存。 这是默认设置。 选中 - 生成像素缓存。	Boolean
像素缓存位置 (可选)	像素缓存的位置。 如果未定义位置，则缓存将写入 C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\。 如果已定义位置，则向镶嵌数据集添加新栅格时无需重新定义路径。 您只需在添加新数据时选中启用像素缓存参数（Python 中的 enable_pixel_cache = "USE_PIXEL_CACHE"）。	Folder; String

派生输出

标注	说明	数据类型
更新的镶嵌数据集	已更新的镶嵌数据集。	Mosaic Layer

Python

arcpy.management.AddRastersToMosaicDataset(in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description}, {force_spatial_reference}, {estimate_statistics}, {aux_inputs}, {enable_pixel_cache}, {cache_location})

名称	说明	数据类型
in_mosaic_dataset	要添加栅格数据的镶嵌数据集的路径和名称。	Mosaic Layer
raster_type	栅格类型特定于影像产品。 它与栅格格式一起标识元数据信息，例如地理配准、采集日期和传感器类型。 如果要使用 LAS、LAS 数据集或 Terrain 栅格类型，则在指定像元大小时必须使用 .art 文件。 有关受支持的传感器和栅格类型的列表，请参阅受支持的传感器列表。	Raster Type
input_path [input_path,...]	指定输入文件、文件夹、栅格数据集、镶嵌数据集、表或服务的路径和名称。 并非所有输入选项都可用。 所选栅格类型将确定可用选项。 Dataset—ArcGIS 地理数据集（例如地理数据库或表中的栅格或镶嵌数据集）将被用作输入。 Folder—包含多个栅格数据集的文件夹将被用作输入。 该文件夹可包含子文件夹。此选项受包括子文件夹和输入数据过滤器参数的影响。 File—一个或多个存储于磁盘的文件夹、影像服务定义文件 (.ISDef) 或栅格处理定义文件 (.RPDef) 中的栅格数据集将被用作输入。文件列表将忽略与添加的栅格类型不对应的文件。此选项不得与栅格数据集文件格式（如 TIFF 或 MrSID 文件）配合使用，请改为使用数据集输入类型。 Service—WCS、地图、影像服务或 web 服务图层文件将被用作输入。	File; Image Service; LAS Dataset Layer; Layer File; Map Server; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace
update_cellsize_ranges (可选)	指定是否计算镶嵌数据集中每个栅格的像元大小范围。 这些值将写入 minPS 和 maxPS 字段中的属性表。 UPDATE_CELL_SIZES—计算镶嵌数据集中所有栅格的像元大小范围。 这是默认设置。 NO_CELL_SIZES—不会计算像元大小范围。	Boolean
update_boundary (可选)	指定是否生成或更新镶嵌数据集的边界面。 默认情况下，边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。 UPDATE_BOUNDARY—生成或更新边界。 这是默认设置。 NO_BOUNDARY—不生成或更新边界。	Boolean
update_overviews (可选)	指定是否定义和生成镶嵌数据集的概视图。 UPDATE_OVERVIEWS—将定义和生成概视图。 NO_OVERVIEWS—将不会定义或生成概视图。 这是默认设置。	Boolean
maximum_pyramid_levels (可选)	将在镶嵌数据集中使用的最大金字塔等级数。 例如，值 2 表示仅使用源栅格的前两个金字塔等级。 将此参数留空或输入值 -1 将会构建所有等级的金字塔。 该值可影响显示及将要生成的概视图数。	Long
maximum_cell_size (可选)	将在镶嵌数据集中使用的最大金字塔像元大小。	Double
minimum_dimension (可选)	将在镶嵌数据集中使用的栅格金字塔的最小尺寸。	Long
spatial_reference (可选)	输入数据的空间参考系统。 如果数据没有坐标系，则应指定此参数；否则，将使用镶嵌数据集的坐标系。 它还可用于覆盖输入数据的坐标系。	Spatial Reference
filter (可选)	将被添加到镶嵌数据集的数据的过滤器。 可以使用 SQL 表达式来创建数据过滤器。 过滤器的通配符适用于输入数据的完整路径。 以下 SQL 语句将用于选择与以下对象 ID 相匹配的行： OBJECTID IN (19745, 19680, 19681, 19744, 5932, 5931, 5889, 5890, 14551, 14552, 14590, 14591) 要仅添加一个 TIFF 图像，可以在文件扩展名前添加一个星号。 *.TIF 要添加文件路径或文件名中包含单词 sensor 的图像，则需要在单词 sensor 前后都填加一个星号。 *sensor2009* 您还可以使用 PERL 语法来创建数据过滤器。 REGEX:.*1923.*|.*1922.* REGEX:.*192[34567].*|.*194.*|.*195.* 不支持以下将多个词汇分组作为表达式一部分的 PERL 语法： REGEX:.* map_mean_.*(?:(?:[a-z0-9]*)_pptPct_(?:[0-9]|1[0-2]*?)_2[0-9]_*\w*).img 或者也可以使用以下语法： REGEX:.*map_mean_*[a-z0-9]*_pptPct_([0-9]|1[0-2])_2[0-9]*_\w*.img	String
sub_folder (可选)	指定是否递归搜索子文件夹。 SUBFOLDERS—搜索所有子文件夹。 这是默认设置。 NO_SUBFOLDERS—仅浏览顶级文件夹以查找数据。	Boolean
duplicate_items_action (可选)	指定如何处理重复栅格。 将使用原始路径和文件名来执行检查，以确定是否已添加各个栅格。 选择在发现重复路径和文件名后执行的操作。 ALLOW_DUPLICATES—将添加所有栅格，即使它们已经存在于镶嵌数据集中。 这是默认设置。 EXCLUDE_DUPLICATES—不会添加重复的栅格。 OVERWRITE_DUPLICATES—重复的栅格将覆盖现有的栅格。	String
build_pyramids (可选)	为每个源栅格构建金字塔。 NO_PYRAMIDS—不构建金字塔。 这是默认设置。 BUILD_PYRAMIDS—将构建金字塔。	Boolean
calculate_statistics (可选)	指定是否为每个源栅格计算统计数据。 NO_STATISTICS—不计算统计数据。 这是默认设置。 CALCULATE_STATISTICS—计算统计数据。	Boolean
build_thumbnails (可选)	制定是否为每个源栅格构建缩略图。 NO_THUMBNAILS—不构建缩略图。 这是默认设置。 BUILD_THUMBNAILS—构建缩略图。	Boolean
operation_description (可选)	用于介绍栅格数据添加操作的描述。 它将添加到可用作搜索的一部分或在其他时间作为引用的栅格类型表。	String
force_spatial_reference (可选)	指定坐标系。 将数据加载到镶嵌数据集中时，将 spatial_reference 参数中指定的坐标系用于所有栅格。 NO_FORCE_SPATIAL_REFERENCE—加载数据时，将使用各个栅格数据的坐标系。 这是默认设置。 FORCE_SPATIAL_REFERENCE—加载数据时，将 spatial_reference 参数中指定的坐标系用于各个栅格数据集。	Boolean
estimate_statistics (可选)	指定是否在镶嵌数据集级别对镶嵌数据集估算统计数据，以便更快地进行渲染和处理。 NO_STATISTICS—不估算统计数据。 将使用每个项目在镶嵌数据集中生成的统计数据进行显示和处理。 这是默认设置。 ESTIMATE_STATISTICS—将在镶嵌数据集级别估算统计数据。 将会使用用于显示镶嵌数据集的像素分布，而非镶嵌数据集中的源项目分布。	Boolean
aux_inputs [aux_inputs,...] (可选)	栅格类型设置，可在栅格类型属性页面中进行定义。 此参数中的设置将覆盖在栅格类型属性页面中定义的设置。	Value Table
enable_pixel_cache (可选)	指定是否生成像素缓存，以便更快地显示和处理镶嵌数据集。 NO_PIXEL_CACHE—不生成像素缓存。 这是默认设置。 USE_PIXEL_CACHE—生成像素缓存。	Boolean
cache_location (可选)	像素缓存的位置。 如果未定义位置，则缓存将写入 C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\。 如果已定义位置，则向镶嵌数据集添加新栅格时无需重新定义路径。 您只需在添加新数据时选中启用像素缓存参数（Python 中的 enable_pixel_cache = "USE_PIXEL_CACHE"）。	Folder; String

派生输出

名称	说明	数据类型
out_mosaic_dataset	已更新的镶嵌数据集。	Mosaic Layer

代码示例

AddRastersToMosaicDataset 示例 1（Python 窗口）

这是 AddRastersToMosaicDataset 函数的 Python 示例。

import arcpy
arcpy.AddRastersToMosaicDataset_management(
     "c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+", 
     "c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
     "UPDATE_OVERVIEWS", "2", "#", "#", "GCS_WGS_1984.prj",
     "*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
     "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS", 
     "Add Landsat L1G", "FORCE_SPATIAL_REFERENCE",
     "NO_STATISTICS", "", "USE_PIXEL_CACHE", 
r"C:\test\cachelocation")

AddRastersToMosaicDataset 示例 2（独立脚本）

这是 AddRastersToMosaicDataset 函数的 Python 脚本示例。

#Add Raster Dataset type Raster to FGDB Mosaic Dataset
#Calculate Cell Size Ranges and Build Boundary
#Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
#Apply TIFF file filter
#Build Pyramids for the source datasets

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
mdname = "AddMD.gdb/md_rasds"
rastype = "Raster Dataset"
inpath = "c:/data/rasds"
updatecs = "UPDATE_CELL_SIZES"
updatebnd = "UPDATE_BOUNDARY"
updateovr = "UPDATE_OVERVIEWS"
maxlevel = "2"
maxcs = "#"
maxdim = "#"
spatialref = "#"
inputdatafilter = "*.tif"
subfolder = "NO_SUBFOLDERS"
duplicate = "EXCLUDE_DUPLICATES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildthumb = "NO_THUMBNAILS"
comments = "Add Raster Datasets"
forcesr = "#"
estimatestats = "ESTIMATE_STATISTICS"
auxilaryinput = ""
enablepixcache = "USE_PIXEL_CACHE"
cachelocation = "c:\\test\\cachelocation"

arcpy.AddRastersToMosaicDataset_management(
     mdname,  rastype, inpath, updatecs, updatebnd, updateovr,
     maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
     subfolder, duplicate, buildpy, calcstats, 
     buildthumb, comments, forcesr, estimatestats,
     auxilaryinput, enablepixcache, cachelocation)

环境

当前工作空间, 范围, 地理变换, 并行处理因子, 金字塔, 栅格统计, 临时工作空间

特殊情况

许可信息

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