Conjunto de datos 3D

Esta guía muestra cómo se previsualizan los archivos 3D en el Hub y cómo estructurar un conjunto de datos de activos OpenUSD, como los paquetes SimReady para simulación de robótica. Los archivos 3D no se muestran en el Dataset Viewer, pero puedes previsualizar cada archivo en su página, y los conjuntos de datos SimReady obtienen una galería de sus activos en la página del conjunto de datos.

Vista previa de archivos 3D

Haz clic en un archivo 3D en la pestaña Files and versions de un dataset o Storage Bucket para abrirlo en un visor 3D interactivo. Puedes rotar, hacer zoom y abrir el visor a pantalla completa.

Capas y texturas de OpenUSD

Un activo USD suele dividirse en varios archivos: un archivo raíz que hace referencia a subcapas, cargas, materiales y texturas. El visor carga estos archivos referenciados desde el mismo repositorio, por lo que debe mantener la estructura de carpetas con la que creó el activo y usar rutas relativas para las referencias. No se pueden cargar referencias a rutas absolutas ni a archivos fuera del repositorio.

Conjuntos de datos SimReady

SimReady es una especificación para activos de OpenUSD listos para usar en simulación, con física, materiales y etiquetas semánticas. Los conjuntos de datos que contienen paquetes SimReady muestran una tarjeta 3D Assets en su página, con el número de paquetes y hasta 15 miniaturas muestreadas en todo el conjunto de datos. Al hacer clic en una miniatura, se abre su archivo USD en el visor.

Por ejemplo, consulte nvidia/simready-assets o nvidia/PhysicalAI-SimReady-Warehouse-01.

Estructura del paquete

Un paquete es una carpeta que contiene un archivo com.nvidia.simready.packaging.json. Los paquetes pueden estar a cualquier profundidad en el repositorio, y las carpetas dentro de un paquete forman parte de ese paquete.

Cada paquete necesita una miniatura de su archivo USD raíz para aparecer en la tarjeta. Siguiendo el requisito de SimReady para las miniaturas, la miniatura de <folder>/<file>.usd es <folder>/.thumbs/256x256/<file>.usd.png (o .usda.png, .usdc.png, .usdz.png), en la carpeta del paquete o en una carpeta inferior:

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 archivo opcional <file>.usd_light.png se muestra en modo claro, y <file>.usd.png en modo oscuro.
• Las miniaturas de más de 4 MB se omiten.

La tarjeta se actualiza después de cada push al conjunto de datos.

Etiqueta de modalidad

Los conjuntos de datos con archivos 3D reciben la modalidad 3d, por lo que aparecen al filtrar conjuntos de datos por modalidad. También puedes configurarla en la tarjeta del conjunto de datos, consulta Forzar la configuración de una modalidad de conjunto de datos.