.. MotilA documentation master file, created by
   sphinx-quickstart on Fri Nov 21 14:13:59 2025.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

MotilA documentation
====================

.. image:: https://badgen.net/badge/icon/GitHub%20repository?icon=github&label
   :target: https://github.com/FabrizioMusacchio/motila/
   :alt: GitHub Repository

.. image:: https://img.shields.io/github/v/release/FabrizioMusacchio/motila
   :target: https://github.com/FabrizioMusacchio/motila/releases
   :alt: GitHub Release

.. image:: https://img.shields.io/pypi/v/motila.svg
   :target: https://pypi.org/project/motila/
   :alt: PyPI Version

.. image:: https://img.shields.io/badge/License-GPL%20v3-green.svg
   :target: https://motila.readthedocs.io/en/latest/overview.html#license
   :alt: GPLv3 License

.. image:: https://github.com/FabrizioMusacchio/motila/actions/workflows/python-tests.yml/badge.svg
   :target: https://github.com/FabrizioMusacchio/motila/actions/workflows/python-tests.yml
   :alt: Test Status

.. image:: https://img.shields.io/github/last-commit/FabrizioMusacchio/MotilA
   :target: https://github.com/FabrizioMusacchio/MotilA/commits/main/
   :alt: GitHub Last Commit

.. image:: https://img.shields.io/codecov/c/github/FabrizioMusacchio/Motila?logo=codecov
   :target: https://codecov.io/gh/fabriziomusacchio/motila
   :alt: Code Coverage

.. image:: https://img.shields.io/github/issues/FabrizioMusacchio/MotilA
   :target: https://github.com/FabrizioMusacchio/MotilA/issues
   :alt: Open Issues

.. image:: https://img.shields.io/github/issues-closed/FabrizioMusacchio/MotilA?color=53c92e
   :target: https://github.com/FabrizioMusacchio/MotilA/issues?q=is%3Aissue%20state%3Aclosed
   :alt: Closed Issues

.. image:: https://img.shields.io/github/issues-pr/FabrizioMusacchio/MotilA
   :target: https://github.com/FabrizioMusacchio/MotilA/pulls
   :alt: Pull Requests

.. image:: https://readthedocs.org/projects/motila/badge/?version=latest
   :target: https://motila.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

.. image:: https://img.shields.io/github/languages/code-size/fabriziomusacchio/motila
   :alt: GitHub Code Size

.. image:: https://img.shields.io/pypi/dm/MotilA?logo=pypy&label=PiPY%20downloads&color=blue
   :target: https://pypistats.org/packages/motila
   :alt: PyPI Downloads and Stats


`MotilA <https://github.com/FabrizioMusacchio/MotilA>`_ is a Python-based pipeline for microglial fine process motility analysis
from 4D and 5D multiphoton imaging data.


This documentation provides:

* an overview of the pipeline and its scientific context,
* installation and basic usage instructions,
* a detailed description of the processing steps and parameters,
* an automatically generated API reference.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   overview
   data_requirements
   tutorials
   parameters
   api
   contributing

MotilA is `free and open-source software (FOSS) <https://en.wikipedia.org/wiki/Free_and_open-source_software>`_ distributed under the :ref:`GPL-3.0 license <license>`.