Skip to content

Commit d381b07

Browse files
committed
Merge branch 'release-v1.1' into 'master'
Release v1.1 See merge request ped-dyn-emp/petrack!465
2 parents 19bc642 + 6030e53 commit d381b07

30 files changed

+114
-77
lines changed

.zenodo.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,11 @@
2727
"name": "Dreßen, Luke",
2828
"orcid": "0000-0001-5425-010X"
2929
},
30+
{
31+
"affiliation": "Forschungszentrum Jülich GmbH",
32+
"name": "Hermanns, Simon",
33+
"orcid": "0009-0008-7918-0097"
34+
},
3035
{
3136
"affiliation": "Forschungszentrum Jülich GmbH",
3237
"name": "Adrian, Juliane",

CHANGELOG.md

Lines changed: 37 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,19 @@
1+
# 1.1
2+
3+
- Export trajectories and metadata to hdf5. For file format infos see [here](https://ped.fz-juelich.de/dataarchive/doku.php?id=info)
4+
- Fix crash on windows on loading a machine learning model
5+
- Update to Qt6
6+
- Fix arrow of spinbox `show only` not updating after importing trajectories
7+
- Creating manual trackpoints or calibration points is now more intuitive
8+
- Regions of interest are now visible per default
9+
- Minor improvements to machine learning marker
10+
- `show` set to false implies `fix` is true now
11+
- Better warnings on incorrect 3dc files
12+
- Video export now exports the undistorted video
13+
- Add shortctut for jumping to start of trajectory
14+
- Text is not automatically selected anymore on input dialogs
15+
- Numbering for pedestrians on txt import is now always the same
16+
117
# 1.0
218

319
- Downloads are now available on GitLab and GitHub without prior registration
@@ -43,7 +59,6 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
4359

4460
**Highlights**
4561

46-
4762
- Option to show complete trajectory of selected person
4863
- Change shortcuts
4964
- Adapt default export settings
@@ -57,9 +72,10 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
5772
**Highlights**
5873

5974
- Updated Layout of keybinding window
60-
- Start Sphinx-Documentation inside of repository, accessible on <https://go.fzj.de/petrack-docs>
75+
- Start Sphinx-Documentation inside of repository, accessible on <https://go.fzj.de/petrack-docs>
6176

6277
## 0.10.2
78+
6379
For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compare/8f17e1af...4dca7dbc)
6480

6581
**Highlights**
@@ -69,6 +85,7 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
6985
- Add "Sequence FPS" used for export of txt-files, independent of playback FPS
7086

7187
## 0.10.1
88+
7289
For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compare/e8b5afad...8f17e1af)
7390

7491
**Highlights**
@@ -78,18 +95,20 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
7895
- Misc. bug fixes concerning intrinsic calibration
7996

8097
## 0.10.0
98+
8199
For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compare/ac443ac3...e8b5afad)
82100

83101
**Highlights**
84102

85103
- Add new tab `correction` for quick sanity checks on the trajectories
86104
- `immutable` checkbox in the calibration tab
87105
- can be used to prevent accidental changes to the calibration values
88-
- Fixed freezing of GUI on Mac
106+
- Fixed freezing of GUI on Mac
89107

90108
# v0.9
91109

92110
## v0.9.4
111+
93112
For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compare/3c490af3...ac443ac3)
94113

95114
**Highlights**
@@ -111,6 +130,7 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
111130
- Missing frames computation is cached in .pet-file
112131

113132
## v0.9.2
133+
114134
For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compare/aa0534e6...42a8a21b)
115135

116136
**Highlights**
@@ -155,7 +175,7 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
155175
- Slanted view for external calibration
156176
- Coordinate system and grid is possible
157177
- Introduced multicolor marker with black dot
158-
- Video support for various codecs
178+
- Video support for various codecs
159179
- Visualization of motion capturing files
160180
- Improvements to re-tracking
161181
- Implement code marker
@@ -175,27 +195,32 @@ For complete comparison see [here](https://github.com/ped-dyn-emp/PeTrack/compar
175195
- Some performance improvements
176196

177197
# v0.7
198+
178199
introduce stereo cameras; alternate height
179200
background subtraction especially for stereo cameras; recognition of unmarked pedestrians; integration of 4 disparity algorithms
180201
filter to swap picture; more video codecs; color blobs as marker using HSV triangle
181-
marker with two dots added; export of viewing direction
202+
marker with two dots added; export of viewing direction
182203

183-
# v0.6
184-
bug fixes; improve speed; expand visualization possibilities; add variable tracking region adapted to head size; provide program combine to merge trajectories
204+
# v0.6
185205

206+
bug fixes; improve speed; expand visualization possibilities; add variable tracking region adapted to head size; provide program combine to merge trajectories
186207

187208
# v0.5
188-
improve robustness of tracking with interpolation and extrapolation; first analysis functionality
189209

210+
improve robustness of tracking with interpolation and extrapolation; first analysis functionality
190211

191212
# v0.4
192-
tracking import and export; manual adding and deleting of trackpoints
213+
214+
tracking import and export; manual adding and deleting of trackpoints
193215

194216
# v0.3
195-
recognition; tracking; color mapping
217+
218+
recognition; tracking; color mapping
196219

197220
# v0.2
198-
add first recognition
221+
222+
add first recognition
199223

200224
# v0.1
201-
only camera calibration is supported; import and export of video and image sequence
225+
226+
only camera calibration is supported; import and export of video and image sequence

CMakeLists.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
# Project setup
1616
################################################################################
1717
cmake_minimum_required(VERSION 3.18 FATAL_ERROR)
18-
project(petrack LANGUAGES CXX VERSION 1.0.0)
18+
project(petrack LANGUAGES CXX VERSION 1.1.0)
1919
set(CMAKE_CXX_STANDARD 17)
2020
set(CMAKE_CXX_STANDARD_REQUIRED ON)
2121
set(CMAKE_CXX_EXTENSIONS OFF)

ReadMe.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
# PeTrack
22

33
[![Documentation Status](https://readthedocs.org/projects/petrack/badge/?version=latest)](https://petrack.readthedocs.io/en/latest/?badge=latest)
4-
[![pipeline status](https://jugit.fz-juelich.de/ped-dyn-emp/petrack/badges/master/pipeline.svg)](https://jugit.fz-juelich.de/ped-dyn-emp/petrack/-/commits/master)
4+
[![pipeline status](https://jugit.fz-juelich.de/ped-dyn-emp/petrack/badges/master/pipeline.svg)](https://jugit.fz-juelich.de/ped-dyn-emp/petrack/-/commits/master)
55
[![Latest Release](https://jugit.fz-juelich.de/ped-dyn-emp/petrack/-/badges/release.svg)](https://jugit.fz-juelich.de/ped-dyn-emp/petrack/-/releases)
66
[![download](https://img.shields.io/badge/download-here-brightgreen?link=https://go.fzj.de/petrack-download&link=https://go.fzj.de/petrack-download)](https://go.fzj.de/petrack-download)
77
[![DOI](https://zenodo.org/badge/DOI/10.1016/j.neucom.2012.01.036.svg)](https://doi.org/10.1016/j.neucom.2012.01.036)
88
[![DOI](https://zenodo.org/badge/doi/10.5078176/zenodo.5078176.svg)](https://doi.org/10.5281/zenodo.5078176)
99
[![License](https://img.shields.io/badge/License-GPLv3-blue)](https://opensource.org/license/gpl-3-0)
10-
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
10+
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
1111

1212
![PeTrack logo](/icons/logo.png)
1313

@@ -16,26 +16,28 @@ For the understanding of the dynamics inside crowds reliable empirical data are
1616
The program deals 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.
1717
Different kinds of markers (e.g. with height information, head direction, individual code) are implemented. With a stereo camera more accurate height measurements and also markerless tracking is possible.
1818

19-
2019
## Download & installation:
20+
2121
We publish installers for windows. To get the latest installer, visit this
22-
[webpage](https://go.fzj.de/petrack-download) and download the current installer.
22+
[webpage](https://go.fzj.de/petrack-download) and download the current installer.
2323

2424
## How to use PeTrack
2525

26-
To learn how to use PeTrack, please have a look at our documentation [here](https://petrack.readthedocs.io/).
26+
To learn how to use PeTrack, please have a look at our documentation [here](https://petrack.readthedocs.io/).
2727

2828
> Note that PeTrack can only be used if some steps are considered **during the planning and execution of the experiments**. This includes, but is not limited to, calibration and selecting hats. See [Planning of Experiments](https://petrack.readthedocs.io/en/latest/planning/planning.html)
2929
3030
After all of that, enjoy successful recognition and tracking 😃
3131
![Picture of pedestrians with colored hats with indications of detected heads and tracked past trajectory](/docs/source/user_interface/images/past_path.png)
3232

3333
Some documentation is built into PeTrack itself. For example, you can use the `help`-menu to find a list of all keybindings. For running in a "batch-mode", PeTrack has a CLI, whose options are listed by calling
34+
3435
```bash
3536
petrack -help
3637
```
3738

3839
## Tutorial & demo
40+
3941
A small demo project is provided in the `demo` folder. It contains all necessary
4042
files for setting up a project with PeTrack. You can download these files via
4143
[this link](https://go.fzj.de/petrack-demo-download). A tutorial leading through
@@ -45,9 +47,11 @@ The intermediate project files for each step are also included in the `demo`
4547
folder.
4648

4749
## How to cite
50+
4851
Please cite the general paper and the corresponding software version in your publications if PeTrack helps your research.
4952

5053
General Paper:
54+
5155
- Boltes, M. and Seyfried, A.: Collecting Pedestrian Trajectories; In: Neurocomputing, Special Issue on Behaviours in Video, vol. 100, pp. 127-133 (2013)
5256
<details><summary>BibTeX</summary>
5357

@@ -65,6 +69,7 @@ General Paper:
6569
keywords = {Pedestrian detection, Laboratory experiment},
6670
}
6771
```
72+
6873
</details>
6974

7075
Software Version:
@@ -98,19 +103,21 @@ Software Version:
98103
url = {https://doi.org/10.5281/zenodo.15119517},
99104
}
100105
```
106+
101107
</details>
102108

103109
To find your corresponding version, check the `about` menu or look into the terminal output of PeTrack. To cite PeTrack as software without specifying a version, use the DOI [10.5281/zenodo.5078176](https://doi.org/10.5281/zenodo.5078176).
104110

105-
106111
## License
112+
107113
This project is licensed under the terms of the GPLv3 license. For further information see [LICENSE](./LICENSE).
108114

109115
## Changelog:
110-
See [CHANGELOG.md](./CHANGELOG.md)
111116

117+
See [CHANGELOG.md](./CHANGELOG.md)
112118

113119
## Dependencies:
114-
* Qwt (https://qwt.sf.net)
115-
* Qt (https://www.qt.io/)
116-
* OpenCV (https://opencv.org/)
120+
121+
- Qwt (https://qwt.sf.net)
122+
- Qt (https://www.qt.io/)
123+
- OpenCV (https://opencv.org/)

demo/00_files/00_empty.pet

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!DOCTYPE PETRACK>
3-
<PETRACK VERSION="1.0.0">
3+
<PETRACK VERSION="1.1.0">
44
<MAIN SRC="" STATUS_HEIGHT="0"/>
55
<STEREO>
66
<DISPARITY ALGO="0" COLOR="0" HIDE_INVALID="1" OPACITY="100" SHOW="0">

demo/01_calibration/01_intrinsic.pet

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!DOCTYPE PETRACK>
3-
<PETRACK VERSION="1.0.0">
3+
<PETRACK VERSION="1.1.0">
44
<MAIN SRC="../00_files/video/video.mp4" STATUS_HEIGHT="0"/>
55
<STEREO>
66
<DISPARITY ALGO="0" COLOR="0" HIDE_INVALID="1" OPACITY="100" SHOW="0">
@@ -40,7 +40,7 @@
4040
</CALIBRATION>
4141
<RECOGNITION>
4242
<PERFORM ENABLED="0" METHOD="5" MLMETHOD="0" STEP="1"/>
43-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
43+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
4444
<MARKER BRIGHTNESS="50" IGNORE_WITHOUT="1"/>
4545
<SIZE_COLOR AUTO_WB="0" DEFAULT_HEIGHT="180" GREY_LEVEL="50" MAP_NUMBER="0" MODEL="0" SHOW="1" SYMBOL_SIZE="10" X="0" Y="1" Z="255">
4646
<MAP COLORED="1" FROM_HUE="0" FROM_SAT="0" FROM_VAL="128" HEIGHT="255" INV_HUE="0" MAP_HEIGHT="180" TO_HUE="359" TO_SAT="255" TO_VAL="255" WIDTH="359" X="0" Y="0"/>
@@ -54,7 +54,7 @@
5454
<EXTRAPOLATION ENABLED="1"/>
5555
<MERGE ENABLED="0"/>
5656
<ONLY_VISIBLE ENABLED="1"/>
57-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
57+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
5858
<SEARCH_MISSING_FRAMES ENABLED="1"/>
5959
<RECALCULATE_MEDIAN_HEIGHT ENABLED="1"/>
6060
<ALLOW_ALTERNATE_HEIGHT ENABLED="0"/>

demo/01_calibration/02_extrinsic.pet

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!DOCTYPE PETRACK>
3-
<PETRACK VERSION="1.0.0">
3+
<PETRACK VERSION="1.1.0">
44
<MAIN SRC="../00_files/calibration/extrinsic/00_all.png" STATUS_HEIGHT="0"/>
55
<STEREO>
66
<DISPARITY ALGO="0" COLOR="0" HIDE_INVALID="1" OPACITY="100" SHOW="0">
@@ -40,7 +40,7 @@
4040
</CALIBRATION>
4141
<RECOGNITION>
4242
<PERFORM ENABLED="0" METHOD="5" MLMETHOD="0" STEP="1"/>
43-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
43+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
4444
<MARKER BRIGHTNESS="50" IGNORE_WITHOUT="1"/>
4545
<SIZE_COLOR AUTO_WB="0" DEFAULT_HEIGHT="180" GREY_LEVEL="50" MAP_NUMBER="0" MODEL="0" SHOW="1" SYMBOL_SIZE="10" X="0" Y="1" Z="255">
4646
<MAP COLORED="1" FROM_HUE="0" FROM_SAT="0" FROM_VAL="128" HEIGHT="255" INV_HUE="0" MAP_HEIGHT="180" TO_HUE="359" TO_SAT="255" TO_VAL="255" WIDTH="359" X="0" Y="0"/>
@@ -54,7 +54,7 @@
5454
<EXTRAPOLATION ENABLED="1"/>
5555
<MERGE ENABLED="0"/>
5656
<ONLY_VISIBLE ENABLED="1"/>
57-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
57+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
5858
<SEARCH_MISSING_FRAMES ENABLED="1"/>
5959
<RECALCULATE_MEDIAN_HEIGHT ENABLED="1"/>
6060
<ALLOW_ALTERNATE_HEIGHT ENABLED="0"/>

demo/01_calibration/03_calibrated_with_video.pet

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!DOCTYPE PETRACK>
3-
<PETRACK VERSION="1.0.0">
3+
<PETRACK VERSION="1.1.0">
44
<MAIN SRC="../00_files/video/video.mp4" STATUS_HEIGHT="0"/>
55
<STEREO>
66
<DISPARITY ALGO="0" COLOR="0" HIDE_INVALID="1" OPACITY="100" SHOW="0">
@@ -40,7 +40,7 @@
4040
</CALIBRATION>
4141
<RECOGNITION>
4242
<PERFORM ENABLED="0" METHOD="5" MLMETHOD="0" STEP="1"/>
43-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
43+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
4444
<MARKER BRIGHTNESS="50" IGNORE_WITHOUT="1"/>
4545
<SIZE_COLOR AUTO_WB="0" DEFAULT_HEIGHT="180" GREY_LEVEL="50" MAP_NUMBER="0" MODEL="0" SHOW="1" SYMBOL_SIZE="10" X="0" Y="1" Z="255">
4646
<MAP COLORED="1" FROM_HUE="0" FROM_SAT="0" FROM_VAL="128" HEIGHT="255" INV_HUE="0" MAP_HEIGHT="180" TO_HUE="359" TO_SAT="255" TO_VAL="255" WIDTH="359" X="0" Y="0"/>
@@ -54,7 +54,7 @@
5454
<EXTRAPOLATION ENABLED="1"/>
5555
<MERGE ENABLED="0"/>
5656
<ONLY_VISIBLE ENABLED="1"/>
57-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
57+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
5858
<SEARCH_MISSING_FRAMES ENABLED="1"/>
5959
<RECALCULATE_MEDIAN_HEIGHT ENABLED="1"/>
6060
<ALLOW_ALTERNATE_HEIGHT ENABLED="0"/>

demo/02_recognition/04_recognition_codemarker.pet

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!DOCTYPE PETRACK>
3-
<PETRACK VERSION="1.0.0">
3+
<PETRACK VERSION="1.1.0">
44
<MAIN SRC="../00_files/video/video.mp4" STATUS_HEIGHT="0"/>
55
<STEREO>
66
<DISPARITY ALGO="0" COLOR="0" HIDE_INVALID="1" OPACITY="100" SHOW="0">
@@ -54,7 +54,7 @@
5454
<EXTRAPOLATION ENABLED="1"/>
5555
<MERGE ENABLED="0"/>
5656
<ONLY_VISIBLE ENABLED="1"/>
57-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
57+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
5858
<SEARCH_MISSING_FRAMES ENABLED="1"/>
5959
<RECALCULATE_MEDIAN_HEIGHT ENABLED="1"/>
6060
<ALLOW_ALTERNATE_HEIGHT ENABLED="0"/>

demo/02_recognition/04_recognition_multicolor.pet

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!DOCTYPE PETRACK>
3-
<PETRACK VERSION="1.0.0">
3+
<PETRACK VERSION="1.1.0">
44
<MAIN SRC="../00_files/video/video.mp4" STATUS_HEIGHT="0"/>
55
<STEREO>
66
<DISPARITY ALGO="0" COLOR="0" HIDE_INVALID="1" OPACITY="100" SHOW="0">
@@ -54,7 +54,7 @@
5454
<EXTRAPOLATION ENABLED="1"/>
5555
<MERGE ENABLED="0"/>
5656
<ONLY_VISIBLE ENABLED="1"/>
57-
<REGION_OF_INTEREST FIX="0" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
57+
<REGION_OF_INTEREST FIX="1" HEIGHT="3000" SHOW="0" WIDTH="4000" X="0" Y="0"/>
5858
<SEARCH_MISSING_FRAMES ENABLED="1"/>
5959
<RECALCULATE_MEDIAN_HEIGHT ENABLED="1"/>
6060
<ALLOW_ALTERNATE_HEIGHT ENABLED="0"/>

0 commit comments

Comments
 (0)