🩺 Interactive 3D medical visualization system for exploring human anatomy
✨ Features • 📥 Installation • 🚀 Quick Start • 📖 Usage
- 🩺 Overview
- ✨ Features
- 📥 Installation
- 🚀 Quick Start
- 📖 Usage
- 🎮 Interactive Controls
- 📂 Supported Formats
- 🤝 Contributing
- 📜 License
- 🙏 Acknowledgments
- 📧 Contact
This repository provides interactive human body system viewers using Python/Qt and VTK, featuring integrated 3D clipping and curved MPR tools for NIfTI/DICOM volumes — along with realistic signal-driven animations and ECG simulation.
It includes dedicated modules for:
🫀 Cardiovascular | 🧠 Nervous | 💪 Musculoskeletal | 🦷 Dental systems
All systems are launched via a Tkinter-based main interface or standalone entry points.
- 💗 Real-time ECG simulation with conduction modeling
- 📊 Heart sounds and audio cues
- 🗣️ Text-to-speech annotations
- 🩸 Interactive vessel visualization
- ✂️ Integrated advanced clipping with anatomical planes
- 🔍 Integrated curved MPR for volume exploration
update.heart.animation.online-video-cutter.com.mp4
- 🧬 Brain visualization
- 📊 EEG-driven surface coloring
- ⚡ Neural signal pathway animation with glow effects
- ✂️ Integrated multi-plane clipping tools
- 🔍 Integrated curved MPR (Multiplanar Reconstruction)
signals.brain.online-video-cutter.com.mp4
- 💪 Bone and muscle rendering
- ⚡ Neural signal visualization with motor pathway simulation
- 🦵 Stair climbing animation sequence (signal → knee flex)
- 🎨 Advanced quality controls
- ✨ Edge enhancement options
- ✂️ Integrated advanced clipping
- 🔍 Integrated curved MPR
leg.animation.mp4
- 😁 Teeth segmentation
- 🎨 Color preset management
- 🔧 Procedural tooth generation
- 💫 Neural signal animation
- 🦴 Jaw movement control (open/close)
- ✂️ Integrated advanced clipping
- 🔍 Integrated curved MPR
teeth.neural.jaw.online-video-cutter.com.mp4
All systems now include built-in access to:
-
✂️ Advanced Clipping: Interactive 3D clipping with axial/coronal/sagittal planes
- Octant clipping (hide specific regions: left/right/front/back/top/bottom)
- Visual anatomical plane overlays (colored by orientation)
- Real-time plane position adjustment
-
📊 Curved MPR: Interactive curved multiplanar reconstruction
- Load NIfTI, DICOM
- Draw custom curved paths on 2D slices
- Generate straightened CPR images along the path
- Adjustable slice range selection
-
📈 ECG Widget: Embeddable real-time ECG display with dark theme (Cardiovascular)
-
🧪 Enhanced Animations:
- Blood-flow particle animation (Cardiovascular)
- Neural pathway visualization (Nervous & Musculoskeletal)
- Jaw movement cycles (Dental)
- 🐍 Python 3.10+
- 🖥️ GPU recommended (optional, for enhanced rendering)
pip install PyQt5
pip install vtk
pip install numpy
pip install scipy
pip install matplotlib
pip install pandas
pip install pillow
pip install pyttsx3
pip install nibabel # Required for MPR functionalityOr use the requirements file:
pip install -r requirements.txtpython main.pyThe main launcher provides buttons to start each system module in a separate process.
# 🫀 Cardiovascular system
python cardiovascular_system.py
# 🧠 Nervous system
python nervous_system.py
# 🦴 Musculoskeletal system
python musculoskeletal_system.py
# 🦷 Dental system
python dental_system.pyAccess from the "🔍 Curved MPR" tab in any system:
- Click "Open MPR Tool" button
- 📂 Load NIfTI/DICOM
- 🎯 Use 'Display Slice' slider to browse through the volume
- 🎨 Set 'CPR Start/End' slice range for the reconstruction depth
- 🖱️ Click on the 2D image to draw curve points along your desired path
- ✨ Click "Generate CPR" to create straightened view
Access from the "✂️ Clipping" tab in any system:
- Click "Open Advanced Clipping" button
- 🎚️ Position clipping planes using X/Y/Z sliders (0-100%)
- 👁️ Toggle anatomical plane overlays (Axial=Blue, Sagittal=Red, Coronal=Green)
- 🧭 Select octant regions to hide (Left/Right/Front/Back/Top/Bottom)
- ⌨️ Use "Reset All" to restore default view
The cardiovascular module includes:
- 📈 P-QRS-T wave generation
- 💗 Atrial and ventricular contraction mapping
- 📊 Synchronized heart sounds
- 🗣️ Optional text-to-speech guidance
Nervous System:
- Watch neural pathways light up on the brain surface
- Choose from Pain, Vision, or Thinking pathways
- Adjustable animation speed
Musculoskeletal System:
- Stair climbing sequence: Neural signal → Knee flexion → Reset
- Starts with left leg, then right leg
- Realistic motor pathway simulation
- Neural signal propagation through teeth (root to crown)
- Jaw movement control (open/close with sound effects)
- Combined sequence: Signal → Open → Signal → Close
📦 human-body-systems/
├── 🚀 main.py # Tkinter launcher (subprocess-based)
├── 🫀 cardiovascular_system.py # Heart & vessels with ECG + integrated tools
├── 🧠 nervous_system.py # Brain viewer + integrated tools
├── 🦴 musculoskeletal_system.py # Bones & muscles + integrated tools
├── 🦷 dental_system.py # Dental visualization + integrated tools
├── 📋 requirements.txt # Python dependencies
└── 📄 README.md # This file
Note: clipping.py and mpr.py have been removed. Their functionality is now integrated into each system module.
| Type | Extensions | Description |
|---|---|---|
| Meshes | .stl, .obj, .ply, .vtk |
3D anatomical models |
| Volumes | .nii, .nii.gz, DICOM, PNG stacks |
Medical imaging volumes (for MPR) |
| Audio | .wav, .mp3 |
Heart sounds / voice guidance |
These datasets were partially used in this project for testing, visualization, and evaluation purposes.
3D Multimodal Dental Dataset based on CBCT and Oral Scan — Figshare
A multimodal 3D dataset combining Cone Beam CT (CBCT) and intraoral scans, designed for dental anatomy and visualization research.
Please refer to the original Figshare page for citation details and licensing information.
Healthy-Total-Body-CTs — The Cancer Imaging Archive (TCIA)
https://www.cancerimagingarchive.net/collection/healthy-total-body-cts/
A dataset containing low-dose, whole-body CT scans of 30 healthy subjects with detailed tissue segmentation (organs, fat, muscle, etc.).
Data Citation:
Selfridge, A. R., Spencer, B., Shiyam Sundar, L. K., Abdelhafez, Y., Nardo, L., Cherry, S. R., & Badawi, R. D. (2023).
Low-Dose CT Images of Healthy Cohort (Healthy-Total-Body-CTs) (Version 2) [Dataset]. The Cancer Imaging Archive. https://doi.org/10.7937/NC7Z-4F76
| Action | Control |
|---|---|
| Rotate 3D view | Left mouse drag |
| Pan camera | Right mouse drag |
| Zoom | Mouse scroll |
| Reset camera | R key |
| Toggle clipping | Access via Clipping tab |
| Adjust opacity | Use opacity sliders in UI |
| Enable curved MPR | Access via MPR tab |
| Focus on region | Enable Focus Mode, then click |
| Toggle wireframe | W key |
Contributions are welcome! 🎉
To contribute:
- Fork this repo
- Create a feature branch (
git checkout -b feature-name) - Commit changes (
git commit -m "Add feature") - Push and open a PR
Please ensure code follows PEP8 and includes minimal documentation.
This project is provided as-is for educational and research purposes. Not intended for clinical diagnostic use.
- 🛠️ Built with VTK, PyVista, and Qt
- 🥼 Medical imaging support via nibabel and pydicom
- 💗 ECG simulation based on physiological models
Project Contributor: Maryam Moustafa
Project Contributor: Aya Sayed
Project Contributor: Nour Ahmed
Project Contributor: Mahmoud Mazen
Made with ❤️ for medical visualization and education