Source code for streamlit_app.app.ui

"""User interface module."""

# Copyright  2025  Institute of Light and Matter, CNRS UMR 5306, University Claude Bernard Lyon 1
# Contributors: Oscar DUFOUR, Maxime STAPELLE, Alexandre NICOLAS

# This software is a computer program designed to generate a realistic crowd from anthropometric data and
# simulate the mechanical interactions that occur within it and with obstacles.

# This software is governed by the CeCILL-B license under French law and abiding by the rules of distribution
# of free software.  You can  use, modify and/ or redistribute the software under the terms of the CeCILL-B
# license as circulated by CEA, CNRS and INRIA at the following URL "http://www.cecill.info".

# As a counterpart to the access to the source code and  rights to copy, modify and redistribute granted by
# the license, users are provided only with a limited warranty  and the software's author,  the holder of the
# economic rights,  and the successive licensors  have only  limited liability.

# In this respect, the user's attention is drawn to the risks associated with loading,  using,  modifying
# and/or developing or reproducing the software by the user in light of its specific status of free software,
# that may mean  that it is complicated to manipulate,  and  that  also therefore means  that it is reserved
# for developers  and  experienced professionals having in-depth computer knowledge. Users are therefore
# encouraged to load and test the software's suitability as regards their requirements in conditions enabling
# the security of their systems and/or data to be ensured and,  more generally, to use and operate it in the
# same conditions as regards security.

# The fact that you are presently reading this means that you have had knowledge of the CeCILL-B license and that
# you accept its terms.

from pathlib import Path
from typing import Any

import streamlit as st
from streamlit_option_menu import option_menu

import streamlit_app.utils.constants as cst_app


[docs] def setup_app() -> None: """Set up the Streamlit page configuration.""" st.set_page_config( page_title=f"{cst_app.PROJECT_NAME} Project", page_icon=":bar_chart:", layout="wide", initial_sidebar_state="expanded", menu_items={ "Get Help": "https://github.com/Crowd-Mechanics/LEMONS", "Report a bug": "https://github.com/Crowd-Mechanics/LEMONS/issues", "About": f"# {cst_app.PROJECT_NAME} Project " + ":flag-fr:", }, )
[docs] def init_sidebar_looks() -> None: """Initialize the appearance of the sidebar with several badges and a logo image.""" current_file_path = Path(__file__) ROOT_DIR = current_file_path.parent.parent.parent.parent.absolute() logo_path = ROOT_DIR / "docs" / "source" / "_static" / "logo" / "logo_app.png" article_badge = "[![](https://badgen.net/badge/DOI/open%20access/orange)](https://scipost.org/submissions/scipost_202507_00067v1/)" doc_badge = "[![](https://badgen.net/static/DOC/lemons-docs/cyan?icon=https://icons.getbootstrap.com/icons/filetype-doc/)](https://lemons.readthedocs.io/en/latest/index.html)" repo_badge = "[![](https://badgen.net/badge/icon/GitHub?icon=github&label)](https://github.com/Crowd-Mechanics/LEMONS)" zenodo_badge = "[![](https://badgen.net/badge/VIDEOS/10.5281%2Fzenodo.17885366/red)](https://doi.org/10.5281/zenodo.17885366)" c1, c2 = st.sidebar.columns((0.25, 0.8)) c1.write("**Article**") c2.write(article_badge) c1.write("**Doc**") c2.write(doc_badge) c1.write("**Code**") c2.markdown(repo_badge, unsafe_allow_html=True) c1.write("**Zenodo**") c2.markdown(zenodo_badge, unsafe_allow_html=True) st.sidebar.image(str(logo_path), width="stretch") st.sidebar.warning("⚠️ All measurements in this app are displayed in centimeters.")