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

描述

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

使用方法

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

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

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

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

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

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

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

语法

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; MapServer; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace
update_cellsize_ranges
(可选)

指定是否计算镶嵌数据集中每个栅格的像元大小范围。这些值将写入 minPSmaxPS 字段中的属性表。

  • 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

已更新的镶嵌数据集。

镶嵌图层

代码示例

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: 是

相关主题