Understanding Usd and Sdf structures: Quick Reference — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)

Quick Reference: Understanding Usd and Sdf Structures

This cheat sheet provides essential facts and definitions for working with Usd and Sdf structures, foundational to data modeling in OpenUSD pipelines.

1. Core Concepts

• Usd (Universal Scene Description): High-level API and data model for describing 3D scenes, built on top of Sdf.
• Sdf (Scene Description Foundation): Low-level layer managing scene description data as hierarchical layers and primitives.

2. Structure Hierarchy

• Layer: A container of scene description data, typically stored in a file (.usd, .usda, .usdc).
• Prim (Primitive): The fundamental building block representing scene elements (e.g., geometry, lights, cameras).
• Properties: Attributes or relationships attached to prims.
• Primvars: Specialized properties storing per-vertex or per-face data, such as colors or UVs.

3. Usd and Sdf Relationship

• Usd provides a user-friendly interface to manipulate scene data.
• Sdf manages the underlying data storage, layering, and composition.
• Changes in Usd translate to modifications in Sdf layers and prim specs.

4. Key Data Types and Value Handling

• Value Types: Include scalar types (int, float, bool), vectors, matrices, strings, tokens, and arrays.
• TimeSamples: Store time-varying values for animation; values keyed at specific time codes.
• Usd supports interpolation of timeSamples for smooth animation playback.

5. Built-in Schemas

• Usd defines standard schemas for common prim types (e.g., UsdGeomMesh, UsdLuxLight).
• Schemas provide predefined properties and behaviors to ensure consistency.
• Custom schemas can extend or specialize built-in types.

6. Rules and Best Practices

• Always work on the stage (UsdStage) to access and modify Usd data.
• Use prim paths to uniquely identify prims within a layer or stage.
• Layer composition allows overriding and layering of scene data without duplication.
• Maintain clear separation between data definition (Sdf) and data manipulation (Usd API).

Example: Accessing a Prim and Its Property

Task: Retrieve the "color" primvar from a mesh prim at path /World/Geom/Mesh1.

Steps:

1. Open the UsdStage from a USD file.
2. Get the prim at /World/Geom/Mesh1.
3. Access the primvar named "color".

Code snippet (conceptual):

stage = Usd.Stage.Open("scene.usd") prim = stage.GetPrimAtPath("/World/Geom/Mesh1") colorPrimvar = UsdGeom.Mesh(prim).GetPrimvar("color")

More in this topic

Value types, timeSamples, and built-in schemas: Quick Reference — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Value types, timeSamples, and built-in schemas: Worked Example — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Understanding Usd and Sdf structures: Practice Questions — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Data Modeling — NVIDIA-Certified Professional: OpenUSD DevelopmentValue types, timeSamples, and built-in schemas: Common Mistakes — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Working with prims, properties, and primvars: Common Mistakes — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Working with prims, properties, and primvars: Worked Example — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Working with prims, properties, and primvars: Quick Reference — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Value types, timeSamples, and built-in schemas — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Working with prims, properties, and primvars — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Understanding Usd and Sdf structures — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Working with prims, properties, and primvars: Practice Questions — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Understanding Usd and Sdf structures: Common Mistakes — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Understanding Usd and Sdf structures: Worked Example — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)Value types, timeSamples, and built-in schemas: Practice Questions — Data Modeling (NVIDIA-Certified Professional: OpenUSD Development)