Calibration Mode
How to record debug videos for calibration and performance checks of the configured scenarios

Calibration Overlay in SWARM Control Center

For easy calibration, you can use our Calibration Overlay per Stream in the Control Center. As you can see in the screenshot below, this mode offers visibility about what objects the software is able to detect in the current previewed frame.
Our detected objects are surrounded by a so-called bounding box. Any bounding box also displays the center of the object. In order to distinguish the objects, we offer the calibration more in differentiated colors. Any event that gets delivered via MQTT is triggered by the center of the object (dot in the center of the bounding box).
Calibration Mode in SCC

What is the debug mode?

For more detailed calibration insights and performance check, you can use the advances debug mode.
For data security reason, the debug mode needs to be enabled manually and is not enabled by default.
Debug mode let you visually show the SWARM software in action. It is designed for debugging on Swarm side mainly, but can also be used for adjusting and understanding SWARM. There are multiple parameters you may use for the debug mode. In the following, we are showing the most common parameter - a counting line.
Remember GDPR/DSGVO, whenever you work with the debug mode! Technically, it is possible to record the debug mode and breach data privacy!
Debug Mode
The Debug mode can be enabled in the device twin in Azure.
If you do not host the SWARM Perception Platform in your own Azure, Support can enable it for you.
Add the following lines to the stream block in the device twin:
1
"debug": true,
2
"parameters": {
3
"drawActiveTracks": true,
4
"drawFinishedTracks": true,
5
"drawClasses": true
6
}
Copied!
It is important to add the lines to the correct block, otherwise you may break the configuration!
1
"streams": {
2
"595f144f-f66a-43e4-a3f4-c01d02723841": {
3
"expert": {
4
"model": "traffic-detector-urban-standard-fast",
5
"heatmap": false,
6
"originDestination": {
7
"zones": {
8
...
9
}
10
},
11
"crossing": {
12
"lines": {
13
...
14
}
15
},
16
"regionOfInterest": {
17
"regions": {
18
...
19
}
20
}
21
},
22
"camera": {
23
...
24
},
25
"mqtt": {
26
...
27
},
28
"debug": true,
29
"parameters": {
30
"drawActiveTracks": true,
31
"drawFinishedTracks": true,
32
"drawClasses": true
33
}
34
}
Copied!

Access Debug Stream

Once the debug mode is enabled, you can access the stream on all IPs, which are configured on the SWARM Perception Box (or your own Hardware) via browser and port 8090.
Access Debug Stream via Browser
If you have enabled the debug mode for multiple streams, the path changes for every stream. e.g.: Stream 1 is available via http://IP:8090/0, stream 2 via path http://IP:8090/1, stream 3 has path http://IP:8090/3, ...
You may also use any kind of video streaming application, like VLC, to access the stream as well.