Gescannte Linien extrahieren (Conversion Tools)

Zusammenfassung

Generiert Polylinien-Features aus gescannten Bildern.

Abbildung

Abbildung: Werkzeug "Gescannte Linien extrahieren"

Verwendung

Das Raster muss in zwei Klassen unterteilt sein (Binärbild), um Features extrahieren zu können.
Die Ergebnisse können vom Zustand der gescannten Karte zum Zeitpunkt der Extraktion abhängen. Um Rauschen und unerwünschte Pixel zu beseitigen, ist es manchmal erforderlich, das Bild vor der Extraktion von Features zu bearbeiten.
Die Parameter legen fest, welche Zellen extrahiert werden, sowie den Grad der Generalisierung und Glättung, der auf die Ausgabe-Polylinien-Features angewendet wird.
Das Generieren von Ausgabe-Polylinien-Features ist optional.

Beschriftung	Erläuterung	Datentyp
Eingabe-Scan-Kartenbild	Das Eingabe-Raster-Dataset. Das Raster muss in zwei Klassen unterteilt sein (Binärbild).	Raster Layer
Vordergrundwert	Der Vordergrundwert, der die Raster-Zellen darstellt, die in Linien-Features extrahiert werden.	Long
Ausgabe-Mittelachsen-Features	Die konvertierten Ausgabe-Polylinien.	Feature Class
Schnittpunktlösung	Gibt an, wie Polylinien-Features an Raster-Schnittpunkten erstellt werden. Raster-Schnittpunkte sind Positionen, an denen sich drei oder mehr Raster-Linien treffen. Geometrisch—Winkel und gerade Linien werden an Schnittpunkten beibehalten. Verwenden Sie diese Option, wenn die Genauigkeit von Winkeln und geraden Linien von entscheidender Bedeutung ist, z. B. bei Lageplänen und Zeichnungen. Dies ist die Standardeinstellung. Medianwert—Nicht geradlinige (unregelmäßige) Winkel werden anhand der Mittelwertberechnung von Richtungen verarbeitet. Verwenden Sie diese Option für natürliche oder organische Features, bei denen sich Linien in unregelmäßigen Winkeln treffen, beispielsweise bei der Erstellung von Umgebungskarten. Keine—Mit Schnittpunkten wird nicht gesondert umgegangen; Features werden unverändert extrahiert. Verwenden Sie diese Option, wenn Schnittpunkte nicht vorhanden oder nicht von Bedeutung sind, beispielsweise bei Höhenkonturlinien.	String
Maximale Linienbreite (Optional)	Mit diesem Filter können Sie größere, breitere Linien auslassen und sich auf die Extraktion der dünneren Linien im Raster konzentrieren. Dieser Parameter hat außerdem einen Einfluss auf die Konstruktion der Ausgabe-Features, weshalb es wichtig ist, den genauesten Wert für Ihre Daten zu verwenden. Raster-Linien, deren Breite der maximalen Linienbreite entspricht oder darunter liegt, sind für die Extraktion der Mittelachse geeignet, während breitere Elemente als Polygon-Features extrahiert werden (sofern der Parameter Ausgabe-Polygon-Features angegeben ist).	Double
Rauschpegel (Optional)	Der Rauschpegel, der bei der Extraktion ausgelassen wird, um die Ergebnisse zu verbessern.	Double
Komprimierungstoleranz (Optional)	Vereinfacht Linien, indem Stützpunkte basierend auf der angegebenen Toleranz entfernt werden. Höhere Werte für die Komprimierungstoleranz führen zu weniger Stützpunkten und einer größeren Abweichung vom ursprünglichen Linien-Shape. Die Komprimierungstoleranz gibt den Grad der Generalisierung an, nicht die Karten- oder Pixeleinheiten.	Double
Glättung anwenden (Optional)	Gibt an, ob auf die Polylinien-Features bei der Extraktion eine Glättung angewendet wird. Aktiviert—Glättung wird auf die extrahierten Polylinien-Features angewendet. Deaktiviert—Glättung wird nicht auf die extrahierten Polylinien-Features angewendet.	Boolean
Glättungsgewichtung (Optional)	Die Intensität der Glättung. Mit höheren Werten für die Glättungsgewichtung werden glattere Linien erzielt, allerdings kann die Ausgabe vom ursprünglichen Shape abweichen. Der Wert für die Glättungsgewichtung ist keine bestimmte Karten- oder Pixeleinheit.	Double
Ecken auflösen (Optional)	Gibt an, ob Ecken an Positionen, an denen Raster-Linien sich überschneiden, geschärft oder geglättet werden. Beim Extrahieren natürlicher Features (z. B. Konturlinien, Bodengrenzen oder Wasserläufe) ist die Auflösung von Ecken möglicherweise nicht so wichtig wie bei anderen Arten von Kartenbildern, die die gebaute Umgebung darstellen. Aktiviert—Ecken werden an Positionen geschärft, an denen sich Raster-Linien überschneiden. Deaktiviert—Ecken werden an Positionen geglättet, an denen sich Raster-Linien überschneiden.	Boolean
Maximaler Winkel für Ecke (Optional)	Der maximale Winkel der überschneidenden Raster-Linien, der als Ecke gilt.	Double
Lochgröße (Optional)	Wenn die Diagonallänge eines Loches kleiner als oder gleich der angegebenen Entfernung ist, gilt dieses bei der Extraktion als Teil der Raster-Linie. Mit diesem Parameter können Sie Löcher (kleine Lücken, die vollständig von Vordergrundpixeln umschlossen sind) in Raster-Linien bei der Extraktion ignorieren. Löcher sind oftmals auf eine schlechte Qualität der Quelle oder auf Scanfehler zurückzuführen.	Long
Lücken schließen (Optional)	Gibt an, ob das Werkzeug Unterbrechungen in einer Raster-Linie verarbeitet und Lücken schließt, die kleiner als oder gleich der angegebenen Toleranz sind, wodurch eine kontinuierliche Polylinie entsteht. Lücken werden nicht an Positionen geschlossen, an denen sich Raster-Linien überschneiden. Aktiviert—Lücken werden für die extrahierten Polylinien-Features geschlossen. Deaktiviert—Lücken werden für die extrahierten Polylinien-Features nicht geschlossen.	Boolean
Lückentoleranz (Optional)	Die Entfernung, gemessen in Pixel, die verwendet wird, um zu bestimmen, ob Lücken zwischen Raster-Linien bei der Extraktion geschlossen werden.	Double
Winkel für die Suche nach Lücken (Optional)	Der Winkel, der für die Suche nach Lücken in Raster-Linien verwendet wird, um die Extraktionsergebnisse zu optimieren. Dieser Parameter ist hilfreich, wenn geschwungene Raster-Linien mit Unterbrechungen extrahiert werden sollen, da er eine genauere und kontinuierliche Ausgabe-Polylinie gewährleistet.	Double
Ausgabe-Polygon-Features (Optional)	Die Ausgabe-Feature-Class, die die konvertierten Polygone enthält, die die Umrisslinien der Raster-Zellen darstellen.	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})

