Extraire les polygones scannés (Outils de conversion)

Résumé

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

Illustration

Illustration de l’outil Extract Scanned Polygons (Extraire les polygones numérisés)

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 surfaciques en sortie.

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 Polygon Features (Entités surfaciques en sortie)	Classe d’entités en sortie destinée à contenir les polygones convertis qui représentent le contour des cellules raster.	Feature Class
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 surfaciques lors de l’extraction. Activé—Un lissage est appliqué aux entités surfaciques extraites. Décoché—Aucun lissage n’est appliqué aux entités surfaciques 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
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

arcpy.conversion.ExtractScannedPolygons(in_raster, foreground_value, out_polygons, {compression}, {smoothing}, {smoothing_weight}, {hole_size})

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_polygons	Classe d’entités en sortie destinée à contenir les polygones convertis qui représentent le contour des cellules raster.	Feature Class
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 surfaciques lors de l’extraction. `SMOOTHING`—Un lissage est appliqué aux entités surfaciques extraites. `NO_SMOOTHING`—Aucun lissage n’est appliqué aux entités surfaciques 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
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

Exemple de code

Exemple 1 d’utilisation de l’outil ExtractScannedPolygons (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.ExtractScannedPolygons(
    in_raster="Scanned_Map_Image", foreground_value=[1],
    out_polygons=r"C:\data\output.gdb\Extracted_Polygons", compression=0.025,
    smoothing=True, smoothing_weight=3, hole_size=0
)

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

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

# Name: ExtractScannedPolygonsEx_02.py
# Description: Extracts polygons 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]
outPolygons = 'c:/data/output.gdb/Extracted_Polygons'
compression = 0.025
smoothing = True
smoothingWeight = 3
holeSize = 0

# Run ExtractScannedPolygons
arcpy.conversion.ExtractScannedPolygons(
    inRaster, foregroundValue, outPolygons, compression, smoothing,
    smoothingWeight, holeSize
)

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