Walrus-Heart
forecasting electrical waves in cardiac tissue
2 min read
Walrus-Heart is built on the Walrus physics foundation model (1.3B parameters from Polymathic AI) and fine-tuned to predict electrical waves in cardiac tissue. It simulates normal contractions, premature beats, and re-entrant spiral waves characteristic of ventricular tachycardia across healthy, fibrotic, and scarred tissue. Unlike the base model, it is adapted to specific biophysical problems in cardiology and uses new field embeddings. It is geared toward researchers working on cardiac digital twins and physics-informed machine learning.
Key features
- Walrus fine-tuning: adapts the 1.3-billion-parameter physics model to the dynamics of cardiac electrical activity.
- Pretraining efficiency: outperforms counterparts trained from scratch even when using 8 times less data.
- Tissue structure modeling: accounts for conductivity, voltage, and tissue recovery levels on a 2D grid.
- Ready-to-use checkpoints: weights are available for different training configurations and durations.
What you can do
- Run an interactive sandbox: test the physics simulation in the model's demo space.
- Analyze wave propagation: explore simulations of normal rhythms and arrhythmias on virtual tissue.
- Integrate into your pipeline: use the loading code and configs for your own experiments with Walrus.
- Use for educational research: leverage the simulations and dataset for research projects on cardiac activity modeling.
Example
# pip install "walrus @ git+[https://github.com/PolymathicAI/walrus@73f2cf6b4c5871c8f5434802725b55666c66b5ab](https://github.com/PolymathicAI/walrus@73f2cf6b4c5871c8f5434802725b55666c66b5ab)" huggingface_hub safetensors
import json
from huggingface_hub import hf_hub_download
from hydra.utils import instantiate
from omegaconf import OmegaConf
from safetensors.torch import load_file
run = "pretrained_n200"
cfg = OmegaConf.load(hf_hub_download("Ethgar/walrus-heart", f"{run}/model_config.yaml"))
fmap = json.load(open(hf_hub_download("Ethgar/walrus-heart", f"{run}/field_to_index_map.json")))
model = instantiate(cfg.model, n_states=max(fmap.values()) + 1)
model.add_ft_options({"learnable_rope": True, "rope_per_axis": True})
model.load_state_dict(load_file(hf_hub_download("Ethgar/walrus-heart", f"{run}/model.safetensors")))
Read more
Details• Benchmarks: best single-step test VRMSE is 0.145 / 0.154 depending on the pretrained checkpoint.
• Hardware requirements: trained on a single A100 80 GB GPU.
• Limitations: begins to drift on long rollouts (more than 10–20 steps); the simulation is based on the Aliev-Panfilov model.
• Intended use: strictly for research and educational purposes, not for clinical use.










Comments