Hub documentation

Dataset 3D

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Dataset 3D

Panduan ini menunjukkan bagaimana file 3D dipratinjau di Hub, dan bagaimana menyusun dataset aset OpenUSD, seperti paket SimReady untuk simulasi robotika. File 3D tidak ditampilkan di Dataset Viewer, tetapi Anda dapat memratinjau setiap file di halamannya, dan dataset SimReady mendapatkan galeri aset mereka di halaman dataset.

Pratinjau file 3D

Klik file 3D di tab Files and versions dari dataset atau Storage Bucket untuk membukanya di viewer 3D interaktif. Anda dapat memutar, memperbesar, dan membuka viewer dalam layar penuh.

FormatEkstensi
OpenUSD.usd, .usda, .usdc, .usdz
glTF.glb, .gltf

Lapisan dan tekstur OpenUSD

Aset USD sering kali dipecah ke dalam beberapa file: file root yang merujuk ke sublayer, payload, material, dan tekstur. Viewer memuat file-file yang dirujuk tersebut dari repositori yang sama, jadi pertahankan struktur folder yang Anda gunakan saat membuat aset, dan gunakan path relatif untuk referensi. Referensi ke path absolut, atau ke file di luar repositori, tidak dapat dimuat.

Dataset SimReady

SimReady adalah spesifikasi untuk aset OpenUSD yang siap digunakan dalam simulasi, lengkap dengan fisika, material, dan label semantik. Dataset yang berisi paket SimReady menampilkan kartu 3D Assets di halamannya, yang memuat jumlah paket dan hingga 15 thumbnail yang diambil secara acak dari seluruh dataset. Mengklik thumbnail akan membuka file USD-nya di viewer.

Sebagai contoh, lihat nvidia/simready-assets atau nvidia/PhysicalAI-SimReady-Warehouse-01.

Struktur paket

Paket adalah folder yang berisi file com.nvidia.simready.packaging.json. Paket dapat berada di kedalaman mana pun dalam repositori, dan folder di dalam paket merupakan bagian dari paket tersebut.

Setiap paket membutuhkan thumbnail dari file USD root-nya agar muncul di kartu. Mengikuti persyaratan SimReady untuk thumbnail, thumbnail dari <folder>/<file>.usd adalah <folder>/.thumbs/256x256/<file>.usd.png (atau .usda.png, .usdc.png, .usdz.png), di folder paket atau satu folder di bawahnya:

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 opsional ditampilkan dalam mode terang, dan <file>.usd.png dalam mode gelap.
  • Thumbnail yang lebih besar dari 4 MB akan dilewati.

Kartu diperbarui setelah setiap push ke dataset.

Tag modalitas

Dataset dengan file 3D mendapatkan modalitas 3d, sehingga muncul saat memfilter dataset berdasarkan modalitas. Anda juga dapat menyetelnya di kartu dataset, lihat Memaksa penyetelan modalitas dataset.

Update on GitHub