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.
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.
Sintaxis
arcpy.conversion.RasterToPolygon(in_raster, out_polygon_features, {simplify}, {raster_field}, {create_multipart_features}, {max_vertices_per_feature})
Parámetro | 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
Ejemplo de RasterToPolygon (ventana Python)
Convierte un dataset ráster en entidades de polígono.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.RasterToPolygon_conversion("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
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "zone"
outPolygons = "c:/output/zones.shp"
field = "VALUE"
# Execute RasterToPolygon
arcpy.RasterToPolygon_conversion(inRaster, outPolygons, "NO_SIMPLIFY", field)
Entornos
- Auto ejecución
- Espacio de trabajo actual
- Valor Z de salida predeterminado
- Extensión
- Transformaciones geográficas
- Resolución M
- Tolerancia M
- Mantener el índice espacial
- Palabra clave CONFIG de salida
- Sistema de coordenadas de salida
- La salida tiene valores M
- La salida tiene valores Z
- Palabra clave CONFIG de salida
- Dominio XY de salida
- Dominio Z de salida
- Espacio de trabajo temporal
- Alinear ráster
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí