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.

LEMONS: An Open-Source Platform to Generate Non-Circular, Anthropometry-Based Pedestrian Shapes and Simulate Their Mechanical Interactions in 2D

Documentation

Comprehensive installation guidelines, tutorials, and a complete API reference are available in our official documentation.

Authors

• Oscar Dufour
• Maxime Stapelle
• Alexandre Nicolas

This project is developed at Institute of Light and Matter.

Citation

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

An example of a crowd simulation

Forward propagation of a push through a row of people (experience from Feldmann S., Adrian J., 2023). Dotted lines: measured head trajectories, solid lines: simulation.

An example of a 3D crowd

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