Extraire les lignes scannées (Outils de conversion)

Résumé

Génère des entités polylignes à partir d’images numérisées.

Illustration

Illustration de l’outil Extract Scanned Lines (Extraire les lignes numérisées)

Utilisation

Le raster doit être classé dans deux classes (image binaire) pour extraire des entités.
Les résultats peuvent être déterminés par l’état de la carte numérisée au moment de l’extraction. Pour éliminer le bruit et les pixels indésirables, il est parfois nécessaire de modifier l’image avant l’extraction des entités.
Les paramètres contrôlent les cellules à extraire, ainsi que la quantité de généralisation et de lissage appliquée aux entités polylignes en sortie.
La génération des entités surfaciques en sortie est facultative.

Etiqueter	Explication	Type de données
Input Scanned Map Image (Image de carte numérisée en entrée)	Jeu de données raster en entrée. Le raster doit être classé dans deux classes (image binaire).	Raster Layer
Foreground Value (Valeur de premier plan)	Valeur de premier plan qui représente les cellules raster à extraire sous forme d’entités linéaires.	Long
Output Centerline Features (Entités d’axe médian en sortie)	Polylignes converties en sortie.	Feature Class
Intersection Solution (Solution d’intersection)	Indique le mode de création des entités polylignes aux intersections raster. Les intersections de raster sont les endroits où trois lignes raster ou plus se croisent. Geometrical (Géométrique)—Les angles et les lignes droites sont conservés aux intersections. Utilisez cette option si l’exactitude des angles et des lignes droites est essentielle (par exemple, pour les plans de site ou les dessins). Il s’agit de l’option par défaut. Médiane—Les angles non rectilignes (irréguliers) sont traités en calculant la moyenne des directions. Utilisez cette option pour les entités naturelles ou organiques où les lignes se croisent selon des angles irréguliers (par exemple, pour la cartographie environnementale). Aucun—Aucun traitement spécial n’est appliqué aux intersections ; les entités sont extraites telles quelles. Utilisez cette option si les intersections sont absentes ou sans importance (par exemple, pour les isolignes d’élévation).	String
Maximum Line Width (Largeur de ligne maximale) (Facultatif)	Filtre permettant d’omettre les lignes épaisses du raster pour n’extraire que les lignes les plus fines. Ce paramètre ayant également un impact sur la construction des entités en sortie, il est essentiel d’utiliser la valeur la plus précise possible pour vos données. Les axes médians des lignes raster dont la largeur est inférieure ou égale à la largeur de ligne maximale peuvent être extraits. Les éléments plus larges sont quant à eux extraits sous forme d’entités surfaciques (si le paramètre Output Polygon Features (Entités surfaciques en sortie) est spécifié).	Double
Noise Level (Niveau de bruit) (Facultatif)	Niveau de bruit supprimé de l’extraction afin d’en améliorer les résultats.	Double
Compression Tolerance (Tolérance de compression) (Facultatif)	Simplifie les lignes en supprimant les sommets selon la tolérance spécifiée. Des valeurs de tolérance de compression élevées engendrent un plus petit nombre de sommets et un écart plus important par rapport à la forme d’origine des lignes. La tolérance de compression indique le niveau de généralisation et non les unités cartographiques ou les pixels.	Double
Apply Smoothing (Appliquer un lissage) (Facultatif)	Indique si un lissage doit être appliqué aux entités polylignes lors de l’extraction. Activé—Un lissage est appliqué aux entités polylignes extraites. Décoché—Aucun lissage n’est appliqué aux entités polylignes extraites.	Boolean
Smoothing Weight (Pondération de lissage) (Facultatif)	Intensité du lissage. Des valeurs de pondération de lissage élevées produisent des lignes plus lisses, mais peuvent engendrer un écart de la sortie par rapport à la forme d’origine. La valeur de pondération de lissage n’est pas une unité cartographique ou de pixel spécifique.	Double
Resolve Corners (Résoudre les angles) (Facultatif)	Indique si les angles sont affinés ou lissés aux intersections des lignes raster. Lors de l’extraction d’entités naturelles (par exemple, isolignes, limites des sols ou cours d’eau), la correction des angles est susceptible d’être moindre que pour d’autres types d’image de carte qui représentent l’environnement bâti. Activé—Les angles sont affinés aux intersections des lignes raster. Décoché—Les angles sont lissés aux intersections des lignes raster.	Boolean
Maximum Corner Angle (Angle de coin maximal) (Facultatif)	Angle maximal à considérer comme un coin pour les lignes raster qui s’intersectent.	Double
Hole Size (Taille de discontinuité) (Facultatif)	Si la diagonale d’un trou est inférieure ou égale à la distance spécifiée, il est considéré comme faisant partie de la ligne raster lors de l’extraction. Ce paramètre vous permet d’ignorer les trous (petits écarts entourés de pixels de premier plan) dans les lignes raster lors de l’extraction. Les trous sont généralement dus à une source de qualité médiocre ou à des erreurs de numérisation.	Long
Close Gaps (Fermer les interruptions) (Facultatif)	Indique si l’outil gère les interruptions dans une ligne raster et comble les écarts inférieurs ou égaux à la tolérance spécifiée pour produire une polyligne continue. Les écarts ne sont pas comblés aux intersections des lignes raster. Activé—Les écarts sont comblés pour les entités polylignes extraites. Décoché—Les écarts ne sont pas comblés pour les entités polylignes extraites.	Boolean
Tolérance d’écart (Facultatif)	Distance en pixels utilisée pour déterminer si les écarts entre les lignes raster doivent être comblés lors de l’extraction.	Double
Gap Search Angle (Angle de recherche d’écarts) (Facultatif)	Angle à utiliser pour rechercher les écarts dans les lignes raster afin d’améliorer les résultats de l’extraction. Ce paramètre est utile lors de l’extraction de lignes raster courbes contenant des interruptions car il permet d’obtenir une polyligne en sortie plus précise et continue.	Double
Output Polygon Features (Entités surfaciques en sortie) (Facultatif)	Classe d’entités en sortie destinée à contenir les polygones convertis qui représentent le contour des cellules raster.	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})

