创建镶嵌图层 (数据管理)

摘要

根据镶嵌数据集或图层文件创建镶嵌图层。该工具创建的图层是临时图层,如果不将此图层另存为图层文件或保存地图,该图层在会话结束后将不会继续存在。

此工具可用来创建图层,这样便可以对镶嵌数据集内的指定波段子集进行处理。

使用情况

  • 可仅通过波段的子集来创建输出。 这样可以节省时间和磁盘空间。

参数

标注说明数据类型
镶嵌数据集

输入镶嵌数据集的路径和名称。

Mosaic Layer
输出镶嵌图层

输出镶嵌图层的名称。

Mosaic Layer
表达式
(可选)

使用 SQL 定义查询,或者使用查询构建器构建查询。

SQL Expression
模板范围
(可选)

指定输出范围的方法可以是定义四个坐标,也可以是使用现有图层的范围。

  • 当前显示范围 地图视图 - 范围基于活动地图或场景。 仅在存在活动地图时,才可使用此选项。
  • 绘制范围 构造直角并完成草图 - 范围将基于在地图或场景上绘制的矩形。 此选项将在工程地理数据库中创建要素类并将图层添加至地图。 该要素类的坐标系将与地图相同。
    注:

    环境对话框中不提供此选项。 只能在具有范围数据类型的工具参数中或工具对话框的环境选项卡中找到此选项。

    注:

    当选中从“编辑”选项卡启用和禁用编辑编辑选项时,必须在编辑功能区选项卡上启用编辑才能绘制范围。

  • 图层范围 Layer - 范围基于活动地图图层。 使用下拉列表选择可用图层,或使用所有图层中数据的范围选项获取所有活动地图图层(不包括底图)的组合范围。 仅在存在具有图层的活动地图时,才可使用此选项。

    每个地图图层具有以下选项:

    • 所有要素 全选 - 图层中所有要素的范围。
    • 选定要素Area from Selected Features - 图层中选定要素的范围。
    • 可见要素 Extent Indicator - 图层中可见要素的范围。
      注:

      选定要素 Area from Selected Features可见要素 Extent Indicator 选项中的范围仅适用于要素图层。

  • 浏览 浏览 - 范围基于现有数据集。
  • 剪贴板 粘贴 - 可在剪贴板中复制和粘贴范围。
    • 复制范围 复制 - 将范围坐标和坐标系复制到剪贴板。
    • 使用粘贴范围 粘贴 - 从剪贴板粘贴范围坐标和(可选)坐标系。 如果剪贴板值不包含坐标系,则范围将使用地图的坐标系。
    注:

    将使用与 ArcPy Extent 对象相同的格式和顺序从剪贴板中复制和粘贴范围坐标:x-min、y-min、x-max、y-max 和空间参考。

  • 重置范围 重置 - 将范围重置为默认值。
  • 手动输入坐标 - 坐标必须是数值,并且与活动地图的坐标系相匹配。
    警告:

    地图可能使用与输入的坐标不同的显示单位。 不支持使用主方向(N、S、E、W)。 在南纬和西经坐标中使用负号。

Extent
波段
(可选)

将为图层导出的波段。 如果未指定波段,则输出中将使用所有波段。

Value Table
镶嵌方法
(可选)

选择镶嵌方法。镶嵌方法定义了如何使用镶嵌数据集中的不同栅格数据来创建图层。

  • CLOSEST_TO_CENTER根据栅格中心与视图中心的距离对栅格数据进行排序,与视图中心距离越近,栅格数据的次序越靠前。
  • NORTH_WEST根据栅格中心与西北方向的距离对栅格数据进行排序,与西北方向距离越近,栅格数据的次序越靠前。
  • LOCK_RASTER允许用户根据 ID 或名称锁定单个或多个栅格数据的显示。选择此选项后,需要指定锁定栅格的 ID。
  • BY_ATTRIBUTE根据属性字段及其与基础值的差异对栅格数据进行排序。选择此选项后,还需要设置排序字段和排序基础值参数。
  • CLOSEST_TO_NADIR根据像底点与视图中心的距离对栅格数据进行排序,像底点与视图中心的距离越近,栅格数据的次序越靠前。像底点可以不同于中心点,尤其是在倾斜的影像数据中。
  • CLOSEST_TO_VIEWPOINT根据像底点与用户定义的视点之间的距离对栅格数据进行排序,像底点与视点距离越近,栅格数据的次序越靠前。
  • SEAMLINE使用预定义的接缝线形状分割栅格,并且可以选择是否沿接边使用羽化功能。在生成接缝线的过程中对排序进行预定义。使用此镶嵌方法时,镶嵌运算符 LAST 无效。
String
排序字段
(可选)

选择排序字段。如果镶嵌方法为 BY_ATTRIBUTE,则需要设置排序栅格时所要使用的默认字段。根据服务表中类型为元数据的字段来定义字段列表。

String
排序基础值
(可选)

排序基础值。根据此值与指定字段中的属性值之间的差异对影像(栅格数据)进行排序。

String
锁定栅格 ID
(可选)

应将服务锁定至的栅格 ID 或栅格名称,以便只显示指定的栅格。如果未定义,将遵循系统默认设置。可使用分号分隔的列表定义多个 ID。

String
排序顺序
(可选)

选择排序顺序是升序还是降序。

  • ASCENDING排序顺序将为升序。这是默认设置。
  • DESCENDING排序顺序将为降序。
String
镶嵌运算符
(可选)

