CT_MRI_LOCATION.md

# CT Scan and MRI Images - Location Guide

<!--
Medical Imaging Dataset - CT Scan and MRI Location Guide
=========================================================

Project: Medical Imaging Dataset
Website: https://rskworld.in
Contact: help@rskworld.in, support@rskworld.in
Phone: +91 93305 39277
Founder: Molla Samser
Designer & Tester: Rima Khatun
-->

## Current Status

### CT Scan Images
- **Location**: `data/ct_scan/images/`
- **Current Count**: 5 images (sample/generated data)
- **Files**:
- `ct_scan_001.png`
- `ct_scan_002.png`
- `ct_scan_003.png`
- `ct_scan_004.png`
- `ct_scan_005.png`

### MRI Images
- **Location**: `data/mri/images/`
- **Current Count**: 5 images (sample/generated data)
- **Files**:
- `mri_001.png`
- `mri_002.png`
- `mri_003.png`
- `mri_004.png`
- `mri_005.png`

## Where to Get REAL CT Scan and MRI Images

### Option 1: Brain MRI Dataset (Easiest - Kaggle) ⭐ RECOMMENDED

**Dataset**: Brain MRI Images for Brain Tumor Detection
- **Source**: Kaggle
- **URL**: https://www.kaggle.com/datasets/navoneel/brain-mri-images-for-brain-tumor-detection
- **Size**: ~300 MB
- **Images**: ~3,000+ real brain MRI images
- **License**: CC BY 4.0

**To Download**:
```bash
# 1. Install Kaggle API (if not already installed)
pip install kaggle

# 2. Setup Kaggle credentials
# - Get API token from: https://www.kaggle.com/account
# - Place kaggle.json in C:\Users\YourUsername\.kaggle\

# 3. Download the dataset
kaggle datasets download -d navoneel/brain-mri-images-for-brain-tumor-detection

# 4. Extract and organize
python -m zipfile -e brain-mri-images-for-brain-tumor-detection.zip data/temp/mri/
python organize_mri_data.py
```

---

### Option 2: Medical MNIST (Includes CT and MRI)

**Dataset**: Medical MNIST
- **Source**: Kaggle / Official Website
- **Kaggle URL**: https://www.kaggle.com/datasets/andrewmvd/medical-mnist
- **Official URL**: https://medmnist.com/
- **Size**: ~200 MB
- **Images**: ~66,000 images across multiple modalities
- **Includes**: CT scans, MRI, X-ray, Ultrasound, etc.
- **License**: CC BY 4.0

**To Download**:

**Option A - Kaggle**:
```bash
kaggle datasets download -d andrewmvd/medical-mnist
python -m zipfile -e medical-mnist.zip data/temp/medmnist/
python organize_medmnist.py
```

**Option B - Official Website** (No account needed):
1. Visit: https://medmnist.com/
2. Click "Download" on desired dataset
3. Extract and organize by modality

---

### Option 3: The Cancer Imaging Archive (TCIA)

**Source**: TCIA
- **URL**: https://www.cancerimagingarchive.net/
- **Description**: Open-access database of medical images for cancer research
- **Modalities**: CT, MRI, PET scans
- **Access**: Free registration required

**To Download**:
1. Register at: https://www.cancerimagingarchive.net/
2. Browse collections by cancer type
3. Download via TCIA Data Portal
4. Organize CT scans to `data/ct_scan/images/`
5. Organize MRI to `data/mri/images/`

---

### Option 4: Radiopaedia (Educational Use)

**Source**: Radiopaedia
- **URL**: https://radiopaedia.org/
- **Description**: Educational radiology resource with case studies
- **Modalities**: X-ray, CT, MRI, Ultrasound
- **Access**: Free, educational use
- **License**: CC BY-NC-SA

**To Download**:
1. Visit: https://radiopaedia.org/
2. Browse cases by modality (CT, MRI)
3. Download images for educational purposes
4. Organize to appropriate directories

---

### Option 5: OpenNeuro (Brain MRI)

**Source**: OpenNeuro
- **URL**: https://openneuro.org/
- **Description**: Open-science database for brain imaging
- **Modalities**: MRI, fMRI, EEG
- **Access**: Free, open access

**To Download**:
1. Visit: https://openneuro.org/
2. Browse datasets
3. Download via web interface or API
4. Extract MRI images to `data/mri/images/`

---

## Quick Start - Download Brain MRI (Recommended)

The **easiest way** to get real MRI images:

1. **Create free Kaggle account**: https://www.kaggle.com
2. **Get API key**:
- Go to Account Settings → API
- Click "Create New API Token"
- Download `kaggle.json`
3. **Setup credentials**:
- Windows: Place `kaggle.json` in `C:\Users\YourUsername\.kaggle\`
4. **Download**:
```bash
pip install kaggle
kaggle datasets download -d navoneel/brain-mri-images-for-brain-tumor-detection
```
5. **Extract and organize**:
```bash
python -m zipfile -e brain-mri-images-for-brain-tumor-detection.zip data/temp/mri/
python organize_mri_data.py
```

**Result**: You'll have ~3,000+ real brain MRI images in `data/mri/images/`

---

## Directory Structure

After downloading, your structure should look like:

```
data/
├── ct_scan/
│ ├── images/ ← Place CT scan images here
│ └── labels/ ← Place CT scan labels here
└── mri/
├── images/ ← Place MRI images here
└── labels/ ← Place MRI labels here
```

---

## Helper Scripts Created

I've created these helper scripts for you:

1. **download_ct_mri_kaggle.bat** - Windows batch script to download from Kaggle
2. **organize_mri_data.py** - Organizes downloaded MRI images
3. **organize_medmnist.py** - Organizes Medical MNIST by modality

---

## Summary

**Current Images**:
- CT Scan: 5 (sample) → Located in `data/ct_scan/images/`
- MRI: 5 (sample) → Located in `data/mri/images/`

**To Get Real Images**:
1. **Brain MRI**: Kaggle (~3,000+ images) - Easiest option
2. **Medical MNIST**: Kaggle/Website (~66,000 images) - Includes both CT and MRI
3. **TCIA**: Registration required - Large collection
4. **Radiopaedia**: Free educational resource
5. **OpenNeuro**: Brain imaging datasets

---

## Contact

- **Website**: [rskworld.in](https://rskworld.in)
- **Email**: help@rskworld.in, support@rskworld.in
- **Phone**: +91 93305 39277

---

**Note**: All datasets are for educational and research purposes only.