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

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 ejecuta 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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. Point—El ráster se convertirá en un dataset de puntos. Esta es la opción predeterminada. Línea—El ráster se convertirá en un dataset de entidades de línea. Polígono—El 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

Etiqueta	Explicación	Tipo de datos
Entidad de salida	Las entidades de salida.	Clase de entidad

Python

arcpy.ra.ConvertRasterToFeature(inputRaster, field, outputType, {simplifyLinesOrPolygons}, outputName, {createMultipartFeatures}, {maxVerticesPerFeature})

Nombre	Explicación	Tipo 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. POINT—El ráster se convertirá en un dataset de puntos. Esta es la opción predeterminada. LINE—El ráster se convertirá en un dataset de entidades de línea. POLYGON—El 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. SIMPLIFY—Las entidades de línea o poligonales se suavizarán para producir un resultado más generalizado. Esta es la opción predeterminada. NO_SIMPLIFY—Las 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_PART—Se crearán entidades multiparte a partir de los polígonos que tengan el mismo valor. SINGLE_OUTER_PART—Se 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

Nombre	Explicación	Tipo 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)

Entornos

Extensión, Sistema de coordenadas de salida, Alinear ráster

Información de licenciamiento

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