Reconstruire une surface (Reality Mapping)

Disponible avec une licence Advanced.

Disponible pour une organisation ArcGIS disposant de la licence ArcGIS Reality.

Synthèse

Génère un modèle de surface numérique (MNS), des ortho vraies, des maillages MNS, des maillages 3D 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 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 Dossier de reconstruction. Si l’outil est à nouveau exécuté avec la même valeur de paramètre Dossier de reconstruction, la présence du fichier reality.json définit les paramètres Scénario, Qualité, Entités de plan d’eau et 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 Entités de plan d’eau et Entités de correction, définissez ces valeurs de paramètre sur NONE.

• En cas de modification du jeu de données mosaïque, indiquez un autre dossier pour 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 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 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 Options de reconstruction et un autre paramètre facultatif, la valeur du paramètre facultatif remplace la valeur de Options de reconstruction.

  La liste suivante définit les mots-clés utilisés par le paramètre 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 recouvrement longitudinal (sur la bande) entre les images. Ce mot-clé est utilisé lorsque scenario est défini sur AERIAL_NADIR.
  • swdOverlap : pourcentage de recouvrement latéral (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.
  • 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 depuis le système de coordonnées du projet dans le 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.

• Voici un exemple de la valeur du paramètre Options de reconstruction spécifiée en tant que fichier JSON :

  {
    "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 Produits est défini sur 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 Par défaut du paramètre Scénario a été remplacée par l’option Drone. Par ailleurs, les options de paramètres suivantes sont obsolètes :

• Paramètre Qualité : les options Moyen et Faible sont obsolètes.
• Paramètre Zone d’intérêt : l’option Auto est obsolète.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Jeu 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 Scénario est défini sur 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 Scénario est défini sur 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.	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 Scénario est défini sur Aérien nadiral ou Satellite. Véritable Ortho—L’imagerie est orthorectifiée. Cette option est spécifiée par défaut lorsque le paramètre Scénario est défini sur 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 Scénario est défini sur Aérien nadiral ou Satellite. Nuage 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 Scénario est défini sur Drone ou sur Aérien oblique. Maillage—Un maillage 3D est généré. Cette option est spécifiée par défaut lorsque le paramètre Scénario est défini sur Drone ou sur 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 obtenue

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

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.	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, 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 obtenue

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

Exemple de code

Exemple 1 d’utilisation de l’outil 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 l’outil 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 l’outil 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" 

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