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

摘要

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

输入还可以是连接到影像服务器的 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
波段
(可选)

选择要为图层输出哪些波段。 如果未指定波段,则输出中将使用所有波段。

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: 是

相关主题