/SingleFileMovementAnalysis

This repository contain scripts for analyzing single-file movement experiments recorded by a top-view, or side-view camera

Primary LanguagePythonMIT LicenseMIT

SingleFileMovementAnalysis

Introduction

======= This repository contains scripts for analyzing single-file movement experiments recorded by a top-view (straight, oval), or side-view camera, , and pedestrians walk anticlockwise

  • Example (top-view camera):

    • School GymBay, main circle.
    • Link

    gymbaymain

  • Example of (side-view camera)

    • Influence of gender in single-file movement.
    • Link

    gender_single_file_sample

Analysis results and trajectories used in this README can be download from this link.

Requirements

Download and install the requirements with

pip3 install -r requirements.txt

Description of some scripts

Script Description
00_transformation_additional.py Trajectory data may require some transformation (rotation , transition, etc).
01_transformation_straight_traj.py Transform oval to straight trajectory data accoring to Ziemer.
00_cal_vel_rho_headway.py Calculate the individual velocity, headway, and 1D Voronoi density.
02_plot_timeseries_rho_v.py Plot timeseries of density and speed.
01_extract_steadyState_data.py extract the steady state data.

Example

  • determining the steady state scripts/03_plotting/plot_timeseries_rho_v.py timeseries_rho_vel

  • the fundamental diagram (FD, rho-vel), and headway-velocity scripts/03_plotting/plot_rho_h_vel.py schoolGymBay_rho_vel schoolGymBay_h_vel

  • the trajectories scripts/03_plotting/plot_traj_raw.py GymBay_main_15_1

  • the trajectories after transformation scripts/03_plotting/plot_traj_straight.py GymBay_main_15_1_transformation_additional_straight_traj

  • the spacial-temporal (x-t) relation scripts/03_plotting/plot_x_t.py GymBay_main_15_1_transformation_additional_straight_traj_x_t

  • bining data (rho-velocity) (headway-velocity) scripts/03_plotting/plot_data_binning.py schoole_GymBay_main_binning_h_vel schoole_GymBay_main_binning_rho_vel

Note

To calculate the velocity_headway_rho of top-view camera experiments that captured only the straight measurement area such as the Caserne experiment, we use the same analysis methodology of side-view experiments.