omniverse-asset-validator 1.11.1

NVIDIA Asset Validator

Omniverse Asset Validator

An extensible framework to validate OpenUSD assets. Inspired by Pixar's usdchecker, this library extends validation capabilities with additional rules and provides automatic issue fixing.

Features

• Rule-based validation — Modular rule interface with registration mechanism for custom validators
• Flexible engine — Run validation on a Usd.Stage, individual layers, or recursively search folders
• Auto-fixing — Issue fixing interface for applying automated corrections when rules provide suggestions
• Command line interface — Standalone CLI for validation outside of GUI applications
• Lightweight — Pure Python implementation requiring only OpenUSD

Installation

Install from PyPI:

pip install omniverse-asset-validator

Optional Dependencies

For full functionality, install with optional dependencies:

# Include usd-core
pip install omniverse-asset-validator[usd]

# Include NumPy (for optimizations)
pip install omniverse-asset-validator[numpy]

# Install all optional dependencies
pip install omniverse-asset-validator[usd,numpy]

Basic usage

from omni.asset_validator import ValidationEngine, IssueFixer

engine = ValidationEngine()
results = engine.validate("path/to/asset.usda")

for issue in results.issues():
    print(f"{issue.severity}: {issue.message}")

fixer = IssueFixer()
fix_results = fixer.fix(results.issues())

for result in fix_results:
    print(f"{result.status}: {result.issue.message}")

The ValidationEngine also supports selecting specific rules with enableRule() / disableRule() and filtering by category with enableCategory().

Command Line Interface

The omni_asset_validate command provides validation from the terminal:

# Validate a single file
omni_asset_validate asset.usda

# Validate a directory recursively
omni_asset_validate ./assets/

# Apply automatic fixes
omni_asset_validate --fix asset.usda

# Validate specific categories
omni_asset_validate --category Material --category Geometry asset.usda

# Enable specific rules only
omni_asset_validate --no-init-rules --rule StageMetadataChecker asset.usda

# Export results to CSV
omni_asset_validate --csv-output results.csv asset.usda

# Show help
omni_asset_validate --help

Documentation

• Full Documentation
• API Reference
• Available Rules

Requirements

• Python 3.10 - 3.12
• OpenUSD 22.11 or later

License

Apache-2.0