De ráster a polígono (Conversión)

Resumen

Convierte un dataset ráster en entidades de polígono.

Uso

  • El ráster de entrada puede tener cualquier tamaño de celda y debe ser un dataset ráster entero válido.

  • El parámetro Campo le permite elegir qué campo de atributo del dataset ráster de entrada se convertirá en un atributo en la clase de entidad de salida. Si no se especifica ningún campo, los valores de la celda del ráster de entrada (el campo VALUE) se convertirán en una columna con el encabezado Gridcode en la tabla de atributos de la clase de entidad de salida.

  • El siguiente gráfico ilustra cómo se vectoriza el ráster de entrada cuando se convierte en una salida de entidad poligonal. El resultado se presenta para ambas configuraciones del parámetro Simplificar.

    Ilustración de la salida con diferentes opciones de simplificar
    Comparación de la salida con diferentes opciones de simplificar
  • Si el parámetro Crear entidades multiparte está activado (MULTIPLE_OUTER_PART en Python), la salida será una clase de entidad multiparte y, en promedio, se procesa más rápido. Sin embargo, si la clase de entidad de salida contiene un número de entidades muy elevado, podría provocar un error de memoria insuficiente. El proceso de agrupamiento es similar al utilizado en la herramienta Disolver.

  • Es posible usar el parámetro Número máximo de vértices por polígono para subdividir un polígono en polígonos más pequeños basándose en un límite de vértices especificado. Esta posibilidad resulta particularmente útil si las entidades de salida contienen un número de vértices muy elevado. Este parámetro produce una salida similar a la creada por la herramienta Subdividir.

  • Si se especifica Extensión en la configuración del entorno y la esquina inferior izquierda de la extensión de salida no coincide con la esquina de ninguna celda en el ráster de entrada, durante el procesamiento se realizará un desplazamiento de la alineación de la celda del ráster de entrada para que coincida con la extensión especificada. Este desplazamiento activará un remuestreo del ráster de entrada utilizando el método de Vecino más cercano. Por consiguiente, las entidades de salida también se desplazarán y puede que las entidades de salida resultantes no se superpongan exactamente con el ráster de entrada original. Puede evitar este desplazamiento utilizando el ráster de entrada como Ráster de alineación en el entorno.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

El dataset ráster de entrada.

El ráster debe ser de tipo entero.

Raster Layer
Entidades de polígono de salida

La clase de entidad de salida que contendrá los polígonos que se convirtieron.

Feature Class
Simplificar polígonos
(Opcional)

Determina si los polígonos de salida se suavizarán a formas más simples o se ajustarán a los bordes de la celda del ráster de entrada.

  • Activado: los polígonos se suavizarán a formas más simples. El suavizado se realiza de tal modo que los polígonos contengan un número mínimo de segmentos mientras permanecen lo más cerca posible de los bordes de la celda ráster original. Esta es la opción predeterminada.
  • Desactivado: el borde de los polígonos se ajustará exactamente a los bordes de la celda del ráster de entrada. Con esta opción, la conversión de nuevo en un ráster de la clase de entidad de polígono resultante generará un ráster idéntico al original.
Boolean
Campo
(Opcional)

El campo que se utiliza para asignar los valores desde las celdas del ráster de entrada a los polígonos del dataset de salida.

Puede ser un campo entero o de cadena de caracteres.

Field
Crear entidades multiparte
(Opcional)

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

  • Activado: especifica que se crearán entidades multiparte a partir de los polígonos que tengan el mismo valor.
  • Desactivado: especifica que se crearán entidades individuales 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.

Si se deja vacío, los polígonos de salida no se dividen. El valor predeterminado es que esté vacío.

Long

arcpy.conversion.RasterToPolygon(in_raster, out_polygon_features, {simplify}, {raster_field}, {create_multipart_features}, {max_vertices_per_feature})
NombreExplicaciónTipo de datos
in_raster

El dataset ráster de entrada.

El ráster debe ser de tipo entero.

Raster Layer
out_polygon_features

La clase de entidad de salida que contendrá los polígonos que se convirtieron.

Feature Class
simplify
(Opcional)

Determina si los polígonos de salida se suavizarán a formas más simples o se ajustarán a los bordes de la celda del ráster de entrada.

  • SIMPLIFYLos polígonos se suavizarán a formas más simples. El suavizado se realiza de tal modo que los polígonos contengan un número mínimo de segmentos mientras permanecen lo más cerca posible de los bordes de la celda ráster original. Esta es la opción predeterminada.
  • NO_SIMPLIFYEl borde de los polígonos se ajustará exactamente a los bordes de la celda del ráster de entrada. Con esta opción, la conversión de nuevo en un ráster de la clase de entidad de polígono resultante generará un ráster idéntico al original.
Boolean
raster_field
(Opcional)

El campo que se utiliza para asignar los valores desde las celdas del ráster de entrada a los polígonos del dataset de salida.

Puede ser un campo entero o de cadena de caracteres.

Field
create_multipart_features
(Opcional)

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

  • MULTIPLE_OUTER_PARTEspecifica que se crearán entidades multiparte a partir de los polígonos que tengan el mismo valor.
  • SINGLE_OUTER_PARTEspecifica que se crearán entidades individuales para cada polígono. Esta es la opción predeterminada.
Boolean
max_vertices_per_feature
(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.

Si se deja vacío, los polígonos de salida no se dividen. El valor predeterminado es que esté vacío.

Long

Muestra de código

Ejemplo de RasterToPolygon (ventana Python)

Convierte un dataset ráster en entidades de polígono.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.RasterToPolygon("zone", "c:/output/zones.shp", "NO_SIMPLIFY",
                                 "VALUE")
Ejemplo de RasterToPolygon (script independiente)

Convierte un dataset ráster en entidades de polígono.

# Name: RasterToPolygon_Ex_02.py
# Description: Converts a raster dataset to polygon features.
# Requirements: None

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inRaster = "zone"
outPolygons = "c:/output/zones.shp"
field = "VALUE"

# Run RasterToPolygon
arcpy.conversion.RasterToPolygon(inRaster, outPolygons, "NO_SIMPLIFY", field)