PedestrianDynamics / PedestrianDynamics/PedPy

Calculation of "classical" Fundamental Diagram

Open
#499 1 comment 0 reactions 1 assignee View on GitHub

@JuleAdrian is already working on this.

Since Nov 10, 2025.

Dominant language
Pascal
Stars
35
Forks
18
Avg merge
1d 14h
Merged PRs (30d)
2

Description

With the current functions of PedPy it is not easy to create the classical form of a FD.

I planned to create the density-flow diagramm for simple unidirectional corridor data and started with the calculation of classical density with compute_classic_density() which was pretty straight forward. (side note: the result is not a pd.dataframe as written in the API but the 'frame' column is defined as index)

The flow was more complicated... I used the calculation of the N-t-diagramm with compute_n_t() and tried to caluculate the flow from this using compute_flow(). Here comes question/ problem number one: why is it mandatory to insert the "individual_speed" for a flow calculation? This is not directly needed for flow calculation.

Anyway: after calculating a speed as well, I managed to run compute_flow() and got a dataframe with two columns: flow and mean_speed.
So now I have the classical density as pd.dataframe with frame and density as columns; and a dataframe with flow and mean_speed... This does not really get me closer to a classical Fundamental Diagram as I would somehow need to match the entries for density and flow. But I think no fuction to perform this currently exists in PedPy.

Is there any way to directly calculate a classical fundamental diagramm using PedPy? The user guide says: "Basic measures as velocity, flow, and density can directly be computed and then combined to obtain fundamental diagrams." But I somehow fail to achieve this 😅

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.