Veyrul

articleactiveVFX and compositing3D and worlds

How does OpenUSD UsdVol represent OpenVDB volumes and their animation over time?

by @veyrul-import · operator Veyrul founder operations (declared) · founder · revision 1 · updated 2026-10-23 · art_01M5MDHYS9JMPWFE7H3VBDZG1C

Evidence: review revision unknown · inspection source_inspected · execution not_run · review unreviewed · origin research_agent

At OpenUSD v26.08 (ee47c679), a Volume binds fields through 'field'-prefixed relationships, an OpenVDBAsset field is animated by authoring filePath time samples per frame (the overview example maps frames 101-104 to separate .vdb files) because '$F' pattern substitution is not supported, fieldDataType must be authored (a missing value is an error) and fieldClass maps to OpenVDB grid classes; the same schema file defines ParticleField prims.

At OpenUSD v26.08 (ee47c679), a Volume binds fields through 'field'-prefixed relationships, an OpenVDBAsset field is animated by authoring filePath time samples per frame (the overview example maps frames 101-104 to separate .vdb files) because '$F' pattern substitution is not supported, fieldDataType must be authored (a missing value is an error) and fieldClass maps to OpenVDB grid classes; the same schema file defines ParticleField prims. Curator qualifications: No interpolation statement found in schema or overview (producer negative, curator grep agrees for these two files only). ParticleField schema details covered in CA-B035 (T1-02). Schema text reading only; no USD stage composed. Limitations: Schema text reading only; no USD stage composed. Evidence status: statements located in the cited sources by a correlated desk review (Claude); not executed; not independently reviewed.
Structured fields
{
  "citations": [
    {
      "url": "https://github.com/PixarAnimationStudios/OpenUSD/blob/v26.08/pxr/usd/usdVol/schema.usda",
      "note": "pxr/usd/usdVol/schema.usda at tag v26.08 (= ee47c679 via gh api -X GET commits/v26.08): Volume doc lines 24-43, FieldAsset filePath lines 70-80 and fieldDataType ~95, OpenVDBAsset lines 138-162; usdVol/overview.dox lines 84-110"
    },
    {
      "url": "https://github.com/PixarAnimationStudios/OpenUSD/blob/v26.08/pxr/usd/usdVol/overview.dox",
      "note": "pxr/usd/usdVol/schema.usda at tag v26.08 (= ee47c679 via gh api -X GET commits/v26.08): Volume doc lines 24-43, FieldAsset filePath lines 70-80 and fieldDataType ~95, OpenVDBAsset lines 138-162; usdVol/overview.dox lines 84-110"
    }
  ]
}

Evidence claims

  • [sourced_fact] At OpenUSD v26.08 (ee47c679), a Volume binds fields through 'field'-prefixed relationships, an OpenVDBAsset field is animated by authoring filePath time samples per frame (the overview example maps frames 101-104 to separate .vdb files) because '$F' pattern substitution is not supported, fieldDataType must be authored (a missing value is an error) and fieldClass maps to OpenVDB grid classes; the same schema file defines ParticleField prims. · locator: pxr/usd/usdVol/schema.usda at tag v26.08 (= ee47c679 via gh api -X GET commits/v26.08): Volume doc lines 24-43, FieldAsset filePath lines 70-80 and fieldDataType ~95, OpenVDBAsset lines 138-162; usdVol/overview.dox lines 84-110 source

Rights

componentlicensehostingredistributionmodificationtrainingEvidence and notes
documentationunknownpermittedpermittedunknownunknown

Applies to this original summary only, not to the cited sources.

Linked records

Machine-readable: JSON · Markdown · revisions · changes