Reconstruire une surface (Gestion des données)—ArcGIS Pro

Disponible avec une licence Advanced.

Synthèse

Génère des orthophotos MNS, maillages 2.5D, maillages 3D et nuages de points à partir d’une imagerie ajustée.

Licence :

L’outil Reconstruire une surface n’est disponible que par l’intermédiaire d’une version de test bêta limitée sur invitation uniquement.

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 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.
- applyGlobalColorBalancing : valeur booléenne qui indique si l'équilibrage des couleurs est appliqué.
- orthoEnhanceTexture : valeur booléenne qui indique si les textures sont améliorées pour les produits ortho MNS.
- meshEnahnceTexture : valeur booléenne qui indique si les textures sont améliorées pour les produits de maillage.
- force8BitColor : valeur booléenne qui indique si une couleur 8 bits est utilisée quelle que soit l’entrée.
- 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.
- exportImagePyramidsInTIFFs : valeur booléenne qui indique si les pyramides d’images seront exportées dans des fichiers .tiff.
- 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.
  MeshFileFormat TextureFileFormat
  OSGB
  S3TC
  CESIUM
  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
- cesiumOverImposeHeightsOnTargetEllipsoid : 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 False, les valeurs de hauteur du maillage en entrée sont interprétées en tant que hauteurs au-dessus de l’ellipsoïde Cesium.
- cesiumDracoCompression : valeur booléenne qui indique si la taille de maillage est réduite dans un souci d’amélioration des performances.
- slpkExportInPCS : valeur booléenne qui indique si une transformation du système de coordonnées est effectuée pour le format de maillage SLPK. Par défaut, SURE convertit les résultats du maillage SLPK vers le système de coordonnées WGS 84 avec les hauteurs du géoïde EGM96. En présence de la valeur True, 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. Si cette option a pour valeur True, les WKID des systèmes de coordonnées verticales et horizontales ainsi que les unités du modèle de hauteur et de hauteur doivent être définis.

MeshFileFormat	TextureFileFormat
OSGB	S3TC
CESIUM	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

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

Étiquette	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 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ètre facultatifs.	File; String
Scénario (Facultatif)	Indique le type d’imagerie utilisé pour la génération des produits en sortie. Par défaut—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.	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—Les images en entrée sont utilisées à leur résolution d’origine (maximale). Elevée—Les images en entrée sont échantillonnées deux fois. Moyenne—Les images en entrée sont échantillonnées quatre fois. Faible—Les images en entrée sont échantillonnées huit fois.	String
Produits (Facultatif)	Spécifie les produits à générer. MNS—Un modèle numérique de surface (MNS) est généré. Ce produit est sélectionné par défaut lorsque le paramètre Scénario est défini sur Aérien nadiral. Véritable Ortho—L’imagerie est orthorectifiée. Ce produit est sélectionné par défaut lorsque le paramètre Scénario est défini sur Aérien nadiral. Maillage MNS—Un maillage MNS est généré. Ce produit est sélectionné par défaut lorsque le paramètre Scénario est défini sur Aérien nadiral. Nuages de points—Un nuage de points d’image est généré. Ce produit est sélectionné par défaut lorsque le paramètre Scénario est défini sur Par défaut ou sur Aérien oblique. Maillage—Un maillage 3D est généré. Ce produit est sélectionné 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. Aucun—Toutes les images sont utilisées lors du traitement. Auto—L'étendue du traitement est calculée automatiquement. Il s’agit de l’option par défaut.	Feature Class; 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 un shapefile 3D.	Feature Class; 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 un shapefile 3D.	Feature Class; Feature Layer; File; String

Sortie obtenue

Étiquette	Explication	Type de données
Dossier de reconstruction mis à jour	Dossier de reconstruction en sortie.	Folder

arcpy.management.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é. 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ètre facultatifs.	File; String
scenario (Facultatif)	Indique le type d’imagerie utilisé pour la génération des produits en sortie. DEFAULT—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.	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—Les images en entrée sont utilisées à leur résolution d’origine (maximale). HIGH—Les images en entrée sont échantillonnées deux fois. MEDIUM—Les images en entrée sont échantillonnées quatre fois. LOW—Les images en entrée sont échantillonnées huit fois.	String
products [products,...] (Facultatif)	Spécifie les produits à générer. DSM—Un modèle numérique de surface (MNS) est généré. Ce produit est sélectionné par défaut lorsque le paramètre scenario est défini sur AERIAL_NADIR. TRUE_ORTHO—L’imagerie est orthorectifiée. Ce produit est sélectionné par défaut lorsque le paramètre scenario est défini sur AERIAL_NADIR. DSM_MESH—Un maillage MNS est généré. Ce produit est sélectionné par défaut lorsque le paramètre scenario est défini sur AERIAL_NADIR. POINT_CLOUD—Un nuage de points d’image est généré. Ce produit est sélectionné par défaut lorsque le paramètre scenario est défini sur DEFAULT ou sur AERIAL_OBLIQUE. MESH—Un maillage 3D est généré. Ce produit est sélectionné 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. NONE—Toutes les images sont utilisées lors du traitement. AUTO—L'étendue du traitement est calculée automatiquement. Il s’agit de l’option par défaut.	Feature Class; 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 un shapefile 3D.	Feature Class; 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 un shapefile 3D.	Feature Class; 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 un maillage 3D à partir de l’orthoimagerie.

# Import system modules
import arcpy

3d_surface = arcpy.management.ReconstructSurface(r"C:\SURE.gdb\droneMD", r"C:\RS_output", None, "DEFAULT", 
	   None, None, "HIGH", "TRUE_ORTHO", 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 un MNS, un maillage MNS et une ortho vraie à partir de l’orthoimagerie

# Import system modules
import arcpy

surface = arcpy.management.ReconstructSurface(r"C:\SURE.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,"meshEnhanceTexture":true,"areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI"}')

Exemple 3 d’utilisation de l’outil ReconstructSurface (script autonome)

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

# Import system modules
import arcpy


# Define input parameters
in_mosaic = "C:/SURE.gdb/farm"
out_folder = "C:/ScenarioNadir"
json_file = ""
scenario = "AERIAL_NADIR"
forward_overlap = 60
side_overlap = 30
out_quality = "ULTRA"
output_products = "DSM;TRUE_ORTHO;DSM_MESH"

#Execute - Generate Products
surface = arcpy.management.ReconstructSurface(in_mosaic, out_folder,json_file,
		scenario, forward_overlap, side_overlap, out_quality, output_products)

Environnements

Étendue, Type de processeur

Informations de licence

Basic: Non
Standard: Nécessite Reality Mapping
Advanced: Nécessite Reality Mapping

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?

Synthèse

Licence :

Utilisation

Paramètres

Sortie obtenue

Sortie obtenue

Exemple de code

Environnements

Informations de licence

Rubriques connexes

Dans cette rubrique