Créer le contenu d’une couche de scène de maillage intégré (Gestion des données)

Synthèse

Crée le contenu d’une couche de scène (.slpk ou .i3sREST) à partir de données binaires OpenSceneGraph (OSGB).

Utilisation

  • Comme les autres formats graphiques 3D, le format de données OSGB ne prend pas en charge nativement la spécification ou la capture du système de coordonnées du modèle. Généralement, les fichiers OSGB sont générés dans un système de coordonnées cartésiennes qui localise les données avec des coordonnées fixes. Les coordonnées x, y et z du modèle ne sont pas fondamentalement des localisations géographiques, mais des localisations relatives à une origine géométrique arbitraire (0, 0, 0). Un système de coordonnées type utilisé pour de tels modèles est la convention Easting-Northing-UP (ENU), selon laquelle l’axe des x peut être considéré comme une direction d’abscisse, l’axe des y comme une direction d’ordonnée et l’axe des z pointe vers le haut. Pour que vous puissiez géoréférencer correctement le modèle, un fichier supplémentaire de métadonnées .xml, .3mx ou un fichier de géoréférencement (.wld3) est requis. Il doit pouvoir être placé avec le dossier qui contient les fichiers OSGB ou être spécifié via le paramètre Point d’ancrage.

  • Si aucun fichier ne permet de géoréférencer le modèle, vous pouvez créer un fichier .wld3 pour en indiquer l’origine. Ce fichier délimité par des espaces ou des virgules peut être mis en forme en degrés décimaux, comme <From x,y,z> <space> <To x,y,z>.

    Exemple de fichier de géoréférencement pour géoréférencer le modèle. Il suffit qu’une seule paire de coordonnées inclue les coordonnées du point d’ancrage.

    0, 0, 0 -117.17222, 34.0392512, 0
  • Si les fichiers OSGB ont été créés avec un système de coordonnées connu, placez le fichier de projection (.prj) avec le dossier dans lequel se trouvent les fichiers OSGB pour géoréférencer correctement le modèle. Par exemple, si le chemin du fichier en entrée est C:\temp\data et que les fichiers OSGB se trouvent dans les sous-dossiers C:\temp\data\Tile_001 et C:\temp\data\Tile_002, placez le fichier de projection ou le fichier de métadonnées dans le dossier C:\temp\data.

  • Le tableau suivant répertorie les fichiers de géoréférencement à utiliser pour chaque système de coordonnées en entrée du modèle OSGB :

    Système de coordonnées en entréeFichier de géoréférencement

    Système de coordonnées locales (ENU)

    Fichier .xml, .wld3 ou .3mx, ou classe d’entités ponctuelles

    Système de coordonnées projetées

    Fichier de projection (.prj)

    Système de coordonnées géographiques

    Fichier de projection (.prj)

  • Utilisez le paramètre Taille de texture maximale pour définir la taille de texture par nœud dans le paquetage de couche de scène en sortie. Les tailles de texture supérieures à 4096 risquent de ne pas être prises en charge sur toutes les plateformes. Scene Viewer prend en charge une taille de texture maximale de 8192.

  • Les fichiers au format OSGB sont créés par Drone2Map et par des fournisseurs tiers. Pour obtenir la liste complète des fournisseurs, reportez-vous à la rubrique Couche de scène de maillage intégré.

  • Utilisez le paramètre Connexion Cloud cible pour produire en sortie le contenu de couche de scène vers un object store situé dans le Cloud, comme Amazon S3, Azure Blob Storage, Alibaba OSS ou Google Cloud. Ce contenu peut être publié en tant que service de scène et l’emplacement choisi doit être inscrit en tant que data store géré par l’utilisateur dans ArcGIS Enterprise.

  • Vous pouvez créer un fichier de connexion (.acs) à l’aide de l’outil Créer un fichier de connexion au stockage Cloud.

Paramètres

ÉtiquetteExplicationType de données
Jeu de données en entrée

