https://github.com/mateusjssilva/mit-bih-arrhythmia-db-visualizer
A visualizer for the MIT-BIH Arrhythmia Database that allows users to view and analyze ECG signal data along with annotations.
https://github.com/mateusjssilva/mit-bih-arrhythmia-db-visualizer
arrythmia mit-bih-arrhythmia pyhton streamlit visualizer
Last synced: about 2 months ago
JSON representation
A visualizer for the MIT-BIH Arrhythmia Database that allows users to view and analyze ECG signal data along with annotations.
- Host: GitHub
- URL: https://github.com/mateusjssilva/mit-bih-arrhythmia-db-visualizer
- Owner: MateusjsSilva
- License: mit
- Created: 2024-09-07T12:55:28.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-08T16:52:04.000Z (3 months ago)
- Last Synced: 2025-03-30T07:43:10.520Z (2 months ago)
- Topics: arrythmia, mit-bih-arrhythmia, pyhton, streamlit, visualizer
- Language: Python
- Homepage:
- Size: 438 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MIT-BIH Arrhythmia DB Visualizer
This project provides a visualizer for the **MIT-BIH Arrhythmia Database**, allowing users to view ECG signal data alongside their respective annotations. The tool offers interactive data exploration, including statistical summaries, annotation distributions, and plots of signals with annotation markers.
## Features
- **ECG Signal Visualization**: View ECG signals with annotations from the MIT-BIH Arrhythmia Database.
- **Interactive Graphs**: Display signal traces, annotation distribution (bar chart, pie chart), and time-series signals with annotation markers.
- **Detailed Statistics**: Analyze the number and types of annotations, including beat and non-beat annotations.
- **Multilingual Support**: Interface available in English and Portuguese, including translated annotation descriptions.
- **Download the Database**: [Download the MIT-BIH Arrhythmia Database](https://physionet.org/physiobank/database/mitdb/) to access the ECG signals and annotations.
## Screenshots
- **Download to a folder**
- **Multilingual Support - English Interface**
- **Multilingual Support - Portuguese Interface**
## Application Screenshots
- **Settings and Configuration**
- **Signal Details**
- **Annotation Summary**
- **Statistical Analysis**
- **ECG Signal Visualization with Annotations**
## Getting Started
### Prerequisites
Ensure that Python 3.7+ is installed on your system. You will also need to install the required dependencies.
## Getting Started
1. Clone the repository:
```sh
git clone [email protected]:MateusjsSilva/MIT-BIH-Arrhythmia-DB-Visualizer.git
cd MIT-BIH-Arrhythmia-DB-Visualizer
```
2. **Create a virtual environment**:
```sh
python -m venv venv
```
3. **Activate the virtual environment**:
- On Windows:
```sh
venv\Scripts\activate
```
- On macOS/Linux:
```sh
source venv/bin/activate
```
4. **Install the required Python packages**:
```sh
pip install -r requirements.txt
```
### Running the Visualizer
1. **Prepare the MIT-BIH Arrhythmia Database files**:
- Place your `.dat`, `.hea`, and `.atr` files from the **MIT-BIH Arrhythmia Database** into a directory (e.g., `./data/mit-bih-arrhythmia-database`).
2. **Launch the Streamlit application**:
```sh
streamlit run .\src\visualizer.py
```
3. You will be prompted to enter the path where your MIT-BIH files are located and then select a record to visualize.
### Usage
Once the visualizer is running, you can interact with the following features:
- **Signal Overview:** View detailed information about the signals in the selected record, including frequency, units, and available comments.
- **Annotations:** See all annotations in the record, with counts of beat and non-beat annotations and their corresponding definitions.
- **Statistics:** Graphical breakdown of annotation counts and percentages, displayed in bar and pie charts.
- **Signal Plotting:** Select a specific signal from the record and visualize it alongside its annotations.
- **Language Selection:** Choose between English and Portuguese interfaces via the sidebar language selector.
## Recent Updates
### Multilingual Support (May 2024)
- Added full translation support for English and Portuguese
- Translated interface elements, buttons, and annotation descriptions
- Language can be switched on-the-fly through a dropdown menu in the sidebar
- All statistics, charts, and visualizations now display in the selected language
## Contribution
Feel free to open issues or submit pull requests. All contributions are welcome!
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contact
If you have any questions or suggestions, feel free to open an issue or submit a pull request!