CircAdapt Framework
A modular simulation framework for cardiovascular research
The CircAdapt framework is designed for researchers and students who want to simulate cardiovascular mechanics and hemodynamics using custom models in a fully scriptable environment. It provides a flexible, physics-based modeling approach that is accessible through Python, with a focus on reproducibility, extensibility, and integration into research workflows. Developed over the past 25 years at the Maastricht University department of biomedical engineering, this framework has been widely applied in research and education.
If you are looking for an interactive graphical tool to explore cardiovascular physiology without programming, download the CircAdaptUI tool from our website: www.circadapt.org.
This documentation is focused on the Python interface to CircAdapt. It includes technical guidance on installation, model composition, simulation control, and customization.
Get started
Why use pyCircAdapt?
Modular architecture: build models by combining heart, vessel, and control system modules
Accessible in Python: script all simulations and analysis programmatically
Pre-built models: start quickly or adapt existing cardiovascular simulations
Open and scriptable: create fully customized simulation protocols with complete control over model configuration and execution
Extensible design: extend functionality through C++ plugins for advanced customization
Validated: used in peer-reviewed research and academic teaching
Key models in pyCircAdapt
pyCircAdapt includes several example models. In this context, a model refers to a combination of modules that are parameterized to together represent the healthy cardiovascular system. These models illustrate the modular structure of the framework, demonstrate key functionalities, and help users get started quickly.
