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

BeschriftungErläuterungDatentyp
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.

  • DrohneDie Eingabe-Bilddaten werden als mit Drohnen oder mit terrestrischen Kameras erfasst definiert.
  • Nadir-LuftbildDie Eingabe-Bilddaten werden als mit großen photogrammetrischen Kamerasystemen erfasst definiert.
  • SchrägluftbildDie Eingabe-Bilddaten werden als mit Schrägluftbild-Kamerasystemen erfasst definiert.
  • SatellitenaufnahmenDie 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.

  • UltraDie höchste Punktwolkendichte wird verwendet. Eingabebilder werden mit ihrer ursprünglichen (vollen) Auflösung verwendet.
  • HochDie hohe Punktwolkendichte wird verwendet. Eingabebilder werden zweimal reduziert.
String
Produkte
(optional)

Gibt die zu generierenden Produkte an.

  • DSMEs wird ein DSM generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Nadir-Luftbild oder Satellit festgelegt ist.
  • True OrthoDie Bilddaten werden orthorektifiziert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Nadir-Luftbild und Satellit festgelegt ist.
  • DSM-MeshEs wird ein DSM-Mesh generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Nadir-Luftbild oder Satellit festgelegt ist.
  • PunktwolkeEs wird eine Bildpunktwolke generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter Szenario auf Drohne oder Schrägluftbild festgelegt ist.
  • MeshEs 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

BeschriftungErläuterungDatentyp
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})
NameErläuterungDatentyp
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.

  • DRONEDie Eingabe-Bilddaten werden als mit Drohnen oder mit terrestrischen Kameras erfasst definiert.
  • AERIAL_NADIRDie Eingabe-Bilddaten werden als mit großen photogrammetrischen Kamerasystemen erfasst definiert.
  • AERIAL_OBLIQUEDie Eingabe-Bilddaten werden als mit Schrägluftbild-Kamerasystemen erfasst definiert.
  • SATELLITEDie 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.

  • ULTRADie höchste Punktwolkendichte wird verwendet. Eingabebilder werden mit ihrer ursprünglichen (vollen) Auflösung verwendet.
  • HIGHDie hohe Punktwolkendichte wird verwendet. Eingabebilder werden zweimal reduziert.
String
products
[products,...]
(optional)

Gibt die zu generierenden Produkte an.

  • DSMEs wird ein DSM generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf AERIAL_NADIR oder SATELLITE festgelegt ist.
  • TRUE_ORTHODie Bilddaten werden orthorektifiziert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf AERIAL_NADIR festgelegt ist.
  • DSM_MESHEs wird ein DSM-Mesh generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf AERIAL_NADIR oder SATELLITE festgelegt ist.
  • POINT_CLOUDEs wird eine Bildpunktwolke generiert. Diese Option wird standardmäßig angegeben, wenn der Parameter scenario auf DRONE oder AERIAL_OBLIQUE festgelegt ist.
  • MESHEs 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

NameErläuterungDatentyp
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

Verwandte Themen