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, 2,5D-Meshes, 3D-Meshes und Punktwolken aus angepassten Bilddaten.

Lizenz:

Das Werkzeug Oberfläche rekonstruieren ist nur mit einer ArcGIS Reality for ArcGIS Pro-Lizenz in Kombination mit einer ArcGIS-Standard- oder -Advanced-Lizenz verfügbar.

Verwendung

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

• Nach der Werkzeugausführung wird die Datei Project.spr im Wert Rekonstruktionsordner erstellt. Wenn der Wert Rekonstruktionsordner erneut verwendet wird, führt das Vorhandensein der Datei Project.spr dazu, dass der Parameter Eingabe-Mosaik-Dataset im Bereich Geoverarbeitung ausgeblendet wird. So können Sie weitere Produkte generieren, ohne Informationen aus dem Eingabe-Mosaik erneut berechnen zu müssen, da sie in der Datei Project.spr gespeichert sind. Führen Sie das Werkzeug erneut aus, um weitere Produkte für dasselbe Projekt zu generieren.

• 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.

  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.
  • srs: Das geographische Koordinatensystem eines Projekts im WKT-Format.
  • 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".
  • cellSizeMultiplicator: Ein Skalarwert für die Zellengröße. Dieser Wert wird automatisch geschätzt, er kann aber auch manuell definiert werden. Mögliche Werte sind AUTO oder Werte des Typs "Double".
  • areaX: Die X-Koordinaten der Ausgabeausdehnung.
  • areaY: Die Y-Koordinaten der Ausgabeausdehnung.
  • areaZ: Die Z-Koordinaten der Ausgabeausdehnung.
  • areaFeatures: Der Interessenbereich.
  • waterbodyFeatures: Ein Polygon, das die Ausdehnung großer Gewässer angibt.
  • correctionFeatures: Ein Polygon, das die Ausdehnung aller Flächen angibt, bei denen es sich nicht um Gewässer handelt.
  • gpuStatus: Ein boolescher Wert, der angibt, ob die GPU für die Verarbeitung verwendet wird. Der Standardwert hängt vom Wert der Umgebungseinstellung "Prozessortyp" ab.
  • applyGlobalColorBalancing: Ein boolescher Wert, der angibt, ob ein Farbausgleich angewendet wird. Der Standardwert ist "true".
  • orthoEnhanceTexture: Ein boolescher Wert, der angibt, ob Texturen für DSM-Ortho-Produkte korrigiert werden. Der Standardwert ist "false".
  • meshEnhanceTexture: Ein boolescher Wert, der angibt, ob Texturen für Mesh-Produkte korrigiert werden. Der Standardwert ist "true".
  • colorBitDepth: Ein ganzzahliger Wert, der die Farb-Bit-Tiefe von True-Ortho- und DSM-Produkten angibt. Gültige Werte sind 8 und 16. Der Standardwert ist 8 Bit.
  • dsmDepthBuffer: Ein ganzzahliger Wert, mit dem festgelegt wird, wie viele der höchsten Punkte in einer DSM-Zelle zum Berechnen des Höhenwertes für die Zelle verwendet werden. Standardmäßig wird der Wert automatisch ermittelt, er kann jedoch auch manuell angegeben werden.
  • exportAdditionalTFWs: Ein boolescher Wert, der angibt, ob zusätzliche .tfw-Dateien exportiert werden. Der Standardwert ist "true".
  • exportImagePyramidsInTIFFs: Ein boolescher Wert, der angibt, ob Bildpyramiden in .tiff-Dateien exportiert werden. Der Standardwert ist "true".
  • dsmMetaProducts: Gibt die DSM-Metainformationsprodukte an, die in die Ausgabe einbezogen werden sollen. Die Werte können eine beliebige Kombination aus DSM_CELL_POINT_COUNT, DSM_HEIGHT_COLORED, DSM_POINT_COLOR, DSM_POINT_COLOR_INTERPOLATE, DSM_BINARY_MASK, DSM_DISTANCE_MAP, DSM_POINT_MODEL_COUNT, DSM_CELL_SD und DSM_ROUGHNESS enthalten.
  • meshAndTextureFormats: Gibt das Mesh-Ausgabeformat an. Es sind jedoch nur bestimmte Kombinationen aus Mesh- und Texturformaten kompatibel. Die unterstützten Kombinationen sind in der folgenden Tabelle aufgeführt. Standardmäßig werden die Formate OSGB und S3TC verwendet.

    MeshFileFormat	TextureFileFormat
    OSGB	S3TC
    3D_TILES	JPG und S3TC
    SLPK	JPG, JPG und DDS
    LOD_OBJ	JPG, PNG und DDS
    LOD_DAE	JPG, PNG und DDS
    DAE	JPG und PNG
    OBJ	JPG und PNG

  • 3dTilesOverImposeHeightsOnTargetEllipsoid: Ein boolescher Wert, der angibt, ob alle Dimensionen, einschließlich der Höhe, ohne Änderungen in das Koordinatensystem konvertiert werden, das von Cesium (WGS84) verwendet wird. Wenn diese Option "false" lautet, werden die Höhenwerte des Eingabe-Mesh als Höhen über dem Cesium-Ellipsoid interpretiert. Der Standardwert ist "true".
  • 3dTilesExportInPCS: Ein boolescher Wert, der angibt, ob eine Transformation von Koordinatensystemen für das Mesh-Format "3D-Kacheln" durchgeführt wird. Lautet der Wert "false", werden die 3D-Kacheln-Mesh-Ergebnisse in das Koordinatensystem "WGS84" mit EGM96-Geoidhöhen konvertiert. Bei "true" wird für das Mesh-Format "3D-Kacheln" eine Transformation von Koordinatensystemen nur durchgeführt, wenn ein anderes Koordinatensystem erforderlich ist. Der Standardwert ist "false".
  • slpkExportInPCS: Ein boolescher Wert, der angibt, ob eine Transformation von Koordinatensystemen für das SLPK-Mesh-Format durchgeführt wird. Lautet der Wert "false", werden die SLPK-Mesh-Ergebnisse in das Koordinatensystem "WGS84" mit EGM96-Geoidhöhen konvertiert. Bei "true" wird für das SLPK-Mesh-Format eine Transformation von Koordinatensystemen nur durchgeführt, wenn ein anderes Koordinatensystem erforderlich ist. Der Standardwert ist "true".

