The CircAdapt Framework: Create Fast Computational Models of Cardiovascular Function

The CircAdapt framework marks a milestone in cardiovascular system modeling, transforming the established CircAdapt model into a comprehensive platform that enables the development and implementation of multiple model variants. At its core, the framework maintains the one-fiber assumption to relate local sarcomere mechanics to global hemodynamics. The framework consists of three components: a high-performance C++ library, a Python-based interface (pyCircAdapt), and a graphical user interface (CircAdaptUI). The C++ library serves as the computational engine, featuring extensively verified modules that define ordinary differential equations for cardiovascular simulation. These modules undergo rigorous testing and are complemented by comprehensive documentation. PyCircAdapt provides a user-friendly wrapper that simplifies interaction with the core library, allowing researchers to focus on conceptual model development rather than numerical implementation. The framework supports both closed-loop and open-loop configurations. Additionally, the framework’s modular architecture enables external module development, providing flexibility for specialized research applications while maintaining high computational efficiency. A graphical user interface (CircAdaptUI) further enhances accessibility for research and educational purposes. This paper presents the framework’s architecture, components, and capabilities, demonstrating its versatility in creating fast, functional cardiovascular models tailored to specific research needs.