Fichiers au format OSGB ou dossiers contenant les fichiers OSGB, qui seront importés dans le paquetage de couche de scène de maillage intégré. Ce paramètre permet de sélectionner plusieurs fichiers OSGB ou plusieurs dossiers contenant des fichiers OSGB.

File; Folder
Paquetage de couche de scène en sortie
(Facultatif)

Paquetage de couche de scène de maillage intégré qui sera créé. Ce paramètre est requis si aucune valeur n’est indiquée pour le paramètre Connexion Cloud cible.

File
Point d’ancrage
(Facultatif)

Entité ponctuelle ou fichier .3mx, .xml ou .wld3 qui sera utilisé pour positionner le centre du modèle OSGB. Si la classe d’entités comprend plusieurs points, seul le premier sera utilisé pour géoréférencer les données.

Feature Layer; File
Suffixe de fichier
(Facultatif)

Spécifie les fichiers qui seront traités pour le jeu de données en entrée.

  • Tous les fichiers pris en chargeTous les fichiers binaires, quelle que soit leur extension, seront traités afin de déterminer s’ils sont au format OSGB.
  • Fichiers dotés de l’extension *.osgbSeuls les fichiers dotés de l’extension .osgb seront traités.
String
Système de coordonnées en sortie
(Facultatif)

Système de coordonnées du paquetage de couche de scène en sortie. Il peut s’agir de n’importe quel système de coordonnées projetées ou personnalisées. Les systèmes de coordonnées géographiques pris en charge incluent les systèmes WGS84 et China Geodetic Coordinate System 2000. Les systèmes WGS84 et EGM96 Geoid sont respectivement les systèmes de coordonnées horizontales et verticales par défaut. Le système de coordonnées peut être spécifié de l’une des manières suivantes :

  • Spécifiez le chemin d’accès à un fichier .prj.
  • Référencez un jeu de données avec le système de coordonnées approprié.
  • Utilisez un objet arcpy.SpatialReference.

Spatial Reference
Taille de texture maximale
(Facultatif)

Taille de texture maximale en pixels pour chaque nœud de couche de scène.

Long
Optimisation de texture
(Facultatif)

Spécifie les textures qui sont optimisées en fonction de la plateforme cible sur laquelle le paquetage de couche de scène est utilisé.

Attention :

Le traitement des optimisations qui incluent KTX2 peut prendre un certain temps. Pour obtenir plus rapidement des résultats, utilisez les options Bureau ou Aucun.

  • ToutTous les formats de texture, dont JPEG, DXT et KTX2, sont optimisés pour être utilisés sur les plateformes bureautiques, Web et mobiles.
  • BureautiqueLes textures prises en charge par Windows, Linux et Mac, dont JPEG et DXT, sont optimisées pour être utilisées sur des clients AllSource sous Windows et sur des clients bureautiques ArcGIS Runtime sous Windows, Linux et Mac. Il s’agit de l’option par défaut.
  • MobileLes textures prises en charge par Android et iOS, dont JPEG et KTX2, sont optimisées pour être utilisées dans les applications mobiles ArcGIS Runtime.
  • AucunLes textures JPEG sont optimisées pour être utilisées sur les plateformes bureautiques et Web.
String
Connexion Cloud cible
(Facultatif)

Fichier de connexion Cloud cible (.acs) dans lequel le contenu de la couche de scène (.i3sREST) est généré.

Folder
Nom en sortie
(Facultatif)

Nom en sortie du contenu de la couche de scène lorsque la sortie est générée dans un stockage Cloud. Ce paramètre est disponible uniquement si une valeur est indiquée pour le paramètre Connexion Cloud cible.

String

arcpy.management.CreateIntegratedMeshSceneLayerPackage(in_dataset, {out_slpk}, {anchor_point}, {file_suffix}, {out_coor_system}, {max_texture_size}, {texture_optimization}, {target_cloud_connection}, {out_name})
NomExplicationType de données
in_dataset
[in_dataset,...]

Fichiers au format OSGB ou dossiers contenant les fichiers OSGB, qui seront importés dans le paquetage de couche de scène de maillage intégré. Ce paramètre permet de sélectionner plusieurs fichiers OSGB ou plusieurs dossiers contenant des fichiers OSGB.

