Resilient source seeking with robot swarms - 2D

This repository was introduced in a lesson given by Héctor García de Marina at MRS Summer School 2023. It contains some Python simulations that help us to validate the results and findings presented in the following articles:

    @misc{acuaviva2024resilientsourceseekingrobot,
      title={Resilient source seeking with robot swarms}, 
      author={Antonio Acuaviva and Jesus Bautista and Weijia Yao and Juan Jimenez and Hector Garcia de Marina},
      year={2024},
      url={https://arxiv.org/abs/2309.02937},
    }

Installation

We recommend creating a dedicated virtual environment to ensure that the project dependencies do not conflict with other Python packages:

python -m venv venv
source venv/bin/activate

Then, install the required dependencies:

pip install --upgrade pip
pip install -r requirements.txt

requirements.txt contains the versions tested for compatibility with the simulator. Do not modify the versions to ensure stable and reproducible environments. Note that ssl_simulator already provides stable versions for the following core packages: numpy, matplotlib, tqdm, pandas, scipy, ipython.

Additional Dependencies

Some additional dependencies, such as LaTeX fonts and FFmpeg, may be required. We recommend following the installation instructions provided in the ssl_simulator README.

Usage

We recommend running the Jupyter notebooks in the notebooks directory to get an overview of the project's structure and see the code in action.

Credits

This repository is maintained by Jesús Bautista Villar. For inquiries or further information, please get in touch with him at jesbauti20@gmail.com.