.. .. include:: ../README.rst

PyAFV
======

.. image:: ../assets/model_illustration.png
   :width: 300px
   :align: right

**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. :cite:`huang2023bridging,teomy2018confluent,wang2026divergence`.

.. It pulls data from the `Open Food Facts database <https://world.openfoodfacts.org/>`_
.. and offers a *simple* and *intuitive* API.

Check out the :doc:`usage`, :doc:`examples`, and :doc:`api/index` section for further information, including
how to :ref:`install <installation>` the project, usage examples, and the complete API reference.

.. |GitHub| replace:: **GitHub**
.. _GitHub: https://github.com/wwang721/pyafv

.. note::

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


.. image:: ../assets/pbc.png
   :width: 300px
   :align: right


Contents
--------

.. toctree::
   :maxdepth: 3
   :numbered:

   Home <self>
   usage
   examples
   api/index


.. warning::

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


References
----------

.. bibliography:: ./main.bib
   :style: unsrt