|
|
Home
|
|
|
====
|
|
|
|
|
|
Für neue Entwickler
|
|
|
--------------------------------------
|
|
|
[Einrichten einer Entwicklungsumgebung](docs/setup) \
|
|
|
[Wie schreibe ich Doxygen Kommentare?](docs/doxygen) \
|
|
|
[Wie schreibe ich Unit Tests?](docs/unit_tests) \
|
|
|
[How do I add my own testcase to the regression tests?](docs/regression_test) |
|
|
\[\[_TOC_\]\]
|
|
|
|
|
|
# PeTrack
|
|
|
In order to understand and thereupon to model the pedestrian dynamics, reliable empirical data of pedestrian movement are necessary for analysis and verification. The existing database is small, inaccurate and highly contradictory. Manual procedures for collecting this data are very time-consuming and usually do not supply sufficient accuracy in space and time.
|
|
|
|
|
|
For this reason we are developing the tool named `PeTrack` (**Pe**destrian **Trac**king) to automatically extract accurate pedestrian trajectories from video recordings. The joint trajectories of all pedestrians provide data like velocity, flow, density and individual distances at any time and position. With such a tool extensive experimental series with a large number of persons can be analyzed.
|
|
|
|
|
|
The program has to deal with wide angle lenses and a high density of pedestrians. Lens distortion and perspective view are taken into account. The procedure includes calibration, recognition, tracking and height detection.
|
|
|
|
|
|
Different kinds of markers (e.g. with height information, head direction) are implemented. With a special stereo camera also marker less tracking is possible.
|
|
|
|
|
|
An executable of `PeTrack` is available [here](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/petrackDownload.html?nn=2317856). The brief [documentation](usage/Usage) of using `PeTrack` cannot answer all questions. Thus you may [contact the author](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Boltes_Maik/main.html?nn=2317856) before setting up experiments and automatic extraction with `PeTrack`.
|
|
|
|
|
|
![Download Video](uploads/9a171c82e9bde1891c2a99eca38ded08/petrackAblaufArena.mp4)
|
|
|
|
|
|
![Download Video](uploads/2c50611b2fdbfcc3e4a33c609b85dffa/petrackArenaResult.mp4)
|
|
|
|
|
|
![Download Video](uploads/31c514747c6ad122b4d27b24a9ccbf67/petrackAblaufLarge.mp4)
|
|
|
|
|
|
## For users of `PeTrack`
|
|
|
|
|
|
Some information on the usage of `PeTrack` can be found here:
|
|
|
- [General usage](usage/Usage)
|
|
|
- [Workflow](usage/Workflow)
|
|
|
|
|
|
If you run across some issues or bugs when using the software we highly appreciate any reporting.
|
|
|
|
|
|
## For new Developers
|
|
|
|
|
|
If you want to us help improve `PeTrack` any contributions are highly appreciated. Some things to help you, to start working on `PeTrack` can be found here:
|
|
|
- [Einrichten einer Entwicklungsumgebung](docs/setup)
|
|
|
- [Wie schreibe ich Doxygen Kommentare?](docs/doxygen)
|
|
|
- [Wie schreibe ich Unit Tests?](docs/unit_tests)
|
|
|
- [How do I add my own testcase to the regression tests?](docs/regression_test)
|
|
|
|
|
|
We apologize that the texts and some comments in the code are in German, we are working on translating it to English to address a wider audience. If you have questions, feel free to ask. |