Oberfläche rekonstruieren (Reality Mapping Tools)

Zusammenfassung

Generiert ein digitales Oberflächenmodell (DSM), True-Orthos, DSM-Meshes, 3D-Meshes, Gaussian-Splatting und Punktwolken aus angepassten Bilddaten in einem Mosaik-Dataset.

Verwendung

Der Wert des Parameters Eingabe-Mosaik-Dataset muss vorab angepasst werden. Weitere Informationen zur Blockausgleichung beim Ortho-Mapping finden Sie in der Dokumentation 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, z. B. "tilingOrigin": [0, 0].
- areaFeatures—Der Interessenbereich.
- waterbodyFeatures—Ein Polygon, das die Ausdehnung großer Gewässer definiert.
- coarseWaterbody—Ein boolescher Wert, der das Gewässer-Feature angibt, ist ein genaues Gewässer oder ein grobes Gewässer. Die Einstellung False bewirkt, dass das Gewässer genau ist. Die Einstellung True bewirkt, dass das Gewässer grob ist. Der Standardwert ist True.
- 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.
- meshSettings—Legt die Mesh-Einstellungen für Mesh-Produkte fest. Die folgenden Mesh-Einstellungen werden unterstützt: srs, exportInLocalCoordinateSystem, exportAsSingleFile und keepHeightsOfInputCoordinateSystem. Die unterstützten Mesh-Einstellungen hängen vom jeweiligen Mesh-Format ab. Mesh-Einstellungen können global oder anhand des Formats festgelegt werden. Wenn die Einstellung beispielsweise auf { "dsmMeshSettings": { "srs": "4326;5773" } } festgelegt wurde, erfolgt die Ausgabe der Mesh-Formate SLPK und 3D_Tiles in den angegebenen Raumbezug. Wenn Sie möchten, dass die Ausgabe der Mesh-Formate SLPK und 3D_Tiles in einen anderen Raumbezug erfolgt, legen Sie die Einstellungen anhand des Formats fest.
  - srs—Der Raumbezug für das SLPK-Format. Beim Wert srs kann es sich um ein WKID-Paar des horizontalen und des vertikalen Koordinatensystems handeln, wie z. B. "4326;5773" oder WKT. Der erste Wert stellt das horizontale Koordinatensystem dar, und der Wert srs kann angegeben werden, wenn die Transformation vom Projektkoordinatensystem in das ausgewählte Koordinatensystem unterstützt wird. Wenn es sich beim Ziel-Raumbezug um ein geographisches Koordinatensystem handelt, wird derzeit nur WGS84 unterstützt. Standardmäßig ist der Raumbezug des Mosaik-Datasets angegeben.
  - exportInLocalCoordinateSystem—Ein boolescher Wert, der angibt, ob das Mesh in ein lokales Koordinatensystem exportiert wird. Diese Option ist für das OBJ-Format verfügbar. Die Einstellung True bewirkt, dass das Mesh in ein lokales Koordinatensystem exportiert wird. Die Einstellung False bewirkt, dass das Mesh in das Koordinatensystem der Rekonstruktion exportiert wird. Der Standardwert ist False.
  - exportAsSingleFile—Ein boolescher Wert, der angibt, ob das Mesh als einzelne .obj-Datei oder als mehrere Dateien exportiert wird. Diese Option ist nur für das OBJ-Format verfügbar. Die Einstellung True bewirkt, dass das Mesh als einzelne .obj-Datei exportiert wird. Die Einstellung False bewirkt, dass das Mesh als mehrere .obj-Dateien exportiert wird. Der Standardwert ist False.
- dsmMeshSettings—Legt die Mesh-Einstellungen für das DSM-Mesh-Produkt fest. Die unterstützten DSM-Mesh-Einstellungen entsprechen den zuvor genannten Einstellungen für meshSettings.
- tiePointTablePath—Gibt den Pfad zur Verknüpfungspunkttabelle an.
- slnPointTablePath—Gibt den Pfad zur Lösungspunktetabelle an.
Im folgenden Beispiel wird der Wert des Parameters Rekonstruktionsoptionen als JSON-Datei angegeben:

<!--```other { "scenario": "AERIAL_NADIR", "fwdOverlap": 0.60, "swdOverlap": 0.30, "quality": "ULTRA", "products": "DSM;TRUE_ORTHO;DSM_MESH", "dsmMeshFormats": "SLPK;3D_TILES;OBJ", "dsmMetaProducts": "DSM_BINARY_MASK;DSM_DISTANCE_MAP", "dsmMeshSettings": { "SLPK": { "srs": "4326;5773" }, "OBJ": { "exportInLocalCoordinateSystem": false, "exportAsSingleFile": false } }, "resultsFolder": "C:\RMResultsFolder" }
Multispektrale Drohnendaten bieten nur Unterstützung für das Generieren von DSM- und True-Ortho-Produkten; das Generieren von Punktwolken- oder Mesh-Produkten wird nicht unterstützt.
Wenn der Parameter Produkte auf DSM festgelegt ist, erstellt das Werkzeug ein LAS-Ausgabe-Dataset oder einen LAS-Ordner im Ordner ...\Results\DSM\las. Das LAS-Dataset oder der LAS-Ordner kann zur Erstellung eines digitalen Terrain-Modells (DTM) mit dem Werkzeug Interpolieren aus Punktwolke verwendet werden.
Legacy:

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.

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. Der Standardwert 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. Schnell—Das Produkt wird in angepasster Qualität generiert, um Workflows zu unterstützen, bei denen ein schnelles Ergebnis erforderlich ist.	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 oder 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. Gaussian-Splatting—Punkte werden in einer dichten 3D-Punktwolke mit einer Gauß'schen Verteilung gerendert. Mithilfe von maschinellem Lernen werden High-Fidelity-3D-Szenen rekonstruiert, um feine Details, z. B. dünne Strukturen, zu erfassen.	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

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. Der Standardwert ist 60. Dieser Parameter wird aktiviert, wenn der Parameter `scenario` auf `AERIAL_NADIR` festgelegt wurde.	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` festgelegt wurde.	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. `RAPID`—Das Produkt wird in angepasster Qualität generiert, um Workflows zu unterstützen, bei denen ein schnelles Ergebnis erforderlich ist.	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` oder `SATELLITE` 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`, `AERIAL_OBLIQUE` festgelegt ist. `GAUSSIAN_SPLATS`—Punkte werden in einer dichten 3D-Punktwolke mit einer Gauß'schen Verteilung gerendert. Mithilfe von maschinellem Lernen werden High-Fidelity-3D-Szenen rekonstruiert, um feine Details, z. B. dünne Strukturen, zu erfassen.	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"

# Run - 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.

Lizenzierungsinformationen

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

Oberfläche rekonstruieren (Reality Mapping Tools)

Zusammenfassung

Verwendung

Hinweis:

Hinweis:

Legacy:

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen