Overview
This page links to the tutorials of all applications for recognition of cardiovascular diseases by analysing medical and CFD data.
Tutorials
All tutorials are available here.
Content:
- Diagnosis tutorial
- Prognosis tutorial
- Interface tutorial
- LV segmentation and EF estimation tutorial
- CFD tutorial
Diagnosis tutorial
The full tutorial is available in the Sphinx repository here:
- Repository: AI-Based Cardiac Diagnosis from Echocardiography
- Diagnosis Tutorial: Provides a step-by-step guide on how to use the diagnosis codes.
- Documentation page: Describes the purpose and functionality of each code and script included in the repository.
What the tutorial covers
- How to organise the echocardiography datasets.
- How to run normalisation.
- (Optional) how to apply HODMD pre-processing.
- How to pre-train Masked Autoencoder (MAE).
- How to train the ViT classifier.
- How to evaluate the performance on new echocardiography datasets and inspect the results.
Related links
- Notebooks
- Datasets: Confidential CNIC datasets.
- Application hub: Cardiac Pathology
Prognosis tutorial
The full tutorial is available in the Sphinx repository here:
- Repository: AI-Based Cardiac Prognosis from Echocardiography
- Prognosis Tutorial: Provides a step-by-step guide on how to use the prognosis codes.
- Documentation page: Describes the purpose and functionality of each code and script included in the repository.
What the tutorial covers
- How to organise the echocardiography datasets.
- How to run normalisation.
- (Optional) how to apply HODMD pre-processing.
- How to pre-train Masked Autoencoder (MAE).
- How to train the ViT regression model.
- How to evaluate the performance on new echocardiography datasets and inspect the results.
Related links
- Notebooks
- Datasets: Confidential CNIC datasets.
- Application hub: Cardiac Pathology
Interface tutorial
CardioView is the clinical desktop interface that bridges the technical environment; modal decomposition and deep learning models, with the medical environment, letting clinicians load echocardiography videos and run the diagnosis and prognosis models directly, with no coding required. Like large-scale LLMs, the tool also supports automatic retraining on newly validated clinical cases once enough samples are collected.
Codes
This repository is currently private and not yet publicly available. If you are interested in accessing the code, please contact us at soledad.leclainche@upm.es.
LV segmentation and EF estimation tutorial
The full tutorial is available in the Sphinx repository here:
- Repository: EchoNet Cardiac Analysis Tutorial
- LV segmentation and EF estimation Tutorial
- Online tutorial
What the tutorial covers
- How to prepare the data.
- How to run normalisation.
- How to perform Left-Ventricle (LV) Segmentation.
- How to perform Ejection Fraction Prediction.
- How to validate the obtained results.
Related links
- Scripts
- Medical data
- Application hub: Cardiac Pathology
CFD & High-Fidelity Simulations tutorial
The full tutorial is available in the Sphinx repository here:
- Repository: Left Ventricle CFD Simulations
Explore our step-by-step video tutorials on setting up CFD simulations of the left ventricle. These resources include all necessary files to replicate our results, offering a comprehensive guide for anyone aiming to deepen their understanding or reproduce our findings.
What the tutorial covers
- How to perform geometry pre-processing to define ventricular wall motion required for the simulations.
- How to load the geometry, meshing, and set up the simulation in STAR-CCM+ to replicate left ventricle blood flow results.
- How to perform left ventricle blood flow simulations in Fluent.
Geometry Pre-Processing
This section provides our MATLAB codes for generating STL file sequences that define ventricular wall motion for CFD simulations. The workflow is based on integrating ventricular volume variation from a flow rate chart that describes the quantity of blood coming in and out of the left ventricle.
We offer two approaches:
- Idealized Geometry: Where the wall motion is defined analytically, and STL files are generated accordingly.
- Patient-Specific Geometry: Requires code adjustments since analytical expressions are unavailable. This process includes extracting the left ventricle model from cardiotomography data to ensure accurate patient-specific simulations.
Download the necessary files here.
Download the slides here.
CFD with Star-CCM+
This section provides a complete guide on replicating our blood flow simulations inside the left ventricle using STAR-CCM+. From loading the geometry and meshing to configuring the simulation settings, we walk you through each step to ensure accurate reproduction of our results.
Download the necessary files here.
Download the slides here.
CFD with Ansys Fluent
In this section, we outline the entire process of setting up blood flow simulations within the left ventricle using Ansys Fluent. From importing the geometry and generating the mesh to configuring the simulation parameters, this guide covers everything needed to successfully replicate our results.
Download the necessary files here.
Download the slides here.
Videos
- Introduction: Explanation of the project, integrating CFD simulations with Neural Networks:
- Step 1: Geometry pre-processing:
- Step 2: Replicating the blood flow simulations inside the left ventricle using STAR-CCM+:
- Step 3: Setting up blood flow simulations within the left ventricle using Ansys Fluent, grouping together everything required to successfully replicate the results:
Results
The ideal models of the left ventricle (LV) for our simulations are taken directly from these references and are shown in the following figure. These models essentially represent an idealization of the ventricular cavity with two tubes attached to simulate inflow and outflow through the mitral and aortic valves, respectively.

The computational framework used in this study is designed to solve the Navier-Stokes equations, assuming that blood behaves as an incompressible non-Newtonian fluid. We choose laminar flow conditions that are particularly effective in capturing the vortical features of the diastolic phase of the cardiac cycle. Boundary conditions are a critical aspect; therefore, wall motion, inflow and outflow are set to match the ventricular flow rate curve extracted from references. A grid convergence study was performed to ensure that the simulations were fine-tuned.
The primary objective of this study is to examine the formation and evolution of the vortex ring, a prominent flow feature during the E-wave of diastole. The vortex ring plays a pivotal role in cardiac hemodynamics and has been extensively studied in the literature. The vortex ring emerges from the mitral valve during the E-wave of diastole, with its axis aligned with the mitral valve axis. The initial shape of the vortex ring is that of a donut, although it is asymmetric, with a thinner profile closer to the wall. This indicates a healthy heart. As the vortex ring traverses the ventricle, it gradually tilts due to the reduction in inflow velocity. Interactions between the vortex ring and the ventricular walls result in the formation of secondary vortex tubes. These vortex tubes exhibit complex instabilities, which ultimately result in their interaction with the vortex ring and its subsequent destabilization. The evolution of this flow structure is depicted in Figures X and Y for the geometries used by Zheng et al. and Vedula et al., respectively.

This analysis highlights the importance of CFD in advancing our understanding of intracardiac flow dynamics and developing improved diagnostic and therapeutic strategies for cardiovascular diseases.
Related links
- Files for geometry pre-processing here.
- Files for CFD with Star-CCM+ here.
- Files for CFD with Ansys Fluent here.
- Application hub: Cardiac Pathology
Contributors
- Andrés Bell-Navas
- Ander Sánchez Muñoz
- Zhuoqun Zhao
- Eneko Lazpita Suinaga