Tracking Hub Administrator Guide

Version 1.6 | Published December 15, 2022 ©

Post System

The Tracking Hub Post system lets you record tracking data and play the data back at a later time. To use this feature, every field in the video and every tracking data must be stamped with a timecode. The timecode is read by Plura timecode reader card (PCLPCIe 3G).

Note: While the Live timecode can be LTC based, the Post timecode must be field based (ATC VITC). If a frame based timecode is used for live, the increases the field count on every field change. This is not possible for post, as the video can be shuttled back and forward, and therefore the direction is not given for sure.


Create a Post Session

Click the New Session button to create a new session. Enter the session name in the pane that opens, then click Create.


Load a Post Session

To load a previously stored session, click the Load button in the Post section of the window. A pane with a list of previously recorded sessions appears. Select one of the sessions and click Load Session. images/download/attachments/58358873/Post_3.png

Configure a Post Session

After creating or loading a session, the timeline and timecode labels are visible. A green bar in the time line display indicates time spans where tracking data was recorded and is in memory. The red timecode arrow shows the actual post timecode. The white arrow shows the live timecode. Hold Ctrl and scroll the mouse wheel to modify the timeline scale. You can change the position of the timeline using the scroll bar at the bottom.

Hover the mouse over the Post Timecode or Live Timecode labels to display a tooltip that shows the Post timecode source or the Live timecode source.

You can automatically load a saved session after Tracking Hub restarts. Activate the Auto load switch to enable this feature.


Right click the Live or Post Timecode labels to select the actual timecode source. A small window appears, which shows the available timecode sources of Tracking Hub.

Note: The must be run in AV-Card mode to recognize the installed Plura timecode card. Otherwise, the timecode sources are not displayed.

SimLive and SimPost are used to record tracking data without timecode reader card. This is for analysis purposes only and should never be used for production recording!


Selecting the Recording and Replay Sources

Tracking Hub can record two sources of data. The parameters coming from the tracking system can be recorded separately, and are sent to the rig during replay. This enables correcting offsets and rig setup after the data was recorded. The second source is the finally baked camera matrix, which is recorded after the rig calculations have taken place. This data can not be modified.

The following screenshot shows the parameter selection for a tracking system. For every parameter, recording and replay can be checked in a check box. An individual delay can be given for every parameter. Replay for a parameter is activated when replay is checked and the post timecode differs by more than five fields from the live timecode.


When recording tracking data, Tracking Hub records one package per field. Usually, this is the desired behavior. In rare cases (recording Motion Analysis Data), the tracking system sends more than one package per field. This can happen if a tracking system is running at 60 Hz and the studio is running at 50 Hz. In this case, Tracking Hub interpolates the data and no jitter is visible. In the recorded session, a jitter will be visible. When this happens, the flag use interpolated data can be switched on and the post system records the interpolated data.


You can activate recording and replay of the camera matrix in the Camera Service settings. There is also an option for the camera delay.


Camera Channels

When loading a session that has more than one camera, the camera channels are named by the number in creation order of the service. You can assign any channel that has been loaded from a former session to any camera service. To assign a channel to a service, choose one of the available channels from the drop down menu. If nothing is selected, the channel with the number of the camera service is used.


Post Offset and Delay

Tracking Hub offers two types of delays. One is an offset that is added or subtracted (depending on the sign) from the actual Post timecode. The typical offset for Parameter recording is -2 fields, and for a camera matrix recording it is usually two fields. The second delay setting is a ring buffer. This is useful in configurations where shuttling back and forward is used.


Post Data Storage

The post data is written to file immediately after being received. Tracking Hub contains about four hours of data in memory.

  • The storage location is C:\ProgramData\vizrt\VizTH\Post.

  • The ring buffer size of the post channels can be changed in the BaseConfig.xml.

  • PostBufferSize is the number of packages stored before the oldest is deleted.

  • PostFileCutTime is the time when Tracking Hub creates a new save file for the PostData. The PostFileCutTime gives the Time in minutes.

Example: PostBufferSize="1000000" PostFileCutTime="0"