VTK to USD Conversion

The physiomotion4d-convert-vtk-to-usd command converts VTK, VTP, or VTU mesh files to USD for Omniverse visualization. Multiple input files are treated as a time series.

Basic Usage

physiomotion4d-convert-vtk-to-usd heart.vtp \
    --output heart.usd

Time Series

physiomotion4d-convert-vtk-to-usd heart_*.vtp \
    --output heart_animation.usd \
    --fps 30

Appearance Options

Solid color:

physiomotion4d-convert-vtk-to-usd heart.vtp \
    --output heart_red.usd \
    --appearance solid \
    --color 1 0 0

Anatomy material:

physiomotion4d-convert-vtk-to-usd heart.vtp \
    --output heart_material.usd \
    --appearance anatomy \
    --anatomy-type heart

Colormap from a VTK point data array:

physiomotion4d-convert-vtk-to-usd frame_*.vtk \
    --output stress.usd \
    --appearance colormap \
    --primvar vtk_point_stress_c0 \
    --cmap viridis \
    --intensity-range 0 500

Splitting

By default, meshes are split by connected component. Use --no-split to keep one mesh, or --by-cell-type to split by cell type.

physiomotion4d-convert-vtk-to-usd mesh.vtu \
    --output mesh.usd \
    --by-cell-type

Python API

Use physiomotion4d.WorkflowConvertVTKToUSD for the workflow API and physiomotion4d.ConvertVTKToUSD for direct in-memory conversion.