De ráster a polilínea (Conversión)

Resumen

Convierte un dataset ráster en entidades de polilínea.

Uso

  • El ráster de entrada puede tener cualquier tamaño de celda válido mayor que 0 y puede ser cualquier 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 Grid_code 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 de polilínea. 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 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 polilíneas de salida

La clase de entidad de salida que contendrá las polilíneas que se convirtieron.

Feature Class
Valor de fondo
(Opcional)

Especifica el valor que identificará las celdas de fondo. El dataset ráster se visualiza como un conjunto de celdas de primer plano y de celdas de fondo. Las entidades lineales se forman desde las celdas de primer plano.

  • ZeroEl fondo se compone de celdas de cero o menos o NoData. Todas las celdas con un valor mayor que cero se consideran un valor de primer plano.
  • NoDataEl fondo se compone de celdas NoData. Todas las celdas con valores válidos pertenecen al primer plano.
String
Longitud mínima de arco colgante
(Opcional)

La longitud mínima de las polilíneas colgantes que se mantendrán. El valor predeterminado es cero.

Double
Simplificar polilíneas
(Opcional)

Simplifica una línea al eliminar pequeñas fluctuaciones o curvaturas extrañas conservando su forma esencial.

  • Activada: las polilíneas se simplificarán en formas más simples, de tal manera que cada una contenga un número mínimo de segmentos. Esta es la opción predeterminada.
  • Desactivada: las polilíneas no se simplificarán.
Boolean
Campo
(Opcional)

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

Puede ser un campo entero o de cadena de caracteres.

Field

arcpy.conversion.RasterToPolyline(in_raster, out_polyline_features, {background_value}, {minimum_dangle_length}, {simplify}, {raster_field})
NombreExplicaciónTipo de datos
in_raster

El dataset ráster de entrada.

El ráster debe ser de tipo entero.

Raster Layer
out_polyline_features

La clase de entidad de salida que contendrá las polilíneas que se convirtieron.

Feature Class
background_value
(Opcional)

Especifica el valor que identificará las celdas de fondo. El dataset ráster se visualiza como un conjunto de celdas de primer plano y de celdas de fondo. Las entidades lineales se forman desde las celdas de primer plano.

  • ZEROEl fondo se compone de celdas de cero o menos o NoData. Todas las celdas con un valor mayor que cero se consideran un valor de primer plano.
  • NODATAEl fondo se compone de celdas NoData. Todas las celdas con valores válidos pertenecen al primer plano.
String
minimum_dangle_length
(Opcional)

La longitud mínima de las polilíneas colgantes que se mantendrán. El valor predeterminado es cero.

Double
simplify
(Opcional)

Simplifica una línea al eliminar pequeñas fluctuaciones o curvaturas extrañas conservando su forma esencial.

  • SIMPLIFYLas polilíneas se simplificarán en formas más simples, de tal manera que cada una contenga un número mínimo de segmentos. Esta es la opción predeterminada.
  • NO_SIMPLIFYLas polilíneas no se simplificarán.
Boolean
raster_field
(Opcional)

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

Puede ser un campo entero o de cadena de caracteres.

Field

Muestra de código

Ejemplo de RasterToPolyline (ventana Python)

Convierte un dataset ráster en entidades de polilínea.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToPolyline("flowstr", "c:/output/streams.shp", "ZERO",
                                  50, "SIMPLIFY")
Ejemplo de RasterToPolyline (secuencia de comandos independiente)

Convierte un dataset ráster en entidades de polilínea.

# Name: RasterToPolyline_Ex_02.py
# Description: Converts a raster dataset to polyline features.
# Requirements: None

# Import system modules
import arcpy

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

# Set local variables
inRaster = "flowstr"
outLines = "c:/output/flowstream.shp"
backgrVal = "ZERO"
dangleTolerance = 50
field = "VALUE"

# Run RasterToPolygon
arcpy.conversion.RasterToPolyline(inRaster, outLines, backgrVal, 
                                  dangleTolerance, "SIMPLIFY", field)