Hub documentation

3B Veri Seti

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

3B Veri Seti

Bu kılavuz, 3D dosyaların Hub'da nasıl önizlendiğini ve SimReady paketleri gibi OpenUSD varlıklarından oluşan bir veri setinin nasıl yapılandırılacağını gösterir. 3D dosyalar Dataset Viewer içinde görüntülenmez; ancak her dosyanın sayfasında önizleme yapabilirsiniz ve SimReady veri setleri, veri seti sayfasında varlıklarının bir galerisine sahip olur.

3D dosyalarını önizleme

Bir veri setinin Files and versions sekmesindeki veya Storage Bucket'taki bir 3D dosyasına tıklayarak onu etkileşimli bir 3D görüntüleyicide açabilirsiniz. Görüntüleyiciyi döndürebilir, yakınlaştırabilir ve tam ekran olarak açabilirsiniz.

BiçimEklentiler
OpenUSD.usd, .usda, .usdc, .usdz
glTF.glb, .gltf

OpenUSD katmanları ve dokuları

USD varlığı genellikle birden fazla dosyaya bölünür: alt katmanları, yükleri, malzemeleri ve dokuları referans veren bir kök dosya. Görüntüleyici, bu referans verilen dosyaları aynı depodan yükler; bu nedenle varlığı oluştururken kullandığınız klasör yapısını koruyun ve referanslar için göreli yollar kullanın. Mutlak yollara veya depodaki dosyalar dışındaki dosyalara yapılan referanslar yüklenemez.

SimReady veri kümeleri

SimReady, fizik, malzemeler ve anlamsal etiketlere sahip, simülasyonda kullanıma hazır OpenUSD varlıkları için bir spesifikasyondur. SimReady paketleri içeren veri setlerinin sayfalarında, veri seti genelinde örneklenen paket sayısı ve en fazla 15 küçük resim içeren bir 3D Assets kartı görüntülenir. Bir küçük resme tıklamak, ilgili USD dosyasını görüntüleyicide açar.

Örneğin, nvidia/simready-assets veya nvidia/PhysicalAI-SimReady-Warehouse-01 adreslerine bakın.

Paket yapısı

Bir paket, com.nvidia.simready.packaging.json dosyası içeren bir klasördür. Paketler, depodaki herhangi bir derinlikte bulunabilir ve bir paketin içindeki klasörler o paketin bir parçasıdır.

Her paketin kartta görünmesi için kök USD dosyasının küçük bir önizlemesine (thumbnail) ihtiyacı vardır. SimReady önizleme gereksinimine göre, <folder>/<file>.usd dosyasının önizlemesi <folder>/.thumbs/256x256/<file>.usd.png (veya .usda.png, .usdc.png, .usdz.png) biçimindedir ve paket klasöründe veya bir alt klasörde bulunur:

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
    └── ...
  • İsteğe bağlı <file>.usd_light.png dosyası açık modda, <file>.usd.png dosyası ise koyu modda gösterilir.
  • 4 MB'den büyük küçük resimler atlanır.

Kart, veri setine her itme (push) işleminden sonra güncellenir.

Modallite etiketi

3D dosyaları içeren veri setleri 3d modalitesine sahip olur, bu nedenle modaliteye göre veri setlerini filtrelerken görünürler. Ayrıca bunu veri seti kartında da ayarlayabilirsiniz, bkz. Bir veri seti modalitesini zorla ayarlama.

Update on GitHub