选择要使用的镶嵌运算符。如果两个或更多栅格具有相同的排序优先级,则可使用此参数来进一步细化排序顺序。

  • FIRST列表中第一个栅格的次序将最为靠前。这是默认设置。
  • LAST列表中最后一个栅格的次序将最为靠前。
  • MIN值越低的栅格次序越靠前。
  • MAX值越高的栅格次序越靠前。
  • MEAN平均像素值的次序将最为靠前。
  • BLEND通过对值进行融合来获得输出像元值;该融合结果依据算法得出,该算法基于权重且与重叠区域内各像素到边缘的距离相关。
  • SUM输出像元值将为所有重叠像元的聚合。
String
输出像元大小
(可选)

输出镶嵌图层的像元大小。

Double
处理模板
(可选)

可应用于输出镶嵌图层的栅格函数处理模板。

  • 无处理模板。
String

arcpy.management.MakeMosaicLayer(in_mosaic_dataset, out_mosaic_layer, {where_clause}, {template}, {band_index}, {mosaic_method}, {order_field}, {order_base_value}, {lock_rasterid}, {sort_order}, {mosaic_operator}, {cell_size}, {processing_template})
名称说明数据类型
in_mosaic_dataset

输入镶嵌数据集的路径和名称。

Mosaic Layer
out_mosaic_layer

输出镶嵌图层的名称。

Mosaic Layer
where_clause
(可选)

使用 SQL 定义查询

SQL Expression
template
(可选)

指定输出范围的方法可以是定义四个坐标,也可以是使用现有图层的范围。

  • MAXOF - 将使用的所有输入的最大范围。
  • MINOF - 将使用的所有输入共用的最小范围。
  • DISPLAY - 范围与可见显示范围相等。
  • 图层名称 - 将使用指定图层的范围。
  • Extent 对象 - 将使用指定对象的范围。
  • 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标以 x-min,y-min,x-max,y-max 的顺序表示。
Extent
band_index
[ID,...]
(可选)

将为图层导出的波段。 如果未指定波段,则输出中将使用所有波段。

Value Table
mosaic_method
(可选)

选择镶嵌方法。镶嵌方法定义了如何使用镶嵌数据集中的不同栅格数据来创建图层。

  • CLOSEST_TO_CENTER根据栅格中心与视图中心的距离对栅格数据进行排序,与视图中心距离越近,栅格数据的次序越靠前。
  • NORTH_WEST根据栅格中心与西北方向的距离对栅格数据进行排序,与西北方向距离越近,栅格数据的次序越靠前。
  • LOCK_RASTER允许用户根据 ID 或名称锁定单个或多个栅格数据的显示。选择此选项后,需要指定锁定栅格的 ID。
  • BY_ATTRIBUTE根据属性字段及其与基础值的差异对栅格数据进行排序。选择此选项后,还需要设置排序字段和排序基础值参数。
  • CLOSEST_TO_NADIR根据像底点与视图中心的距离对栅格数据进行排序,像底点与视图中心的距离越近,栅格数据的次序越靠前。像底点可以不同于中心点,尤其是在倾斜的影像数据中。
  • CLOSEST_TO_VIEWPOINT根据像底点与用户定义的视点之间的距离对栅格数据进行排序,像底点与视点距离越近,栅格数据的次序越靠前。
  • SEAMLINE使用预定义的接缝线形状分割栅格,并且可以选择是否沿接边使用羽化功能。在生成接缝线的过程中对排序进行预定义。使用此镶嵌方法时,镶嵌运算符 LAST 无效。
String
order_field
(可选)

选择排序字段。如果镶嵌方法为 BY_ATTRIBUTE,则需要设置排序栅格时所要使用的默认字段。根据服务表中类型为元数据的字段来定义字段列表。

String
order_base_value
(可选)

排序基础值。根据此值与指定字段中的属性值之间的差异对影像(栅格数据)进行排序。

String
lock_rasterid
(可选)

应将服务锁定至的栅格 ID 或栅格名称,以便只显示指定的栅格。如果未定义,将遵循系统默认设置。可使用分号分隔的列表定义多个 ID。

String
sort_order
(可选)

选择排序顺序是升序还是降序。

  • ASCENDING排序顺序将为升序。这是默认设置。
  • DESCENDING排序顺序将为降序。
String
mosaic_operator
(可选)

选择要使用的镶嵌运算符。如果两个或更多栅格具有相同的排序优先级,则可使用此参数来进一步细化排序顺序。

  • FIRST列表中第一个栅格的次序将最为靠前。这是默认设置。
  • LAST列表中最后一个栅格的次序将最为靠前。
  • MIN值越低的栅格次序越靠前。
  • MAX值越高的栅格次序越靠前。
  • MEAN平均像素值的次序将最为靠前。
  • BLEND通过对值进行融合来获得输出像元值;该融合结果依据算法得出,该算法基于权重且与重叠区域内各像素到边缘的距离相关。
  • SUM输出像元值将为所有重叠像元的聚合。
String
cell_size
(可选)

输出镶嵌图层的像元大小。

Double
processing_template
(可选)

可应用于输出镶嵌图层的栅格函数处理模板。

  • None无处理模板。
String

代码示例

MakeMosaicLayer 示例 1(Python 窗口)

这是 MakeMosaicLayer 的 Python 示例。

arcpy.MakeMosaicLayer_management(
        "fgdb.gdb/mdsrc", "mdlayer2", "", "clipmd.shp", "3;2;1", 
		"BY_ATTRIBUTE", "Tag", "Dataset", "", "DESCENDING", "LAST", "10", 
		processing_template="NDVI")
MakeMosaicLayer 示例 2(Python 窗口)

这是 MakeMosaicLayer 的 Python 脚本示例。

arcpy.MakeMosaicLayer_management(
        "fgdb.gdb/mdsrc", "mdlayer2", "", "clipmd.shp", "3;2;1", 
		"BY_ATTRIBUTE", "Tag", "Dataset", "", "DESCENDING", "LAST", "10", 
		processing_template="Custom_func")