ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • 帮助
  • Sign Out
ArcGIS Desktop

ArcGIS Online

专为贵组织打造的制图平台

ArcGIS Desktop

全面的专业性 GIS

ArcGIS Enterprise

面向企业的 GIS

ArcGIS Developers

用于构建位置感知应用程序的工具

ArcGIS Solutions

适用于行业的免费模板地图和应用程序

ArcGIS Marketplace

获取适用于组织的应用程序和数据

  • 文档
  • 支持
Esri
  • 登录
user
  • 我的个人资料
  • 登出

ArcMap

  • 主页
  • 入门
  • 地图
  • 分析
  • 管理数据
  • 工具
  • 扩展模块

添加栅格至镶嵌数据集

  • 描述
  • 使用方法
  • 语法
  • 代码示例
  • 环境
  • 许可信息

描述

将文件、文件夹、表或 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})
参数说明数据类型
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; Map Server; 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

派生输出

名称说明数据类型
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 = "#"

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

环境

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

许可信息

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

相关主题

  • “栅格”工具集概述
  • 栅格数据的环境设置
  • 什么是栅格类型?
  • 受支持的栅格数据集文件格式
  • 将栅格数据添加到镶嵌数据集中
  • 支持的栅格和影像数据格式列表

ArcGIS Desktop

  • 主页
  • 文档
  • 支持

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

关于 Esri

  • 关于我们
  • 招贤纳士
  • Esri 博客
  • 用户大会
  • 开发者峰会
Esri
分享您的想法。
Copyright © 2021 Esri. | 隐私政策 | 法律声明