Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

heArtX

A cloud platform for patient-specific finite-element cardiac simulation.

🌐 Live: https://heartx.egr.msu.edu/

heArtX makes patient-specific cardiac biomechanics modeling accessible through the browser: from medical images, users generate finite-element heart models, run whole-heart simulations on high-performance computing (HPC), and explore the results interactively — without managing solvers or infrastructure themselves.

This repository is a public overview and documentation of heArtX. The platform is a private research codebase; no source is published here.

What it does

  • Image → model. Generate patient-specific finite-element heart meshes from cardiac images (segmentation → volumetric mesh generation → fiber assignment).
  • Simulate. Run left-ventricular through four-chamber cardiac-mechanics simulations, coupling myocardial contraction with the systemic and pulmonary circulation.
  • Explore. Inspect pressure–volume behavior, strain, and stress fields in an interactive, browser-based 3D viewer.
  • Reproducible by design. Containerized compute, automated testing, and CI/CD.

Architecture

flowchart LR
  U["User · Browser"] --> W["Web / REST API<br/>auth · per-user data"]
  W --> Q["Async task layer"]
  Q --> C["Containerized compute workers"]
  C --> H[("HPC / batch scheduler")]
  C --> S[("Scientific data store<br/>VTK · HDF5")]
  S --> W
Loading

A split service / compute design: an authenticated web/API tier with per-user data isolation, an asynchronous task layer, and containerized compute workers that offload heavy finite-element runs to HPC. See docs/architecture.md for detail.

Tech stack

Layer Technologies
Backend / API Python, FastAPI, Celery, Redis, PostgreSQL
Simulation FEniCS/DOLFINx, PETSc, MPI, Gmsh/TetGen
Compute / infra Apptainer (containers), Slurm/HPC, VTK/HDF5/XDMF
Engineering Git/GitHub, CI/CD, automated testing

Screenshots

Screenshots live in screenshots/(placeholder; sanitized UI/result images to be added).

Related publications

  • Geometric deep learning for rapid cardiac activation — npj Digital Medicine (2026) · doi
  • Purkinje conduction block & cardiac pump function — Bioengineering (2026) · doi
  • Four-chamber heart mechanics coupled to systemic & pulmonary circulation — preprint, under review

Author

Vahid Ziaei-Rad — sole architect & lead developer. Email · Profile · Google Scholar

About

Public showcase & docs for heArtX — a cloud platform for patient-specific finite-element cardiac simulation (source is private).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors