|
|
This short introduction only illustrates the possibilities and the main functionality of the software `PeTrack`. The main window is shown below; clicking on the picture will enlarge it to see the general user interface. The top (stereo) and bottom (mono) video on the overview page of `PeTrack` illustrates the process of trajectory extraction.
|
|
|
\[\[_TOC_\]\]
|
|
|
|
|
|
This short introduction only illustrates the possibilities and the main functionality of the software `PeTrack`. The main window is shown below; clicking on the picture will enlarge it to see the general user interface. The top (stereo) and bottom (mono) video on the [overview page](Home) of `PeTrack` illustrates the process of trajectory extraction.
|
|
|
|
|
|
![](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/petrackGui.bmp?__blob=poster)
|
|
|
|
|
|
After importing a video, an image sequence or already a complete project the first image will be shown in the top left area of the application. The navigation through the image stream is done below the image. On the right of the image zooming and rotation is possible. The status line in bottom-most area gives information about the pixel under the mouse. It displays the color, pixel row and column and the real world position in the specified height, if the calibration is done correctly. The main settings for the steps of trajectory extraction have to be done on the right tabs calibration, recognition, tracking and analysis, corresponding to the steps of the processing pipeline of the trajectory extraction. These settings are briefly discussed below.
|
|
|
|
|
|
More information especially how the single steps work can be found in a book and the papers [Automatische Erfassung präziser Trajektorien in Personenströmen hoher Dichte](http://juser.fz-juelich.de/record/187743), [Collecting pedestrian trajectories and Automatic Extraction of Pedestrian Trajectories from Video Recordings](http://juser.fz-juelich.de/record/62385).
|
|
|
More information especially how the single steps work can be found in a book and the papers:
|
|
|
- [Automatische Erfassung präziser Trajektorien in Personenströmen hoher Dichte](http://juser.fz-juelich.de/record/187743)
|
|
|
- [Collecting pedestrian trajectories and Automatic Extraction of Pedestrian Trajectories from Video Recordings](http://juser.fz-juelich.de/record/62385).
|
|
|
|
|
|
The software can be used interactively or command line oriented for the automatic generation of trajectories for a sequence of video recordings. The command line options and key bindings can be found on the help pages of the software. The im- and export of project files, image sequences, video recordings and trajectories is possible.
|
|
|
|
... | ... | @@ -14,7 +18,7 @@ Using the software needs good understanding of the extraction process and the sa |
|
|
|
|
|
The calibration tab allows some color correction and an adding of a border, if the picture size increases during the undistortion or tilting of the picture. An adaptive background subtraction is possible, but not needed for the detection with markers.
|
|
|
|
|
|
The intrinsic parameters of the camera model can be manually entered, and some assumptions can be chosen, like the specification of quadratic pixel, the matching of centre of the undistortion and the picture, and the consideration of the tangential distortion. The automatic calculation of the intrinsic parameters is also included. The images for the automatic calibration have to show the pattern [Calibration Pattern (PDF, 5 kB)](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/pattern.pdf?__blob=publicationFile) recorded by the same camera and objective as used for the experiment.
|
|
|
The intrinsic parameters of the camera model can be manually entered, and some assumptions can be chosen, like the specification of quadratic pixel, the matching of centre of the undistortion and the picture, and the consideration of the tangential distortion. The [automatic calculation](https://docs.opencv.org/master/dc/dbb/tutorial_py_calibration.html) of the intrinsic parameters is also included. The images for the automatic calibration have to show the pattern [Calibration Pattern (PDF, 5 kB)](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/pattern.pdf?__blob=publicationFile) recorded by the same camera and objective as used for the experiment.
|
|
|
|
|
|
The extrinsic parameters of the recorded scene can be entered by positioning a coordinate system on the floor and specifying the altitude of the recording camera, if the value determined by the intrinsic calibration is not good enough. Also an automatic calculation of the extrinsic parameters using corresponding points is possible. As far as the heads of every person can be seen also slanted views are supported.
|
|
|
|
... | ... | @@ -30,7 +34,7 @@ With monocular cameras only marked pedestrians can be handled automatically. For |
|
|
|
|
|
In the tracking tab the repetition of the tracking and the quality level for the repetition can be set. The possibly selected extrapolation will determine big differences in the tracking path and displace the tracked point with an extrapolated one.
|
|
|
|
|
|
Also the automatic generation of all trajectories and their im- and export can be initiated here. The switch for inserting missing frames allows the insertion of frames, which have been missed while recording. The other settings adjust only the visualization of the overlay of the trajectories in the video.
|
|
|
Also the [automatic generation](https://docs.opencv.org/master/d4/dee/tutorial_optical_flow.html) of all trajectories and their im- and export can be initiated here. The switch for inserting missing frames allows the insertion of frames, which have been missed while recording. The other settings adjust only the visualization of the overlay of the trajectories in the video.
|
|
|
|
|
|
The pyramidal search regions can be set by size and level. The default size of the highest pyramid level is sixty percent greater than the average head size and four levels are calculated.
|
|
|
|
... | ... | @@ -39,21 +43,13 @@ The pyramidal search regions can be set by size and level. The default size of t |
|
|
The last tab for analysis purpose allows some direct analysing tasks of the trajectories. Up to now only the velocity can be displayed. The green dot cloud shows the individual velocity and the blue line the averaged velocity of every frame.
|
|
|
|
|
|
## Further help
|
|
|
|
|
|
Project examples come with the installation. Command line options and key bindings are described in the help system of the software. This brief documentation 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 the automatic extraction with `PeTrack`.
|
|
|
|
|
|
## Utility
|
|
|
|
|
|
```bash
|
|
|
combine in1.txt in2.txt out.txt
|
|
|
```
|
|
|
|
|
|
coming with the `PeTrack` installation merges trajectories from `in1.txt` (first crossed camera) and `in2.txt` (second crossed camera) to `out.txt|out.dat` with least error. Please use the command line option `[-help|-?]` for further help.
|
|
|
Command line options and key bindings are described in the help system of the software. This brief documentation of using `PeTrack` cannot answer all questions. Thus you may read also the information [workflow](usage/workflow) and [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 the automatic extraction with `PeTrack`.
|
|
|
|
|
|
## Media
|
|
|
- Pattern for automatic calculation of the intrinsic parameters for the calibration:
|
|
|
[Calibration Pattern (PDF, 5 kB) ](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/pattern.pdf?__blob=publicationFile)
|
|
|
- Pattern for automatic calculation of the intrinsic parameters for the calibration: [Calibration Pattern (PDF, 5 kB) ](uploads/79770f9bbf41b6bebe9aeabfa5e10e05/pattern.pdf)
|
|
|
|
|
|
- Video from a part of one experiment of us for testing:
|
|
|
[Example Video (FileTypemp4, 94 MB)](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/exampleVideo.mp4?__blob=publicationFile)
|
|
|
[Example Video (mp4, 94 MB)](https://fz-juelich.sciebo.de/s/hjQEXipvorgBbmy)
|
|
|
|
|
|
- Corresponding PeTrack project for preceding video file:
|
|
|
[PeTrack Project (FileTypexml, 6 kB) ](https://www.fz-juelich.de/ias/ias-7/EN/Expertise/Software/PeTrack/project.xml?__blob=publicationFile) |
|
|
\ No newline at end of file |
|
|
[PeTrack Project (xml, 6 kB) ](uploads/aff9f7a19015f2f27c2f9126be0100c3/project.xml) |
|
|
\ No newline at end of file |