Desktop Help 10.0 - 添加栅格至镶嵌数据集 (数据管理)

摘要

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

用法

所添加的栅格数据处于非托管状态；因此，如果删除或移动栅格数据，镶嵌数据集将受到影响。
仅可将栅格添加到包含在地理数据库中的镶嵌数据集。在地理数据库外部创建的镶嵌数据集仅可包含栅格目录的内容或先前创建的镶嵌数据集的内容。
栅格类型指明将数据加载到镶嵌数据集时所需的元数据。ArcGIS 支持多种默认的栅格类型，支持的栅格类型中列出了这些类型。

语法

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})

参数	说明	数据类型
in_mosaic_dataset	要添加栅格数据的镶嵌数据集的路径和名称。	Mosaic Dataset; Mosaic Layer
raster_type	栅格类型对于影像产品来说是特定的。它与栅格格式一起标识元数据信息，例如地理配准、采集日期和传感器类型。有关默认栅格类型的列表，请参阅支持的栅格类型。	Raster Type
input_path [input_path,...]	文件、文件夹、栅格数据集、栅格目录、镶嵌数据集、表或服务的路径和名称。文件 —允许选择一个或多个存储于磁盘的文件夹、影像服务定义 (.ISDef) 文件和栅格处理定义 (.RPDef) 文件中的栅格数据集。工作空间 —允许选择一个包含多个栅格数据集的文件夹。该文件夹可包含子文件夹。它受“包括子文件夹”和“过滤器”参数的影响。数据集 —允许选择 ArcGIS 地理数据集（如地理数据库中的任何栅格、栅格目录或镶嵌数据集）或表。服务 —允许选择 WCS、地图、影像服务或 Web 服务图层文件。	File; Workspace; Raster Dataset; Mosaic Dataset; Table; Raster Layer; Raster Catalog Layer; Mosaic Layer; WCS Coverage; Image Service; MapServer
update_cellsize_ranges （可选）	计算镶嵌数据集中每个栅格的像元大小范围。这些值将写入 minPS 和 maxPS 列中的属性表。 TRUE —计算镶嵌数据集中所有栅格的像元大小范围。这是默认设置。 FALSE —不会计算像元大小范围。	Boolean
update_boundary （可选）	生成或更新镶嵌数据集的边界面。默认情况下，边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。 TRUE —生成或更新边界。这是默认设置。 FALSE —不生成或更新边界。	Boolean
update_overviews （可选）	定义和生成镶嵌数据集的金字塔。 TRUE —将定义和生成金字塔。 FALSE —将不会定义或生成金字塔。这是默认设置。	Boolean
maximum_pyramid_levels （可选）	定义将在镶嵌数据集中使用的最大金字塔等级数。例如，值 2 表示仅使用源栅格的前两个金字塔等级。将其留空或输入值 -1 将会构建所有等级的金字塔。该值可影响显示及将要生成的金字塔数。	Long
maximum_cell_size （可选）	定义将在镶嵌数据集中使用的最大金字塔像元大小。	Double
minimum_dimension （可选）	定义将在镶嵌数据集中使用的栅格金字塔的最小尺寸。	Long
spatial_reference （可选）	输入数据的空间参考系统。如果数据没有坐标系，则应指定此参数；否则，将使用镶嵌数据集的坐标系。它还可用于覆盖输入数据的坐标系。	Spatial Reference
filter （可选）	将被添加到镶嵌数据集的数据的文件名过滤器。用于该过滤器的通配符可以是位于文件扩展名之前的一个简单的星号，也可以使用 PERL 语法设定格式。 .TIF REGEX:.1923.\|.1922.* REGEX:.192[34567].\|.194.\|.195.	String
sub_folder （可选）	递归搜索子文件夹。 TRUE —搜索所有子文件夹。这是默认设置。 FALSE —仅搜索顶级文件夹。	Boolean
duplicate_items_action （可选）	将使用原始路径和文件名进行检查，以确定是否已添加每个栅格。选择在发现重复路径和文件名后将要执行的操作。 ALLOW_DUPLICATES —将添加所有栅格，即使它们已经存在于镶嵌数据集中。这是默认设置。 EXCLUDE_DUPLICATES —不会添加重复的栅格。 OVERWRITE_DUPLICATES —重复的栅格将覆盖现有的栅格。	Boolean
build_pyramids （可选）	为每个源栅格构建金字塔。 FALSE —不生成金字塔。这是默认设置。 TRUE —将生成金字塔。	Boolean
calculate_statistics （可选）	为每个源栅格计算统计数据。 FALSE —不会生成统计数据。这是默认设置。 TRUE —将生成统计数据。	Boolean
build_thumbnails （可选）	为每个源栅格构建缩略图。 FALSE —不会生成缩略图。这是默认设置。 TRUE —将生成缩略图。	Boolean
operation_description （可选）		String

