Oberfläche rekonstruieren (Reality-Mapping)

Mit der Advanced-Lizenz verfügbar.

Für ArcGIS-Organisationen mit der ArcGIS Reality-Lizenz verfügbar.

Zusammenfassung

Generiert ein digitales Oberflächenmodell (DSM), True Orthos, DSM-Meshes, 3D-Meshes und Punktwolken aus angepassten Bilddaten.

Verwendung

• Der Wert des Parameters Eingabe-Mosaik-Dataset muss vorab angepasst werden. Weitere Informationen zur Blockausgleichung beim Ortho-Mapping finden Sie in der Hilfe für das Werkzeug Blockausgleichung berechnen.

• Beim Ausführen des Werkzeugs wird die reality.json-Datei im Wert des Parameters Rekonstruktionsordner erstellt. Wenn das Werkzeug mit demselben Wert für Rekonstruktionsordner erneut ausgeführt wird, werden bei Vorhandensein der reality.json-Datei die Parameter Szenario, Qualität, Gewässer-Features und Korrektur-Features je nach den Parameterwerten aus der vorherigen Ausführung festgelegt. Führen Sie das Werkzeug erneut aus, um weitere Produkte für dasselbe Projekt zu generieren.

  Hinweis:

  Um die Werte, die für die Parameter Gewässer-Features und Korrektur-Features verwendet werden, zurückzusetzen, legen Sie diese Parameterwerte auf NONE fest.

• Bei Änderungen im Eingabe-Mosaik-Dataset geben Sie für den Wert Rekonstruktionsordner einen anderen Ordner an. Um Produkte zu generieren, die Änderungen am Mosaik-Dataset widerspiegeln, geben Sie diesen neuen Speicherort an, und führen Sie das Werkzeug erneut aus.

• Verwenden Sie den Parameter Interessenbereich, um die Verarbeitung zu beschleunigen und Produkte für eine Teilmenge der Bilder im Eingabe-Mosaik zu generieren.

• Wenn der Parameter Rekonstruktionsoptionen angegeben ist, werden die Standardwerte für die verbleibenden optionalen Parameter durch die Eigenschaften der .json-Datei oder JSON-Zeichenfolge festgelegt.

  Hinweis:

  Wenn dieselbe Eigenschaft mithilfe des Parameters Rekonstruktionsoptionen und eines verbleibenden optionalen Parameters festgelegt wird, überschreibt der Wert des optionalen Parameters den Wert für Rekonstruktionsoptionen.

  In der folgenden Liste werden die vom Parameter Rekonstruktionsoptionen verwendeten Schlüsselwörter als .json-Datei oder JSON-Zeichenfolge definiert:

  • scenario: Gibt den Typ der Bilddaten an, die zum Generieren der Ausgabeprodukte verwendet werden.
  • fwdOverlap: Der Prozentsatz der Vorwärtsüberlappung (Längsüberdeckung) zwischen den Bildern. Das Schlüsselwort wird verwendet, wenn scenario auf AERIAL_NADIR eingestellt ist.
  • swdOverlap: Der Prozentsatz der Seitwärtsüberlappung (Querüberdeckung) zwischen den Bildern. Das Schlüsselwort wird verwendet, wenn scenario auf AERIAL_NADIR eingestellt ist.
  • quality: Gibt die Qualität des endgültigen Produkts an.
  • products: Gibt die zu generierenden Produkte an.
  • tileSize: Die Kachelgröße. Mögliche Werte sind AUTO oder Werte des Typs "Double".
  • cellSize: Die Zellengröße der Ausgabe-Raster-Produkts. Dieser Wert wird automatisch geschätzt, er kann aber auch manuell definiert werden. Mögliche Werte sind AUTO oder Werte des Typs "Double".
  • tilingOrigin: Die Kartenkoordinaten des Kachelursprungs. Beispiel: "tilingOrigin": [0, 0]
  • areaFeatures: Der Interessenbereich.
  • waterbodyFeatures: Ein Polygon, das die Ausdehnung großer Gewässer definiert.
  • correctionFeatures: Ein Polygon, das die Ausdehnung aller Flächen definiert, bei denen es sich nicht um Gewässer handelt.
  • dsmMetaProducts: Gibt die DSM-Metainformationsprodukte an, die in die Ausgabe einbezogen werden sollen. Die Werte können eine beliebige Kombination aus DSM_BINARY_MASK, DSM_DISTANCE_MAP und DSM_POINT_MODEL_COUNT enthalten.
  • meshFormats: Gibt das Mesh-Ausgabeformat an. Gültige Werte sind SLPK, OBJ und 3D_TILES, z. B. "meshFormats": "SLPK;OBJ;3D_TILES". Der Standardwert ist SLPK.
  • processingFolder: Der Verarbeitungsspeicherort im lokalen Speicher. Der Standardwert ist der lokale Temp-Ordner. Der generierte Inhalt wird nach Abschluss der Verarbeitung gelöscht.
  • resultsFolder: Der Ausgabespeicherort für die Ergebnisse der Verarbeitung. Der Standardwert ist der Rekonstruktionsordner.

