Active Finite Voronoi

Build living tissue simulations with the Active-Finite-Voronoi model.

PyAFV is a simple Python toolkit for generating 2D finite-Voronoi tessellations, modeling cell mechanics, and exploring collective motility under active dynamics.

Explore the Repo Read the Docs Install from PyPI

Geometric insight, physical fidelity

Compute areas, perimeters, vertices, edges, and conservative forces while visualizing emergent tissue structure in real time.

Why PyAFV?

Core capabilities

Finite-Voronoi geometry

Generate and analyze finite Voronoi diagrams with rich geometric data: cell areas, perimeters, edges, vertices, and connectivity.

Active tissue dynamics

Activate motility and explore collective motion driven by self-propulsion, adhesion, and confinement.

Ready for experiments

Python ≥ 3.10 support, Cython-accelerated components, and clean APIs for integration into research workflows.

Install & simulate

Quick start

Install

$ pip install pyafv

Build a diagram

>>> import numpy as np
>>> import pyafv as afv
>>> N = 100
>>> pts = np.random.rand(N, 2) * 10 
>>> params = afv.PhysicalParams(r=1.0) 
>>> sim = afv.FiniteVoronoiSimulator(pts, params)
>>> sim.plot_2d(show=True)

Dig deeper

Access the full geometry and conservative forces via sim.build( ) and inspect the returned dictionary for areas, perimeters, edges, and vertices.

View docs

Simulation previews

Visual gallery