创建影像服务器图层 (数据管理)

摘要

根据影像服务创建临时栅格图层。如果不保存文档,所创建的图层将在会话结束后消失。

输入还可以是连接到影像服务器的 SOAP URL。

使用情况

  • 通过该工具可根据影像服务或者引用某影像服务的 URL 来创建一个影像图层。

  • 输出可为整体影像服务,也可为部分影像服务。

  • 通过该工具将影像服务添加到 Python 脚本或模型中,或者在创建地理处理服务时使用此工具。

  • 要裁剪掉部分影像服务,可选择一个输出范围图层或指定一个矩形范围。如果选择输出范围图层,则裁剪范围将基于该图层的范围。

  • 可仅通过波段的子集来创建输出。这将有助于及时保存并节省磁盘空间。

  • 仅当镶嵌选项中包含的影像服务根据镶嵌定义或影像服务定义生成时,镶嵌选项才可用。

参数

标注说明数据类型
输入影像服务

输入影像服务的名称或引用影像服务的 SOAP URL。浏览至某输入影像服务或键入所需的输入影像服务。此工具还支持使用引用影像服务的 SOAP URL。

使用名为 ProjectX 的影像服务名称的示例是:C:\MyProject\ServerConnection.ags\ProjectX.ImageServer

下面是一个 URL 示例:http://AGSServer:8399/arcgis/services/ISName/ImageServer

Image Service; String
输出影像服务器图层

输出影像图层的名称。

Raster Layer
模板范围
(可选)

影像图层的输出范围。

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

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

    注:

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

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

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

    • 所有要素 全选 - 图层中所有要素的范围。
    • 选定要素基于选定要素的区域 - 图层中选定要素的范围。
    • 可见要素 Extent Indicator - 图层中可见要素的范围。
      注:

      选定要素 基于选定要素的区域可见要素 Extent Indicator 选项中的范围仅适用于要素图层。

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

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

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

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

Extent
波段
(可选)

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

Value Table
镶嵌方法
(可选)

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

  • 接缝线使用接缝线在影像间进行平滑过渡。
  • 西北显示距离镶嵌数据集边界西北角最近的影像。
  • 中心显示距离屏幕中心最近的影像。
  • 锁定栅格选择要显示的特定栅格数据集。
  • 按属性基于属性表中的字段显示影像并设置影像优先级。
  • 像底点通过最接近零视角的视角范围来显示栅格。
  • 视点显示距离所选视角最近的影像。
  • 根据镶嵌数据集属性表中的 ObjectID 对栅格进行排序。
String
排序字段
(可选)

将镶嵌方法设为 By_Attribute 时用于栅格排序的默认字段。根据服务表中类型为元数据和整型的字段来定义字段列表(例如,值可以是日期或云覆盖比例)。

String
排序基础值
(可选)

根据此输入值与指定字段中的属性值之间的差异对影像进行排序。

String
锁定栅格 ID
(可选)

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

String
输出像元大小
(可选)

输出影像服务图层的像元大小。

Double
表达式
(可选)

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

SQL Expression
处理模板
(可选)

可应用于输出影像服务图层的栅格函数处理模板。

  • 无处理模板。
String

arcpy.management.MakeImageServerLayer(in_image_service, out_imageserver_layer, {template}, {band_index}, {mosaic_method}, {order_field}, {order_base_value}, {lock_rasterid}, {cell_size}, {where_clause}, {processing_template})
名称说明数据类型
in_image_service

输入影像服务的名称或引用影像服务的 SOAP URL。

使用名为 ProjectX 的影像服务名称的示例是:C:\MyProject\ServerConnection.ags\ProjectX.ImageServer

下面是一个 URL 示例:http://AGSServer:8399/arcgis/services/ISName/ImageServer

Image Service; String
out_imageserver_layer

输出影像图层的名称。

Raster Layer
template
(可选)

影像图层的输出范围。

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

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

Value Table
mosaic_method
(可选)

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

  • SEAMLINE使用接缝线在影像间进行平滑过渡。
  • NORTH_WEST显示距离镶嵌数据集边界西北角最近的影像。
  • CLOSEST_TO_CENTER显示距离屏幕中心最近的影像。
  • LOCK_RASTER选择要显示的特定栅格数据集。
  • BY_ATTRIBUTE基于属性表中的字段显示影像并设置影像优先级。
  • CLOSEST_TO_NADIR通过最接近零视角的视角范围来显示栅格。
  • CLOSEST_TO_VIEWPOINT显示距离所选视角最近的影像。
  • NONE根据镶嵌数据集属性表中的 ObjectID 对栅格进行排序。
String
order_field
(可选)

将镶嵌方法设为 By_Attribute 时用于栅格排序的默认字段。根据服务表中类型为元数据和整型的字段来定义字段列表(例如,值可以是日期或云覆盖比例)。

String
order_base_value
(可选)

根据此输入值与指定字段中的属性值之间的差异对影像进行排序。

String
lock_rasterid
(可选)

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

String
cell_size
(可选)

输出影像服务图层的像元大小。

Double
where_clause
(可选)

使用 SQL 定义查询

SQL Expression
processing_template
(可选)

可应用于输出影像服务图层的栅格函数处理模板。

  • None无处理模板。
String

代码示例

MakeImageServerLayer 示例 1(Python 窗口)

这是 MakeImageServerLayer 工具的 Python 示例。

arcpy.MakeImageServerLayer_management(
        input2, "mdlayer", "feature.shp", "1;2;3",
        "LockRaster", "#", "#", "4", "#", processing_template="Hillshade")
MakeImageServerLayer 示例 2(Python 窗口)

这是 MakeImageServerLayer 工具的 Python 脚本示例。

arcpy.MakeImageServerLayer_management(
        input2, "mdlayer", "feature.shp", "1;2;3",
        "LockRaster", "#", "#", "4", "#", processing_template="Custom_func")

许可信息

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

相关主题