Reconstruire une surface (Outils Reality Mapping)

Résumé

Génère un modèle numérique de surface (MNS), des ortho vraies, des maillages MNS, des maillages 3D, des Gaussian Splats et des nuages de points à partir d’une imagerie ajustée dans un jeu de données mosaïque.

Utilisation

La valeur du paramètre Input Mosaic Dataset (Jeu de données mosaïque en entrée) doit être ajustée au préalable. Pour plus d’informations sur l’ajustement de bloc en orthocartographie, reportez-vous à la documentation de l’outil Calculer l’ajustement de bloc.
Lorsque l’outil est exécuté, un fichier reality.json est créé dans la valeur du paramètre Reconstruction Folder (Dossier de reconstruction). Si l’outil est à nouveau exécuté avec la même valeur de paramètre Reconstruction Folder (Dossier de reconstruction), la présence du fichier reality.json définit les paramètres Scenario (Scénario), Quality (Qualité), Waterbody Features (Entités de plan d’eau) et Correction Features (Entités de correction) en fonction des valeurs de paramètre de l’exécution précédente. Pour générer des produits supplémentaires pour le même projet, exécutez à nouveau l’outil.

Remarque :

Pour réinitialiser les valeurs utilisées pour les paramètres Waterbody Features (Entités de plan d’eau) et Correction Features (Entités de correction), définissez ces valeurs de paramètre sur NONE.
En cas de modification du jeu de données mosaïque en entrée, indiquez un autre dossier pour la valeur Reconstruction Folder (Dossier de reconstruction). Pour générer des produits qui reflètent les modifications apportées au jeu de données mosaïque, indiquez ce nouvel emplacement et exécutez à nouveau l’outil.
Utilisez le paramètre Area of Interest (Zone d’intérêt) afin d’accélérer le traitement et la génération de produits pour un sous-ensemble d’images dans le jeu de données mosaïque en entrée.
Si le paramètre Reconstruction Options (Options de reconstruction) est spécifié, les propriétés du fichier .json ou de la chaîne JSON définissent les valeurs par défaut des autres paramètre facultatifs.

Remarque :

Si la même propriété est définie via le paramètre Reconstruction Options (Options de reconstruction) et un autre paramètre facultatif, la valeur du paramètre facultatif remplace la valeur du paramètre Reconstruction Options (Options de reconstruction).

