This release is a pre-release and may not be stable for production use.
Arritmic3D: A fast Eikonal computational model for electrophysiology
simulation CoMMLab 2026-01-01
Arritmic3D is a fast Eikonal computational model for electrophysiology simulation.
The simulator has three versions in separate branches: branch main
(this branch), with a development version, branch ventricle, with the
ventricle version, and branch atria, with the atria version. Checkout
the desired branch before proceeding.
The original version of the solver was developed in the Java environment Processing. Now it is being migrated to C++ and provided with a Python interface.
Installation
Arritmic3D is available as a Python package in PyPI. From a python environment, you can install the package using pip:
pip install arritmic3d
This will also install some convenience scripts that can be used from outside the python environment, as command line tools (see the usage section).
Compilation from source
You can also compile the wheel yourself. To compile it, you need a standard C++17 compiler, Eigen and Pybind11 installed in your system.
As a reference, in an ubuntu machine it should be enough to run:
sudo apt-get install \
build-essential \
pkg-config \
cmake \
python3-dev \
gcc \
g++ \
libeigen3-dev \
python3-pybind11
Then, clone the repository from GitHub and compile the wheel by running:
python -m pip install --upgrade pip setuptools wheel
python -m pip install .
Usage
The solver is presented as a C++ library with is wrapped in a Python module.
In addition, a Python script to run simulations is provided as an executable called arritmic3d. This script is meant to provide a reather flexible way to run simulations in many common scenarios.
However, for advanced usage, you can build your own Python programs that use the Arritmic3D module. You can find the Arritmic3D API documentation here.
A guide on the usage of the arritmic3d script and other related tools can be found in the
web page.
Citing Arritmic3D
If you find Arritmic3D useful for your research, please cite the following paper:
Serra, Dolors, Pau Romero, Ignacio Garcia-Fernandez, Miguel Lozano, Alejandro Liberos, Miguel Rodrigo, Alfonso Bueno-Orovio, Antonio Berruezo, and Rafael Sebastian. 2022. “An Automata-Based Cardiac Electrophysiology Simulator to Assess Arrhythmia Inducibility.” Mathematics 10 (8): 1293. https://doi.org/10.3390/math10081293.
Related research
Romitti, Giada S., Alejandro Liberos, María Termenón-Rivas, Javier Barrios-Álvarez De Arcaya, Dolors Serra, Pau Romero, David Calvo, et al. 2025. “Implementation of a Cellular Automaton for Efficient Simulations of Atrial Arrhythmias.” Medical Image Analysis 101 (April): 103484. https://doi.org/10.1016/j.media.2025.103484.
Serra, D., P. Franco, P. Romero, G. Romitti, I. García-Fernández, M. Lozano, A. Liberos, et al. 2023. “Assessment of Risk for Ventricular Tachycardia Based on Extensive Electrophysiology Simulations.” In 2023 45th Annual International Conference of the IEEE Engineering in Medicine & Biology Society (EMBC), 1–4. Sydney, Australia: IEEE. https://doi.org/10.1109/EMBC40787.2023.10340169.
Serra, Dolors, Paula Franco, Pau Romero, Ignacio García-Fernández, Miguel Lozano, David Soto, Diego Penela, Antonio Berruezo, Oscar Camara, and Rafael Sebastian. 2022. “Personalized Fast Electrophysiology Simulations to Evaluate Arrhythmogenicity of Ventricular Slow Conduction Channels.” In Statistical Atlases and Computational Models of the Heart. Regular and CMRxMotion Challenge Papers, edited by Oscar Camara, Esther Puyol-Antón, Chen Qin, Maxime Sermesant, Avan Suinesiaputra, Shuo Wang, and Alistair Young, 13593:56–64. Cham: Springer Nature Switzerland. https://doi.org/10.1007/978-3-031-23443-9_6.
Serra, Dolors, Pau Romero, Paula Franco, Ignacio Bernat, Miguel Lozano, Ignacio Garcia-Fernandez, David Soto, Antonio Berruezo, Oscar Camara, and Rafael Sebastian. 2025. “Unsupervised Stratification of Patients With Myocardial Infarction Based on Imaging and In-Silico Biomarkers.” IEEE Transactions on Medical Imaging 44 (12): 4762–74. https://doi.org/10.1109/TMI.2025.3582383.
Serra, Dolors, Pau Romero, Miguel Lozano, Ignacio Garcia-Fernandez, Diego Penela, Antonio Berruezo, Oscar Camara, Miguel Rodrigo, Miriam Gil, and Rafael Sebastian. 2024. “Patient Stratification Based on Fast Simulation of Cardiac Electrophysiology on Digital Twins.” In Statistical Atlases and Computational Models of the Heart. Regular and CMRxRecon Challenge Papers, edited by Oscar Camara, Esther Puyol-Antón, Maxime Sermesant, Avan Suinesiaputra, Qian Tao, Chengyan Wang, and Alistair Young, 14507:35–43. Cham: Springer Nature Switzerland. https://doi.org/10.1007/978-3-031-52448-6_4.
Metadata
Release files for arritmic3d 3.0b8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| arritmic3d-3.0b8.tar.gz | 18.8 MB | Without provenance | Details |
Built distributions (wheels)
Total release size: 64.1 MB
Release files / arritmic3d-3.0b8.tar.gz
| Download URL | arritmic3d-3.0b8.tar.gz |
|---|---|
| Size | 18.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
840a72779961dc6927348224cbf25e6556b6303842ed4bb994800638ec36ff56
|
|
BLAKE2b-256 checksum How to use checksums |
a1fd7f0dbfa19ee78680e261c78bcd371fdad86bdc38998fd41f08fd2cff9bc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp313-cp313-win_amd64.whl
| Download URL | arritmic3d-3.0b8-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
528892ab1de3a9a745e6103bc3b18d89957338c6d804914f5f0c77cc13319086
|
|
BLAKE2b-256 checksum How to use checksums |
9eea03d5eb6b4a49bd3931331d744e0c90dd8ac13bccbb685572f8b354ccb1cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arritmic3d-3.0b8-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
c86092c497d09f5f5ea45841eb97bcfbdc4ed6b5c87d60d0b53e87a58f8f7487
|
|
BLAKE2b-256 checksum How to use checksums |
f6158c1719fba968b86366f113c48b183474d40dd1db8390f2e627b31aa3f51d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | arritmic3d-3.0b8-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ea59bcf9639744baa733384669917af64836d5d45f5eb2188e49cbea47208202
|
|
BLAKE2b-256 checksum How to use checksums |
849e5c9cbe3b7068f982f2ee344c384bdad8c77a9c9b51a5fe9c378a743fc3a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp312-cp312-win_amd64.whl
| Download URL | arritmic3d-3.0b8-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c5f2b00ca08edc18f8f0110f8eab078a522d27aec97aa14ffd7c18b8967ca9b8
|
|
BLAKE2b-256 checksum How to use checksums |
2c8d2c78b4d8336e88262dd25d52f506ca957d9dece5cc8df029fda256a5dbd8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arritmic3d-3.0b8-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
11aff4763ce6ff99e6d86099cc0f1d4bd7fdf4689ff2d217b86bd9eb4b22e10c
|
|
BLAKE2b-256 checksum How to use checksums |
df4e6dc86571c504ed06cba98f6fbd1b2a75bdcc8a9596325f92f515a65b52ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | arritmic3d-3.0b8-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4d9efd4965f3f02163078a47e1257e9b09596216cdd94d9d47253471f068c1ad
|
|
BLAKE2b-256 checksum How to use checksums |
e120df7912a37541dc6fb09e24ac0cc98d3f8d23859f05f7e76c8b7844ffcd22
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp311-cp311-win_amd64.whl
| Download URL | arritmic3d-3.0b8-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d2c82c851f050b1c7b0ca9e5b0ab1bc89902e243e2b0da5f4253ca34a8890183
|
|
BLAKE2b-256 checksum How to use checksums |
7742803b38b049f2511fff5bd2dd26c6669cd214698f3df54fb0a9b93023edf9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arritmic3d-3.0b8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
1fe57d5394ee12a2f4ebba56dc2db7b02006481806d1191e68365003ec96658b
|
|
BLAKE2b-256 checksum How to use checksums |
306680dd03940178fe31978e216757a7770ea98b43d6eaeaa9b20157fb071754
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | arritmic3d-3.0b8-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
cde6ab43deedfc463c37938cc02de2be05d5d0055390f3f2556bff0937a86787
|
|
BLAKE2b-256 checksum How to use checksums |
40f2649e3cd5c829a58316bea0143824b63f81b04f2eb8db0871ffd1299ecbc0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp310-cp310-win_amd64.whl
| Download URL | arritmic3d-3.0b8-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
834eb5891fc226a20e339b46fdc5124380c247778f5b08d04549000e0832e6ed
|
|
BLAKE2b-256 checksum How to use checksums |
6d127939bfc1a8d47f271eb765d0b170ab18232e4dfd0db8d6e66494ca1f361d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arritmic3d-3.0b8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
1972de8431af586315f1f090d7a19a82092961f25781b754c1d6c9d756870f52
|
|
BLAKE2b-256 checksum How to use checksums |
55f62a64a3b1dd1d478a3901140833dd84e5e2dfee081015d701a1b73e6f2c44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Release files / arritmic3d-3.0b8-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | arritmic3d-3.0b8-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a18b8def6875891dac8b35ba2345d979d48205a7d8c1f8fb2d08a9a7f37e4b24
|
|
BLAKE2b-256 checksum How to use checksums |
0aa3c69a79e906434665fc1c16cd730d00ee8b79ba3a2324d8ecf8394fcb3df0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.1.1 CPython/3.12.13
|
Security for arritmic3d 3.0b8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
