Metadata-Version: 2.4
Name: lemons-crowd
Version: 1.0.6
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: pedpy>=1.4.0
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">

[![Paper DOI](https://img.shields.io/badge/Paper%20DOI-10.21468/SciPostPhysCodeb.67-f28c28?style=flat-square&labelColor=2f2f2f)](https://scipost.org/SciPostPhysCodeb.67)
[![Simulation Videos](https://img.shields.io/badge/Simulation%20Videos-Zenodo-1682D4?style=flat-square&labelColor=2f2f2f&logo=zenodo&logoColor=white)](https://doi.org/10.5281/zenodo.17885366)
[![Docs](https://img.shields.io/badge/Docs-lemons--docs-00bcd4?style=flat-square&labelColor=2f2f2f&logo=readthedocs&logoColor=white)](https://lemons.readthedocs.io/en/latest/index.html)
[![GitHub](https://img.shields.io/badge/GitHub-LEMONS-6e7681?style=flat-square&labelColor=2f2f2f&logo=github&logoColor=white)](https://github.com/Crowd-Mechanics/LEMONS)
[![App](https://img.shields.io/badge/App-Streamlit-22c55e?style=flat-square&labelColor=2f2f2f&logo=streamlit&logoColor=white)](https://lemons.streamlit.app/)
[![YouTube](https://img.shields.io/badge/YouTube-tutorial-555555?style=flat-square&labelColor=2f2f2f&logo=youtube&logoColor=ff0000)](https://www.youtube.com/watch?v=ONumhX-LmgI)
[![PyPI](https://img.shields.io/pypi/v/lemons-crowd?style=flat-square&labelColor=2f2f2f&logo=pypi&logoColor=white)](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{10.21468/SciPostPhysCodeb.67,
	title     = {{LEMONS: An open-source platform to generate non-circuLar, anthropometry-based pEdestrian shapes and simulate their Mechanical interactiONS in two dimensions}},
	author    = {Oscar Dufour and Maxime Stapelle and Alexandre Nicolas},
	journal   = {SciPost Phys. Codebases},
	pages     = {67},
	year      = {2026},
	publisher = {SciPost},
	doi       = {10.21468/SciPostPhysCodeb.67},
	url       = {https://scipost.org/10.21468/SciPostPhysCodeb.67},
}
```

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