This repository contains code and resources for detecting NeuroAIDS symptoms through MRI and EEG scans. The project aims to integrate MRI and EEG data to identify key symptoms such as brain atrophy, white matter lesions, presence of masses or tumors, and seizures or epilepsy, providing a comprehensive diagnostic tool for NeuroAIDS.
NeuroAIDS, or HIV-associated neurocognitive disorders (HAND), encompasses various neurological complications arising from HIV infection. This project utilizes machine learning and deep learning techniques to detect:
- Brain Atrophy
- White Matter Lesions
- Presence of Masses or Tumors (MRI scans)
- Seizures and Epilepsy (EEG scans)
- MRI Data Analysis: Detects structural abnormalities such as brain atrophy, white matter lesions, and masses/tumors.
- EEG Data Analysis: Identifies patterns indicative of seizures and epilepsy.
- Multi-Modal Integration: Combines results from MRI and EEG analysis to provide a comprehensive diagnosis.
-
Clone the repository:
git clone https://github.com/watermelonich/neuroaids.git cd neuroaids
-
Install the required packages:
pip install -r requirements.txt
- Place your MRI files in the
data/mri/
directory. - Run the preprocessing script:
python src/preprocess_mri.py
- Place your EEG files in the
data/eeg/
directory. - Run the preprocessing script:
python src/preprocess_eeg.py
- Ensure your preprocessed MRI data and labels are available in
data/mri/
. - Run the MRI model training script:
python src/train_mri_model.py
- Ensure your preprocessed EEG data and labels are available in
data/eeg/
. - Run the EEG model training script:
python src/train_eeg_model.py
- Ensure your preprocessed MRI and EEG data are available in the respective directories.
- Run the model integration and prediction script:
python src/integrate_models.py
To run the entire pipeline from preprocessing to prediction, use:
python main.py
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Make your changes.
- Commit your changes (
git commit -am 'Add new feature'
). - Push to the branch (
git push origin feature-branch
). - Create a new Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.
- Thanks to the contributors and the community for their support and contributions.