Hub documentation

3Dデータセット

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

3Dデータセット

このガイドでは、Hub上で3Dファイルがどのようにプレビューされるか、およびOpenUSDアセット(ロボティクスシミュレーション用のSimReadyパッケージなど)のデータセットをどのように構成するかを示します。3DファイルはDataset Viewerには表示されませんが、各ファイルのページでプレビューできます。また、SimReadyデータセットには、データセットページにアセットのギャラリーが表示されます。

3Dファイルのプレビュー

データセットのFiles and versionsタブまたはStorage Bucket内の3Dファイルをクリックすると、インタラクティブな3Dビューアで開くことができます。ビューアを回転させたり、ズームしたり、全画面表示に切り替えることができます。

形式拡張機能
OpenUSD.usd, .usda, .usdc, .usdz
glTF.glb, .gltf

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)であり、パッケージフォルダー内またはその1階層下にあります:

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モダリティが割り当てられるため、モダリティによるデータセットの絞り込みで表示されます。データセットカードで設定することもできます。データセットのモダリティを強制設定するを参照してください。

Update on GitHub