Jeu de données 3D

Ce guide montre comment les fichiers 3D sont prévisualisés sur le Hub, et comment structurer un jeu de données d’actifs OpenUSD, tels que des packages SimReady pour la simulation robotique. Les fichiers 3D ne sont pas affichés dans le Dataset Viewer, mais vous pouvez prévisualiser chaque fichier sur sa page, et les jeux de données SimReady obtiennent une galerie de leurs actifs sur la page du jeu de données.

Aperçu des fichiers 3D

Cliquez sur un fichier 3D dans l’onglet Fichiers et versions d’un jeu de données ou d’un Storage Bucket pour l’ouvrir dans un visualiseur 3D interactif. Vous pouvez le faire pivoter, zoomer et afficher le visualiseur en plein écran.

Couches et textures OpenUSD

Un actif USD est souvent réparti sur plusieurs fichiers : un fichier racine qui référence des sous-couches, des charges utiles, des matériaux et des textures. Le visionneuse charge ces fichiers référencés depuis le même dépôt, il est donc recommandé de conserver la structure de dossiers utilisée lors de la création de l’actif et d’utiliser des chemins relatifs pour les références. Les références vers des chemins absolus, ou vers des fichiers situés en dehors du dépôt, ne peuvent pas être chargées.

Jeux de données SimReady

SimReady est une spécification pour les assets OpenUSD prêts à l’emploi dans les simulations, avec physique, matériaux et étiquettes sémantiques. Les jeux de données contenant des paquets SimReady affichent une carte 3D Assets sur leur page, indiquant le nombre de paquets et jusqu’à 15 vignettes échantillonnées dans l’ensemble du jeu de données. Un clic sur une vignette ouvre son fichier USD dans le visualiseur.

Par exemple, voir nvidia/simready-assets ou nvidia/PhysicalAI-SimReady-Warehouse-01.

Structure du package

Un package est un dossier contenant un fichier com.nvidia.simready.packaging.json. Les packages peuvent se trouver à n'importe quelle profondeur dans le dépôt, et les dossiers situés à l'intérieur d'un package en font partie.

Chaque package a besoin d’une miniature de son fichier USD racine pour s’afficher dans la carte. Conformément à l’exigence SimReady pour les miniatures, la miniature de <folder>/<file>.usd est <folder>/.thumbs/256x256/<file>.usd.png (ou .usda.png, .usdc.png, .usdz.png), dans le dossier du package ou dans un dossier situé juste en dessous :

my_dataset_repository/
├── IV_pole_a01
│   ├── com.nvidia.simready.packaging.json
│   └── simready_usd
│       ├── .thumbs
│       │   └── 256x256
│       │       ├── sm_IV_pole_a01_01.usd.png
│       │       └── sm_IV_pole_a01_01.usd_light.png
│       ├── sm_IV_pole_a01_01.usd
│       └── payloads
│           └── ...
└── IV_pole_a02
    ├── com.nvidia.simready.packaging.json
    └── ...

• Un fichier <file>.usd_light.png facultatif est affiché en mode clair, et <file>.usd.png en mode sombre.
• Les vignettes de plus de 4 Mo sont ignorées.

La carte est mise à jour après chaque push vers le jeu de données.

Étiquette de modalité

Les jeux de données contenant des fichiers 3D reçoivent la modalité 3d, ils apparaissent donc lors du filtrage des jeux de données par modalité. Vous pouvez également la définir dans la carte du jeu de données, voir Forcer la définition d'une modalité de jeu de données.