Metadata-Version: 2.4
Name: lemons-crowd
Version: 1.0.5
Summary: Python wrapper for the LEMONS library to generate anthropometry-based, non-circular pedestrian shapes, visualize crowds, and simulate 2D dynamics.
Author-email: Oscar DUFOUR <oscar.dufour@univ-lyon1.fr>, Maxime STAPELLE <maxime.stapelle@univ-lyon1.fr>, Alexandre NICOLAS <alexandre.nicolas@univ-lyon1.fr>
License-Expression: CECILL-B
Project-URL: Homepage, https://github.com/Crowd-Mechanics/LEMONS
Project-URL: Issues, https://github.com/Crowd-Mechanics/LEMONS/issues
Keywords: crowd generation,crowd dynamics,pedestrian dynamics,anthropometry,mechanical interactions,bideltoid breadth,chest depth,non-circular shapes
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: cmcrameri>=1.9
Requires-Dist: dicttoxml>=1.7.16
Requires-Dist: gprof2dot>=2025.4.14
Requires-Dist: jupyter>=1.1.1
Requires-Dist: kaleido>=1.2.0
Requires-Dist: kivy>=2.3.1
Requires-Dist: matplotlib>=3.10.3
Requires-Dist: numpy>=2.2.6
Requires-Dist: pandas>=2.2.3
Requires-Dist: plotly>=6.1.1
Requires-Dist: pyvista>=0.45.2
Requires-Dist: scipy>=1.15.3
Requires-Dist: shapely>=2.1.1
Requires-Dist: streamlit>=1.45.1
Requires-Dist: streamlit-option-menu>=0.4.0
Requires-Dist: watchdog>=6.0.0
Requires-Dist: xmltodict>=0.14.2
Dynamic: license-file

<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.
