Extraer líneas escaneadas (Herramientas de conversión)

Resumen

Genera entidades de polilínea a partir de imágenes escaneadas.

Ilustración

Ilustración de la herramienta Extraer líneas escaneadas

Uso

El ráster se debe clasificar en dos clases (imagen binaria) para extraer entidades.
Los resultados pueden depender del estado del mapa escaneado en el momento de la extracción. Para eliminar el ruido y los píxeles no deseados, a veces es necesario modificar la imagen antes de la extracción de entidades.
Los parámetros determinan qué celdas se extraen, así como el grado de generalización y suavizado que se aplica a las entidades de polilínea de salida.
La generación de entidades de polígono de salida es opcional.

Etiqueta	Explicación	Tipo de datos
Entrada de imagen escaneada de mapa	El dataset ráster de entrada. El ráster se debe clasificar en dos clases (imagen binaria).	Raster Layer
Valor de primer plano	El valor de primer plano que representa las celdas ráster que se extraerán a entidades de línea.	Long
Entidades de línea central de salida	Las polilíneas convertidas de salida	Feature Class
Solución de intersección	Especifica cómo se crearán las entidades de polilínea en intersecciones ráster. Las intersecciones ráster son ubicaciones en las que confluyen tres o más líneas ráster. Geométrica—Los ángulos y las líneas rectas se conservarán en las intersecciones. Use esta opción cuando la precisión de los ángulos y de las líneas rectas sea crucial, por ejemplo, para planos o dibujos. Esta es la opción predeterminada. Mediana—Los ángulos no rectilíneos (irregulares) se administrarán promediando indicaciones. Use esta opción para entidades naturales u orgánicas en las que las líneas confluyen en ángulos irregulares, por ejemplo, para representación cartográfica medioambiental. Ninguno—Las intersecciones no se manejarán de forma especial; las entidades se extraerán tal cual. Use esta opción cuando las intersecciones no estén presentes o no sean importantes, por ejemplo, para curvas de nivel de elevación.	String
Ancho máximo de línea (Opcional)	Un filtro que le permite omitir líneas más largas y gruesas y enfocarse en extraer solo líneas más finas en el ráster. El parámetro también influye en la construcción de las entidades de salida, dándole más importancia al uso de los valores más precisos para sus datos. Las líneas ráster con un ancho igual o inferior al ancho máximo de línea reúne los requisitos para la extracción de línea central, mientras que los elementos más anchos se extraerán como entidades de polígono (si el parámetro Entidades de polígono de salida está especificado).	Double
Nivel de ruido (Opcional)	El nivel de ruido que se omitirá de la extracción para ayudar a mejorar los resultados.	Double
Tolerancia de compresión (Opcional)	Simplifica líneas eliminando vértices basados en la tolerancia especificada. Una mayor tolerancia de compresión resultará en menos vértices y una mayor desviación de la forma original de línea. La tolerancia de compresión indica el grado de generalización, no unidades de mapa o de píxeles.	Double
Aplicar suavizado (Opcional)	Especifica si el suavizado se aplicará a las entidades de polilínea durante la extracción. Activado—El suavizado se aplicará a las entidades de polilíneas extraídas. Desactivado—El suavizado no se aplicará a las entidades de polilíneas extraídas.	Boolean
Peso de suavizado (Opcional)	La intensidad de suavizado. Valores superiores de peso de suavizado producen líneas más suaves, pero pueden provocar que la salida se desvíe de la forma original. El valor de peso de suavizado no es una unidad específica de mapa o de píxel.	Double
Resolver esquinas (Opcional)	Especifica si las esquinas se refinarán o suavizarán un ubicaciones de intersección de las líneas ráster. Al extraer entidades naturales (tales como curvas de nivel, límites de suelo o cursos de agua), la resolución de las esquinas puede no ser tan importante como en otros tipos de imágenes de mapa que representan el entorno construido. Activado—Las esquinas se refinarán en ubicaciones en las que intersequen líneas ráster. Desactivado—Las esquinas se suavizarán en ubicaciones en las que intersequen líneas ráster.	Boolean
Ángulo máximo de esquina (Opcional)	El ángulo máximo de intersección de líneas ráster que se considerarán una esquina.	Double
Tamaño del agujero (Opcional)	Si la longitud diagonal de un agujero es menor o igual que la distancia especificada, se tratará como parte de la línea ráster cuando se extrae. Este parámetro le permite ignorar agujeros (pequeños huecos completamente encerrados por píxeles de primer plano) en líneas ráster durante la extracción. Los agujeros a menudo resultan de una calidad de origen deficiente o errores de escaneo.	Long
Cerrar huecos (Opcional)	Especifica si la herramienta gestiona las interrupciones en una línea ráster y cierra huecos que son menores o iguales que la tolerancia especificada resultando en una polilínea continua. Los huecos no se cerrarán en ubicaciones en las que intersequen líneas ráster. Activado—Los huecos se cerrarán en las entidades de polígono extraídas. Desactivado—Los huecos no se cerrarán en las entidades de polígono extraídas.	Boolean
Tolerancia a la separación (Opcional)	La distancia, medida en píxeles, que se usará para determinar si los huecos entre líneas ráster se deben cerrar durante la extracción.	Double
Ángulo de búsqueda de huecos (Opcional)	El ángulo que se usará para buscar huecos en líneas ráster para mejorar los resultados de extracción. Este parámetro es útil al extraer líneas ráster curvas que contienen interrupciones, garantizando una polilínea de salida más precisa y continua.	Double
Entidades de polígono de salida (Opcional)	La clase de entidad de salidad que contendrá los polígonos convertidos que representan la lista de celdas ráster.	Feature Class

