# Dataset of Simulated Intracardiac Transmembrane Voltage Recordings and ECG Signals

**Authors: Mikel Landajuela (LLNL), Rushil Anirudh (LLNL), Robert Blake (LLNL) (IM release number : LLNL-MI-835833)**
<p align="center">
<img src="figures/rotating_hearts.gif" width=1000/>
</p>

The dataset consists of pairs of computationally simulated intracardiac transmembrane voltage recordings and ECG signals.
In total, 16140 organ-level simulations were conducted to create this dataset, using a library of heart geometries and physiological conditions (different tissue conductivities, basic cycle lengths, etc).
Simulations were performed at LLNL's Lassen supercomputer, concurrently utilizing 4 GPUs and 40 CPU cores.
Each simulation produced pairs of 500ms-by-10 ECG signals and 500ms-by-75 transmembrane voltage signals. 
For convenience, we collect those signals in matrices.
Each of these matrices is then stored as a numpy array.

The data generation process is illustrated in this figure:
<p align="center">
<img src="figures/dataset_gen_illustration.png" width=1000/>
</p>

For further details:
- Look in `documentation/documentation.pdf` for a detailed description of the dataset, including the simulation process
- Look at the files `documentation/dataset_description.png` and `documentation/dataset_description.csv` for details on each simulation study
- Jupyter Notebook: Inspect the data using `notebooks/dataset_inspect.ipynb`
- Mathematica Notebook: Inspect the data using `notebooks/dataset_inspect.nb`
- The license documents can be found in `license`

## Acknowledgments
We thank Livermore Computing (LC) at LLNL for the computational resources that enabled this work.
We thank the Laboratory Directed Research and Development (LDRD) program at LLNL under the National Nuclear Security Administration (NNSA) for their support of this work, project number 18-LW-078.
This work was performed under the auspices of the U.S. Department of Energy by Lawrence Livermore National Laboratory under Contract DE-AC52-07NA27344. LLNL-JRNL-799842.

## Copyright
Copyright (c) 2022, Lawrence Livermore National Security, LLC. 
Produced at the Lawrence Livermore National Laboratory 
Written by Mikel Landajuela Larma (landajuelala1@llnl.gov). 
Release number - LLNL-MI-835833-DRAFT. 
All rights reserved.

This work was produced under the auspices of the U.S. Department of Energy by Lawrence Livermore National Laboratory under Contract DE-AC52-07NA27344.
This work was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor Lawrence Livermore National Security, LLC, nor any of their employees makes any warranty, expressed or implied, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights.
Reference herein to any specific commercial product, process, or service by trade name, trademark, manufacturer, or otherwise does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States Government or Lawrence Livermore National Security, LLC.
The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States Government or Lawrence Livermore National Security, LLC, and shall not be used for advertising or product endorsement purposes.