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, Performance, Contributing to PyAFV, and API reference sections for further information, including how to install the package, usage examples, benchmarks, local development, and the complete API reference.

Note

For the latest updates, see the GitHub repository.

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. Performance
  • 3.1. Measuring performance
  • 3.2. Benchmarking backends
• 4. Calibration
  • 4.1. How to calibrate against the DP model
  • 4.2. Usage of the DP simulator
• 5. Contributing to PyAFV
  • 5.1. Code of Conduct
  • 5.2. How to contribute
  • 5.3. Coding standards
  • 5.4. Documentation requirements
  • 5.5. Writing tests
  • 5.6. Featured examples
  • 5.7. Submitting a pull request
  • 5.8. Reporting issues
  • 5.9. Code review process
  • 5.10. Questions?
• 6. API reference
  • 6.1. pyafv
  • 6.2. pyafv.PhysicalParams
  • 6.3. pyafv.FiniteVoronoiSimulator
  • 6.4. pyafv.target_delta
  • 6.5. pyafv.calibrate

Caution

Future versions may introduce changes to features and APIs.

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.

[4]

J.-Q. Lv, P.-C. Chen, Y.-P. Chen, H.-Y. Liu, S.-D. Wang, J. Bai, C.-L. Lv, Y. Li, Y. Shao, X.-Q. Feng, and B. Li. Active hole formation in epithelioid tissues. Nature Physics, 20(8):1313–1323, 2024. doi:10.1038/s41567-024-02504-1.

Indices

• Index

• Module Index