PyAFV

PyAFV is a Python implementation of the active-finite-Voronoi (AFV) model in 2D.

The AFV framework was introduced and developed in, for example, Refs. [1, 2, 3].

Check out the Getting started, Examples, and API reference sections for further information, including how to install the package, usage examples, and the complete API reference.

Note

This project is under active development, see GitHub for the latest updates.

Contents

• Home
• 1. Getting started
  • 1.1. Installation
  • 1.2. A simple example
• 2. Examples
  • 2.1. Relaxation to mechanical equilibrium
  • 2.2. Active-Finite-Voronoi (AFV) dynamics
  • 2.3. Connectivity between cells
  • 2.4. Custom plotting
  • 2.5. Periodic boundary conditions
  • 2.6. Varying cell target areas from cell to cell
• 3. Contributing to PyAFV
  • 3.1. How to contribute
  • 3.2. Coding standards
  • 3.3. Documentation requirements
  • 3.4. Writing tests
  • 3.5. Featured examples
  • 3.6. Submitting a pull request
  • 3.7. Reporting issues
  • 3.8. Code review process
  • 3.9. Questions?
• 4. API reference
  • 4.1. pyafv
  • 4.2. pyafv.PhysicalParams
  • 4.3. pyafv.FiniteVoronoiSimulator
  • 4.4. pyafv.target_delta

Warning

This is an early release of the software. Features and APIs may change in future versions.

References

[1]

J. Huang, H. Levine, and D. Bi. Bridging the gap between collective motility and epithelial–mesenchymal transitions through the active finite voronoi model. Soft Matter, 19(48):9389–9398, 2023. doi:10.1039/D3SM00327B.

[2]

E. Teomy, D. A. Kessler, and H. Levine. Confluent and nonconfluent phases in a model of cell tissue. Phys. Rev. E, 98:042418, Oct 2018. doi:10.1103/PhysRevE.98.042418.

[3]

W. Wang and B. A. Camley. Divergence of detachment forces in the finite-voronoi model, manuscript in preparation. manuscript in preparation, 2026.