引用已有数据创建镶嵌数据集 (数据管理)

摘要

基于现有的栅格目录、栅格目录中的选择集或镶嵌数据集来创建新的镶嵌数据集。

用法

语法

CreateReferencedMosaicDataset_management (in_dataset, out_mosaic_dataset, {coordinate_system}, {number_of_bands}, {pixel_type}, {where_clause}, {in_template_dataset}, {extent}, {select_using_features}, {lod_field}, {minPS_field}, {maxPS_field}, {pixelSize}, {build_boundary})
参数说明数据类型
in_dataset

输入栅格目录或镶嵌数据集的路径及名称。

Mosaic Layer; Mosaic Dataset; Raster Catalog Layer
out_mosaic_dataset

路径和文件夹位置或地理数据库,用于创建镶嵌数据集。

Mosaic Dataset
coordinate_system
(可选)

已定义的镶嵌数据集坐标系,用于创建的所有关联文件。

Spatial Reference
number_of_bands
(可选)

镶嵌数据集所支持的栅格数据集的波段数。

Long
pixel_type
(可选)

栅格像元的位深度,用于确定镶嵌数据集输出的值的范围。例如,一个 8 位的镶嵌数据集可以具有 256 个不同的像素值,即范围从 0 至 255。

如果未定义,此值将从第一个栅格数据集获取。

  • 1_BIT1 位无符号整数。值可以为 0 或 1。
  • 2_BIT2 位无符号整数。支持的值为 0 到 3。
  • 4_BIT4 位无符号整数。支持的值为 0 到 15。
  • 8_BIT_UNSIGNED8 位无符号数据类型。支持的值为 0 到 255。
  • 8_BIT_SIGNED8 位有符号数据类型。支持的值为 -128 到 127。
  • 16_BIT_UNSIGNED16 位无符号数据类型。取值范围为 0 到 65,535。
  • 16_BIT_SIGNED16 位有符号数据类型。取值范围为 -32,768 到 32,767。
  • 32_BIT_UNSIGNED32 位无符号数据类型。取值范围为 0 到 4,294,967,295。
  • 32_BIT_SIGNED32 位有符号数据类型。取值范围为 -2,147,483,648 到 2,147,483,647。
  • 32_BIT_FLOAT支持小数的 32 位数据类型。
  • 64_BIT支持小数的 64 位数据类型。
String
where_clause
(可选)

使用 SQL 定义查询,或使用“查询构建器”构建查询(该查询用于确定从栅格目录或镶嵌定义中添加到镶嵌数据集中的栅格数据集)。

SQL Expression
in_template_dataset
(可选)

使用已指定栅格数据集或要素类的范围,从栅格目录或镶嵌数据集中定义在镶嵌数据集中使用的栅格数据集范围。

位于已定义范围边缘的栅格将被包含到镶嵌数据集中。

输入并非仅限于面要素类。

Feature Layer;Raster Layer
extent
(可选)

x 坐标及 y 坐标的最大值与最小值,用于定义镶嵌数据集中使用的来自栅格目录或镶嵌数据集中的栅格数据集。

Envelope
select_using_features
(可选)

若指定了要素类,您可以选择将范围限定为其包络矩形或将其裁剪至要素。

这种情况下,输入必须为面要素类。

  • SELECT_USING_FEATURES选择将基于要素形状。这是默认设置。
  • NO_SELECT_USING_FEATURES选择将基于要素类中数据的范围。
Boolean
lod_field
(可选)

栅格目录表中用于定义地图比例(在此比例下,会显示镶嵌,否则会显示线框)的字段。

Field
minPS_field
(可选)

栅格目录表中用于定义栅格最小像元大小(在此像元大小下,会显示镶嵌,否则会显示线框)的字段。

Field
maxPS_field
(可选)

栅格目录表中用于定义栅格最大像元大小(在此像元大小下,会显示镶嵌,否则会显示线框)的字段。

Field
pixelSize
(可选)

将显示镶嵌的最大像元大小。若在此分辨率之上显示镶嵌,则会显示线框。

Double
build_boundary
(可选)

为镶嵌数据集生成边界面。默认情况下,边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。

只有在地理数据库中创建镶嵌数据集时才可用。

  • BUILD_BOUNDARY生成或更新边界。这是默认设置。
  • NO_BOUNDARY 不生成边界。
Boolean

代码示例

CreateReferencedMosaicDataset 示例 1(Python 窗口)

这是 CreateReferencedMosaicDataset 的 Python 示例。

import arcpy
arcpy.CreateReferencedMosaicDataset_management("c:/workspace/input.gdb/md", \
                                               "c:/workspace/output.gdb/refMD", \
                                               "GCS_WGS_1984.prj", "1", "#", \
                                               "#","c:/temp/ref_md.shp", \
                                               "SELECT_USING_FEATURES", "#", \
                                               "#", "#", "#", "#", "NO_BOUNDARY")
CreateReferencedMosaicDataset 示例 2(独立脚本)

这是 CreateReferencedMosaicDataset 的 Python 脚本示例。

##===========================
##Create Referenced Mosaic Dataset
##Usage: CreateReferencedMosaicDataset_management input_dataset out_mosaic_dataset
##                                                {coordinate_system} {number_of_bands}
##                                                {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED
##                                                | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 16_BIT_SIGNED
##                                                | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT
##                                                | 64_BIT} {where_clause} {in_template_dataset}
##                                                {extent} {SELECT_USING_FEATURES
##                                                | NO_SELECT_USING_FEATURES}
##                                                {lod_field} {minPS_field} {maxPS_field}
##                                                {pixelSize} {BUILD_BOUNDARY | NO_BOUNDARY}

try:
    import arcpy
    arcpy.env.workspace = "C:/Workspace"
    # Create Referenced Mosaic Dataset from existing Mosaic Dataset
    # Use shape file to clip the source mosaic dataset
    arcpy.CreateReferencedMosaicDataset_management("RefMD.gdb/md", "ref_md.amd",\
                                                   "GCS_WGS_1984.prj", "1", "#",\
                                                   "#", "ref_md.shp", "#", \
                                                   "SELECT_USING_FEATURES",
                                                   "#", "#", "#", "#", "NO_BOUNDARY")
    
    # Create Referenced Mosaic Dataset from unmanaged raster catalog  
    arcpy.CreateReferencedMosaicDataset_management("RefMD.gdb/rc", "RefMD.gdb/rc_md",\
                                                   "#", "3", "#", "OBJECTID=2", "#",\
                                                   "#", "#", "Scale", "minps", "maxps",\
                                                   "3", "BUILD_BOUNDARY")
    
except:
    print "Calculate Referenced Mosaic Dataset example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcView: 否
ArcEditor: 是
ArcInfo: 是

7/10/2012