スキャンされたラインを抽出 (変換ツール)

サマリー

スキャン画像からポリラインフィーチャを生成します。

図

スキャンされたラインを抽出ツールの図

使用法

フィーチャを抽出するには、ラスターが 2 つのクラス (バイナリーイメージ) に分類されている必要があります。
結果は、抽出時にスキャンされたマップの状態によって左右されることがあります。ノイズや不要なピクセルを除去するために、フィーチャを抽出する前に画像を修正する必要がある場合があります。
パラメーターでは、抽出するセルや、出力ポリラインフィーチャに適用されるジェネラライズやスムージングの度合いを制御します。
出力ポリゴンフィーチャの生成は任意です。

パラメーター

Dialog
Python

ラベル	説明	データタイプ
入力スキャンマップ画像	入力ラスターデータセット。ラスターは 2 つのクラス (バイナリーイメージ) に分類する必要があります。	Raster Layer
前景値	ラインフィーチャに抽出されるラスターセルを表す前景値。	Long
出力中心線フィーチャ	出力された変換後のポリライン。	Feature Class
交点の処理方法	ラスターの交点でポリラインフィーチャが作成される方法を指定します。ラスターの交点は、3 つ以上のラスターラインが交差する位置です。 Geometrical—角度と直線は交点で保持されます。このオプションは、角度と直線の正確さが重要である場合に使用します (サイト計画、ドローイングなど)。これがデフォルトです。 Median—非直線的 (不規則) な角度は、方向の平均値によって処理されます。このオプションは、ラインが不規則な角度で交差する自然や有機的なフィーチャで使用します (環境マッピングなど)。なし—交点では特別な処理は行われません。フィーチャはそのまま抽出されます。このオプションは、交点が存在しないか、重要でない場合に使用します (等高線など)。	String
最大ライン幅 (オプション)	ラスター内の大きくて太いラインを除外し、細いラインのみを集中的に抽出するフィルター。このパラメーターは、出力フィーチャの構築にも影響を及ぼすため、データに対して最も正確な値を使用することが重要です。最大ライン幅以下の幅を持つラスターラインは中心線の抽出の対象となり、幅が広いエレメントはポリゴンフィーチャとして抽出されます (出力ポリゴンフィーチャパラメーターが指定されている場合)。	Double
ノイズレベル (オプション)	結果を向上するために、抽出から除外されるノイズのレベル。	Double
圧縮許容値 (オプション)	所定の許容値に基づいて頂点を取り除くことによって、ラインを単純化します。圧縮許容値を高くすると頂点の数が減り、元のライン形状からの逸脱が大きくなります。圧縮許容値とは、マップ単位やピクセル単位ではなく、ジェネラライズの度合いを示します。	Double
スムージングの適用 (オプション)	抽出時にポリラインフィーチャにスムージングを適用するかどうかを指定します。オン—抽出されたポリラインフィーチャにスムージングが適用されます。オフ—抽出されたポリラインフィーチャにスムージングが適用されません。	Boolean
スムージングの加重 (オプション)	スムージングの強度。スムージングの加重値が大きくなるほどラインは滑らかになりますが、出力が元の形状から逸脱する可能性があります。スムージングの加重値は、特定のマップ単位またはピクセル単位ではありません。	Double
コーナーの処理 (オプション)	ラスターラインが交差する位置でコーナーをシャープにするか滑らかにするかを指定します。自然物 (コンター、土壌の境界線、河川など) を抽出する際、建造環境を表す他のタイプのマップイメージほどコーナーの解像度が重要視されないことがあります。オン—ラスターラインが交差する位置でコーナーがシャープになります。オフ—ラスターラインが交差する位置でコーナーが滑らかになります。	Boolean
最大コーナー角度 (オプション)	コーナーと見なされる、交差するラスターラインの最大角度。	Double
ホールサイズ (オプション)	ホールの対角線の長さが指定された距離以下であれば、抽出時にラスターラインの一部として扱われます。このパラメーターでは、抽出時にラスターラインのホール (前景ピクセルで完全に囲まれた小さなギャップ) を無視できます。ホールは、ソースの品質が低い場合や、スキャニングエラーが発生した場合に生じます。	Long
ギャップを埋める (オプション)	ツールがラスターラインの途切れを処理し、指定された許容値以下のギャップを埋めることで、連続したポリラインを生成するかどうかを指定します。ギャップはラスターラインが交差する位置では埋められません。オン—抽出されたポリラインフィーチャのギャップは埋められます。オフ—抽出されたポリラインフィーチャのギャップは埋められません。	Boolean
ギャップ許容値 (オプション)	抽出時に、ラスターライン間のギャップを埋めるかどうかを判断するために使用される、ピクセル単位の距離。	Double
ギャップ検索角度 (オプション)	ラスターラインのギャップを検索し、抽出結果を向上するために使用される角度。このパラメーターは、中断を含む曲線ラスターラインを抽出する場合に役に立ち、より正確で連続した出力ポリラインを生成できます。	Double
出力ポリゴンフィーチャ (オプション)	ラスターセルのアウトラインを表す、変換されたポリゴンを格納する出力フィーチャクラス。	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})

