描述
将文件、文件夹、表或 Web 服务等多种来源的栅格数据集添加到镶嵌数据集。
使用方法
所添加的栅格数据处于非托管状态；如果删除或移动栅格数据，镶嵌数据集将受到影响。
栅格数据仅可添加到包含在地理数据库中的镶嵌数据集。在地理数据库外部创建的镶嵌数据集仅可包含先前创建的镶嵌数据集的内容。
栅格类型参数确定了将数据加载到镶嵌数据集时所需的元数据。
栅格类型特定于影像产品。它与栅格格式一起标识元数据信息，例如地理配准、采集日期和传感器类型。
处理模板选项包含将应用于要添加到镶嵌数据集的各项目的函数，以及应用函数的方式或顺序。
为加快显示和处理速度，可在选择启用像素缓存选项后生成镶嵌数据集的像素缓存。
语法
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,...] | 指定输入文件、文件夹、栅格数据集、镶嵌数据集、表或服务的路径和名称。 并非所有输入选项都可用。所选栅格类型将确定可用选项。
| 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 （可选） | 指定是否计算镶嵌数据集中每个栅格的像元大小范围。这些值将写入 minPS 和 maxPS 字段中的属性表。
| Boolean |
update_boundary （可选） | 指定是否生成或更新镶嵌数据集的边界面。默认情况下，边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。
| Boolean |
update_overviews （可选） | 指定是否定义和生成镶嵌数据集的概视图。
| Boolean |
maximum_pyramid_levels （可选） | 将在镶嵌数据集中使用的最大金字塔等级数。例如，值 2 表示仅使用源栅格的前两个金字塔等级。将此参数留空或输入值 -1 将会构建所有等级的金字塔。 该值可影响显示及将要生成的概视图数。 | Long |
maximum_cell_size （可选） | 将在镶嵌数据集中使用的最大金字塔像元大小。 | Double |
minimum_dimension （可选） | 将在镶嵌数据集中使用的栅格金字塔的最小尺寸。 | Long |
spatial_reference （可选） | 输入数据的空间参考系统。 如果数据没有坐标系，则应指定此参数；否则，将使用镶嵌数据集的坐标系。它还可用于覆盖输入数据的坐标系。 | Spatial Reference |
filter （可选） | 将被添加到镶嵌数据集的数据的过滤器。可以使用 SQL 表达式来创建数据过滤器。过滤器的通配符适用于输入数据的完整路径。 以下 SQL 语句将用于选择与以下对象 ID 相匹配的行：
如果想仅添加一个 TIFF 图像，可以在文件扩展名前添加一个星号。
如果希望添加文件路径或文件名中包含单词 sensor 的图像，则需要在单词 sensor 前后都填加一个星号。
您还可以使用 PERL 语法来创建数据过滤器。
不支持以下将多个词汇分组作为表达式一部分的 PERL 语法：
或者也可以使用以下语法：
| String |
sub_folder （可选） | 指定是否递归搜索子文件夹。
| Boolean |
duplicate_items_action （可选） | 指定如何处理重复栅格。将使用原始路径和文件名来执行检查，以确定是否已添加各个栅格。选择在发现重复路径和文件名后执行的操作。
| String |
build_pyramids （可选） | 为每个源栅格构建金字塔。
| Boolean |
calculate_statistics （可选） | 指定是否为每个源栅格计算统计数据。
| Boolean |
build_thumbnails （可选） | 制定是否为每个源栅格构建缩略图。
| Boolean |
operation_description （可选） | 用于介绍栅格数据添加操作的描述。它将添加到可用作搜索的一部分或在其他时间作为引用的栅格类型表。 | String |
force_spatial_reference （可选） | 指定坐标系。将数据加载到镶嵌数据集中时，将 spatial_reference 参数中指定的坐标系用于所有栅格。
| Boolean |
estimate_statistics （可选） | 指定是否在镶嵌数据集级别对镶嵌数据集估算统计数据，以便更快地进行渲染和处理。
| Boolean |
aux_inputs [aux_inputs,...] （可选） | 栅格类型设置，可在栅格类型属性页面中进行定义。此参数中的设置将覆盖在栅格类型属性页面中定义的设置。 | Value Table |
enable_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 工具的 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 工具的 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: 是