User manual
Version: v4.5.2
5.6.2 fusionTrack in a ME system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
5.6.3 Annex: Explanation of applied part . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6 Software installation 30
6.1 Windows installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6.2 Linux installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7 How the fusionTrack device works 31
7.1 Communicating with the fusionTrack device . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.2 The fusionTrack device coordinates system and working volume . . . . . . . . . . . . . . . 31
7.3 Information provided by the fusionTrack device . . . . . . . . . . . . . . . . . . . . . . . . . 33
7.3.1 The fusionTrack events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
7.4 Fiducial detection and marker tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
7.5 Temperature compensation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
7.6 The fusionTrack device markers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
7.6.1 Passive markers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7.6.2 Active markers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
7.7 Marker geometry les . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
7.8 Marker tracking parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7.9 Phantom ducials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.10 Stray ducials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
8 Using the fusionTrack system 45
8.1 The fusionTrack system options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
8.1.1 Library related options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
8.1.2 Device related options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
8.1.3 Detection stage related options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
8.1.4 Wireless related options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
8.1.5 Authentication related options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
8.1.6 Environment and options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
8.2 User interface software ‘demo.exe’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
8.2.1 Recalibration of a marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
8.2.2 Exporting the data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
8.2.3 Dumping the data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
8.3 Command line software samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
8.4 Latency measuring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.4.1 Running the software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.5 Compilation of provided samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
8.5.1 Windows compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
8.5.2 Unices compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
9 Language bindings 65
9.1 Python wrapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
9.2 Matlab wrapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
10 Command line utility tool 67
10.1 Establishing a connection with atnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
10.2 Updating the rmware of the fusionTrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
10.3 Updating the rmware of the fusionTrack shock detection unit . . . . . . . . . . . . . . . . . 68
Atracsys / 2020-06-17 / 16:48:00 2 / 113