lemons-crowd 1.0.5
Python wrapper for the LEMONS library to generate anthropometry-based, non-circular pedestrian shapes, visualize crowds, and simulate 2D dynamics.
Requires Python: >=3.13
Keywords: crowd generation, crowd dynamics, pedestrian dynamics, anthropometry, mechanical interactions, bideltoid breadth, chest depth, non-circular shapes

<table align="center" style="width:100%; border-collapse:collapse;">
  <tr>
    <td align="center" style="width:100%;">
      <img src="https://raw.githubusercontent.com/Crowd-Mechanics/LEMONS/master/docs/source/_static/logo/logo_doc.png" width="300" alt="Project icon" style="display:block; margin:auto;">
    </td>
  </tr>
  <tr>
    <td align="left" style="width:100%;">
    </td>
  </tr>
</table>


<div align="center">

[![](https://badgen.net/badge/DOI/open%20access/orange)](https://scipost.org/submissions/scipost_202507_00067v2/)
[![](https://badgen.net/static/DOC/lemons-docs/cyan?icon=https://icons.getbootstrap.com/icons/filetype-doc/)](https://lemons.readthedocs.io/en/latest/index.html)
[![](https://badgen.net/badge/icon/GitHub?icon=github&label)](https://github.com/Crowd-Mechanics/LEMONS)
[![](https://badgen.net/badge/🚀/Streamlit%20App/green)](https://lemons.streamlit.app/)
[![](https://badgen.net/badge/VIDEO/10.5281%2Fzenodo.17885366/red)](https://doi.org/10.5281/zenodo.17885366)
[![PyPI](https://img.shields.io/pypi/v/lemons-crowd)](https://pypi.org/project/lemons-crowd/)


 <img src="https://raw.githubusercontent.com/Crowd-Mechanics/LEMONS/master/docs/source/_static/logo/logo_icon.png" alt="lemon" width="20" style="vertical-align:middle;"> **LEMONS**: *An Open-Source Platform to Generate Non-Circular, Anthropometry-Based Pedestrian Shapes and Simulate Their Mechanical Interactions in 2D*

</div>


## Documentation

Comprehensive installation guidelines, tutorials, and a complete API reference are available in our [official documentation](https://lemons.readthedocs.io/en/latest/).
## Authors

* Oscar Dufour
* Maxime Stapelle
* Alexandre Nicolas

This project is developed at
[Institute of Light and Matter](https://ilm.univ-lyon1.fr/).

## Citation

[![CITATION.cff](https://github.com/Crowd-Mechanics/LEMONS/actions/workflows/citation.yml/badge.svg)](https://github.com/Crowd-Mechanics/LEMONS/actions/workflows/citation.yml)

If you use `LEMONS`, we encourage you to cite or reference this work as you would any other scientific research. The package is a result of a huge amount of time and effort invested by the authors. Citing us allows us to measure the impact of the research and encourages others to use the library.

Cite us:
```
@article{lemons_2025_14906931,
    author    = {Dufour, Oscar and Stapelle, Maxime and Nicolas, Alexandre},
    title     = {LEMONS - An open-source platform to generate non-circuLar, anthropometry-based pEdestrian shapes and simulate their Mechanical interactiONS in two dimensions},
    journal   = {SciPost Phys. Codebases},
    publisher = {SciPost},
    month     = {dec},
    year      = {2025},
    version   = {v1.0.5},
}
```

## An example of a generated crowd
<tr>
  <td align="center" style="width:100%;">
    <img src="https://raw.githubusercontent.com/Crowd-Mechanics/LEMONS/master/data/images/crowd_150_agents.png" width="450" alt="Project icon" style="display:block; margin:auto;">
  </td>
</tr>

## An example of a crowd simulation
Forward propagation of a push through a row of people (experience from [Feldmann S., Adrian J., 2023](https://doi.org/10.1016/j.ssci.2023.106173)). Dotted lines: measured head trajectories, solid lines: simulation.
<tr>
  <td align="center" style="width:100%;">
    <img src="https://raw.githubusercontent.com/Crowd-Mechanics/LEMONS/master/data/images/practical_case_push_close_to_wall.png" width="450" alt="An example of a crowd simulation." style="display:block; margin:auto;">
  </td>
</tr>

## An example of a 3D crowd
<tr>
  <td align="center" style="width:100%;">
    <img src="https://raw.githubusercontent.com/Crowd-Mechanics/LEMONS/master/data/images/3D_crowd.png" width="450" alt="A crowd in 3D." style="display:block; margin:auto;">
  </td>
</tr>
Here, the female specimen’s legs are together (touching), whereas the male specimen’s legs are apart.

## License
Every part of `LEMONS` is available under the [`CeCILL-B`](https://cecill.info/licences.fr.html) license.