• Die Standardwerte für den Parameter Rekonstruktionsoptionen werden nur für einen neu erstellten Rekonstruktionsordner verwendet. Falls der Rekonstruktionsordner vorhanden ist, bleiben die Standardwerte des vorhandenen Rekonstruktionsordners bestehen.

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

  {
      "scenario": "AERIAL_NADIR",
      "fwdOverlap": .60,
      "swdOverlap": .30,
      "quality": "HIGH",
      "products": "DSM;TRUE_ORTHO;DSM_MESH",
      "areaX": [424960.019858008, 425010.984614762],
      "areaY": [5132484.30528369, 5132517.9432181],
      "gpuStatus": True,
      "applyGlobalColorBalancing": True,
      "dsmMetaProducts": "DSM_HEIGHT_COLORED;DSM_ROUGHNESS"
  
  }

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 Parameter 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 oben unter Verwendung.	File; String
Szenario (optional)	Gibt den Typ der Bilddaten an, die zum Generieren der Ausgabeprodukte verwendet werden. Standard—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.	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—Eingabebilder werden mit ihrer ursprünglichen (vollen) Auflösung verwendet. Hoch—Eingabebilder werden zweimal reduziert. Mittel—Eingabebilder werden viermal reduziert. Niedrig—Eingabebilder werden achtmal reduziert.	String
Produkte (optional)	Gibt die zu generierenden Produkte an. DSM—Es wird ein DSM generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter Szenario auf Nadir-Luftbild festgelegt ist. True Ortho—Die Bilddaten werden orthorektifiziert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter Szenario auf Nadir-Luftbild festgelegt ist. DSM-Mesh—Es wird ein DSM-Mesh generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter Szenario auf Nadir-Luftbild festgelegt ist. Punktwolke—Es wird eine Bildpunktwolke generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter Szenario auf Standard oder Schrägluftbild festgelegt ist. Mesh—Es wird ein 3D-Mesh generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter Szenario auf Standard 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 einer Eingabe-Shapefile 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. Keine—Bei der Verarbeitung werden alle Bilder verwendet. Automatisch—Die Verarbeitungsausdehnung wird automatisch berechnet. Dies ist die Standardeinstellung.	Feature Layer; File; String
Gewässer-Features (optional)	Ein Polygon, das die Ausdehnung großer Gewässer definiert. Die besten Ergebnisse erzielen Sie mit einem 3D-Feature.	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. Wenn der Parameterwert recon_folder ein vorhandenes Projekt enthält, geben Sie None für den Parameter in_mosaic_dataset an.	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 Parameter 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 oben unter Verwendung.	File; String
scenario (optional)	Gibt den Typ der Bilddaten an, die zum Generieren der Ausgabeprodukte verwendet werden. DEFAULT—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.	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—Eingabebilder werden mit ihrer ursprünglichen (vollen) Auflösung verwendet. HIGH—Eingabebilder werden zweimal reduziert. MEDIUM—Eingabebilder werden viermal reduziert. LOW—Eingabebilder werden achtmal reduziert.	String
products [products,...] (optional)	Gibt die zu generierenden Produkte an. DSM—Es wird ein DSM generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter scenario auf AERIAL_NADIR festgelegt ist. TRUE_ORTHO—Die Bilddaten werden orthorektifiziert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter scenario auf AERIAL_NADIR festgelegt ist. DSM_MESH—Es wird ein DSM-Mesh generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter scenario auf AERIAL_NADIR festgelegt ist. POINT_CLOUD—Es wird eine Bildpunktwolke generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter scenario auf DEFAULT oder AERIAL_OBLIQUE festgelegt ist. MESH—Es wird ein 3D-Mesh generiert. Diese Option ist standardmäßig ausgewählt, wenn der Parameter scenario auf DEFAULT 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 einer Eingabe-Shapefile 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. NONE—Bei der Verarbeitung werden alle Bilder verwendet. AUTO—Die Verarbeitungsausdehnung wird automatisch berechnet. Dies ist die Standardeinstellung.	Feature Layer; File; String
waterbody_features (optional)	Ein Polygon, das die Ausdehnung großer Gewässer definiert. Die besten Ergebnisse erzielen Sie mit einem 3D-Feature.	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, "DEFAULT", 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":"DEFAULT","quality":"HIGH","products":"DSM;TRUE_ORTHO;DSM_MESH","cellSize":0.05,"correctionFeatures":"\\\\shared_location\\RMeTesting.gdb\\CorrectionFeature","meshAndTextureFormats":{"OSGB":"S3TC","SLPK":"JPG","OBJ":"JPG","LOD_DAE":"PNG"},"applyGlobalColorBalancing":true,"areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI"}')

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,	scenario, forward_overlap, side_overlap, out_quality, output_products)

Umgebungen

Ausdehnung, Prozessortyp

Lizenzinformationen

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