Name	Erläuterung	Datentyp
in_raster	Das Eingabe-Raster-Dataset. Das Raster muss in zwei Klassen unterteilt sein (Binärbild).	Raster Layer
foreground_value	Der Vordergrundwert, der die Raster-Zellen darstellt, die in Linien-Features extrahiert werden.	Long
out_centerlines	Die konvertierten Ausgabe-Polylinien.	Feature Class
intersection_solution	Gibt an, wie Polylinien-Features an Raster-Schnittpunkten erstellt werden. Raster-Schnittpunkte sind Positionen, an denen sich drei oder mehr Raster-Linien treffen. `GEOMETRICAL`—Winkel und gerade Linien werden an Schnittpunkten beibehalten. Verwenden Sie diese Option, wenn die Genauigkeit von Winkeln und geraden Linien von entscheidender Bedeutung ist, z. B. bei Lageplänen und Zeichnungen. Dies ist die Standardeinstellung. `MEDIAN`—Nicht geradlinige (unregelmäßige) Winkel werden anhand der Mittelwertberechnung von Richtungen verarbeitet. Verwenden Sie diese Option für natürliche oder organische Features, bei denen sich Linien in unregelmäßigen Winkeln treffen, beispielsweise bei der Erstellung von Umgebungskarten. `NONE`—Mit Schnittpunkten wird nicht gesondert umgegangen; Features werden unverändert extrahiert. Verwenden Sie diese Option, wenn Schnittpunkte nicht vorhanden oder nicht von Bedeutung sind, beispielsweise bei Höhenkonturlinien.	String
line_width (Optional)	Mit diesem Filter können Sie größere, breitere Linien auslassen und sich auf die Extraktion der dünneren Linien im Raster konzentrieren. Dieser Parameter hat außerdem einen Einfluss auf die Konstruktion der Ausgabe-Features, weshalb es wichtig ist, den genauesten Wert für Ihre Daten zu verwenden. Raster-Linien, deren Breite der maximalen Linienbreite entspricht oder darunter liegt, sind für die Extraktion der Mittelachse geeignet, während breitere Elemente als Polygon-Features extrahiert werden (sofern der Parameter `out_polygons` angegeben ist).	Double
noise_level (Optional)	Der Rauschpegel, der bei der Extraktion ausgelassen wird, um die Ergebnisse zu verbessern.	Double
compression (Optional)	Vereinfacht Linien, indem Stützpunkte basierend auf der angegebenen Toleranz entfernt werden. Höhere Werte für die Komprimierungstoleranz führen zu weniger Stützpunkten und einer größeren Abweichung vom ursprünglichen Linien-Shape. Die Komprimierungstoleranz gibt den Grad der Generalisierung an, nicht die Karten- oder Pixeleinheiten.	Double
smoothing (Optional)	Gibt an, ob auf die Polylinien-Features bei der Extraktion eine Glättung angewendet wird. `SMOOTHING`—Glättung wird auf die extrahierten Polylinien-Features angewendet. `NO_SMOOTHING`—Glättung wird nicht auf die extrahierten Polylinien-Features angewendet.	Boolean
smoothing_weight (Optional)	Die Intensität der Glättung. Mit höheren Werten für die Glättungsgewichtung werden glattere Linien erzielt, allerdings kann die Ausgabe vom ursprünglichen Shape abweichen. Der Wert für die Glättungsgewichtung ist keine bestimmte Karten- oder Pixeleinheit.	Double
corners (Optional)	Gibt an, ob Ecken an Positionen, an denen Raster-Linien sich überschneiden, geschärft oder geglättet werden. Beim Extrahieren natürlicher Features (z. B. Konturlinien, Bodengrenzen oder Wasserläufe) ist die Auflösung von Ecken möglicherweise nicht so wichtig wie bei anderen Arten von Kartenbildern, die die gebaute Umgebung darstellen. `CORNERS`—Ecken werden an Positionen geschärft, an denen sich Raster-Linien überschneiden. `NO_CORNERS`—Ecken werden an Positionen geglättet, an denen sich Raster-Linien überschneiden.	Boolean
max_corner_angle (Optional)	Der maximale Winkel der überschneidenden Raster-Linien, der als Ecke gilt.	Double
hole_size (Optional)	Wenn die Diagonallänge eines Loches kleiner als oder gleich der angegebenen Entfernung ist, gilt dieses bei der Extraktion als Teil der Raster-Linie. Mit diesem Parameter können Sie Löcher (kleine Lücken, die vollständig von Vordergrundpixeln umschlossen sind) in Raster-Linien bei der Extraktion ignorieren. Löcher sind oftmals auf eine schlechte Qualität der Quelle oder auf Scanfehler zurückzuführen.	Long
close_gaps (Optional)	Gibt an, ob das Werkzeug Unterbrechungen in einer Raster-Linie verarbeitet und Lücken schließt, die kleiner als oder gleich der angegebenen Toleranz sind, wodurch eine kontinuierliche Polylinie entsteht. Lücken werden nicht an Positionen geschlossen, an denen sich Raster-Linien überschneiden. `CLOSE_GAPS`—Lücken werden für die extrahierten Polylinien-Features geschlossen. `NO_CLOSE_GAPS`—Lücken werden für die extrahierten Polylinien-Features nicht geschlossen.	Boolean
gap_tolerance (Optional)	Die Entfernung, gemessen in Pixel, die verwendet wird, um zu bestimmen, ob Lücken zwischen Raster-Linien bei der Extraktion geschlossen werden.	Double
gap_search_angle (Optional)	Der Winkel, der für die Suche nach Lücken in Raster-Linien verwendet wird, um die Extraktionsergebnisse zu optimieren. Dieser Parameter ist hilfreich, wenn geschwungene Raster-Linien mit Unterbrechungen extrahiert werden sollen, da er eine genauere und kontinuierliche Ausgabe-Polylinie gewährleistet.	Double
out_polygons (Optional)	Die Ausgabe-Feature-Class, die die konvertierten Polygone enthält, die die Umrisslinien der Raster-Zellen darstellen.	Feature Class

Codebeispiel

ExtractScannedLines: Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

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

ExtractScannedLines: Beispiel 2 (eigenständiges Skript)

Extrahiert Linien aus einem gescannten Kartenbild

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

Umgebungen

Aktueller Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne

Lizenzierungsinformationen

Basic: Nein
Standard: Nein
Advanced: Ja