Nom	Explication	Type de données
in_raster	Jeu de données raster en entrée. Le raster doit être classé dans deux classes (image binaire).	Raster Layer
foreground_value	Valeur de premier plan qui représente les cellules raster à extraire sous forme d’entités linéaires.	Long
out_centerlines	Polylignes converties en sortie.	Feature Class
intersection_solution	Indique le mode de création des entités polylignes aux intersections raster. Les intersections de raster sont les endroits où trois lignes raster ou plus se croisent. `GEOMETRICAL`—Les angles et les lignes droites sont conservés aux intersections. Utilisez cette option si l’exactitude des angles et des lignes droites est essentielle (par exemple, pour les plans de site ou les dessins). Il s’agit de l’option par défaut. `MEDIAN`—Les angles non rectilignes (irréguliers) sont traités en calculant la moyenne des directions. Utilisez cette option pour les entités naturelles ou organiques où les lignes se croisent selon des angles irréguliers (par exemple, pour la cartographie environnementale). `NONE`—Aucun traitement spécial n’est appliqué aux intersections ; les entités sont extraites telles quelles. Utilisez cette option si les intersections sont absentes ou sans importance (par exemple, pour les isolignes d’élévation).	String
line_width (Facultatif)	Filtre permettant d’omettre les lignes épaisses du raster pour n’extraire que les lignes les plus fines. Ce paramètre ayant également un impact sur la construction des entités en sortie, il est essentiel d’utiliser la valeur la plus précise possible pour vos données. Les axes médians des lignes raster dont la largeur est inférieure ou égale à la largeur de ligne maximale peuvent être extraits. Les éléments plus larges sont quant à eux extraits sous forme d’entités surfaciques (si le paramètre `out_polygons` est spécifié).	Double
noise_level (Facultatif)	Niveau de bruit supprimé de l’extraction afin d’en améliorer les résultats.	Double
compression (Facultatif)	Simplifie les lignes en supprimant les sommets selon la tolérance spécifiée. Des valeurs de tolérance de compression élevées engendrent un plus petit nombre de sommets et un écart plus important par rapport à la forme d’origine des lignes. La tolérance de compression indique le niveau de généralisation et non les unités cartographiques ou les pixels.	Double
smoothing (Facultatif)	Indique si un lissage doit être appliqué aux entités polylignes lors de l’extraction. `SMOOTHING`—Un lissage est appliqué aux entités polylignes extraites. `NO_SMOOTHING`—Aucun lissage n’est appliqué aux entités polylignes extraites.	Boolean
smoothing_weight (Facultatif)	Intensité du lissage. Des valeurs de pondération de lissage élevées produisent des lignes plus lisses, mais peuvent engendrer un écart de la sortie par rapport à la forme d’origine. La valeur de pondération de lissage n’est pas une unité cartographique ou de pixel spécifique.	Double
corners (Facultatif)	Indique si les angles sont affinés ou lissés aux intersections des lignes raster. Lors de l’extraction d’entités naturelles (par exemple, isolignes, limites des sols ou cours d’eau), la correction des angles est susceptible d’être moindre que pour d’autres types d’image de carte qui représentent l’environnement bâti. `CORNERS`—Les angles sont affinés aux intersections des lignes raster. `NO_CORNERS`—Les angles sont lissés aux intersections des lignes raster.	Boolean
max_corner_angle (Facultatif)	Angle maximal à considérer comme un coin pour les lignes raster qui s’intersectent.	Double
hole_size (Facultatif)	Si la diagonale d’un trou est inférieure ou égale à la distance spécifiée, il est considéré comme faisant partie de la ligne raster lors de l’extraction. Ce paramètre vous permet d’ignorer les trous (petits écarts entourés de pixels de premier plan) dans les lignes raster lors de l’extraction. Les trous sont généralement dus à une source de qualité médiocre ou à des erreurs de numérisation.	Long
close_gaps (Facultatif)	Indique si l’outil gère les interruptions dans une ligne raster et comble les écarts inférieurs ou égaux à la tolérance spécifiée pour produire une polyligne continue. Les écarts ne sont pas comblés aux intersections des lignes raster. `CLOSE_GAPS`—Les écarts sont comblés pour les entités polylignes extraites. `NO_CLOSE_GAPS`—Les écarts ne sont pas comblés pour les entités polylignes extraites.	Boolean
gap_tolerance (Facultatif)	Distance en pixels utilisée pour déterminer si les écarts entre les lignes raster doivent être comblés lors de l’extraction.	Double
gap_search_angle (Facultatif)	Angle à utiliser pour rechercher les écarts dans les lignes raster afin d’améliorer les résultats de l’extraction. Ce paramètre est utile lors de l’extraction de lignes raster courbes contenant des interruptions car il permet d’obtenir une polyligne en sortie plus précise et continue.	Double
out_polygons (Facultatif)	Classe d’entités en sortie destinée à contenir les polygones convertis qui représentent le contour des cellules raster.	Feature Class

Exemple de code

Exemple 1 d’utilisation de l’outil ExtractScannedLines (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre 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"
)

Exemple 2 d’utilisation de l’outil ExtractScannedLines (script autonome)

Extrait des lignes d’une image cartographique numérisée.

# 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
)

Environnements

Espace de travail courant, Etendue, Système de coordonnées en sortie, Transformations géographiques, Mot-clé CONFIG en sortie, Domaine XY en sortie, Domaine Z en sortie

Informations de licence

Basic: Non
Standard: Non
Advanced: Oui