3D 数据集

本指南介绍了 3D 文件在 Hub 上的预览方式，以及如何组织包含 OpenUSD 资产的（例如用于机器人仿真的 SimReady 包）数据集。3D 文件不会在 Dataset Viewer 中显示，但您可以在每个文件的页面上进行预览，而 SimReady 数据集则会在数据集页面上展示其资产的图库。

预览 3D 文件

在数据集的 Files and versions 选项卡或 Storage Bucket 中，点击一个 3D 文件即可在交互式 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 MB 的缩略图将被跳过。

每次向数据集推送后，卡片都会更新。

模态标签

包含 3D 文件的数据集会被赋予 3d 模态，因此在使用按模态筛选数据集时会出现。你也可以在数据集卡片中设置该模态，参见强制设置数据集模态。