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.

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 rubrique 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. Par 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.
  • Voici un exemple de la valeur du paramètre Options de reconstruction spécifiée en tant que fichier JSON :

    {
        "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"
    }
  • 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

ÉtiquetteExplicationType 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.

  • DroneL’imagerie en entrée est définie comme étant acquise via des drones ou des caméras terrestres.
  • Aérien nadiralL’imagerie en entrée est définie comme étant acquise via d’importants systèmes de caméras photogrammétriques.
  • Aérien obliqueL’imagerie en entrée est définie comme étant acquise via des systèmes de caméras obliques.
  • SatelliteL’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.

  • UltraLe 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éeLe 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.

  • MNSUn 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 OrthoL’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 et Satellite.
  • Maillage MNSUn 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 pointsUn 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.
  • MaillageUn 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.
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

ÉtiquetteExplicationType 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})
NomExplicationType 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.

  • DRONEL’imagerie en entrée est définie comme étant acquise via des drones ou des caméras terrestres.
  • AERIAL_NADIRL’imagerie en entrée est définie comme étant acquise via d’importants systèmes de caméras photogrammétriques.
  • AERIAL_OBLIQUEL’imagerie en entrée est définie comme étant acquise via des systèmes de caméras obliques.
  • SATELLITEL’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.

  • ULTRALe 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).
  • HIGHLe 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.

  • DSMUn 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_ORTHOL’imagerie est orthorectifiée. Cette option est spécifiée par défaut lorsque le paramètre scenario est défini sur AERIAL_NADIR.
  • DSM_MESHUn 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_CLOUDUn 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.
  • MESHUn 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 sur AERIAL_OBLIQUE.
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

NomExplicationType 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

Rubriques connexes