https://github.com/pedestriandynamics/dashboard

Dashboard: Analysis of pedestrian dynamics based on trajectory files
https://github.com/pedestriandynamics/dashboard

analysis-framework pedestrian-dynamics pedestrian-trajectories python science-research

Last synced: 3 months ago
JSON representation

Dashboard: Analysis of pedestrian dynamics based on trajectory files

• Host: GitHub
• URL: https://github.com/pedestriandynamics/dashboard
• Owner: PedestrianDynamics
• License: mit
• Created: 2022-03-22T20:38:08.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-10-08T04:13:23.000Z (over 1 year ago)
• Last Synced: 2025-04-13T17:23:06.202Z (10 months ago)
• Topics: analysis-framework, pedestrian-dynamics, pedestrian-trajectories, python, science-research
• Language: Python
• Homepage:
• Size: 701 KB
• Stars: 8
• Watchers: 1
• Forks: 0
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Citation: CITATION.cff

Awesome Lists containing this project

README

          
[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://share.streamlit.io/pedestriandynamics/dashboard/main/app.py)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7697604.svg)](https://doi.org/10.5281/zenodo.7697604)

[![fair-software.eu](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8B%20%20%E2%97%8F%20%20%E2%97%8B-orange)](https://fair-software.eu)

# JuPedSim-Dashboard

Show statistics and make plots extracted from [jpscore](https://github.com/jupedsim/jpscore)-simulations and [experimental data](https://ped.fz-juelich.de/db/).



## Use

This app can be used online: 

https://go.fzj.de/dashboard

or locally by running 

```bash

streamlit run app.py

```

To install the requirements use:

```bash

pip install -r requirements.txt

```

## Draw geometries 

To draw geometries on trajectory-plots, try to connect all lines, such that they form a closed polygon.

This is only necessary if you want to visualize the geometry with [jpsvis](https://www.jupedsim.org/).

You can download your drawing as an xml file according to jupedsim's [format](https://www.jupedsim.org/jpscore_geometry.html)

It is possible to draw: 

- Lines 

- Rectangles

Lines and rectangle can be rotated and scaled.

To try out:

https://go.fzj.de/geometry

# Ressources

- Demo: https://youtu.be/4xTqSbllCwg

- Talk in the [deRSE23](https://de-rse23.sciencesconf.org/) from some scientific motivation of this project is available [here](https://zenodo.org/record/7697604).

**NOTE**: The script tries to exctract the unit of the data from the trajectory file. A good idea might be to convert the trajetories before using with this [script](https://github.com/JuPedSim/jpscore/blob/master/scripts/petrack2jpsvis.py)

or add a header with the unit information. For example a line starting with 

`#unit: cm`

## Profiles 

The density profile uses the speed of the pedestrians calculated by the Weidmann diagram.

Therefore, for jpscore-simulations, use the `optional_output`-option in the inifile:

```xml

    

```

## NT-curve 

NT-curves and flow at lines (`transitions` or [area_L](https://www.jupedsim.org/jpsreport_inifile#measurement-area))

are calculates be testing for every agent, if croses the line.

Therefore, define in the geometry transitions, such that the pedestrian fully pass them.