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

摘要

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

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

使用情况

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

参数

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

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

Mosaic Layer
输出镶嵌图层

输出镶嵌图层的名称。

Mosaic Layer
表达式
(可选)

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

SQL Expression
模板范围
(可选)

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

  • 默认 - 该范围将基于所有参与输入的最大范围设定。这是默认设置。
  • 当前显示范围 - 该范围与数据框或可见显示范围相等。如果没有活动地图,则该选项将不可用。
  • 如下面的指定 - 该范围将基于指定的最小和最大范围值。
  • 浏览 - 该范围将基于现有数据集。
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")