Convertir ráster a entidad (Análisis ráster)

Resumen

Convierte un ráster en un dataset de entidades como puntos, líneas o polígonos.

Ilustración

Herramienta Convertir ráster a entidad

Uso

  • Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

    La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. Esta herramienta no admite capas o datos ráster locales.

  • Los rásteres se pueden convertir a entidades de punto, línea o polígono.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa ráster de entrada

La capa ráster de entrada.

Feature Set
Campo

Un campo que especifica el valor de conversión.

Puede ser cualquier valor entero o de texto.

Los campos que contienen valores de punto flotante solo se pueden utilizar si la salida es a un dataset de puntos.

La opción predeterminada es el campo Value, que contiene el valor de cada celda ráster.

Field
Tipo de salida

Especifica el tipo de salida.

Si el tipo de salida es Línea o Polígono, aparece un parámetro adicional que permite la simplificación de líneas o polígonos.

  • PointEl ráster se convertirá en un dataset de puntos. Esta es la opción predeterminada.
  • LíneaEl ráster se convertirá en un dataset de entidades de línea.
  • PolígonoEl ráster se convertirá en un dataset de entidades poligonales.
String
Simplificar líneas o polígonos
(Opcional)

Especifica si las líneas o polígonos se simplificarán (se suavizarán). El suavizado se realiza de tal modo que la línea contenga un número mínimo de segmentos mientras permanece lo más cerca posible de los bordes de la celda ráster original.

  • Activado: las entidades de línea o poligonales se suavizarán para producir un resultado más generalizado. Esta es la opción predeterminada.
  • Desactivado: las entidades de línea o poligonales no se suavizarán y seguirán los límites de las celdas del dataset ráster.
Boolean
Nombre de salida

La clase de entidad de salida que contendrá los puntos, las líneas o los polígonos que se han convertido.

String
Crear entidades multiparte
(Opcional)

Especifica si los polígonos de salida estarán compuestos por entidades multiparte o de una sola parte.

  • Activado: se crearán entidades multiparte a partir de los polígonos que tengan el mismo valor.
  • Desactivado: se crearán entidades individuales (de una sola parte) para cada polígono. Esta es la opción predeterminada.
Boolean
Número máximo de vértices por entidad poligonal
(Opcional)

El límite de vértices utilizado para subdividir un polígono en polígonos más pequeños. Este parámetro produce una salida similar a la creada por la herramienta Subdividir de la caja de herramientas Administración de datos.

Si se deja vacío, los polígonos de salida no se dividen. Esta es la opción predeterminada.

Este parámetro solo es compatible si el Tipo de salida es Polígono.

Long

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidad de salida

Las entidades de salida.

Clase de entidad

arcpy.ra.ConvertRasterToFeature(inputRaster, field, outputType, {simplifyLinesOrPolygons}, outputName, {createMultipartFeatures}, {maxVerticesPerFeature})
NombreExplicaciónTipo de datos
inputRaster

La capa ráster de entrada.

Feature Set
field

Un campo que especifica el valor de conversión.

Puede ser cualquier valor entero o de texto.

Los campos que contienen valores de punto flotante solo se pueden utilizar si la salida es a un dataset de puntos.

La opción predeterminada es el campo Value, que contiene el valor de cada celda ráster.

Field
outputType

Especifica el tipo de salida.

  • POINTEl ráster se convertirá en un dataset de puntos. Esta es la opción predeterminada.
  • LINEEl ráster se convertirá en un dataset de entidades de línea.
  • POLYGONEl ráster se convertirá en un dataset de entidades poligonales.
String
simplifyLinesOrPolygons
(Opcional)

Especifica si las líneas o polígonos se simplificarán (se suavizarán). El suavizado se realiza de tal modo que la línea contenga un número mínimo de segmentos mientras permanece lo más cerca posible de los bordes de la celda ráster original.

  • SIMPLIFYLas entidades de línea o poligonales se suavizarán para producir un resultado más generalizado. Esta es la opción predeterminada.
  • NO_SIMPLIFYLas entidades de línea o poligonales no se suavizarán y seguirán los límites de las celdas del dataset ráster.

Este parámetro solo es compatible si outputType es LINE o POLYGON.

Boolean
outputName

La clase de entidad de salida que contendrá los puntos, las líneas o los polígonos que se han convertido.

String
createMultipartFeatures
(Opcional)

Especifica si los polígonos de salida estarán compuestos por entidades multiparte o de una sola parte.

  • MULTIPLE_OUTER_PARTSe crearán entidades multiparte a partir de los polígonos que tengan el mismo valor.
  • SINGLE_OUTER_PARTSe crearán entidades individuales (de una sola parte) para cada polígono. Esta es la opción predeterminada.

Este parámetro solo es compatible si outputType es POLYGON.

Boolean
maxVerticesPerFeature
(Opcional)

El límite de vértices utilizado para subdividir un polígono en polígonos más pequeños. Este parámetro produce una salida similar a la creada por la herramienta Subdividir de la caja de herramientas Administración de datos.

Si se deja vacío, los polígonos de salida no se dividen. Esta es la opción predeterminada.

Este parámetro solo es compatible si outputType es POLYGON.

Long

Salida derivada

NombreExplicaciónTipo de datos
outputFeatures

Las entidades de salida.

Clase de entidad

Muestra de código

Ejemplo 1 de ConvertRasterToFeature (ventana de Python)

En ese ejemplo se convierte un ráster a entidades de polígono.

import arcpy
arcpy.ra.ConvertRasterToFeature('https://MyPortal.esri.com/server/rest/services/Hosted/Landuse/ImageServer', 
                                'Value', 'POLYGON', 'SIMPLIFY', 'outFeatures')
Ejemplo 2 de ConvertRasterToFeature (script independiente).

En ese ejemplo se convierte un ráster a entidades de polígono.

#-------------------------------------------------------------------------------
# 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)

Información de licenciamiento

  • Basic: Requiere ArcGIS Image Server
  • Standard: Requiere ArcGIS Image Server
  • Advanced: Requiere ArcGIS Image Server

Temas relacionados