File; Folder
out_slpk
(Facultatif)

Paquetage de couche de scène de maillage intégré qui sera créé. Ce paramètre est requis si aucune valeur n’est indiquée pour le paramètre Connexion Cloud cible.

File
anchor_point
(Facultatif)

Entité ponctuelle ou fichier .3mx, .xml ou .wld3 qui sera utilisé pour positionner le centre du modèle OSGB. Si la classe d’entités comprend plusieurs points, seul le premier sera utilisé pour géoréférencer les données.

Feature Layer; File
file_suffix
(Facultatif)

Spécifie les fichiers qui seront traités pour le jeu de données en entrée.

  • *Tous les fichiers binaires, quelle que soit leur extension, seront traités afin de déterminer s’ils sont au format OSGB.
  • osgbSeuls les fichiers dotés de l’extension .osgb seront traités.
String
out_coor_system
(Facultatif)

Système de coordonnées du paquetage de couche de scène en sortie. Il peut s’agir de n’importe quel système de coordonnées projetées ou personnalisées. Les systèmes de coordonnées géographiques pris en charge incluent les systèmes WGS84 et China Geodetic Coordinate System 2000. Les systèmes WGS84 et EGM96 Geoid sont respectivement les systèmes de coordonnées horizontales et verticales par défaut. Le système de coordonnées peut être spécifié de l’une des manières suivantes :

  • Spécifiez le chemin d’accès à un fichier .prj.
  • Référencez un jeu de données avec le système de coordonnées approprié.
  • Utilisez un objet arcpy.SpatialReference.

Spatial Reference
max_texture_size
(Facultatif)

Taille de texture maximale en pixels pour chaque nœud de couche de scène.

Long
texture_optimization
(Facultatif)

Spécifie les textures qui sont optimisées en fonction de la plateforme cible sur laquelle le paquetage de couche de scène est utilisé.

Attention :

Le traitement des optimisations qui incluent KTX2 peut prendre un certain temps. Pour obtenir plus rapidement des résultats, utilisez les options Desktop ou None.

  • AllTous les formats de texture, dont JPEG, DXT et KTX2, sont optimisés pour être utilisés sur les plateformes bureautiques, Web et mobiles.
  • DesktopLes textures prises en charge par Windows, Linux et Mac, dont JPEG et DXT, sont optimisées pour être utilisées sur des clients AllSource sous Windows et sur des clients bureautiques ArcGIS Runtime sous Windows, Linux et Mac. Il s’agit de l’option par défaut.
  • MobileLes textures prises en charge par Android et iOS, dont JPEG et KTX2, sont optimisées pour être utilisées dans les applications mobiles ArcGIS Runtime.
  • NoneLes textures JPEG sont optimisées pour être utilisées sur les plateformes bureautiques et Web.
String
target_cloud_connection
(Facultatif)

Fichier de connexion Cloud cible (.acs) dans lequel le contenu de la couche de scène (.i3sREST) est généré.

Folder
out_name
(Facultatif)

Nom en sortie du contenu de la couche de scène lorsque la sortie est générée dans un stockage Cloud. Ce paramètre est disponible uniquement lorsqu’une valeur est spécifiée pour le paramètre target_cloud_connection.

String

Exemple de code

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

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.CreateIntegratedMeshSceneLayerPackage_management(
    "terrain_osgb", "mesh.slpk", "anchor.wld3", "OSGB", arcpy.SpatialReference(4326))
Exemple 2 d’utilisation de la fonction CreateIntegratedMeshSceneLayerPackage (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python avec une entrée à plusieurs dossiers.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.CreateIntegratedMeshSceneLayerPackage_management(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP")
Exemple 3 d’utilisation de la fonction CreateIntegratedMeshSceneLayerPackage (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python avec une sortie dans un stockage Cloud.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.CreateIntegratedMeshSceneLayerPackage_management(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP",
    'AWS.acs', 'mySceneLayer.i3srest')