PhysioMotion4D tutorials

Build animated medical USD workflows for NVIDIA Omniverse

PhysioMotion4D converts 3D and 4D medical scans into dynamic OpenUSD assets for NVIDIA Omniverse. Start with the tutorial cards, then use the documentation sections below for installation, CLI workflows, API references, developer notes, and contribution guidance.

Not validated for clinical use. PhysioMotion4D 2026.05.07 beta is a research and visualization toolkit, not a medical device. Do not use it for diagnosis, treatment planning, or clinical decision-making.

01

Heart-Gated CT to Animated USD

Convert cardiac 4D CT frames into registered contours and an animated OpenUSD model.

Slicer-Heart-CT 02

CT Segmentation to VTK Surfaces

Segment one CT phase and export patient anatomy as VTK PolyData surfaces.

Slicer-Heart-CT 03

Create a PCA Shape Model

Build a statistical shape model from aligned cardiac meshes.

KCL-Heart-Model 04

Fit Statistical Model to Patient

Fit a PCA heart model to patient-specific anatomy for model-based reconstruction.

Tutorial 3 output 05

VTK Surface Series to Animated USD

Convert VTK meshes into a time-sampled USD scene for Omniverse playback.

Tutorial 2 output 06

Reconstruct High-Resolution 4D CT

Register respiratory CT phases and reconstruct a higher-resolution 4D volume series.

DirLab-4DCT

Documentation

Explore the rest of the docs

Installation

Set up PhysioMotion4D with CUDA extras, CPU-only options, and required system tools.

Getting Started

Run your first workflow and understand the basic CT-to-USD processing path.

Examples

Review focused usage patterns for common cardiac, lung, segmentation, and USD tasks.

CLI Workflows

Use production command-line workflows for conversion, reconstruction, modeling, and USD export.

API Reference

Browse classes and modules for workflows, segmentation, registration, USD, and utilities.

Developer Docs

Understand architecture, extension points, coordinate transforms, and implementation boundaries.

Architecture

Trace the actual workflow classes and data flow from CT inputs to USD outputs.

Contributing

Follow repository conventions for code style, testing, documentation, and pull requests.

Testing

Run the fast test suite, data-gated tutorial tests, and regression checks.

Troubleshooting

Diagnose environment, data, segmentation, registration, and USD playback issues.

Tutorial Details

See Tutorials for the recommended run order, commands, datasets, and per-tutorial implementation details.