[![license](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](./LICENSE)

## ECG classification using MIT-BIH dataset 

This repo is an implementation of https://www.nature.com/articles/s41591-018-0268-3 and https://arxiv.org/abs/1707.01836

and focus on training using a MIT-BIH dataset. If you want to train using CINC or open irhythm data, see the open source which the authors of the original research paper have coded at https://github.com/awni/ecg

Introduction to MIT-BIH dataset at physionet : https://physionet.org/physiobank/database/mitdb/

### Dependency (Updated, April 1, 2025)

- Python == 3.12.9

- Flask==3.1.0

- gevent==24.11.1

- keras==3.9.1

- numpy==2.1.3

- pip-tools==7.4.1

- scikit-learn==1.6.1

- scipy==1.15.2

- six==1.17.0

- tensorflow==2.19.0

- tensorflow-metal==1.2.0

- tqdm==4.67.1

- Werkzeug==3.1.3

- wfdb==4.2.0

### Data setup and train 

I recommend using a vitual enviroment for Python, so run setup.sh in order to install and to activate it. 

```

$ git clone https://github.com/physhik/ecg-mit-bih.git

$ cd ecg-mit-bih

$ python -m venv ecg-env

$ source ./ecg-env/bin/activate

(ecg-env) $ pip install -r requrirements.txt

(ecg-env) $ python src/data.py --downloading True

(eng-env) $ python src/train.py

```

Now you have a trained model for ECG classification 

### Test

Predict an annotation of [CINC2017 data](https://physionet.org/challenge/2017/) or your own data(csv file)

It randomly chooses one of data, and predict the slices of the signal.

Run predict.py in the virtual environment we have already set up.

```

(ecg-env) $ python src/predict.py --cinc_download True

```

--cinc_download branch is used at first to download the CINC2017 data.

See src/config.py and customize your parameters or learn better way to train and test 

### Jupyter notebook example

In case, you do not have a GPU above a decent performance, you might be able to use Google colab. Follow the [Jupyter notebook](https://github.com/physhik/ecg-mit-bih/blob/master/src/practice/ecg_mit.ipynb).

### Flask web app

The flask web app is based on the keras-flask-deploy [Github repo](https://github.com/mtobeiyf/keras-flask-deploy-webapp). 

#### Run app.py

```

(ecg-env) $ python src/app.py

```

![png](src/static/asset/capture1.png)

and choose a csv heart heat signal and click predict, and see the result. 

![png](src/static/asset/capture2.png)

I have put one csv file in static/asset directory. The first value of the column become sample rate of the web app. If you use your own heart beat csv file, insert the sample at the first, too.   

### Using Docker, Buld and run an image for the ECG trained model.(Not yet updated)

After installation of Docker, 

```

$ docker-compose up -d .  

```

### Introduction to ECG 

I presented a bit more about ECG classfications on my personal blog, http://physhik.github.io 

Find the posts from tags or categories easily.  

### Reference to 

The original research papers

https://www.nature.com/articles/s41591-018-0268-3

https://arxiv.org/abs/1707.01836

The open source by authors

https://github.com/awni/ecg

also noticable 

https://github.com/fernandoandreotti/cinc-challenge2017/tree/master/deeplearn-approach