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 2,5D, des maillages 3D et des nuages de points à partir d’une imagerie ajustée.

Licence :

L’outil Reconstruire une surface n’est disponible qu’avec une licence ArcGIS Reality for ArcGIS Pro, associée à une licence ArcGIS Standard ou Advanced.

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 dans Reality Mapping, reportez-vous à la rubrique de l’outil Calculer l’ajustement de bloc.

  • Après l’exécution de l’outil, un fichier Project.spr est créé dans la valeur de Dossier de reconstruction. Si la valeur de Dossier de reconstruction est à nouveau utilisée, la présence du fichier Project.spr entraîne le masquage du paramètre Jeu de données mosaïque en entrée dans la fenêtre Géotraitement. Cela vous permet de générer des produits supplémentaires sans recalcul des informations à partir de la mosaïque en entrée, car elles sont stockées dans le fichier Project.spr. Si vous souhaitez générer des produits supplémentaires pour le même projet, exécutez à nouveau l’outil.

  • 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, spécifiez 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 la 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.

    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.
    • srs : système de coordonnées géographiques d’un projet au format WKT.
    • 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.
    • cellSizeMultiplicator : valeur scalaire de la taille d’une cellule. Cette valeur est automatiquement estimée, mais il est possible de la définir manuellement. Les valeurs admises sont AUTO ou de type double.
    • areaX : coordonnées x de l’étendue en sortie.
    • areaY : coordonnées y de l’étendue en sortie.
    • areaZ : coordonnées z de l’étendue en sortie.
    • areaFeatures : zone d’intérêt.
    • waterbodyFeatures : polygone qui spécifie l’étendue des plans d’eau de grande taille.
    • correctionFeatures : polygone qui spécifie l’étendue de toutes les surfaces autres que des plans d’eau.
    • gpuStatus : valeur booléenne qui indique si le GPU est utilisé pour le traitement. La valeur par défaut dépend de la valeur de l’environnement Type de processeur.
    • applyGlobalColorBalancing : valeur booléenne qui indique si l'équilibrage des couleurs est appliqué. Par défaut, cette propriété est définie sur vrai.
    • orthoEnhanceTexture : valeur booléenne qui indique si les textures sont améliorées pour les produits ortho MNS. Par défaut, cette propriété est définie sur faux.
    • meshEnhanceTexture : valeur booléenne qui indique si les textures sont améliorées pour les produits de maillage. Par défaut, cette propriété est définie sur vrai.
    • colorBitDepth - Valeur d’entier qui indique la profondeur de bits de couleur des produits Ortho vraie et MNS. Les valeurs valides sont 8 et 16. La valeur par défaut est 8 bits.
    • dsmDepthBuffer : valeur entière qui définit le nombre de points les plus hauts dans une cellule MNS à utiliser pour calculer la valeur de hauteur de cette cellule. Par défaut, cette valeur est déterminée automatiquement, mais elle peut également être spécifiée manuellement.
    • exportAdditionalTFWs : valeur booléenne qui indique si des fichiers .tfw supplémentaires seront exportés. Par défaut, cette propriété est définie sur vrai.
    • exportImagePyramidsInTIFFs : valeur booléenne qui indique si les pyramides d’images seront exportées dans des fichiers .tiff. Par défaut, cette propriété est définie sur vrai.
    • dsmMetaProducts : indique les produits de métadonnées MNS à inclure dans la sortie. Les valeurs peuvent inclure toute combinaison de 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 et DSM_ROUGHNESS.
    • meshAndTextureFormats : indique le format de maillage en sortie. Seules des combinaisons spécifiques de formats de texture et de maillage sont compatibles. Les combinaisons prises en charge sont répertoriées dans la table ci-après. Les formats OSGB et S3TC sont utilisés par défaut.

      MeshFileFormatTextureFileFormat

      OSGB

      S3TC

      3D_TILES

      JPG et S3TC

      SLPK

      JPG, JPG et DDS

      LOD_OBJ

      JPG, PNG et DDS

      LOD_DAE

      JPG, PNG et DDS

      DAE

      JPG et PNG

      OBJ

      JPG et PNG

    • 3dTilesOverImposeHeightsOnTargetEllipsoid : Valeur booléenne qui indique si toutes les dimensions incluant la hauteur sont converties vers le système de coordonnées utilisé par Cesium (WGS 84) sans modification. Si cette option est définie sur faux, les valeurs de hauteur du maillage en entrée sont interprétées en tant que hauteurs au-dessus de l’ellipsoïde Cesium. Par défaut, cette propriété est définie sur vrai.
    • 3dTilesExportInPCS : valeur booléenne qui indique si une transformation du système de coordonnées est effectuée pour le format de maillage Tuiles 3D. Si la propriété est fausse, les résultats du maillage Tuiles 3D sont convertis dans le système de coordonnées WGS 84 avec les hauteurs du géoïde EGM96. Pour la valeur vraie, aucune transformation du système de coordonnées n’est effectuée pour le format de maillage Tuiles 3D , sauf lorsqu’un système de coordonnées différent est requis. Par défaut, cette propriété est définie sur faux.
    • slpkExportInPCS : valeur booléenne qui indique si une transformation du système de coordonnées est effectuée pour le format de maillage SLPK. Si la propriété est fausse, les résultats du maillage SLPK sont convertis dans le système de coordonnées WGS 84 avec les hauteurs du géoïde EGM96. Pour la valeur vraie, aucune transformation du système de coordonnées n’est effectuée pour le format de maillage SLPK, sauf lorsqu’un système de coordonnées différent est requis. Par défaut, cette propriété est définie sur vrai.
  • Les valeurs par défaut du paramètre Options de reconstruction ne sont utilisées que pour un dossier de reconstruction récemment créé. Les valeurs par défaut du dossier de reconstruction existant, le cas échéant, sont conservées.

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

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

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 ce paramètre 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ètres facultatifs. Pour voir la liste des options, reportez-vous à Utilisations ci-dessus.