名前	説明	データタイプ
in_raster	入力ラスターデータセット。ラスターは 2 つのクラス (バイナリーイメージ) に分類する必要があります。	Raster Layer
foreground_value	ラインフィーチャに抽出されるラスターセルを表す前景値。	Long
out_centerlines	出力された変換後のポリライン。	Feature Class
intersection_solution	ラスターの交点でポリラインフィーチャが作成される方法を指定します。ラスターの交点は、3 つ以上のラスターラインが交差する位置です。 `GEOMETRICAL`—角度と直線は交点で保持されます。このオプションは、角度と直線の正確さが重要である場合に使用します (サイト計画、ドローイングなど)。これがデフォルトです。 `MEDIAN`—非直線的 (不規則) な角度は、方向の平均値によって処理されます。このオプションは、ラインが不規則な角度で交差する自然や有機的なフィーチャで使用します (環境マッピングなど)。 `NONE`—交点では特別な処理は行われません。フィーチャはそのまま抽出されます。このオプションは、交点が存在しないか、重要でない場合に使用します (等高線など)。	String
line_width (オプション)	ラスター内の大きくて太いラインを除外し、細いラインのみを集中的に抽出するフィルター。このパラメーターは、出力フィーチャの構築にも影響を及ぼすため、データに対して最も正確な値を使用することが重要です。最大ライン幅以下の幅を持つラスターラインは中心線の抽出の対象となり、幅が広いエレメントはポリゴンフィーチャとして抽出されます (`out_polygons` パラメーターが指定されている場合)。	Double
noise_level (オプション)	結果を向上するために、抽出から除外されるノイズのレベル。	Double
compression (オプション)	所定の許容値に基づいて頂点を取り除くことによって、ラインを単純化します。圧縮許容値を高くすると頂点の数が減り、元のライン形状からの逸脱が大きくなります。圧縮許容値とは、マップ単位やピクセル単位ではなく、ジェネラライズの度合いを示します。	Double
smoothing (オプション)	抽出時にポリラインフィーチャにスムージングを適用するかどうかを指定します。 `SMOOTHING`—抽出されたポリラインフィーチャにスムージングが適用されます。 `NO_SMOOTHING`—抽出されたポリラインフィーチャにスムージングが適用されません。	Boolean
smoothing_weight (オプション)	スムージングの強度。スムージングの加重値が大きくなるほどラインは滑らかになりますが、出力が元の形状から逸脱する可能性があります。スムージングの加重値は、特定のマップ単位またはピクセル単位ではありません。	Double
corners (オプション)	ラスターラインが交差する位置でコーナーをシャープにするか滑らかにするかを指定します。自然物 (コンター、土壌の境界線、河川など) を抽出する際、建造環境を表す他のタイプのマップイメージほどコーナーの解像度が重要視されないことがあります。 `CORNERS`—ラスターラインが交差する位置でコーナーがシャープになります。 `NO_CORNERS`—ラスターラインが交差する位置でコーナーが滑らかになります。	Boolean
max_corner_angle (オプション)	コーナーと見なされる、交差するラスターラインの最大角度。	Double
hole_size (オプション)	ホールの対角線の長さが指定された距離以下であれば、抽出時にラスターラインの一部として扱われます。このパラメーターでは、抽出時にラスターラインのホール (前景ピクセルで完全に囲まれた小さなギャップ) を無視できます。ホールは、ソースの品質が低い場合や、スキャニングエラーが発生した場合に生じます。	Long
close_gaps (オプション)	ツールがラスターラインの途切れを処理し、指定された許容値以下のギャップを埋めることで、連続したポリラインを生成するかどうかを指定します。ギャップはラスターラインが交差する位置では埋められません。 `CLOSE_GAPS`—抽出されたポリラインフィーチャのギャップは埋められます。 `NO_CLOSE_GAPS`—抽出されたポリラインフィーチャのギャップは埋められません。	Boolean
gap_tolerance (オプション)	抽出時に、ラスターライン間のギャップを埋めるかどうかを判断するために使用される、ピクセル単位の距離。	Double
gap_search_angle (オプション)	ラスターラインのギャップを検索し、抽出結果を向上するために使用される角度。このパラメーターは、中断を含む曲線ラスターラインを抽出する場合に役に立ち、より正確で連続した出力ポリラインを生成できます。	Double
out_polygons (オプション)	ラスターセルのアウトラインを表す、変換されたポリゴンを格納する出力フィーチャクラス。	Feature Class

コードのサンプル

ExtractScannedLines の例 1 (Python ウィンドウ)

次のサンプルは、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"
)

ExtractScannedLines の例 2 (スタンドアロンスクリプト)

スキャンマップ画像からラインを抽出

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

環境

現在のワークスペース, 範囲, 出力座標系, 地理座標系変換, 出力データのコンフィグレーションキーワード, 出力データの XY ドメイン, 出力データの Z ドメイン

ライセンス情報

Basic: いいえ
Standard: いいえ
Advanced: はい

スキャンされたラインを抽出 (変換ツール)

サマリー

図

使用法

パラメーター

環境

ライセンス情報

関連トピック