arcpy.conversion.ExtractScannedLines(in_raster, foreground_value, out_centerlines, intersection_solution, {line_width}, {noise_level}, {compression}, {smoothing}, {smoothing_weight}, {corners}, {max_corner_angle}, {hole_size}, {close_gaps}, {gap_tolerance}, {gap_search_angle}, {out_polygons})

Nombre	Explicación	Tipo de datos
in_raster	El dataset ráster de entrada. El ráster se debe clasificar en dos clases (imagen binaria).	Raster Layer
foreground_value	El valor de primer plano que representa las celdas ráster que se extraerán a entidades de línea.	Long
out_centerlines	Las polilíneas convertidas de salida	Feature Class
intersection_solution	Especifica cómo se crearán las entidades de polilínea en intersecciones ráster. Las intersecciones ráster son ubicaciones en las que confluyen tres o más líneas ráster. `GEOMETRICAL`—Los ángulos y las líneas rectas se conservarán en las intersecciones. Use esta opción cuando la precisión de los ángulos y de las líneas rectas sea crucial, por ejemplo, para planos o dibujos. Esta es la opción predeterminada. `MEDIAN`—Los ángulos no rectilíneos (irregulares) se administrarán promediando indicaciones. Use esta opción para entidades naturales u orgánicas en las que las líneas confluyen en ángulos irregulares, por ejemplo, para representación cartográfica medioambiental. `NONE`—Las intersecciones no se manejarán de forma especial; las entidades se extraerán tal cual. Use esta opción cuando las intersecciones no estén presentes o no sean importantes, por ejemplo, para curvas de nivel de elevación.	String
line_width (Opcional)	Un filtro que le permite omitir líneas más largas y gruesas y enfocarse en extraer solo líneas más finas en el ráster. El parámetro también influye en la construcción de las entidades de salida, dándole más importancia al uso de los valores más precisos para sus datos. Las líneas ráster con un ancho igual o inferior al ancho máximo de línea reúne los requisitos para la extracción de línea central, mientras que los elementos más anchos se extraerán como entidades de polígono (si el parámetro `out_polygons` está especificado).	Double
noise_level (Opcional)	El nivel de ruido que se omitirá de la extracción para ayudar a mejorar los resultados.	Double
compression (Opcional)	Simplifica líneas eliminando vértices basados en la tolerancia especificada. Una mayor tolerancia de compresión resultará en menos vértices y una mayor desviación de la forma original de línea. La tolerancia de compresión indica el grado de generalización, no unidades de mapa o de píxeles.	Double
smoothing (Opcional)	Especifica si el suavizado se aplicará a las entidades de polilínea durante la extracción. `SMOOTHING`—El suavizado se aplicará a las entidades de polilíneas extraídas. `NO_SMOOTHING`—El suavizado no se aplicará a las entidades de polilíneas extraídas.	Boolean
smoothing_weight (Opcional)	La intensidad de suavizado. Valores superiores de peso de suavizado producen líneas más suaves, pero pueden provocar que la salida se desvíe de la forma original. El valor de peso de suavizado no es una unidad específica de mapa o de píxel.	Double
corners (Opcional)	Especifica si las esquinas se refinarán o suavizarán un ubicaciones de intersección de las líneas ráster. Al extraer entidades naturales (tales como curvas de nivel, límites de suelo o cursos de agua), la resolución de las esquinas puede no ser tan importante como en otros tipos de imágenes de mapa que representan el entorno construido. `CORNERS`—Las esquinas se refinarán en ubicaciones en las que intersequen líneas ráster. `NO_CORNERS`—Las esquinas se suavizarán en ubicaciones en las que intersequen líneas ráster.	Boolean
max_corner_angle (Opcional)	El ángulo máximo de intersección de líneas ráster que se considerarán una esquina.	Double
hole_size (Opcional)	Si la longitud diagonal de un agujero es menor o igual que la distancia especificada, se tratará como parte de la línea ráster cuando se extrae. Este parámetro le permite ignorar agujeros (pequeños huecos completamente encerrados por píxeles de primer plano) en líneas ráster durante la extracción. Los agujeros a menudo resultan de una calidad de origen deficiente o errores de escaneo.	Long
close_gaps (Opcional)	Especifica si la herramienta gestiona las interrupciones en una línea ráster y cierra huecos que son menores o iguales que la tolerancia especificada resultando en una polilínea continua. Los huecos no se cerrarán en ubicaciones en las que intersequen líneas ráster. `CLOSE_GAPS`—Los huecos se cerrarán en las entidades de polígono extraídas. `NO_CLOSE_GAPS`—Los huecos no se cerrarán en las entidades de polígono extraídas.	Boolean
gap_tolerance (Opcional)	La distancia, medida en píxeles, que se usará para determinar si los huecos entre líneas ráster se deben cerrar durante la extracción.	Double
gap_search_angle (Opcional)	El ángulo que se usará para buscar huecos en líneas ráster para mejorar los resultados de extracción. Este parámetro es útil al extraer líneas ráster curvas que contienen interrupciones, garantizando una polilínea de salida más precisa y continua.	Double
out_polygons (Opcional)	La clase de entidad de salidad que contendrá los polígonos convertidos que representan la lista de celdas ráster.	Feature Class

