ECGProcess 1.1.0__tar.gz

ecgprocess-1.1.0/ECGProcess.egg-info/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: ECGProcess
+Version: 1.1.0
+Summary: A python module to process and standardise ECG data
+Author-email: "A. Floriaan Schmidt" <floriaanschmidt@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://gitlab.com/SchmidtAF/ECGProcess
+Project-URL: Documentation, https://SchmidtAF.gitlab.io/ECGProcess/
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENCE.txt
+Requires-Dist: lxml>=5
+Requires-Dist: xmltodict>=0.14
+Requires-Dist: pandas>=2.1.1
+Requires-Dist: numpy>=1.26
+Requires-Dist: scipy>=1.7
+Requires-Dist: tensorflow>=2.16
+Requires-Dist: pydicom>=2
+Requires-Dist: matplotlib>=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=6; extra == "dev"
+Requires-Dist: pytest-mock>=3.0; extra == "dev"
+Requires-Dist: pytest-dependency>=0.5; extra == "dev"
+Requires-Dist: codespell; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: bump2version>=1; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: sphinx-rtd-theme; extra == "dev"
+Requires-Dist: sphinx-bootstrap-theme; extra == "dev"
+Requires-Dist: furo; extra == "dev"
+Requires-Dist: myst-parser; extra == "dev"
+Requires-Dist: nbsphinx; extra == "dev"
+Requires-Dist: nbsphinx-link; extra == "dev"
+Requires-Dist: sphinx-argparse; extra == "dev"
+Requires-Dist: numpydoc; extra == "dev"
+Requires-Dist: docutils<0.21; extra == "dev"
+Requires-Dist: notebook; extra == "dev"
+Requires-Dist: jupyter; extra == "dev"
+Dynamic: license-file
+
+![Schematic](https://ecgprocess-schmidtaf-f9abe0f74d20c469a1e6cca62c7f636ef6bf6b9ffe.gitlab.io/_static/ECGProcessSchematic.png)
+
+# An ECG processing module
+__version__: `1.1.0`
+
+
+This repository host a mixture of function dealing with processing 
+electrocardiogram (ECG) data, and preparing these data for analysis.
+The processing functions are intended for user defined parametrisation 
+(using user supplied configuration files `cnf`) about the data which 
+should be extracted, covering signal data such as waveforms or
+median beats, as well as metadata relevant for downstream QC or as
+tabular information. 
+
+The module implements a basic application programming interface, mapping
+ECG data from distinct file types (e.g. XML or DICOM) to class attributes
+providing a fixed interface for downstream analysis and interrogation. 
+
+The documentation for ECGProcess can be found [here](https://SchmidtAF.gitlab.io/ECGProcess/). 
+
+
+## Installation 
+At present, the repository is undergoing development and no packages exist yet 
+on PyPy or in Conda.
+Therefore it is recommended that it is installed in either of the two ways
+listed below.
+First, clone this repository and then `cd` to the root of the repository.
+
+```sh
+git clone git@gitlab.com:SchmidtAF/ECGProcess.git
+cd ECGProcess
+```
+
+### Installation using conda dependencies
+A conda environment is provided in a `yaml` file in the directory 
+`./resources/conda/envs/`.
+A new conda environment called `ecgprocess` can be built using the command:
+
+```sh
+# From the root of the repository
+conda env create --file ./resources/conda/envs/conda_create.yaml
+```
+
+To add to an existing environment use:
+
+```sh
+# From the root of the repository
+conda env update --file ./resources/conda/envs/conda_update.yaml
+```
+
+Next the package can be installed: 
+
+```sh
+python -m pip install .
+```
+
+Or for an editable (developer) install run the command below from the root of 
+the repository.
+The difference with this is that you can just to a `git pull` to 
+update repository, or switch branches without re-installing:
+
+```sh
+python -m pip install -e .
+
+```
+### Installation not using any conda dependencies
+If you are not using conda in any way then install the dependencies via `pip` 
+and install repository as an editable install also via pip:
+
+Install dependencies:
+
+```sh
+python -m pip install --upgrade -r requirements.txt
+```
+
+Then to install repository you can either do:
+
+```sh
+python -m pip install .
+```
+
+Or for an editable (developer) install run the command below from the root of
+the repository.
+The difference with this is that you can just to a `git pull` to update
+repository, or switch branches without re-installing:
+
+```sh
+python -m pip install -e .
+```
+
+## Next steps...
+After installation you might wish to try the `pytest` to confirm 
+everything is in working order. 
+
+```sh
+# From the root of the repository
+pytest tests
+```
+
+## Usage
+
+Please have a look at the examples in 
+[resources](https://gitlab.com/SchmidtAF/ECGProcess/-/tree/master/resources/examples)
+for some possible recipes. 
+

ecgprocess-1.1.0/ECGProcess.egg-info/SOURCES.txt

@@ -0,0 +1,38 @@
+LICENCE.txt
+README.md
+pyproject.toml
+requirements-dev.txt
+requirements.txt
+ECGProcess.egg-info/PKG-INFO
+ECGProcess.egg-info/SOURCES.txt
+ECGProcess.egg-info/dependency_links.txt
+ECGProcess.egg-info/requires.txt
+ECGProcess.egg-info/top_level.txt
+ecgprocess/__init__.py
+ecgprocess/_version.py
+ecgprocess/constants.py
+ecgprocess/errors.py
+ecgprocess/plot_ecgs.py
+ecgprocess/process_dicom.py
+ecgprocess/process_xml.py
+ecgprocess/tabular.py
+ecgprocess/example_data/__init__.py
+ecgprocess/example_data/examples.py
+ecgprocess/example_data/example_datasets/.example-XML1.xml.un~
+ecgprocess/example_data/example_datasets/.example-XML1.xsd.un~
+ecgprocess/example_data/example_datasets/.example-XML1_a.xsd.un~
+ecgprocess/example_data/example_datasets/.example-XML1_d.xsd.un~
+ecgprocess/example_data/example_datasets/.example-XML1_wrong.xsd.un~
+ecgprocess/example_data/example_datasets/example-DICOM1.dcm
+ecgprocess/example_data/example_datasets/example-DICOM2.dcm
+ecgprocess/example_data/example_datasets/example-XML1.xml
+ecgprocess/example_data/example_datasets/example-XML1.xsd
+ecgprocess/example_data/example_datasets/example-XML1_error.xsd
+ecgprocess/example_data/example_datasets/example-XML1_wrong.xsd
+ecgprocess/example_data/example_datasets/string_data.txt
+ecgprocess/utils/__init__.py
+ecgprocess/utils/config_tools.py
+ecgprocess/utils/ecg_tools.py
+ecgprocess/utils/engineering_tools.py
+ecgprocess/utils/general.py
+ecgprocess/utils/reader_tools.py

ecgprocess-1.1.0/ECGProcess.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ecgprocess-1.1.0/ECGProcess.egg-info/requires.txt

@@ -0,0 +1,30 @@
+lxml>=5
+xmltodict>=0.14
+pandas>=2.1.1
+numpy>=1.26
+scipy>=1.7
+tensorflow>=2.16
+pydicom>=2
+matplotlib>=3.9
+
+[dev]
+pytest>=6
+pytest-mock>=3.0
+pytest-dependency>=0.5
+codespell
+ruff
+bump2version>=1
+build
+twine
+sphinx
+sphinx-rtd-theme
+sphinx-bootstrap-theme
+furo
+myst-parser
+nbsphinx
+nbsphinx-link
+sphinx-argparse
+numpydoc
+docutils<0.21
+notebook
+jupyter

ecgprocess-1.1.0/ECGProcess.egg-info/top_level.txt

@@ -0,0 +1 @@
+ecgprocess

ecgprocess-1.1.0/LICENCE.txt

@@ -0,0 +1,17 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+Copyright (C) 2024  Amand Floriaan Schmidt (amand.schmidt@ucl.ac.uk)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

ecgprocess-1.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: ECGProcess
+Version: 1.1.0
+Summary: A python module to process and standardise ECG data
+Author-email: "A. Floriaan Schmidt" <floriaanschmidt@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://gitlab.com/SchmidtAF/ECGProcess
+Project-URL: Documentation, https://SchmidtAF.gitlab.io/ECGProcess/
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENCE.txt
+Requires-Dist: lxml>=5
+Requires-Dist: xmltodict>=0.14
+Requires-Dist: pandas>=2.1.1
+Requires-Dist: numpy>=1.26
+Requires-Dist: scipy>=1.7
+Requires-Dist: tensorflow>=2.16
+Requires-Dist: pydicom>=2
+Requires-Dist: matplotlib>=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=6; extra == "dev"
+Requires-Dist: pytest-mock>=3.0; extra == "dev"
+Requires-Dist: pytest-dependency>=0.5; extra == "dev"
+Requires-Dist: codespell; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: bump2version>=1; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: sphinx-rtd-theme; extra == "dev"
+Requires-Dist: sphinx-bootstrap-theme; extra == "dev"
+Requires-Dist: furo; extra == "dev"
+Requires-Dist: myst-parser; extra == "dev"
+Requires-Dist: nbsphinx; extra == "dev"
+Requires-Dist: nbsphinx-link; extra == "dev"
+Requires-Dist: sphinx-argparse; extra == "dev"
+Requires-Dist: numpydoc; extra == "dev"
+Requires-Dist: docutils<0.21; extra == "dev"
+Requires-Dist: notebook; extra == "dev"
+Requires-Dist: jupyter; extra == "dev"
+Dynamic: license-file
+
+![Schematic](https://ecgprocess-schmidtaf-f9abe0f74d20c469a1e6cca62c7f636ef6bf6b9ffe.gitlab.io/_static/ECGProcessSchematic.png)
+
+# An ECG processing module
+__version__: `1.1.0`
+
+
+This repository host a mixture of function dealing with processing 
+electrocardiogram (ECG) data, and preparing these data for analysis.
+The processing functions are intended for user defined parametrisation 
+(using user supplied configuration files `cnf`) about the data which 
+should be extracted, covering signal data such as waveforms or
+median beats, as well as metadata relevant for downstream QC or as
+tabular information. 
+
+The module implements a basic application programming interface, mapping
+ECG data from distinct file types (e.g. XML or DICOM) to class attributes
+providing a fixed interface for downstream analysis and interrogation. 
+
+The documentation for ECGProcess can be found [here](https://SchmidtAF.gitlab.io/ECGProcess/). 
+
+
+## Installation 
+At present, the repository is undergoing development and no packages exist yet 
+on PyPy or in Conda.
+Therefore it is recommended that it is installed in either of the two ways
+listed below.
+First, clone this repository and then `cd` to the root of the repository.
+
+```sh
+git clone git@gitlab.com:SchmidtAF/ECGProcess.git
+cd ECGProcess
+```
+
+### Installation using conda dependencies
+A conda environment is provided in a `yaml` file in the directory 
+`./resources/conda/envs/`.
+A new conda environment called `ecgprocess` can be built using the command:
+
+```sh
+# From the root of the repository
+conda env create --file ./resources/conda/envs/conda_create.yaml
+```
+
+To add to an existing environment use:
+
+```sh
+# From the root of the repository
+conda env update --file ./resources/conda/envs/conda_update.yaml
+```
+
+Next the package can be installed: 
+
+```sh
+python -m pip install .
+```
+
+Or for an editable (developer) install run the command below from the root of 
+the repository.
+The difference with this is that you can just to a `git pull` to 
+update repository, or switch branches without re-installing:
+
+```sh
+python -m pip install -e .
+
+```
+### Installation not using any conda dependencies
+If you are not using conda in any way then install the dependencies via `pip` 
+and install repository as an editable install also via pip:
+
+Install dependencies:
+
+```sh
+python -m pip install --upgrade -r requirements.txt
+```
+
+Then to install repository you can either do:
+
+```sh
+python -m pip install .
+```
+
+Or for an editable (developer) install run the command below from the root of
+the repository.
+The difference with this is that you can just to a `git pull` to update
+repository, or switch branches without re-installing:
+
+```sh
+python -m pip install -e .
+```
+
+## Next steps...
+After installation you might wish to try the `pytest` to confirm 
+everything is in working order. 
+
+```sh
+# From the root of the repository
+pytest tests
+```
+
+## Usage
+
+Please have a look at the examples in 
+[resources](https://gitlab.com/SchmidtAF/ECGProcess/-/tree/master/resources/examples)
+for some possible recipes. 
+

ecgprocess-1.1.0/README.md

@@ -0,0 +1,105 @@
+![Schematic](https://ecgprocess-schmidtaf-f9abe0f74d20c469a1e6cca62c7f636ef6bf6b9ffe.gitlab.io/_static/ECGProcessSchematic.png)
+
+# An ECG processing module
+__version__: `1.1.0`
+
+
+This repository host a mixture of function dealing with processing 
+electrocardiogram (ECG) data, and preparing these data for analysis.
+The processing functions are intended for user defined parametrisation 
+(using user supplied configuration files `cnf`) about the data which 
+should be extracted, covering signal data such as waveforms or
+median beats, as well as metadata relevant for downstream QC or as
+tabular information. 
+
+The module implements a basic application programming interface, mapping
+ECG data from distinct file types (e.g. XML or DICOM) to class attributes
+providing a fixed interface for downstream analysis and interrogation. 
+
+The documentation for ECGProcess can be found [here](https://SchmidtAF.gitlab.io/ECGProcess/). 
+
+
+## Installation 
+At present, the repository is undergoing development and no packages exist yet 
+on PyPy or in Conda.
+Therefore it is recommended that it is installed in either of the two ways
+listed below.
+First, clone this repository and then `cd` to the root of the repository.
+
+```sh
+git clone git@gitlab.com:SchmidtAF/ECGProcess.git
+cd ECGProcess
+```
+
+### Installation using conda dependencies
+A conda environment is provided in a `yaml` file in the directory 
+`./resources/conda/envs/`.
+A new conda environment called `ecgprocess` can be built using the command:
+
+```sh
+# From the root of the repository
+conda env create --file ./resources/conda/envs/conda_create.yaml
+```
+
+To add to an existing environment use:
+
+```sh
+# From the root of the repository
+conda env update --file ./resources/conda/envs/conda_update.yaml
+```
+
+Next the package can be installed: 
+
+```sh
+python -m pip install .
+```
+
+Or for an editable (developer) install run the command below from the root of 
+the repository.
+The difference with this is that you can just to a `git pull` to 
+update repository, or switch branches without re-installing:
+
+```sh
+python -m pip install -e .
+
+```
+### Installation not using any conda dependencies
+If you are not using conda in any way then install the dependencies via `pip` 
+and install repository as an editable install also via pip:
+
+Install dependencies:
+
+```sh
+python -m pip install --upgrade -r requirements.txt
+```
+
+Then to install repository you can either do:
+
+```sh
+python -m pip install .
+```
+
+Or for an editable (developer) install run the command below from the root of
+the repository.
+The difference with this is that you can just to a `git pull` to update
+repository, or switch branches without re-installing:
+
+```sh
+python -m pip install -e .
+```
+
+## Next steps...
+After installation you might wish to try the `pytest` to confirm 
+everything is in working order. 
+
+```sh
+# From the root of the repository
+pytest tests
+```
+
+## Usage
+
+Please have a look at the examples in 
+[resources](https://gitlab.com/SchmidtAF/ECGProcess/-/tree/master/resources/examples)
+for some possible recipes. 
+

ecgprocess-1.1.0/ecgprocess/__init__.py

@@ -0,0 +1 @@
+from ._version import __version__

ecgprocess-1.1.0/ecgprocess/_version.py

@@ -0,0 +1 @@
+__version__ = '1.1.0'

ecgprocess-1.1.0/ecgprocess/constants.py

@@ -0,0 +1,170 @@
+'''
+Constants used by ECGProcess
+'''
+
+from dataclasses import dataclass
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class CoreData:
+    '''
+    Core variable names which are used internally by various modules in
+    `ECGProcess`.
+    '''
+    # /////////////////////////////////////////////////////////////////////////
+    class DataTypes:
+        '''
+        Contains constants representing high-level data categories used
+        in ECG processing, such as waveforms, median beats, and metadata.
+        '''
+        WaveForms   = 'WaveForms'
+        MedianBeats = 'MedianBeats'
+        MetaData    = 'MetaData'
+        OtherData   = 'OtherData'
+    # /////////////////////////////////////////////////////////////////////////
+    class Leads:
+        '''
+        The internally used lead names.
+        '''
+        I   = 'I'
+        II  = 'II'
+        III = 'III'
+        aVR = 'aVR'
+        aVL = 'aVL'
+        aVF = 'aVF'
+        V1  = 'V1'
+        V2  = 'V2'
+        V3  = 'V3'
+        V4  = 'V4'
+        V5  = 'V5'
+        V6  = 'V6'
+    # /////////////////////////////////////////////////////////////////////////
+    class MetaData:
+        '''
+        Contains constants representing metadata fields required for
+        ECG processing.
+        '''
+        UID     = 'unique identifier'
+        NLEADS  = 'number of leads'
+        RES_U_W = 'resolution unit (waveforms)'
+        RES_U_M = 'resolution unit (medianbeats)'
+        RES_W   = 'resolution (waveforms)'
+        RES_M   = 'resolution (medianbeats)'
+        SF      = 'sampling frequency (original)'
+        SF_U    = 'sampling frequency unit'
+        SN_W    = 'sampling number (waveforms)'
+        SN_M    = 'sampling number (medianbeats)'
+    # /////////////////////////////////////////////////////////////////////////
+    class ProcessingData:
+        '''
+        Contains constants for attributes and variables created by the process
+        modules.
+        '''
+        TAGS      = 'tags'
+        RAW       = 'raw_data'
+        Duration  = 'duration (sec)'
+        SF_NEW    = 'sampling frequency (processed)'
+        RESAMPLE  = 'resample_500'
+        AUG_LEADS = 'augment_leads'
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class UtilsReaderNames(object):
+    '''
+    Names used in the Utils Reader Tools module.
+    '''
+    DICOM_WAVE_ARRAY     = 'waveform_array'
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class UtilsGeneralNames(object):
+    '''
+    Names used in the Utils General module.
+    '''
+    LXML_ERROR         = 'expected'
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class UtilsConfigData(object):
+    '''
+    Names used in the Utils Config Data module
+    '''
+    MetaData    = CoreData.DataTypes.MetaData
+    OtherData   = CoreData.DataTypes.OtherData
+    WaveForms   = CoreData.DataTypes.WaveForms
+    MedianBeats = CoreData.DataTypes.MedianBeats
+    path        = 'path'
+    data        = '_data'
+    MAPPER      = 'mapper'
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class ProcessXMLNames(object):
+    '''
+    Names used in the process_xml module.
+    '''
+    RESAMPLE  = CoreData.ProcessingData.RESAMPLE
+    AUG_LEADS = CoreData.ProcessingData.AUG_LEADS
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class ProcessDicomNames(object):
+    RESAMPLE  = CoreData.ProcessingData.RESAMPLE
+    AUG_LEADS = CoreData.ProcessingData.AUG_LEADS
+    
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class TabularNames(object):
+    E_META         = 'extract_'+CoreData.DataTypes.MetaData
+    E_WAVE         = 'extract_'+CoreData.DataTypes.WaveForms
+    E_MEDIAN       = 'extract_'+CoreData.DataTypes.MedianBeats
+    ENG_META       = 'engineer_'+CoreData.DataTypes.MetaData
+    ENG_WAVE       = 'engineer_'+CoreData.DataTypes.WaveForms
+    ENG_MEDIAN     = 'engineer_'+CoreData.DataTypes.MedianBeats
+    META_DICT      = 'meta_dict'
+    SKIP_PERM      = 'ignore_permission'
+    SKIP_DATA      = 'ignore_data'
+    SKIP_INVALID   = 'ignore_invalid'
+    CONFIRM_META   = 'confirm_meta'
+    CONFIRM_WAVE   = 'confirm_wave'
+    CONFIRM_MEDIAN = 'confirm_median'
+    SCHEMA         = 'schema'
+    RPATH_L        = 'raw_path_list'
+    FPATH_L        = 'failed_path_list'
+    CPATH_L        = 'curated_path_list'
+    KEY_L          = 'key_list'
+    NO_DATA_L      = 'no_data_list'
+    INVALID_L      = 'invalid_list'
+    TABLE_CALLED   = 'table_called'
+    WRITE_TAB      = 'table'
+    WRITE_NUMPY    = 'numpy'
+    WRITE_TFLOW    = 'tensorflow'
+    WRITE_ECG_PATH = 'target_path'
+    WRITE_TYPE     = 'file_type'
+    ID_START       = '_id_start_number'
+    KEY            = 'key'
+    FILENAM        = 'filename'
+    SIG_LEN_W      = 'signal_length_w'
+    SIG_LEN_M      = 'signal_length_m'
+    PAD_VALUE      = 'pad_value'
+    SN_W_PADDED    = 'sampling number padded (waveforms)'
+    SN_M_PADDED    = 'sampling number padded (medianbeats)'
+    DURATION_PADDED = 'duration padded (sec)'
+
+# %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+class PlotNames:
+    '''
+    Constants used by the ECGDrawing plotting module.
+    '''
+    MILLIVOLT       = 'millivolt'
+    MICROVOLT       = 'microvolt'
+    LEAD_VOLTAGES   = 'lead_voltages'
+    START_POS_FIRST = 'first'
+    # #### standard ECG paper grid dimensions (mm)
+    MINOR_GRID_MM   = 1.0
+    MAJOR_GRID_MM   = 5.0
+    # #### ECGDrawing slot names
+    DEFAULT_LEADS   = '_default_leads'
+    FIGURE          = 'figure'
+    AXES            = 'axes'
+    LAYOUT_MAPPER   = 'layout_mapper'
+    STYLE           = 'style'
+    MINOR_STEP_X    = 'minor_step_x'
+    MAJOR_STEP_X    = 'major_step_x'
+    MINOR_STEP_Y    = 'minor_step_y'
+    MAJOR_STEP_Y    = 'major_step_y'
+    PAPER_SPEED     = 'paper_speed'
+    MM_PER_MV       = 'mm_per_mv'