ModularCirc

ModularCirc is a Python-based toolkit designed to simulate how blood flows through the body. It focuses on simplified, mathematical representations of the cardiovascular system—known as lumped parameter models. These models approximate key physiological quantities, such as blood pressure or heart chamber volume, using single values that represent entire regions or organs. This approach makes simulations faster and easier to work with while still capturing important dynamics.

The library is built to support users with different levels of expertise. At the simplest level, ModularCirc provides ready-made models that can be loaded and explored without writing much code—ideal for quick testing and learning. For those who want more control, it offers a set of building blocks (like simplified arteries or heart chambers) that can be connected to form custom systems. And for advanced users, ModularCirc makes it possible to create entirely new components from scratch, offering full flexibility to define how each part behaves. This layered design makes it a powerful and adaptable tool for cardiovascular research and education.

Getting Started

ModularCirc is available as a Python package and can be installed via pip:

python -m pip install ModularCirc

For more information and detailed documentation, visit the ModularCirc GitHub repository.