代码示例

AddRastersToMosaicDataset 示例 1（Python 窗口）

这是 AddRastersToMosaicDataset 工具的 Python 样本。

import arcpy
arcpy.AddRasters_management("c:/workspace/AddMD.gdb/md01", "Raster Dataset",\
                            "c:/data", "CALCULATE_CELL_SIZES", "BUILD_BOUNDARY",\                                            "BUILD_OVERVIEWS", "#", "#", "#",\
                            "World_Mercator.prj", ".tif", "NO_SUBFOLDERS",\
                            "EXCLUDE_DUPLICATES", "BUILD_PYRAMIDS",\
                            "CALCULATE_STATISTICS", "NO_THUMBNAILS", "Add Rasters")

AddRastersToMosaicDataset 示例 2（独立脚本）

这是 AddRastersToMosaicDataset 工具的 Python 脚本样本。

##===========================
##Add Rasters To Mosaic Dataset
##Usage: AddRastersToMosaicDataset_management in_mosaic_dataset raster_type input_path 
##                             {UPDATE_CELL_SIZES | NO_CELL_SIZES} {UPDATE_BOUNDARY
##                             | NO_BOUNDARY} {NO_OVERVIEWS | UPDATE_OVERVIEWS} 
##                             {maximum_pyramid_levels} {maximum_cell_size} 
##                             {minimum_dimension} {spatial_reference} {filter}
##                             {SUBFOLDERS | NO_SUBFOLDERS} {ALLOW_DUPLICATES
##                             | EXCLUDE_DUPLICATES | OVERWRITE_DUPLICATES}
##                             {NO_PYRAMIDS | BUILD_PYRAMIDS}
##                             {NO_STATISTICS | CALCULATE_STATISTICS} {NO_THUMBNAILS
##                             | BUILD_THUMBNAILS} {operation_description}
try:
    import arcpy
    arcpy.env.workspace = r"C:\Workspace"
    ##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
    ##Force Spatial Reference to World_Mercator
    ##Apply TIFF file filter
    ##Build Pyramids for the source datasets
    arcpy.AddRastersToMosaicDataset_management("AddMD.gdb/md_rasds", "Raster Dataset", "rasds",\
                                "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY", "UPDATE_OVERVIEWS",\
                                "2", "#", "#", "World_Mercator.prj", ".tif", "NO_SUBFOLDERS",\
                                "EXCLUDE_DUPLICATES", "BUILD_PYRAMIDS", "CALCULATE_STATISTICS",\
                                "NO_THUMBNAILS", "Add Raster Datasets")
    
    ##Add Landsat sensor type data to FGDB Mosaic Dataset
    ##Specify the Sensor template as Pansharpened
    ##Use Raster Dataset pyramid up to the cell size of 16
    ##Force Spatial Reference to GCS_WCS_1984
    ##Build Thumbnail for the Mosaic Dataset
    arcpy.AddRastersToMosaicDataset_management("AddMD.gdb/md_landsat","Landsat", "landsat", "UPDATE_CELL_SIZES",\
                                "UPDATE_BOUNDARY", "NO_OVERVIEWS", "#", "16", "#",\
                                "GCS_WGS_1984.prj", "#", "SUBFOLDERS", "EXCLUDE_DUPLICATES",\
                                "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",\
                                "Add Landsat L1G")
    ##Create SDE Mosaic Dataset
    arcpy.AddRastersToMosaicDataset_management("SDE94.sde/TOOLBOX.md_qb","QuickBird", "qb", "UPDATE_CELL_SIZES",\
                                "UPDATE_BOUNDARY", "NO_OVERVIEWS", "#", "#", "#",\
                                "GCS_WGS_1984.prj", "#", "SUBFOLDERS", "EXCLUDE_DUPLICATES",\
                                "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",\
                                "Add QuickBird")
except:
    print "Add Rasters To Mosaic Dataset example failed."
    print arcpy.GetMessages()

环境

当前工作空间, 范围, 金字塔, 栅格统计

许可信息

ArcView: 否

ArcEditor: 是

ArcInfo: 是

7/10/2012

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

摘要

用法

语法

代码示例

环境

相关主题

许可信息