La liste suivante définit les mots-clés utilisés par le paramètre Reconstruction Options (Options de reconstruction) en tant que fichier .json ou chaîne JSON :
- scenario—Indique le type d’imagerie utilisé pour la génération des produits en sortie.
- fwdOverlap—Pourcentage de superposition longitudinale (sur la bande) entre les images. Ce mot-clé est utilisé lorsque scenario est défini sur AERIAL_NADIR.
- swdOverlap—Pourcentage de superposition latérale (entre les bandes) entre les images. Ce mot-clé est utilisé lorsque scenario est défini sur AERIAL_NADIR.
- quality—Indique la qualité du produit final.
- products—Spécifie les produits à générer.
- tileSize—Taille de tuile. Les valeurs admises sont AUTO ou de type double.
- cellSize—Taille de cellule du produit raster en sortie. Cette valeur est automatiquement estimée, mais il est possible de la définir manuellement. Les valeurs admises sont AUTO ou de type double.
- tilingOrigin—Coordonnées cartographiques de l’origine du tuilage. Exemple : "tilingOrigin": [0, 0].
- areaFeatures—Zone d’intérêt
- waterbodyFeatures—Polygone qui définit l’étendue des plans d’eau de grande taille.
- coarseWaterbody—Une valeur booléenne qui spécifie l’entité de plan d’eau est un plan d’eau précis ou un plan d’eau grossier. Si la valeur False est définie pour ce paramètre, le plan d’eau est précis. Si la valeur True est définie pour ce paramètre, le plan d’eau est grossier. La valeur par défaut est True.
- correctionFeatures—Polygone qui définit l’étendue de toutes les surfaces autres que des plans d’eau.
- dsmMetaProducts—Indique les produits de métadonnées MNS à inclure dans la sortie. Les valeurs peuvent inclure toute combinaison de DSM_BINARY_MASK, DSM_DISTANCE_MAP et DSM_POINT_MODEL_COUNT.
- meshFormats—Indique le format de maillage en sortie. Les valeurs valides sont SLPK, OBJ et 3D_TILES. Exemple : "meshFormats": "SLPK;OBJ;3D_TILES". La valeur par défaut est SLPK.
- processingFolder—Emplacement de traitement dans l’espace de stockage local. Le dossier temporaire local est la valeur par défaut. Le contenu généré sera supprimé à l’issue du traitement.
- resultsFolder—Emplacement en sortie des résultats du traitement. Le dossier de reconstruction est la valeur par défaut.
- meshSettings—Spécifie les paramètres de maillage pour les produits de maillage. Les paramètres de maillage pris en charge sont srs, exportInLocalCoordinateSystem, exportAsSingleFile et keepHeightsOfInputCoordinateSystem. Différents formats de maillage prennent en charge différents paramètres de maillage. Les paramètres de maillage peuvent être définis globalement ou selon le format. Par exemple, lorsque { "dsmMeshSettings": { "srs": "4326;5773" } } est défini, le maillage du format SLPK et le maillage du format 3D_Tiles sont générés dans la référence spatiale spécifiée. Si vous voulez que le maillage du format SLPK et le maillage du format 3D_Tiles soient générés chacun dans une référence spatiale différente, définissez les paramètres de maillage selon le format.
  - srs—Référence spatiale du format SLPK. La valeur srs peut être une paire d’identifiants WKID du système de coordonnées horizontales et du système de coordonnées verticales, par exemple "4326;5773" ou WKT. La première valeur est le système de coordonnées horizontales et la valeur srs peut être spécifiée si la transformation du système de coordonnées du projet en système de coordonnées sélectionné est prise en charge. Si la référence spatiale cible est un système de coordonnées géographique, seul WGS84 est pris en charge actuellement. La valeur par défaut est la référence spatiale du jeu de données mosaïque.
  - exportInLocalCoordinateSystem—Valeur booléenne qui indique si le maillage est exporté vers un système de coordonnées locales. Cette option est disponible pour le format OBJ. Si la valeur définie est True, le maillage est exporté dans un système de coordonnées locales. Si la valeur définie est False, le maillage est exporté dans le système de coordonnées de la reconstruction. La valeur par défaut est False.
  - exportAsSingleFile—Valeur booléenne qui indique si le maillage est exporté sous forme d’un fichier unique ou sous forme de plusieurs fichiers .obj. Cette option est disponible uniquement pour le format OBJ. Si la valeur définie est True, le maillage est exporté en tant que fichier .obj unique. Si la valeur définie est False, le maillage est exporté sous forme de plusieurs fichiers .obj. La valeur par défaut est False.
- dsmMeshSettings—Spécifie les paramètres de maillage pour le produit de maillage MNS. Les paramètres de maillage MNS pris en charge sont identiques à ceux de meshSettings ci-dessus.
- tiePointTablePath—Spécifie le chemin d’accès à la table des points de rattachement.
- slnPointTablePath—Spécifie le chemin d’accès à la table des points de solution.
Voici un exemple de la valeur du paramètre Reconstruction Options (Options de reconstruction) spécifiée en tant que fichier JSON :

