MPR Viewer

Multi-Planar Reconstruction Viewer for Medical Imaging

Overview

MPR (Multi-Planar Reconstruction) Viewer is a comprehensive medical imaging application built with PyQt5 that enables visualization and manipulation of 3D medical imaging data.

The application supports both NIfTI and DICOM file formats, offering advanced viewing capabilities including:

• Multi-planar reconstruction (MPR)
• Segmentation overlay
• Oblique slicing
• AI-powered orientation detection

This tool is designed for medical professionals, researchers, and students working with volumetric medical imaging data, providing intuitive controls and powerful visualization features for comprehensive data analysis.

Features

• File Support

NIfTI Format: Load and visualize .nii and.nii.gz files

DICOM Format: Import entire .DICOM series from folders

Export Capabilities: Export processed volumes to both NIfTI and DICOM formats with full metadata preservation

• Viewing Modes

3 Main Views: Simultaneous axial, coronal, and sagittal plane visualization

Oblique View: Custom oblique plane slicing with interactive rotation controls

Segmentation View: Overlay and visualize segmentation masks with edge detection

• Interactive Tools

Slide/Crosshair Mode Navigate through slices with synchronized crosshairs across all views	Contrast Mode Adjust window/level settings for optimal visualization	Zoom/Pan Mode Coordinated zooming and panning across all views
Crop Mode Slice-based cropping to focus on regions of interest	Rotate Mode Interactive oblique plane rotation with visual indicators	Cine Mode Automated slice-by-slice playback for dynamic viewing

• Advanced Features

Segmentation Overlay: Load multiple segmentation files with edge detection and red outline visualization

Aspect Ratio Correction: Automatic voxel spacing-based aspect ratio correction for accurate anatomical representation

AI Orientation Detection: TensorFlow-based model for automatic anatomical orientation classification

Coordinated Zoom: Uniform scaling across all views maintaining spatial relationships

Custom Title Bar: Modern, frameless window design with drag, minimize, maximize, and restore functionality

Requirements

pip install -r requirements.txt

Example Workflow

1) Load Medical Data
Click "Open NIfTI File" or "Open DICOM Folder" to import your medical imaging data. The application automatically:

• Detects orientation (for DICOM files)
• Calculates optimal window/level settings
• Applies aspect ratio correction

2) Navigate and Explore Use intuitive controls to explore your data:

• Mouse wheel: Scroll through slices
• Click and drag: Move crosshair to specific locations
• Double-click: Maximize any view for detailed inspection

3) Adjust Visualization Fine-tune the display for optimal visualization:

• Contrast Mode: Drag to adjust window/level
• Zoom/Pan Mode: Wheel to zoom, drag to pan
• Reset: Restore original settings anytime

Contrast Mode

Zoom/Pan Mode

4) Work with Segmentations Load and visualize segmentation masks:

• Click "Load Segmentation" to add masks

• Switch to "Segmentation View" for dedicated visualization

• Overlays appear as red outlines in all views

  

5) Use Oblique Slicing Create custom viewing angles:

• Switch to "Oblique View" mode
• Enable "Rotate Mode"
• Drag the yellow axis handle to adjust angle
• Oblique view updates in real-time

6) Crop and Export Process and export your data:

• Click the Crop tool to select slice range
• Choose export format (NIfTI or DICOM)
• All metadata and modifications are preserved

Contributors

Team Members

MhmdSheref

Bassel Mostafa

Mahmoud Zahran

RwanOtb

Supervised By

• Prof. Tamer Basha
• Eng. Alaa Tarek