A comprehensive desktop application for detecting brain tumors from MRI scans using machine learning, with a role-based hospital management system interface.
- Multi-User System with different roles (Admin, Doctor, Radiologist, Technician)
- Multiple ML Models (SVM, Random Forest, Logistic Regression) for tumor detection
- Modern UI with customizable themes and responsive design
- Patient Management with complete medical record keeping
- PDF Report Generation for professional documentation
- Model Performance Comparison with visual analytics
- Image Annotation capabilities for radiologists
-
Clone the repository:
git clone https://github.com/itxawangee/hospital-brain-tumor-detection.git cd hospital-brain-tumor-detection -
Install required dependencies:
pip install -r requirements.txt
-
Create necessary directories:
mkdir -p patient_data patient_images models dataset/yes dataset/no
- Python 3.8+
- Required packages:
numpy pandas scikit-learn opencv-python pillow matplotlib fpdf2 joblib
Run the application:
python brain_tumor_detection.py| Role | Username | Password |
|---|---|---|
| Admin | admin | admin123 |
| Doctor | doctor | doctor123 |
| Radiologist | radiologist | radio123 |
| Technician | technician | tech123 |
The system implements three classification models:
-
Support Vector Machine (SVM)
- Pros: Effective in high dimensional spaces
- Cons: Not suitable for large datasets
-
Random Forest
- Pros: Handles large datasets well
- Cons: Slower prediction time
-
Logistic Regression
- Pros: Simple and efficient
- Cons: Struggles with non-linear boundaries
hospital-brain-tumor-detection/
├── brain_tumor_detection.py # Main application file
├── requirements.txt # Dependency list
├── patient_data/ # Patient records storage
├── patient_images/ # Uploaded MRI scans
├── models/ # Trained model storage
├── dataset/ # Training dataset
│ ├── yes/ # Tumor-positive samples
│ └── no/ # Tumor-negative samples
Contributions are welcome! Please follow these steps:
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Project Maintainer: Akrash Noor - akrashnoor2580@gmail.com
Project Link: https://github.com/itxawangee/hospital-brain-tumor-detection
### Key Features of this README:
1. **Badges** - Visual indicators for Python version, GUI framework, and ML capabilities
2. **Clear Installation** - Step-by-step setup instructions
3. **Visual Hierarchy** - Organized sections with emoji icons
4. **Login Credentials** - Ready-to-use test accounts
5. **Project Structure** - Clear directory layout
6. **ML Model Documentation** - Quick comparison of implemented algorithms
7. **Contribution Guidelines** - Standard GitHub workflow instructions
To use this README:
1. Replace placeholder values (yourusername, your.name, etc.)
2. Add actual screenshots to the screenshots folder
3. Update the requirements.txt with your exact dependencies
4. Include a LICENSE file if using a different license