Muestra de código

Ejemplo 1 de ExtractScannedLines (ventana de Python)

El siguiente ejemplo muestra cómo usar esta herramienta en la ventana de Python:

import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.conversion.ExtractScannedLines(
    in_raster="Scanned_Map_Image", foreground_value=[1],
    out_centerlines=r"C:\data\Extracted_Lines",
    intersection_solution="GEOMETRICAL", line_width=20, noise_level=65,
    compression=0.025, smoothing=True, smoothing_weight=3, corners=True,
    max_corner_angle=135, hole_size=0, close_gaps=True, gap_tolerance=5,
    gap_search_angle=100, out_polygons=r"memory\Extracted_out_polygons"
)

Ejemplo 2 de ExtractScannedLines (script independiente)

Extrae líneas de una imagen de mapa escaneada

# Name: ExtractScannedLines_2.py
# Description: Extracts lines from a scanned map image
# Requirements: None

# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'c:/data'

# Set Local Variables
inRaster = "c:/data/ScannedImage"
foregroundValue = [1]
outCenterlines = 'c:/data/output.gdb/ExtractedLines'
intersectionSolution = "GEOMETRICAL"
lineWidth = 20
noiseLevel = 65
compression = 0.025
smoothing = True
smoothingWeight = 3
corners = True
maxCornerAngle = 135
holeSize = 0
closeGaps = True
gapTolerance = 5
gapSearchAngle = 100
outPolygons = 'c:/data/output.gdb/Extracted_out_Polygons'

# Run ExtractScannedLines
arcpy.conversion.ExtractScannedLines(
    inRaster, foregroundValue, outCenterlines, intersectionSolution, lineWidth,
    noiseLevel, compression, smoothing, smoothingWeight, corners,
    maxCornerAngle, holeSize, closeGaps, gapTolerance, gapSearchAngle,
    outPolygons
)

Entornos

Espacio de trabajo actual, Extensión, Sistema de coordenadas de salida, Transformaciones geográficas, Palabra clave CONFIG de salida, Dominio XY de salida, Dominio Z de salida

Información de licenciamiento

Basic: No
Standard: No
Avanzado: Sí