Update README.md

README.md

@@ -1,8 +1,8 @@
 ---
 title: EEG Mental Arithmetic Task Visualizer
-emoji: 🚀
-colorFrom: red
-colorTo: red
+emoji: 💻
+colorFrom: blue
+colorTo: purple
 sdk: docker
 app_port: 8501
 tags:
@@ -11,9 +11,79 @@ pinned: false
 short_description: EEG Visualizer & Data Exploration Space
 ---
 
-# Welcome to Streamlit!
+# 🧠 EEG Mental Arithmetic Explorer
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+Interactive visualization tool for exploring the EEG During Mental Arithmetic Tasks dataset.
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+## Repository Structure
+
+```
+space/
+├── scr/ 
+├────── app.py           # Main Streamlit application
+├── requirements.txt     # Python dependencies
+├── README.md            # This file
+└── edf_files.zip        # Compressed EDF files (auto-extracted on launch)
+```
+
+The EDF files are automatically extracted when the Space starts.
+
+## Features
+
+### 📈 Signal Viewer
+- Visualize EEG signals from 23 channels
+- Stacked or overlay plot options
+- Adjustable time windows
+- Multi-channel selection
+
+### 🌈 Spectral Analysis
+- Power Spectral Density (PSD) visualization
+- Frequency band analysis (Delta, Theta, Alpha, Beta, Gamma)
+- Band power comparison
+- Individual channel analysis
+
+### 📊 Statistics
+- Channel-wise statistical metrics
+- Correlation matrix heatmap
+- Comprehensive data overview
+
+### 👤 Subject Selection
+- Browse all subjects
+- View performance groups (Good/Poor)
+- Toggle between resting and task states
+- Support for both CSV and EDF formats
+
+## Dataset
+
+This explorer uses the [EEG During Mental Arithmetic Tasks](https://huggingface.co/datasets/BrainSpectralAnalytics/eeg-mental-arithmetic) dataset containing:
+- 36 subjects with paired recordings
+- 23 EEG channels (International 10/20 system)
+- Resting state and mental arithmetic task recordings
+- Performance-based classification
+
+## Usage
+
+1. **Select Subject**: Choose from 36 available subjects
+2. **Choose Recording**: Resting state or mental arithmetic task
+3. **Select Format**: CSV (processed) or EDF (original)
+4. **Explore**: Navigate through the different visualization tabs
+
+## Citation
+
+```bibtex
+@article{zyma2019eegmat,
+  author = {Zyma, Igor and Tukaev, Sergii and Seleznov, Ivan and others},
+  title = {Electroencephalograms during Mental Arithmetic Task Performance},
+  journal = {Data},
+  volume = {4},
+  number = {1},
+  year = {2019},
+  doi = {10.3390/data4010014}
+}
+```
+
+## Links
+
+- [Dataset on Hugging Face](https://huggingface.co/datasets/BrainSpectralAnalytics/eeg-mental-arithmetic)
+- [PhysioNet Page](https://physionet.org/content/eegmat/1.0.0/)
+- [Original Paper](https://doi.org/10.3390/data4010014)