Welcome to LifeCycles' documentation!
=======================================

``lifecycles`` is a Python software package designed to track and analyze the longitudinal evolution of groups of items,
e.g., data clusters, graph communities, etc.


If you would like to test ``lifecycles`` functionalities without installing it on your machine consider using the preconfigured Jupyter Hub instances offered by the H2020 `SoBigData++`_ research project.


================ =================== ==================  ==========  ===============
   **Date**      **Python Versions**   **Main Author**   **GitHub**      **pypl**
      2024           3.9 and up       `Andrea Failla`_    `Source`_  `Distribution`_
================ =================== ==================  ==========  ===============


^^^^^^^^^^^^^^^^^^^^
LifeCycles Dev Team
^^^^^^^^^^^^^^^^^^^^

======================= ==============================
**Name**                **Contribution**
`Andrea Failla`_        Library Design, implementation,
                        Documentation
`Salvatore Citraro`_    Implementation
`Rémy Cazabet`_         Implementation
======================= ==============================

.. note:: If you use ``lifecycles`` in your research, please cite it using the following BibTeX entry:

   .. code-block:: bibtex

      @article{Failla2024describing,
        title = {Describing group evolution in temporal data using multi-faceted events},
          ISSN = {1573-0565},
          url = {http://dx.doi.org/10.1007/s10994-024-06600-4},
          DOI = {10.1007/s10994-024-06600-4},
          journal = {Machine Learning},
          publisher = {Springer Science and Business Media LLC},
          author = {Failla,  Andrea and Cazabet,  Rémy and Rossetti,  Giulio and Citraro,  Salvatore},
          year = {2024},
          month = aug
        }

.. toctree::
   :maxdepth: 1
   :hidden:

   overview.rst
   installing.rst
   tutorial.rst
   reference/reference.rst


.. _`Andrea Failla`: https://github.com/andreafailla
.. _`Salvatore Citraro`: https://github.com/dsalvaz
.. _`Rémy Cazabet`: https://cazabetremy.fr
.. _`Source`: https://github.com/andreafailla/lifecycles
.. _`Distribution`: https://pypi.python.org/pypi/lifecycles
.. _`SoBigData++`: https://sobigdata.d4science.org/group/sobigdata-gateway/explore?siteId=20371853