Skip to content

Welcome to the GitHub repo for "HMS - EEG Exploration & Neurocritical Care Journey"! Explore EEG data, understand wave patterns, and delve into conditions like LPDs, GPDs, LRDA, and GRDA.

License

Notifications You must be signed in to change notification settings

ThecoderPinar/HMS-BrainActivity-Analysiss

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Logo

๐ŸŒฉ๏ธ HMS - Exploratory Data Analysis and Journey in Neurocritical Care ๐ŸŒ

A comprehensive exploration into neurocritical care using EEG data analysis.
Explore the docs ยป

View Demo ยท Report Bug ยท Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgements

About The Project

Exploratory Data Analysis and Journey in Neurocritical Care is a project that delves deep into the analysis of EEG data to understand brain activity in critical care scenarios.

What is EEG?

Electroencephalography (EEG) is a non-invasive method used to record electrical activity in the brain. Learn more about EEG here.

How Spectrograms are Related to EEG?

Spectrograms play a crucial role in analyzing EEG data. Find out more about their relationship here.

LPD/GPD/LRDA/GRDA Conditions

Explore various brain conditions such as Lateralized Periodic Discharges (LPDs), Generalized Periodic Discharges (GPDs), Lateralized Rhythmic Delta Activity (LRDA), and Generalized Rhythmic Delta Activity (GRDA) here.

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

Installation

Clone the repository ๐Ÿš€

git clone https://github.com/ThecoderPinar/HMS-BrainActivity-Analysiss.git

๐Ÿš€ Usage

Welcome to the usage section! Here, you'll find examples and code snippets to help you make the most of this project.

1. Data Analysis with Jupyter Notebooks

Navigate to the ๐Ÿ““ notebooks directory to find Jupyter notebooks for in-depth data analysis and visualization.

cd notebook/
jupyter notebook

2. Exploring EEG Data

Check out the ๐Ÿ“‚ data directory (please note, actual EEG data is not provided for privacy and ethical reasons). You can replace the placeholder with your own data.

๐Ÿ“‚ data

  • โ”œโ”€โ”€ train_eegs\1000913311.parquet
  • โ”œโ”€โ”€ train_spectrograms\1000189855.parquet
  • โ”œโ”€โ”€ sample_submission.csv
  • โ”œโ”€โ”€ test.csv
  • โ”œโ”€โ”€ train.csv

3. Project Documentation

Explore the ๐Ÿ“š docs directory for comprehensive project documentation, including this README.

cd docs/

4. Viewing Outputs

Navigate to the output directories:

๐Ÿ“ out

  • โ”œโ”€โ”€ submission.csv
  • โ”œโ”€โ”€ out_image/
  • โ””โ”€โ”€ out_audio/

๐Ÿ““ Notebook

Explore the analysis and visualization of harmful brain activity in the following Jupyter Notebook:

Feel free to open the notebook to dive into the details of our exploratory data analysis journey! ๐Ÿง ๐Ÿ“Š

๐Ÿš€ Roadmap

Here's what's coming up for this project:

๐ŸŽ‰ Version 1.0.0 (Current Release)

  • ๐Ÿš€ Initial release with basic functionalities.
  • ๐Ÿ“Š Exploratory Data Analysis (EDA) on EEG data.
  • ๐Ÿ“ˆ Implement basic data visualization techniques.

๐ŸŒŸ Version 1.1.0

  • ๐ŸŽจ Add advanced visualization features.
  • ๐Ÿ“‰ Include statistical analysis of EEG patterns.
  • ๐Ÿ“˜ Improve documentation for better understanding.

โœจ Version 1.2.0

  • ๐Ÿค– Integrate machine learning models for EEG pattern recognition.
  • ๐ŸŽ‰ Enhance user interface for better user experience.
  • ๐ŸŒ Support for additional EEG datasets.

๐Ÿšง Version 1.3.0

  • โฉ Implement real-time EEG data processing.
  • ๐Ÿ“Š Provide interactive dashboards for data exploration.
  • ๐Ÿค Collaborate with the community to address user feedback.

๐Ÿ”ฎ Future Releases

  • โ˜๏ธ Explore cloud-based EEG data analysis.
  • ๐Ÿ“ฑ Develop mobile applications for on-the-go EEG analysis.
  • ๐Ÿ”„ Continuous improvement based on user feedback and technological advancements.

Feel free to suggest additional features or improvements by opening an issue or reaching out! ๐Ÿš€

Contributing

Contributions make the open source community thrive. If you'd like to contribute to this project, follow these steps:

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the Apache License 2.0. See LICENSE for more information.

Contact

If you want to reach out, feel free to contact me:

Pฤฑnar Topuz - piinartp@gmail.com

Project Link: https://github.com/QMindSolutions/HMS-BrainActivity-Analysis

Acknowledgements

Give credit to the tools, libraries, or resources you used or were inspired by in this project. It's a great way to show appreciation.