ArcMap

添加栅格至镶嵌数据集

摘要

将文件、文件夹、表或 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,...]

文件、文件夹、栅格数据集、镶嵌数据集、表或服务的路径和名称。

并非所有输入选项都可用。可用选项将取决于所选栅格类型。

  • Dataset —用于选择 ArcGIS 地理数据集，例如地理数据库或表中的任何栅格或镶嵌数据集。
  • Workspace —用于选择一个包含多个栅格数据集的文件夹。该文件夹可包含子文件夹。它受包括子文件和输入数据过滤器参数的影响。
  • File —允许选择一个或多个存储于磁盘的文件夹、影像服务定义 (.ISDef) 文件和栅格处理定义 (.RPDef) 文件中的栅格数据集。 同时，文件列表将忽略所有与添加的栅格类型不对应的文件。此选项不得与栅格数据集文件格式（如 TIFF 或 MrSID 文件）配合使用，请与数据集配合使用。
  • Service —用于选择 WCS、地图、影像服务或 Web 服务图层文件。
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 列中的属性表。

  • 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

Derived Output

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

相关主题