摘要
将文件、文件夹、表或 Web 服务等多种来源的栅格数据集添加到镶嵌数据集。
用法
所添加的栅格数据处于非托管状态；因此，如果删除或移动栅格数据，镶嵌数据集将受到影响。
栅格数据仅可添加到包含在地理数据库中的镶嵌数据集。在地理数据库外部创建的镶嵌数据集仅可包含栅格目录的内容或先前创建的镶嵌数据集的内容。
栅格类型参数确定了将数据加载到镶嵌数据集时所需的元数据。
语法
AddRastersToMosaicDataset_management (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})| 参数 | 说明 | 数据类型 |
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 Catalog 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 |
派生输出
| 名称 | 说明 | 数据类型 |
| 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")
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 = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
环境
许可信息
- ArcGIS Desktop Basic: 否
- ArcGIS Desktop Standard: 是
- ArcGIS Desktop Advanced: 是