サーフェスの再構築 (Reconstruct Surface) (リアリティ マッピング)

Advanced のライセンスで利用可能。

ArcGIS Reality ライセンスがある ArcGIS 組織で利用できます。

サマリー

調整後の画像から数値表層モデル (DSM)、トゥルー オルソ、DSM メッシュ、3D メッシュ、および点群を生成します。

使用法

• [入力モザイク データセット] パラメーター値は、事前調整済みである必要があります。 オルソ マッピングのブロック調整の詳細については、[ブロック調整計算 (Compute Block Adjustment)] ツールのドキュメントをご参照ください。

• ツールを実行すると、[再構築フォルダー] パラメーター値内に reality.json ファイルが作成されます。 ツールを再度実行すると、[再構築フォルダー] 値が再び使用された場合、reality.json ファイルが存在すると、以前の実行からの値に基づいて [シナリオ]、[品質]、[水域フィーチャ]、[修正フィーチャ] の各パラメーターが設定されます。 同じプロジェクトに対して追加のプロダクトを生成するには、ツールを再実行します。

  注意:

  [水域フィーチャ] パラメーターと [修正フィーチャ] パラメーターの値をリセットするには、これらのパラメーターの値を NONE に設定します。

• 入力モザイク データセットが変更された場合は、[再構築フォルダー] 値に別のフォルダーを指定します。 モザイク データセットの変更を反映したプロダクトを生成するには、この新しい場所を指定して、ツールを再実行します。

• [対象エリア] パラメーターを使用して、処理を高速化し、入力モザイク データセット内にある画像のサブセットのプロダクトを生成します。

• [再構築オプション] パラメーターが指定されている場合、.json ファイルまたは JSON 文字列のパラメーターは、残りのオプション パラメーターのデフォルトを設定します。

  注意:

  [再構築オプション] パラメーターとその他のオプションのパラメーターで同じプロパティが設定される場合、オプションのパラメーター値によって [再構築オプション] の値が上書きされます。

  以下のリストでは、[再構築オプション] パラメーターが .json ファイルまたは JSON 文字列として使用するキーワードを定義します。

  • scenario - 出力プロダクトの生成に使用される画像のタイプを指定します。
  • fwdOverlap - 画像間の前方 (縦) オーバーラップの割合。 このキーワードは、scenario を AERIAL_NADIR に設定した場合に使用されます。
  • swdOverlap - 画像間の横方向 (サイド) オーバーラップの割合。 このキーワードは、scenario を AERIAL_NADIR に設定した場合に使用されます。
  • quality - 最終プロダクトの品質を指定します。
  • products - 生成するプロダクトを指定します。
  • tileSize - タイル サイズ。 値は AUTO または double 型のいずれかです。
  • cellSize - 出力ラスター プロダクトのセル サイズ。 この値は自動的に推定されますが、手動で定義することもできます。 値は AUTO または double 型のいずれかです。
  • tilingOrigin - タイル原点のマップ座標。 たとえば、"tilingOrigin": [0, 0]
  • areaFeatures - 対象エリア。
  • waterbodyFeatures - 大規模な水域の範囲を定義するポリゴン。
  • correctionFeatures - 水域ではないすべてのサーフェスの範囲を定義するポリゴン。
  • dsmMetaProducts - 出力に含める DSM メタ情報プロダクトを指定します。 値には、DSM_BINARY_MASK、DSM_DISTANCE_MAP、DSM_POINT_MODEL_COUNT の組み合わせを含めることができます。
  • meshFormats - メッシュ出力形式を指定します。 有効な値は SLPK、OBJ、および 3D_TILES です (例: "meshFormats": "SLPK;OBJ;3D_TILES")。 デフォルト値は SLPK です。
  • processingFolder - ローカル ストレージ内の処理の場所。 デフォルト値はローカル一時フォルダーです。 生成されたコンテンツは処理が完了した後で削除されます。
  • resultsFolder - 処理結果の出力場所。 デフォルト値は再構築フォルダーです。

• 次に、JSON として指定される [再構築オプション] パラメーター値の例を示します。

  {
      "scenario": "AERIAL_NADIR",
      "fwdOverlap": .60,
      "swdOverlap": .30,
      "quality": "ULTRA",
      "products": "DSM;TRUE_ORTHO;DSM_MESH",
      "dsmMetaProducts": "DSM_BINARY_MASK;DSM_DISTANCE_MAP",
      "resultsFolder": "C:\\RMResultsFolder"
  }

• [プロダクト] パラメーターが [DSM] に設定されている場合、結果フォルダー ...\Results\DSM\las 内に出力 LAS データセットまたは LAS フォルダーが作成されます。 [点群から内挿 (Interpolate From Point Cloud)] ツールで LAS データセットまたは LAS フォルダーを使用して、数値地形モデル (DTM) を生成することができます。

レガシー:

ArcGIS Pro 3.2 で、[シナリオ] パラメーターの [デフォルト] オプションが [ドローン] オプションに置き換えられました。 さらに、次のパラメーター オプションが非推奨になりました。

