トップへ戻る

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

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

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"
}
    • レガシー:

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

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

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力モザイク データセット

調整された入力モザイク データセット。

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

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 に設定されている場合にデフォルトで指定されます。
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

関連トピック

  • リアリティ マッピング ツールボックスの概要
  • ジオプロセシング ツールの検索
  • ArcGIS Pro のリアリティ マッピング

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報