ecg-marker 1.0.0

This program allows the interactive visualization and annotation of ECG tracings from input files (either raw data or previously annotated)

ECG_MARKER

Setup on Windows

1. Enable WSL

Open PowerShell as administrator and run the following command to install WSL:

wsl --install

2. Install Ubuntu on WSL

After enabling WSL, open the Microsoft Store, search for Ubuntu (or another Linux distribution you prefer), and install it.

3. Update packages in Ubuntu

In the WSL terminal, run the following commands to update the system packages:

sudo apt update
sudo apt upgrade

4. Install Miniconda:

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

bash Miniconda3-latest-Linux-x86_64.sh

source ~/.bashrc

5. Install and configure Git

sudo apt install git

git config --global user.name "your_name"

git config --global user.email "[e-mail]"

6. Clone the repository and navigate to the project directory:

git clone [e-mail]:SoaThais/ECG_MARKER.git

cd ECG_MARKER/

7. Create a Conda environment with the project dependencies

conda env create -f environment.yml

Running the Program

1. Activate the Conda environment

conda activate ecg_marker_env

2. Install the library

conda install -c conda-forge libxcb

2. Run the program

python3 ecg_marker.py  [-h] [-i INPUT] [-f INPUT_FILE] [-d OUTPUT_DIR]
                       [-o OUTPUT_FILE] [--qrs_file QRS_FILE]
                       [--qt_file QT_FILE] [--vel_file VEL_FILE]
                       [--arrhythmia_file ARRHYTHMIA_FILE]
                       [--extrasystole_file EXTRASYSTOLE_FILE]
                       [--apd_file APD_FILE] [-r RAW_DATA]

• Options:

  -h, --help            show this help message and exit

  -i INPUT              Input

  -f INPUT_FILE         Input File (1) or Input Directory (0)

  -d OUTPUT_DIR         Output Directory

  -o OUTPUT_FILE        Output File

  --qrs_file QRS_FILE   Output file with QRS data

  --qt_file QT_FILE     Output file with QT data

  --vel_file VEL_FILE   Output file with estimated normalized velocity data

  --arrhythmia_file ARRHYTHMIA_FILE Output file with arrhythmia marking

  --extrasystole_file EXTRASYSTOLE_FILE Output file with extrasystole marking

  --apd_file APD_FILE   Output file with estimated APD data

  -r RAW_DATA           Raw Data (1) or not (0)

Test Commands

1. For unprocessed files

python3 ./src/ecg_marker/ecg_marker.py  -i ./input/ -f 0 

2. For processed files

python3 ./src/ecg_marker/ecg_marker.py  -i ./output/ecg_data.txt -r 0 

Note

If a folder is used as input, name the files in the directory in alphabetical order.