• Im folgenden Beispiel wird der Wert des Parameters Rekonstruktionsoptionen als JSON-Datei angegeben:

  {
      "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"
  }

Vorversion:

In ArcGIS Pro 3.2 wurde die Option Standard des Parameters Szenario durch die Option Drohne ersetzt. Darüber hinaus sind die folgenden Parameteroptionen veraltet:

• Parameter Qualität: Die Optionen Mittel und Niedrig sind veraltet.
• Parameter Interessenbereich: Die Option Automatisch ist veraltet.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Mosaik-Dataset	Das angepasste Eingabe-Mosaik-Dataset.	Mosaic Dataset; Mosaic Layer
Rekonstruktionsordner	Der Ordner für das Ausgabe-Dataset.	Folder
Rekonstruktionsoptionen (optional)	Eine .json-Datei oder JSON-Zeichenfolge, die die Werte für die Werkzeugparameter angibt. Wenn dieser Parameterwert angegeben ist, werden die Standardwerte für die verbleibenden optionalen Parameter durch die Eigenschaften der .json-Datei oder JSON-Zeichenfolge festgelegt. Eine Liste der Optionen finden Sie im Abschnitt Verwendung.	File; String
Szenario (optional)	Gibt den Typ der Bilddaten an, die zum Generieren der Ausgabeprodukte verwendet werden. Drohne—Die Eingabe-Bilddaten werden als mit Drohnen oder mit terrestrischen Kameras erfasst definiert. Nadir-Luftbild—Die Eingabe-Bilddaten werden als mit großen photogrammetrischen Kamerasystemen erfasst definiert. Schrägluftbild—Die Eingabe-Bilddaten werden als mit Schrägluftbild-Kamerasystemen erfasst definiert. Satellitenaufnahmen—Die Eingabe-Bilddaten werden als mit Satellit erfasst definiert.	String
Vorwärtsüberlappung (optional)	Der zu verwendende Prozentsatz der Vorwärtsüberlappung (Längsüberdeckung) zwischen den Bildern. Die Standardeinstellung ist 60. Dieser Parameter ist aktiv, wenn für den Parameter Szenario die Option Nadir-Luftbild festgelegt ist.	Long
Seitwärtsüberlappung (optional)	Der zu verwendende Prozentsatz der Seitwärtsüberlappung (Querüberdeckung) zwischen den Bildern. Der Standardwert ist 30. Dieser Parameter ist aktiv, wenn für den Parameter Szenario die Option Nadir-Luftbild festgelegt ist.	Long
Qualität (optional)	Gibt die Qualität des endgültigen Produkts an. Ultra—Die höchste Punktwolkendichte wird verwendet. Eingabebilder werden mit ihrer ursprünglichen (vollen) Auflösung verwendet. Hoch—Die hohe Punktwolkendichte wird verwendet. Eingabebilder werden zweimal reduziert.	String
Produkte (optional)	Gibt die zu generierenden Produkte an. DSM—Es wird ein DSM generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Nadir-Luftbild oder Satellit festgelegt ist. True Ortho—Die Bilddaten werden orthorektifiziert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Nadir-Luftbild und Satellit festgelegt ist. DSM-Mesh—Es wird ein DSM-Mesh generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Nadir-Luftbild oder Satellit festgelegt ist. Punktwolke—Es wird eine Bildpunktwolke generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Drohne oder Schrägluftbild festgelegt ist. Mesh—Es wird ein 3D-Mesh generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Drohne oder Schrägluftbild festgelegt ist.	String
Zellengröße (optional)	Die Zellengröße des Ausgabeprodukts.	Double; String
Interessenbereich (optional)	Der Interessenbereich, der zum Auswählen von Bildern für die Verarbeitung verwendet wird. Der Interessenbereich kann automatisch berechnet oder mithilfe eines Eingabe-Polygons definiert werden. Wenn der Wert 3D-Geometrien enthält, wird die Z-Komponente ignoriert. Wenn der Wert überlappende Features enthält, wird die Vereinigungsmenge dieser Features berechnet.	Feature Layer; File; String
Gewässer-Features (optional)	Ein Polygon, das die Ausdehnung großer Gewässer definiert. Bei dem Wert muss es sich um ein 3D-Feature handeln.	Feature Layer; File; String
Korrektur-Features (optional)	Ein Polygon, das die Ausdehnung aller Flächen definiert, bei denen es sich nicht um Gewässer handelt. Bei dem Wert muss es sich um ein 3D-Feature handeln.	Feature Layer; File; String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierter Rekonstruktionsordner	Der Ausgabeordner für die Rekonstruktion.	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})

