3D-набор данных

В этом руководстве показано, как файлы 3D отображаются в превью на Hub, и как структурировать набор данных с ассетами OpenUSD, например, пакетами SimReady для робототехнической симуляции. Файлы 3D не отображаются в Dataset Viewer, но вы можете просмотреть каждый файл на его странице, а для наборов данных SimReady на странице набора данных формируется галерея их ассетов.

Предпросмотр 3D-файлов

Щёлкните по 3D-файлу на вкладке Files and versions набора данных или Storage Bucket, чтобы открыть его в интерактивном 3D-просмотрщике. Вы можете вращать объект, приближать и открывать просмотрщик на весь экран.

Слои и текстуры OpenUSD

USD-актив часто разбит на несколько файлов: корневой файл, который ссылается на подслои, данные, материалы и текстуры. Просмотрщик загружает эти связанные файлы из того же репозитория, поэтому сохраняйте структуру папок, в которой вы создавали актив, и используйте относительные пути для ссылок. Ссылки на абсолютные пути или на файлы вне репозитория не могут быть загружены.

Наборы данных SimReady

SimReady — это спецификация для ассетов OpenUSD, готовых к использованию в симуляции, с физикой, материалами и семантическими метками. Наборы данных, содержащие пакеты SimReady, отображают карточку 3D Assets на своей странице, с количеством пакетов и до 15 миниатюр, выбранных из всего набора данных. Щелчок по миниатюре открывает её файл USD в просмотрщике.

Например, см. nvidia/simready-assets или nvidia/PhysicalAI-SimReady-Warehouse-01.

Структура пакета

Пакет — это папка, содержащая файл com.nvidia.simready.packaging.json. Пакеты могут находиться на любой глубине в репозитории, а папки внутри пакета являются частью этого пакета.

Для отображения карточки пакета требуется миниатюра корневого файла USD. В соответствии с требованием SimReady к миниатюрам, миниатурой для <folder>/<file>.usd является <folder>/.thumbs/256x256/<file>.usd.png (или .usda.png, .usdc.png, .usdz.png), расположенная в папке пакета или в папке на один уровень ниже:

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
    └── ...

• Необязательный файл <file>.usd_light.png отображается в светлой теме, а <file>.usd.png — в тёмной.
• Миниатюры размером более 4 МБ пропускаются.

Карточка обновляется после каждого push в набор данных.

Метка модальности

Наборы данных с 3D-файлами получают модальность 3d, поэтому они отображаются при фильтрации наборов данных по модальности. Вы также можете задать её в карточке набора данных, см. Принудительная установка модальности набора данных.