• [品質] パラメーター - [中] オプションと [低] オプションが非推奨になりました。
• [対象エリア] パラメーター - [自動] オプションが非推奨になりました。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力モザイク データセット	調整された入力モザイク データセット。	Mosaic Dataset; Mosaic Layer
再構築フォルダー	出力データセット フォルダー。	Folder
再構築オプション (オプション)	ツール パラメーターの値を指定する .json ファイルまたは JSON 文字列。 このパラメーター値が指定されている場合、.json ファイルまたは JSON 文字列のプロパティは、残りのオプション パラメーターのデフォルト値を設定します。 オプションのリストは「使用法」セクションをご参照ください。	File; String
シナリオ (オプション)	出力プロダクトの生成に使用される画像のタイプを指定します。 ドローン—入力画像は、ドローンまたは地表カメラで取得された画像として定義されます。 空中直下—入力画像は、規模の大きい写真測量カメラ システムで取得された画像として定義されます。 空中斜め—入力画像は、斜めカメラ システムで取得された画像として定義されます。 衛星画像—入力画像は、衛星で取得された画像として定義されます。	String
前方オーバーラップ (オプション)	画像間で使用される前方 (縦) オーバーラップの割合。 デフォルトは 60 です。 このパラメーターは、[シナリオ] パラメーターが [空中直下] に設定されている場合に有効です。	Long
側方オーバーラップ (オプション)	画像間で使用される横方向 (サイド) オーバーラップの割合。 デフォルトは 30 です。 このパラメーターは、[シナリオ] パラメーターが [空中直下] に設定されている場合に有効です。	Long
品質 (オプション)	最終プロダクトの品質を指定します。 超高—密度が最も高いポイント クラウドが使用されます。 入力画像が元の (フル) 解像度で使用されます。 高—密度が高いポイント クラウドが使用されます。 入力画像が 2 倍ダウンサンプルされます。	String
プロダクト (オプション)	生成するプロダクトを指定します。 DSM—DSM が生成されます。 このオプションは、[シナリオ] パラメーターが [空中直下] または [衛星画像] に設定されている場合にデフォルトで指定されます。 トゥルー オルソ—画像がオルソ幾何補正されます。 このオプションは、[シナリオ] パラメーターが [空中直下] または [衛星画像] に設定されている場合にデフォルトで指定されます。 DSM メッシュ—DSM メッシュが生成されます。 このオプションは、[シナリオ] パラメーターが [空中直下] または [衛星画像] に設定されている場合にデフォルトで指定されます。 点群—画像ポイント クラウドが生成されます。 このオプションは、[シナリオ] パラメーターが [ドローン] または [空中斜め] に設定されている場合にデフォルトで指定されます。 メッシュ—3D メッシュが生成されます。 このオプションは、[シナリオ] パラメーターが [ドローン] または [空中斜め] に設定されている場合にデフォルトで指定されます。	String
セル サイズ (オプション)	出力プロダクトのセル サイズ。	Double; String
対象エリア (オプション)	処理する画像の選択に使用される対象エリア。 対象エリアは、自動的に計算されるか、入力ポリゴンを使用して定義されます。 値に 3D ジオメトリが含まれている場合、Z 成分は無視されます。 値にオーバーラップしているフィーチャが含まれている場合、これらのフィーチャのすべての範囲が計算されます。	Feature Layer; File; String
水域フィーチャ (オプション)	大規模な水域の範囲を定義するポリゴン。 値は 3D フィーチャでなくてはなりません。	Feature Layer; File; String
修正フィーチャ (オプション)	水域ではないすべてのサーフェスの範囲を定義するポリゴン。 値は 3D フィーチャでなくてはなりません。	Feature Layer; File; String

派生した出力

ラベル	説明	データ タイプ
更新された再構築フォルダー	出力再構築フォルダー。	Folder

Python

arcpy.rm.ReconstructSurface(in_mosaic_dataset, recon_folder, {recon_options}, {scenario}, {fwd_overlap}, {swd_overlap}, {quality}, {products}, {cell_size}, {aoi}, {waterbody_features}, {correction_features})

