栅格转要素 (栅格分析)

摘要

将栅格转换为点、线或面的要素数据集。

插图

栅格转要素工具

使用情况

  • 当您登录到已针对 Raster Analysis 配置 ArcGIS Image ServerArcGIS Enterprise 门户时,可以使用此栅格分析门户工具。 工具运行时,ArcGIS Pro 将充当客户端,并且处理将在与 ArcGIS Enterprise 联合的服务器中进行。 门户工具接受来自门户的图层作为输入,并在门户中创建输出。

    输入栅格图层支持门户中的图层、影像服务的 URI 或 URL 或者创建影像服务器图层工具的输出。 此工具不支持本地栅格数据或图层。

  • 可将栅格转换为点、线或面要素。

参数

标注说明数据类型
输入栅格图层

输入栅格图层。

Feature Set
字段

用于指定转换值的字段。

该值可以是整数值或文本值。

包含浮点值的字段仅限向点数据集输出时使用。

默认为 Value 字段,其中包含每个栅格像元中的值。

Field
输出类型

指定输出类型。

如果输出类型为线,则将显示一个附加参数,用于简化线或面。

  • 栅格将转换为点数据集。这是默认设置。
  • 线栅格将转换为线要素数据集。
  • 栅格将转换为面要素数据集。
String
简化线或面
(可选)

指定是否将简化(平滑)线或面。使线拥有最少线段数,同时尽可能接近原始栅格像元边,这就是平滑的实现方式。

  • 选中 - 将对线或面要素进行平滑处理,以生成更为概化的结果。这是默认设置。
  • 取消选中 - 线或面要素将不会进行平滑处理,并且将遵循栅格数据集的像元边界。
Boolean
输出名称

包含已转换点、线或面的输出要素类。

String
创建多部件要素
(可选)

指定输出面是由单部分要素还是多部分要素组成。

  • 选中 - 将根据具有相同值的面创建多部分要素。
  • 取消选中 - 将为每个面创建单个(单部分)要素。这是默认设置。
Boolean
每个面要素的最大折点数
(可选)

用于将面细分为更小的面的折点限制。此参数将产生的输出与数据管理工具箱中的切分工具创建的输出类似。

如果留空,则输出面不会被分割。这是默认设置。

仅当输出类型时,才支持此参数。

Long

派生输出

标注说明数据类型
输出要素

输出要素。

要素类

arcpy.ra.ConvertRasterToFeature(inputRaster, field, outputType, {simplifyLinesOrPolygons}, outputName, {createMultipartFeatures}, {maxVerticesPerFeature})
名称说明数据类型
inputRaster

输入栅格图层。

Feature Set
field

用于指定转换值的字段。

该值可以是整数值或文本值。

包含浮点值的字段仅限向点数据集输出时使用。

默认为 Value 字段,其中包含每个栅格像元中的值。

Field
outputType

指定输出类型。

  • POINT栅格将转换为点数据集。这是默认设置。
  • LINE栅格将转换为线要素数据集。
  • POLYGON栅格将转换为面要素数据集。
String
simplifyLinesOrPolygons
(可选)

指定是否将简化(平滑)线或面。使线拥有最少线段数,同时尽可能接近原始栅格像元边,这就是平滑的实现方式。

  • SIMPLIFY将对线或面要素进行平滑处理,以生成更为概化的结果。这是默认设置。
  • NO_SIMPLIFY线或面要素将不会进行平滑处理,并且将遵循栅格数据集的像元边界。

仅当 outputTypeLINEPOLYGON 时,才支持此参数。

Boolean
outputName

包含已转换点、线或面的输出要素类。

String
createMultipartFeatures
(可选)

指定输出面是由单部分要素还是多部分要素组成。

  • MULTIPLE_OUTER_PART将根据具有相同值的面创建多部分要素。
  • SINGLE_OUTER_PART将为每个面创建单个(单部分)要素。这是默认设置。

仅当 outputTypePOLYGON 时,才支持此参数。

Boolean
maxVerticesPerFeature
(可选)

用于将面细分为更小的面的折点限制。此参数将产生的输出与数据管理工具箱中的切分工具创建的输出类似。

如果留空,则输出面不会被分割。这是默认设置。

仅当 outputTypePOLYGON 时,才支持此参数。

Long

派生输出

名称说明数据类型
outputFeatures

输出要素。

要素类

代码示例

ConvertRasterToFeature 示例 1(Python 窗口)

本示例可将栅格转换为面要素。

import arcpy
arcpy.ra.ConvertRasterToFeature('https://MyPortal.esri.com/server/rest/services/Hosted/Landuse/ImageServer', 
                                'Value', 'POLYGON', 'SIMPLIFY', 'outFeatures')
ConvertRasterToFeature 示例 2(独立脚本)

本示例可将栅格转换为面要素。

#-------------------------------------------------------------------------------
# Name: ConvertRasterToFeature_Ex_02.py
# Description: Convert a raster to polygon features.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/Landuse/ImageServer'
inField = 'Value'
outType = 'POLYGON'
simplify = 'SIMPLIFY'
outFeatures = 'outFeatures'
arcpy.ra.ConvertRasterToFeature(inRaster, inField, outType, simplify, outFeatures)

许可信息

  • Basic: 需要 ArcGIS Image Server
  • Standard: 需要 ArcGIS Image Server
  • Advanced: 需要 ArcGIS Image Server

相关主题