Name	Erläuterung	Datentyp
in_mosaic_dataset	Das angepasste Eingabe-Mosaik-Dataset.	Mosaic Dataset; Mosaic Layer
recon_folder	Der Ordner für das Ausgabe-Dataset.	Folder
recon_options (optional)	Eine .json-Datei oder JSON-Zeichenfolge, die die Werte für die Werkzeugparameter angibt. Wenn dieser Parameterwert angegeben ist, werden die Standardwerte für die verbleibenden optionalen Parameter durch die Eigenschaften der .json-Datei oder JSON-Zeichenfolge festgelegt. Eine Liste der Optionen finden Sie im Abschnitt Verwendung.	File; String
scenario (optional)	Gibt den Typ der Bilddaten an, die zum Generieren der Ausgabeprodukte verwendet werden. DRONE—Die Eingabe-Bilddaten werden als mit Drohnen oder mit terrestrischen Kameras erfasst definiert. AERIAL_NADIR—Die Eingabe-Bilddaten werden als mit großen photogrammetrischen Kamerasystemen erfasst definiert. AERIAL_OBLIQUE—Die Eingabe-Bilddaten werden als mit Schrägluftbild-Kamerasystemen erfasst definiert. SATELLITE—Die Eingabe-Bilddaten werden als mit Satellit erfasst definiert.	String
fwd_overlap (optional)	Der zu verwendende Prozentsatz der Vorwärtsüberlappung (Längsüberdeckung) zwischen den Bildern. Die Standardeinstellung ist 60. Dieser Parameter wird aktiviert, wenn der Parameter scenario auf AERIAL_NADIR gesetzt ist.	Long
swd_overlap (optional)	Der zu verwendende Prozentsatz der Seitwärtsüberlappung (Querüberdeckung) zwischen den Bildern. Der Standardwert ist 30. Dieser Parameter wird aktiviert, wenn der Parameter scenario auf AERIAL_NADIR gesetzt ist.	Long
quality (optional)	Gibt die Qualität des endgültigen Produkts an. ULTRA—Die höchste Punktwolkendichte wird verwendet. Eingabebilder werden mit ihrer ursprünglichen (vollen) Auflösung verwendet. HIGH—Die hohe Punktwolkendichte wird verwendet. Eingabebilder werden zweimal reduziert.	String
products [products,...] (optional)	Gibt die zu generierenden Produkte an. DSM—Es wird ein DSM generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf AERIAL_NADIR oder SATELLITE festgelegt ist. TRUE_ORTHO—Die Bilddaten werden orthorektifiziert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf AERIAL_NADIR festgelegt ist. DSM_MESH—Es wird ein DSM-Mesh generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf AERIAL_NADIR oder SATELLITE festgelegt ist. POINT_CLOUD—Es wird eine Bildpunktwolke generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf DRONE oder AERIAL_OBLIQUE festgelegt ist. MESH—Es wird ein 3D-Mesh generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf DRONE oder AERIAL_OBLIQUE festgelegt ist.	String
cell_size (optional)	Die Zellengröße des Ausgabeprodukts.	Double; String
aoi (optional)	Der Interessenbereich, der zum Auswählen von Bildern für die Verarbeitung verwendet wird. Der Interessenbereich kann automatisch berechnet oder mithilfe eines Eingabe-Polygons definiert werden. Wenn der Wert 3D-Geometrien enthält, wird die Z-Komponente ignoriert. Wenn der Wert überlappende Features enthält, wird die Vereinigungsmenge dieser Features berechnet.	Feature Layer; File; String
waterbody_features (optional)	Ein Polygon, das die Ausdehnung großer Gewässer definiert. Bei dem Wert muss es sich um ein 3D-Feature handeln.	Feature Layer; File; String
correction_features (optional)	Ein Polygon, das die Ausdehnung aller Flächen definiert, bei denen es sich nicht um Gewässer handelt. Bei dem Wert muss es sich um ein 3D-Feature handeln.	Feature Layer; File; String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
derived_recon_folder	Der Ausgabeordner für die Rekonstruktion.	Folder

Codebeispiel

ReconstructSurface: Beispiel 1 (Python-Fenster)

In diesem Beispiel werden 3D-Produkte aus einem angepassten Mosaik-Dataset erstellt.

# 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: Beispiel 2 (Python-Fenster)

In diesem Beispiel werden mithilfe einer JSON-Zeichenfolge DSM-, DSM-Mesh- und True-Ortho-Produkte erstellt.

# 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: Beispiel 3 (eigenständiges Skript)

In diesem Beispiel werden mehrere 2D-Produkte aus Nadir-Luftbildern erstellt.

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Nein
• Standard: Erfordert ArcGIS Reality for ArcGIS Pro
• Advanced: Erfordert ArcGIS Reality for ArcGIS Pro