<!--```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" }
Les données de drone multispectrales prennent uniquement en charge la génération des produits MNS et Ortho vraie ; elles ne prennent pas en charge la génération des produits Nuage de points ou Maillage.
Lorsque le paramètre Products (Produits) est défini sur DSM (MNS), l’outil crée un jeu de données LAS ou un dossier LAS en sortie dans le dossier ...\Results\DSM\las. Le jeu de données ou le dossier LAS peut être utilisé pour générer un modèle numérique de terrain (MNT) à l’aide de l’outil Interpoler à partir d’un nuage de points.
Héritage :

Dans ArcGIS Pro 3.2, l’option Default (Par défaut) du paramètre Scenario (Scénario) a été remplacée par l’option Drone. Par ailleurs, les options de paramètres suivantes sont obsolètes :
- Paramètre Quality (Qualité) : les options Medium (Moyenne) et Low (Faible) sont obsolètes.
- Paramètre Area of Interest (Zone d’intérêt) : l’option Auto est obsolète.

Etiqueter	Explication	Type de données
Mosaïque en entrée	Jeu de données mosaïque en entrée ajusté.	Mosaic Dataset; Mosaic Layer
Dossier de reconstruction	Dossier du jeu de données en sortie.	Folder
Options de reconstruction (Facultatif)	Fichier `.json` ou chaîne JSON qui spécifie les valeurs des paramètres de l’outil. Si la valeur de ce paramètre est indiquée, les propriétés du fichier `.json` ou de la chaîne JSON définissent les valeurs par défaut des autres paramètres facultatifs. Pour voir la liste des options, reportez-vous à la section Utilisations.	File; String
Scénario (Facultatif)	Indique le type d’imagerie utilisé pour la génération des produits en sortie. Drone—L’imagerie en entrée est définie comme étant acquise via des drones ou des caméras terrestres. Aérien nadiral—L’imagerie en entrée est définie comme étant acquise via d’importants systèmes de caméras photogrammétriques. Aérien oblique—L’imagerie en entrée est définie comme étant acquise via des systèmes de caméras obliques. Satellite—L’imagerie en entrée est définie comme étant acquise via un satellite.	String
Recouvrement longitudinal (Facultatif)	Pourcentage de recouvrement longitudinal (sur la bande) utilisé entre les images. La valeur par défaut est 60. Ce paramètre est activé lorsque le paramètre Scenario (Scénario) est défini sur Aerial Nadir (Aérien nadiral).	Long
Recouvrement latéral (Facultatif)	Pourcentage de recouvrement latéral (entre les bandes) utilisé entre les images. La valeur par défaut est 30. Ce paramètre est activé lorsque le paramètre Scenario (Scénario) est défini sur Aerial Nadir (Aérien nadiral).	Long
Qualité (Facultatif)	Indique la qualité du produit final. Ultra—Le niveau le plus élevé de la densité du nuage de points est utilisé. Les images en entrée sont utilisées à leur résolution d’origine (maximale). Elevée—Le niveau élevé de la densité du nuage de points est utilisé. Les images en entrée sont échantillonnées deux fois. Rapide—La qualité de génération du produit sera ajustée pour s’adapter aux processus demandant un résultat rapide.	String
Produits (Facultatif)	Spécifie les produits à générer. MNS—Un MNS est généré. Cette option est spécifiée par défaut lorsque le paramètre Scenario (Scénario) est défini sur Aerial Nadir (Aérien nadiral) ou Satellite. Ortho vraie—L’imagerie est orthorectifiée. Cette option est spécifiée par défaut lorsque le paramètre Scenario (Scénario) est défini sur Aerial Nadir (Aérien nadiral) ou Satellite. Maillage MNS—Un maillage MNS est généré. Cette option est spécifiée par défaut lorsque le paramètre Scenario (Scénario) est défini sur Aerial Nadir (Aérien nadiral) ou Satellite. Nuages de points—Un nuage de points d’image est généré. Cette option est spécifiée par défaut lorsque le paramètre Scenario (Scénario) est défini sur Drone ou Aerial Oblique (Aérien oblique). Maillage—Un maillage 3D est généré. Cette option est spécifiée par défaut lorsque le paramètre Scenario (Scénario) est défini sur Drone ou Aerial Oblique (Aérien oblique). Gaussian Splats—Les points sont rendus dans un nuage de points 3D de forte densité avec une distribution gaussienne et le Machine Learning est utilisé pour reconstruire des scènes 3D haute-fidélité qui capturent des détails fins comme les structures fines.	String
Taille de cellule (Facultatif)	Taille de cellule du produit en sortie.	Double; String
Zone d’intérêt (Facultatif)	Zone d’intérêt utilisée pour la sélection des images à traiter. La zone d’intérêt peut être calculée automatiquement ou définie à l’aide d’un polygone en entrée. Si la valeur contient des géométries 3D, le composant z est ignoré. Si la valeur inclut des entités superposées, l’union de ces entités est calculée.	Feature Layer; File; String
Entités de plan d’eau (Facultatif)	Polygone qui définit l’étendue des plans d’eau de grande taille. La valeur doit être une entité 3D.	Feature Layer; File; String
Entités de correction (Facultatif)	Polygone qui définit l’étendue de toutes les surfaces autres que des plans d’eau. La valeur doit être une entité 3D.	Feature Layer; File; String

Sortie dérivée

Etiqueter	Explication	Type de données
Dossier de reconstruction mis à jour	Dossier de reconstruction en sortie.	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})

Nom	Explication	Type de données
in_mosaic_dataset	Jeu de données mosaïque en entrée ajusté.	Mosaic Dataset; Mosaic Layer
recon_folder	Dossier du jeu de données en sortie.	Folder
recon_options (Facultatif)	Fichier `.json` ou chaîne JSON qui spécifie les valeurs des paramètres de l’outil. Si la valeur de ce paramètre est indiquée, les propriétés du fichier `.json` ou de la chaîne JSON définissent les valeurs par défaut des autres paramètres facultatifs. Pour voir la liste des options, reportez-vous à la section Utilisations.	File; String
scenario (Facultatif)	Indique le type d’imagerie utilisé pour la génération des produits en sortie. `DRONE`—L’imagerie en entrée est définie comme étant acquise via des drones ou des caméras terrestres. `AERIAL_NADIR`—L’imagerie en entrée est définie comme étant acquise via d’importants systèmes de caméras photogrammétriques. `AERIAL_OBLIQUE`—L’imagerie en entrée est définie comme étant acquise via des systèmes de caméras obliques. `SATELLITE`—L’imagerie en entrée est définie comme étant acquise via un satellite.	String
fwd_overlap (Facultatif)	Pourcentage de recouvrement longitudinal (sur la bande) utilisé entre les images. La valeur par défaut est 60. Ce paramètre est activé lorsque le paramètre `scenario` est défini sur `AERIAL_NADIR`.	Long
swd_overlap (Facultatif)	Pourcentage de recouvrement latéral (entre les bandes) utilisé entre les images. La valeur par défaut est 30. Ce paramètre est activé lorsque le paramètre `scenario` est défini sur `AERIAL_NADIR`.	Long
quality (Facultatif)	Indique la qualité du produit final. `ULTRA`—Le niveau le plus élevé de la densité du nuage de points est utilisé. Les images en entrée sont utilisées à leur résolution d’origine (maximale). `HIGH`—Le niveau élevé de la densité du nuage de points est utilisé. Les images en entrée sont échantillonnées deux fois. `RAPID`—La qualité de génération du produit sera ajustée pour s’adapter aux processus demandant un résultat rapide.	String
products [products,...] (Facultatif)	Spécifie les produits à générer. `DSM`—Un MNS est généré. Cette option est spécifiée par défaut lorsque le paramètre `scenario` est défini sur `AERIAL_NADIR` ou `SATELLITE`. `TRUE_ORTHO`—L’imagerie est orthorectifiée. Cette option est spécifiée par défaut lorsque le paramètre `scenario` est défini sur `AERIAL_NADIR` ou `SATELLITE`. `DSM_MESH`—Un maillage MNS est généré. Cette option est spécifiée par défaut lorsque le paramètre `scenario` est défini sur `AERIAL_NADIR` ou `SATELLITE`. `POINT_CLOUD`—Un nuage de points d’image est généré. Cette option est spécifiée par défaut lorsque le paramètre `scenario` est défini sur `DRONE` ou `AERIAL_OBLIQUE`. `MESH`—Un maillage 3D est généré. Cette option est spécifiée par défaut lorsque le paramètre `scenario` est défini sur `DRONE` ou `AERIAL_OBLIQUE`. `GAUSSIAN_SPLATS`—Les points sont rendus dans un nuage de points 3D de forte densité avec une distribution gaussienne et le Machine Learning est utilisé pour reconstruire des scènes 3D haute-fidélité qui capturent des détails fins comme les structures fines.	String
cell_size (Facultatif)	Taille de cellule du produit en sortie.	Double; String
aoi (Facultatif)	Zone d’intérêt utilisée pour la sélection des images à traiter. La zone d’intérêt peut être calculée automatiquement ou définie à l’aide d’un polygone en entrée. Si la valeur contient des géométries 3D, le composant z est ignoré. Si la valeur inclut des entités superposées, l’union de ces entités est calculée.	Feature Layer; File; String
waterbody_features (Facultatif)	Polygone qui définit l’étendue des plans d’eau de grande taille. La valeur doit être une entité 3D.	Feature Layer; File; String
correction_features (Facultatif)	Polygone qui définit l’étendue de toutes les surfaces autres que des plans d’eau. La valeur doit être une entité 3D.	Feature Layer; File; String

Sortie dérivée

Nom	Explication	Type de données
derived_recon_folder	Dossier de reconstruction en sortie.	Folder

Exemple de code

Exemple 1 d’utilisation de la fonction ReconstructSurface (fenêtre Python)

Cet exemple crée des produits 3D à partir d’un jeu de données mosaïque ajusté.

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

Exemple 2 d’utilisation de la fonction ReconstructSurface (fenêtre Python)

Cet exemple crée des produits MNS, Maillage MNS et Ortho vraie à partir d’une chaîne JSON.

# 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"}')

Exemple 3 d’utilisation de la fonction ReconstructSurface (script autonome)

Cet exemple crée plusieurs produits 2D à partir d’une imagerie aérienne nadirale.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Non
Standard: Nécessite ArcGIS Reality for ArcGIS Pro
Advanced: Nécessite ArcGIS Reality for ArcGIS Pro

Reconstruire une surface (Outils Reality Mapping)

Résumé

Utilisation

Remarque :

Remarque :

Héritage :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes