A python module and relative tool to convert Dicom ECG (waveform) files to PDF, PNG, SVG, etc. The DICOM file can also be specified as studyUID seriesUID objectUID and retrieved by your WADO server.

THE PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY OF ANY KIND.

You can use the demo site to quickly test the results before installing the software. You can convert your own DICOM files, or use preloaded sample files from different modality models.

python convert.py <inputfile> [--layout=LAYOUT] [--output=FILE|--format=FMT] --minor-grid
python convert.py <stu> <ser> <obj> [--layout=LAYOUT] [--output=FILE|--format=FMT] --minor-grid
python convert.py --help

For example the file anonymous_ecg_3x4_1.png is generated by:

python convert.py sample_files/anonymous_ecg.dcm -o sample_files/anonymous_ecg_4x3_1.pdf

The input can be a file or the triplet studyUID, seriesUID, objectUID. In the latter case dicom file is downloaded via WADO.

The ouput format is deduced from the extension of the FILE, if --output is given. If the output file is not given --format must be defined. Supported output formats are: eps, jpeg, jpg, pdf, pgf, png, ps, raw, rgba, svg, svgz, tif, tiff.

By default the 5mm grid is drawn, --minor-grid add the minor grid (1mm).

The signals are filtered using a lowpass (40 Hz) butterworth filter of order 2.

LAYOUT can be one of: 3x4_1 (that is 3 rows for 4 columns plus 1 row), 3x4, 6x2, 12x1 (default: 3x4_1). New layouts can be defined adding the corresponding matrix in LAYOUT dictionary in config.py.

You first have to install some system library and a fortran compiler. On a Debian machine:

sudo apt-get install libpng12-dev
sudo apt-get install libblas-dev
sudo apt-get install liblapack-dev 
sudo apt-get install gfortran

sudo pip install -r requirements.txt
git clone [email protected]:marcodebe/dicomecg_convert.git
cd dicomecg_convert
sudo python setup.py install

git clone [email protected]:marcodebe/dicomecg_convert.git
cd dicomecg_convert
virtualenv .
. bin/activate
pip install -r requirements.txt
python setup.py install

To generate documentation use epydoc packages:

cd path/to/dicomecg_convert
epydoc --html -o docs ecg.py

Read epydoc manual for other output formats and options:

epydoc -h

To install the epydoc package on:

sudo pip install epydoc

or download the installation package from Epydoc and follow the instructions.

• http://medical.nema.org/Dicom/supps/sup30_lb.pdf
• http://dicomlookup.com/html/03_03PU.html#LinkTarget_229354
• http://libir.tmu.edu.tw/bitstream/987654321/21661/1/B09.pdf
• Mortara ECG Conformance Statement