In Silico Evaluation of Spatiotemporal Dispersion as a Therapeutic Target in Atrial Fibrillation across a Virtual Population (dataset)

# Biatrial EP Simulation Visualization Author: Giada Sira Romitti Affiliation: Computational Multiscale Simulation Laboratory (CoMMLab), Universitat de València, Valencia, Spain Date: June 2026 This repository provides a MATLAB-based visualization script intended for the inspection and reproduction of results from precomputed electrophysiology simulations on biatrial shell geometries, presented in the study: “In Silico Evaluation of Spatiotemporal Dispersion as a Therapeutic Target in Atrial Fibrillation across a Virtual Population” The code enables the visualization of existing simulation outputs and corresponding atrial surface meshes, including both temporal signals and spatial distributions of membrane potential. The dataset contains simulation results for Control, Pulmonary Vein Isolation (PVI), and PVI combined with spatiotemporal dispersion ablation (PVI+STD) protocols, performed on a subset of 40 virtual patient models selected from a cohort of 160 models, representing those exhibiting the highest atrial fibrillation (AF) activity. Each simulation was performed using seven different pacing sites. Only cases that resulted in sustained AF or atrial flutter (AFlut) are included in the repository. Consequently, some folders may be empty, as no sustained arrhythmic event was observed for those specific configurations. --- ## Contents├── main_read_results.m├── Biatrial_Geometry_Shell/│ ├── shellModel_gXXX.mat│ └── ...│├── 01_gXXX_UtahY_RemodZZZ/│ ├── Control/│ ├── PVI/│ └── PVI+STD/│├── 02_gXXX_UtahY_RemodZZZ/│ ├── Control/│ ├── PVI/│ └── PVI+STD/│...│├── 40_gXXX_UtahY_RemodZZZ/│ ├── Control/│ ├── PVI/│ └── PVI+STD/ --- ## Description of folders ### `main_read_results.m`Main MATLAB script used to load and visualize simulation results. It:- Loads atrial geometry and simulation outputs- Removes vein/valve cap nodes from geometry and signals- Focuses on the last 2.5 seconds of simulation- Displays: - A representative membrane potential time trace - A spatial membrane potential map on the atrial surface --- ### `Biatrial_Geometry_Shell/`This folder contains MATLAB `.mat` files describing the biatrial shell geometries. Each file includes:- `vertices`: 3D coordinates of the atrial mesh nodes- `faces`: triangular surface connectivity These geometries correspond to different anatomical models (`gXXX`). --- ### Simulation folders (`01_...` to `40_...`)Each folder contains electrophysiology simulation results for a given anatomical model and remodeling configuration. Folder naming convention: {index}_gXXX_UtahY_RemodZZZ, where: - **gXXX**: biatrial anatomical model identifier- **UtahY**: fibrosis distribution scenario (Y = 1 to 4)- **RemodZZZ**: electrical remodeling percentage (Z = 25 to 125) Each simulation typically includes:- `PA`: matrix of membrane potentials (nodes × time)- `ind_valvPV`: indices of vein/valve cap nodes to be removed from analysis --- ## Time window All visualizations in `main_read_results.m` focus on the last 2.5 seconds of simulation time, assumed to represent the final dynamics of the simulation. --- ## Requirements - MATLAB R2018 or later (recommended)- No additional toolboxes required for basic visualization --- ## How to run 1. Download the repository2. Open MATLAB in the root directory3. Run: main_read_results.m