MCPcopy Index your code
hub / github.com/MengyunQ/MeshHeart

github.com/MengyunQ/MeshHeart @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
69 symbols 153 edges 8 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

MeshHeart: A Personalized 3D+t Mesh Generative Model for Unveiling Normal Heart Dynamics

Official implementation of the Nature Machine Intelligence 2025 paper

Qiao M., McGurk K.A., Wang S., Matthews P., O'Regan D., Bai W.

Overview

MeshHeart is a geometric deep generative model that reconstructs and generates personalized 3D+t cardiac mesh sequences from demographic and anthropometric conditions (age, sex, weight, height). It models cardiac motion dynamics using a graph-based latent VAE and temporal transformer, enabling normative modelling and disease deviation quantification across large-scale population data.

MeshHeart generates temporally smooth, anatomically realistic 4D cardiac meshes conditioned on age, sex, weight, and height.

Features

  • 🫀 Models personalized 4D cardiac mesh dynamics from clinical attributes
  • 🧠 Latent transformer VAE architecture for spatial-temporal modelling
  • ⚙️ Latent delta to quantify deviation from normal heart function
  • 🧬 PheWAS-enabled discovery of genotype–phenotype–disease links
  • 📊 Trained on 38,309 UK Biobank subjects

Installation

```bash git clone https://github.com/your-username/MeshHeart.git cd MeshHeart conda env create -f environment.yml conda activate meshheart

Core symbols most depended-on inside this repo

normal
called by 2
model/layers.py
reparameterize
called by 2
model/transformer_vae_batch.py
load_config
called by 1
config.py
save_model
called by 1
main.py
train
called by 1
main.py
val
called by 1
main.py
main
called by 1
main.py
MSE_loss
called by 1
loss/loss.py

Shape

Method 38
Function 17
Class 14

Languages

Python100%

Modules by API surface

model/transformer_vae_batch.py28 symbols
model/layers.py11 symbols
loss/loss.py8 symbols
util/utils.py7 symbols
loss/earth_mover_distance.py6 symbols
main.py4 symbols
data/dataloader.py4 symbols
config.py1 symbols

For agents

$ claude mcp add MeshHeart \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact