| Etiqueta | Explicación | Tipo 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.
| 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.
| 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 |
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.
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
arcpy.conversion.RasterToPolygon(in_raster, out_polygon_features, {simplify}, {raster_field}, {create_multipart_features}, {max_vertices_per_feature})| Nombre | Explicación | Tipo 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.
| 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.
| 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
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")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)