| ラベル | 説明 | データ タイプ |
入力フィーチャ | 正規化される建物フットプリントを表すポリゴン。 | Feature Layer |
出力フィーチャクラス | 生成されるフィーチャクラス。 | Feature Class |
方法 | 入力フィーチャの処理に使用される正規化手法を指定します。
| String |
許容値 | 大半の方法で、この値は正規化されたフットプリントが、元のフィーチャの境界から外れることができる最大距離を表します。 指定した値は、入力フィーチャの座標系の距離単位で表されます。 方法として [円形] を使用している場合、元のフィーチャとその正規化された結果に対する、[許容値タイプ] パラメーターで行った選択に基づいて正規化された結果のエリアの割合としてこのオプションを解釈することもできます。 | Double |
密度 | 正規化されたフィーチャが直線か曲線かを評価するのに使用されるサンプリング間隔。 密度は許容値以下である必要があります。 このパラメーターは、直角の識別情報をサポートする手法とのみ使用されます。 | Double |
精度 | 正規化プロセスで使用される空間グリッドの精度。 有効な値の範囲は 0.05 〜 0.25 です。 | Double |
対角線のペナルティ | [直角と対角線] 方法を使用する場合、この値は 2 つの隣接する線分間で直角または対角線のエッジを構築する可能性を示します。 [任意の角度] 方法を使用する場合、この値は、ツールのアルゴリズムで決定される優先エッジに適合しない対角線のエッジを構築する可能性を示します。 ペナルティ値を 0 に設定した場合、優先エッジは使用されず、単純化された不規則なポリゴンが生成されます。 一般的に、この値が高いほど、対角線のエッジが構築される可能性は低くなります。 | Double |
最小半径 | 正規化された円に許容される最小半径。 値が 0 の場合、最小サイズの制限がないことを意味します。 このオプションは、[円形] 方法でのみ利用可能です。 | Double |
最大半径 | 正規化された円に許容される最大半径。 このオプションは、[円形] 方法でのみ利用可能です。 | Double |
配置フィーチャ (オプション) | 正規化されたポリゴンの方向を配置するために使用されるライン フィーチャ。 各ポリゴンは 1 つのライン フィーチャのみに配置されます。 | Feature Layer |
許容値範囲 (オプション) | 最近接配置フィーチャの検索に使用される最大距離閾値。 たとえば、20 メートルの値は、正規化されたポリゴンを配置するために、20 メートル以内にある最も近いラインが使用されることを意味します。 | Linear Unit |
許容値タイプ (オプション) | [方法 パラメーターが [円形] に設定されている場合に許容値をどのように適用するかを指定します。
| String |
サマリー
ジオメトリ内にある不自然な結果を除去して、建物ポリゴンのフットプリントを正規化します。
図
使用法
このツールは、ポリライン圧縮アルゴリズムを使用して、不自然な結果が生成される可能性のあるフィーチャ抽出ワークフローによって作成された建物フットプリント ポリゴンの歪みを矯正します。
建物フットプリントに円形の構造が含まれる場合は、最初にそれらのフィーチャを処理します。 円形の建物の識別には、コンパクト性を使用できます。 この値を計算するには、次の手順を実行します。
- タイプが double のフィールドを追加します。
- フィールド演算を使用して、次の式を計算します。
(4 * 3.14159265358979 * !shape.area!) / !shape.length! ** 2 - 完全な円の場合、値は 1 になります。 ただし、このツールで処理されるポリゴンにはある程度の不規則性があるため、値が 1 に近い場合、円形が含まれる可能性が高くなります。 結果を確認して、円形の建物を示す最小値を識別します。 次に、[方法] パラメーターを [円形] に設定してこのツールを実行する前に、その値以上の値を選択します。
建物フットプリントが表すジオメトリに、45° と 90° の屈曲が含まれる (それ以外の屈曲が含まれる場合もあります) 角度の組み合わせを形成するエッジがある場合、[方法] パラメーターを [任意の角度] に設定します。 まず、不規則なエッジを含むフィーチャのサブセットを選択し、目的の結果が得られる対角のペナルティ値を評価します。 対角線のエッジを適切に取得できる結果が得られない場合は、許容値を変更し、正規化ゾーンを制限して、対角線のペナルティを徐々に下げます。 出力に鋭角な内角の不自然なエッジが含まれる場合は、目的の出力を得られるまで対角線のペナルティを徐々に増やしながらツールを繰り返し実行します。 次に、その値を使用してデータセット全体を処理します。
CUDA をサポートし、メモリが 2 GB を超える NVIDIA グラフィックス カードを搭載したコンピューターで [任意の角度] オプションを使用する場合、このツールは GPU を使用して処理を実行します。 この動作は、[プロセッサー タイプ] 環境で変更できます。 複数の GPU が存在する場合は、特定の GPU を [GPU ID] 環境で設定できます。
ツールを使用して、所定の入力の正規化されたソリューションが生成されない場合、元のフィーチャが出力にコピーされます。 STATUS フィールドに指定された値は、そのフィーチャが正規化されたかどうかを次のように示します。
- 0 = 正規化されたフィーチャ
- 1 = 元のフィーチャ
サイズが大きく異なるジオメトリで方法として [円形] を使用する場合は、[許容値タイプ] パラメーターに [面積比] オプションを指定すると、[距離] オプションよりも良好な結果が得られることがあります。これは、元のフィーチャの限られたサブセットで機能する場合がある固定サイズとは異なり、出力フィーチャの構築が元のジオメトリのサイズによって制限されるためです。
パラメーター
arcpy.ddd.RegularizeBuildingFootprint(in_features, out_feature_class, method, tolerance, densification, precision, diagonal_penalty, min_radius, max_radius, {alignment_feature}, {alignment_tolerance}, {tolerance_type})| 名前 | 説明 | データ タイプ |
in_features | 正規化される建物フットプリントを表すポリゴン。 | Feature Layer |
out_feature_class | 生成されるフィーチャクラス。 | Feature Class |
method | 入力フィーチャの処理に使用される正規化手法を指定します。
| String |
tolerance | 大半の方法で、この値は正規化されたフットプリントが、元のフィーチャの境界から外れることができる最大距離を表します。 指定した値は、入力フィーチャの座標系の距離単位で表されます。 方法として CIRCLE を使用している場合、元のフィーチャとその正規化された結果に対する、tolerance_type パラメーターで行った選択に基づいて正規化された結果のエリアの割合としてこのオプションを解釈することもできます。 | Double |
densification | 正規化されたフィーチャが直線か曲線かを評価するのに使用されるサンプリング間隔。 密度は許容値以下である必要があります。 このパラメーターは、直角の識別情報をサポートする手法とのみ使用されます。 | Double |
precision | 正規化プロセスで使用される空間グリッドの精度。 有効な値の範囲は 0.05 〜 0.25 です。 | Double |
diagonal_penalty | RIGHT_ANGLES_AND_DIAGONALS 方法を使用する場合、この値は 2 つの隣接する線分間で直角または対角線のエッジを構築する可能性を示します。 ANY_ANGLES 方法を使用する場合、この値は、ツールのアルゴリズムで決定される優先エッジに適合しない対角線のエッジを構築する可能性を示します。 一般的に、この値が高いほど、対角線のエッジが構築される可能性は低くなります。 | Double |
min_radius | 正規化された円に許容される最小半径。 値が 0 の場合、最小サイズの制限がないことを意味します。 このオプションは、CIRCLE の手法でのみ利用可能です。 | Double |
max_radius | 正規化された円に許容される最大半径。 このオプションは、CIRCLE の手法でのみ利用可能です。 | Double |
alignment_feature (オプション) | 正規化されたポリゴンの方向を配置するために使用されるライン フィーチャ。 各ポリゴンは 1 つのライン フィーチャのみに配置されます。 | Feature Layer |
alignment_tolerance (オプション) | 最近接配置フィーチャの検索に使用される最大距離閾値。 たとえば、20 メートルの値は、正規化されたポリゴンを配置するために、20 メートル以内にある最も近いラインが使用されることを意味します。 | Linear Unit |
tolerance_type (オプション) | method パラメーターが CIRCLE に設定されている場合に許容値をどのように適用するかを指定します。
| String |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
arcpy.env.workspace = 'c:/data'
arcpy.ddd.RegularizeBuildingFootprint('rough_footprints.shp',
'regularized_footprints.shp',
method='Circle', tolerance=1.5, min_radius=10,
max_radius=20)次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''****************************************************************************
Name: Extract Building Footprints
Description: Extract footprint from lidar points classified as buildings,
regularize its geometry, and calculate the building height.
****************************************************************************'''
import arcpy
lasd = arcpy.GetParameterAsText(0)
footprint = arcpy.GetParameterAsText(1)
try:
lasd_layer = 'building points'
arcpy.management.MakeLasDatasetLayer(lasd, lasd_layer, class_code=6)
temp_raster = 'in_memory/bldg_raster'
arcpy.management.LasPointStatsAsRaster(lasd_layer, temp_raster,
'PREDOMINANT_CLASS', 'CELLSIZE', 2.5)
temp_footprint = 'in_memory/footprint'
arcpy.conversion.RasterToPolygon(temp_raster, temp_footprint)
arcpy.ddd.RegularizeBuildingFootprint(temp_footprint, footprint,
method='RIGHT_ANGLES')
arcpy.ddd.LasPointStatsByArea(lasd_layer, footprint, ['MIN_Z', 'MAX_Z'])
arcpy.management.AddField(footprint, 'Height', 'Double')
arcpy.management.CalculateField(footprint, 'Height',
"round('!Z_Max! - !Z_Min!', 2)",
'PYTHON_9.3')
except arcpy.ExecuteError:
print(arcpy.GetMessages())