PhysioTwin4D tutorials
Build animated medical USD workflows for NVIDIA Omniverse
PhysioTwin4D 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.
Version 2026.07.0
Heart-Gated CT to Animated USD
Convert cardiac 4D CT frames into registered contours and an animated OpenUSD model.
02CT Segmentation to VTK Surfaces
Segment one CT phase and export patient anatomy as VTK PolyData surfaces.
03Create a PCA Shape Model
Build a statistical shape model from aligned cardiac meshes.
04Fit Statistical Model to Patient
Fit a PCA heart model to patient-specific anatomy for model-based reconstruction.
05VTK Surface Series to Animated USD
Convert VTK meshes into a time-sampled USD scene for Omniverse playback.
06Reconstruct High-Resolution 4D CT
Register respiratory CT phases and reconstruct a higher-resolution 4D volume series.
08Fit the Cardiac SSM and Propagate Through Gated Phases
Fit a PCA heart model to the reference phase and propagate it to every gated phase with ICON registration.
09Train a PhysicsNeMo Cardiac Stage Model
Train a PhysicsNeMo MeshGraphNet (9a) or MLP (9b) to predict cardiac meshes at requested stages.
10Predict and Evaluate Cardiac Surfaces
Load a Tutorial 9 checkpoint and predict cardiac surfaces at gated phases or caller-specified stages.
Documentation
Explore the rest of the docs
Installation
Set up PhysioTwin4D 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.
Isaac for Healthcare
Find PhysioTwin4D workflows and assets for Isaac for Healthcare use cases.
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.
Clinical Use
Not validated for clinical use. PhysioTwin4D 2026.07.0 beta is a research and visualization toolkit, not a medical device. Do not use it for diagnosis, treatment planning, or clinical decision-making.