File; String
Scénario
(Facultatif)

Indique le type d’imagerie utilisé pour la génération des produits en sortie.

  • Par défautL’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.
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.

  • UltraLes images en entrée sont utilisées à leur résolution d’origine (maximale).
  • ElevéeLes images en entrée sont échantillonnées deux fois.
  • MoyenneLes images en entrée sont échantillonnées quatre fois.
  • FaibleLes images en entrée sont échantillonnées huit fois.
String
Produits
(Facultatif)

Spécifie les produits à générer.

  • MNSUn MNS est généré. Cette option est sélectionnée par défaut lorsque le paramètre Scénario est défini sur Aérien nadiral.
  • Véritable OrthoL’imagerie est orthorectifiée. Cette option est sélectionnée par défaut lorsque le paramètre Scénario est défini sur Aérien nadiral.
  • Maillage MNSUn maillage MNS est généré. Cette option est sélectionnée par défaut lorsque le paramètre Scénario est défini sur Aérien nadiral.
  • Nuage de pointsUn nuage de points d’image est généré. Cette option est sélectionnée par défaut lorsque le paramètre Scénario est défini sur Par défaut ou sur Aérien oblique.
  • MaillageUn maillage 3D est généré. Cette option est sélectionnée par défaut lorsque le paramètre Scénario est défini sur Par défaut 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 shapefile 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.

  • AucunToutes les images sont utilisées lors du traitement.
  • AutoL'étendue du traitement est calculée automatiquement. Il s’agit de l’option par défaut.
Feature Layer; File; String
Entités de plan d’eau
(Facultatif)

Polygone qui définit l’étendue des plans d’eau de grande taille. Pour optimiser les résultats, utilisez 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é.

Si la valeur du paramètre recon_folder contient un projet existant, spécifiez None pour le paramètre in_mosaic_dataset.

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 ce paramètre 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ètres facultatifs. Pour voir la liste des options, reportez-vous à Utilisations ci-dessus.

File; String
scenario
(Facultatif)

Indique le type d’imagerie utilisé pour la génération des produits en sortie.

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

  • ULTRALes images en entrée sont utilisées à leur résolution d’origine (maximale).
  • HIGHLes images en entrée sont échantillonnées deux fois.
  • MEDIUMLes images en entrée sont échantillonnées quatre fois.
  • LOWLes images en entrée sont échantillonnées huit fois.
String
products
[products,...]
(Facultatif)

Spécifie les produits à générer.

  • DSMUn MNS est généré. Cette option est sélectionnée par défaut lorsque le paramètre scenario est défini sur AERIAL_NADIR.
  • TRUE_ORTHOL’imagerie est orthorectifiée. Cette option est sélectionné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 sélectionnée par défaut lorsque le paramètre scenario est défini sur AERIAL_NADIR.
  • POINT_CLOUDUn nuage de points d’image est généré. Cette option est sélectionnée par défaut lorsque le paramètre scenario est défini sur DEFAULT ou sur AERIAL_OBLIQUE.
  • MESHUn maillage 3D est généré. Cette option est sélectionnée par défaut lorsque le paramètre scenario est défini sur DEFAULT 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 shapefile 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.

  • NONEToutes les images sont utilisées lors du traitement.
  • AUTOL'étendue du traitement est calculée automatiquement. Il s’agit de l’option par défaut.
Feature Layer; File; String
waterbody_features
(Facultatif)

Polygone qui définit l’étendue des plans d’eau de grande taille. Pour optimiser les résultats, utilisez 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, "DEFAULT", None, None, "HIGH", "POINT_CLOUD;MESH", 0.1, r"\\shared_location\RMeTesting.gdb\AOI", None, r"\\shared_location\RMTesting.gdb\CorrectionFeature")
Exemple 1 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":"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"}')
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,	scenario, forward_overlap, side_overlap, out_quality, output_products)

Informations de licence

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

Rubriques connexes