名前	説明	データ タイプ
in_mosaic_dataset	調整された入力モザイク データセット。	Mosaic Dataset; Mosaic Layer
recon_folder	出力データセット フォルダー。	Folder
recon_options (オプション)	ツール パラメーターの値を指定する .json ファイルまたは JSON 文字列。 このパラメーター値が指定されている場合、.json ファイルまたは JSON 文字列のプロパティは、残りのオプション パラメーターのデフォルト値を設定します。 オプションのリストは「使用法」セクションをご参照ください。	File; String
scenario (オプション)	出力プロダクトの生成に使用される画像のタイプを指定します。 DRONE—入力画像は、ドローンまたは地表カメラで取得された画像として定義されます。 AERIAL_NADIR—入力画像は、規模の大きい写真測量カメラ システムで取得された画像として定義されます。 AERIAL_OBLIQUE—入力画像は、斜めカメラ システムで取得された画像として定義されます。 SATELLITE—入力画像は、衛星で取得された画像として定義されます。	String
fwd_overlap (オプション)	画像間で使用される前方 (縦) オーバーラップの割合。 デフォルトは 60 です。 このパラメーターは、scenario パラメーターが AERIAL_NADIR に設定されている場合にアクティブになります。	Long
swd_overlap (オプション)	画像間で使用される横方向 (サイド) オーバーラップの割合。 デフォルトは 30 です。 このパラメーターは、scenario パラメーターが AERIAL_NADIR に設定されている場合にアクティブになります。	Long
quality (オプション)	最終プロダクトの品質を指定します。 ULTRA—密度が最も高いポイント クラウドが使用されます。 入力画像が元の (フル) 解像度で使用されます。 HIGH—密度が高いポイント クラウドが使用されます。 入力画像が 2 倍ダウンサンプルされます。	String
products [products,...] (オプション)	生成するプロダクトを指定します。 DSM—DSM が生成されます。 このオプションは、scenario パラメーターが AERIAL_NADIR または SATELLITE に設定されている場合にデフォルトで指定されます。 TRUE_ORTHO—画像がオルソ幾何補正されます。 このオプションは、scenario パラメーターが AERIAL_NADIR に設定されている場合にデフォルトで指定されます。 DSM_MESH—DSM メッシュが生成されます。 このオプションは、scenario パラメーターが AERIAL_NADIR または SATELLITE に設定されている場合にデフォルトで指定されます。 POINT_CLOUD—画像ポイント クラウドが生成されます。 このオプションは、scenario パラメーターが DRONE または AERIAL_OBLIQUE に設定されている場合にデフォルトで指定されます。 MESH—3D メッシュが生成されます。 このオプションは、scenario パラメーターが DRONE、AERIAL_OBLIQUE、または SATELLITE に設定されている場合にデフォルトで指定されます。	String
cell_size (オプション)	出力プロダクトのセル サイズ。	Double; String
aoi (オプション)	処理する画像の選択に使用される対象エリア。 対象エリアは、自動的に計算されるか、入力ポリゴンを使用して定義されます。 値に 3D ジオメトリが含まれている場合、Z 成分は無視されます。 値にオーバーラップしているフィーチャが含まれている場合、これらのフィーチャのすべての範囲が計算されます。	Feature Layer; File; String
waterbody_features (オプション)	大規模な水域の範囲を定義するポリゴン。 値は 3D フィーチャでなくてはなりません。	Feature Layer; File; String
correction_features (オプション)	水域ではないすべてのサーフェスの範囲を定義するポリゴン。 値は 3D フィーチャでなくてはなりません。	Feature Layer; File; String

派生した出力

名前	説明	データ タイプ
derived_recon_folder	出力再構築フォルダー。	Folder

コードのサンプル

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

この例では、調整されたモザイク データセットから 3D プロダクトを作成します。

# ReconstructSurface example 1 (Python window) 
# This example creates 3D products from an adjusted mosaic dataset. 

# Import system modules 
import arcpy 

products_3d = arcpy.rm.ReconstructSurface(r"C:\ReconstructSurface.gdb\droneMD", r"C:\RS_output", None, "DRONE", None, None, "HIGH", "POINT_CLOUD;MESH", 0.1, r"\\shared_location\RMeTesting.gdb\AOI", None, r"\\shared_location\RMTesting.gdb\CorrectionFeature")

ReconstructSurface の例 2 (Python ウィンドウ)

この例では、JSON 文字列を使用して DSM、DSM メッシュ、およびトゥルー オルソを作成します。

# ReconstructSurface example 2 (Python window) 
# This example creates DSM, DSM mesh, and True Ortho products using JSON string. 

# Import system modules 

import arcpy

products_2d = arcpy.rm.ReconstructSurface(r"C:\ReconstructSurface.gdb\droneMD_json", r"C:\RS_output_folder", r'{"scenario":"DRONE","quality":"ULTRA","products":"DSM;TRUE_ORTHO;DSM_MESH","cellSize":0.05,"correctionFeatures":"\\\\shared_location\\RMeTesting.gdb\\CorrectionFeature","areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI","processingFolder":"\\\\shared_location\\RMeprocessingFolder"}')

ReconstructSurface の例 3 (スタンドアロン スクリプト)

この例では、空中直下画像から複数の 2D プロダクトを作成します。

# ReconstructSurface example 3 (stand-alone script) 
# This example creates multiple 2D products from aerial nadir imagery. 

# Import system modules 
import arcpy 

# Define input parameters 
in_mosaic = "C:/ReconstructSurface.gdb/aerialMD" 
out_folder = "C:/ScenarioAerialNadir" 
json_file = "" 
scenario = "AERIAL_NADIR" 
forward_overlap = 60
side_overlap = 30 
out_quality = "ULTRA" 
output_products = "DSM;TRUE_ORTHO;DSM_MESH" 

# Execute - Generate Products 
products = arcpy.rm.ReconstructSurface(in_mosaic, out_folder, json_file,senario, forward_overlap, side_overlap, out_quality, output_products)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

• Basic: No
• Standard: 次のものが必要 ArcGIS Reality for ArcGIS Pro
• Advanced: 次のものが必要 ArcGIS Reality for ArcGIS Pro