Page 1
Text als Fake ... DTRACK3 User’s Guide ARTtrack , TRACKPACK, SMARTTRACK & DTrack Version 3.1.3 June 2022 c 2022 Advanced Realtime Tracking GmbH & Co. KG Contents are subject to change without notice dasbetrifft die gesamte seitenbreite der seite des...
Page 2
Germany in the EU in the U.S. A.R.T. ARTtrack ARTTRACK DTrack DTRACK3 smARTtrack SMARTTRACK Microsoft and Windows are trademarks registered in the United States and other countries by the Microsoft Corporation. The company names and product names written in this manual are trademarks...
Page 3
Warranty regarding further use of open source software Advanced Realtime Tracking GmbH & Co. KG (denoted as ) provides no warranty for the open source software programs contained in this product, if such programs are used in any manner other than the program execution intended by .
Page 4
Flystick2+ with feedback capabilities Easier configuration of stateless firewalls (UDP sending port 50107) Early warning for expiring licenses Check of DTRACK3-valid license code before upgrading from DTrack2 What’s new in version 3.1.0? The following new features are available in DTRACK3 version v3.1.0:...
Page 5
What’s new in version 3.0.2? The following new features are available in DTRACK3 version v3.0.2: Support of ART Controller/M DTRACK3 Adjustment of for high resolution monitors What’s new in version 3.0.1? The following new features are available in DTRACK3 version v3.0.1: New ’Service’...
five degrees of freedom (i.e. one degree less in orientation) base imaginary connecting line between two cameras (e.g. the two integrated cameras inside the SMARTTRACK2/3/M ART Controller controller for rackmounting, calculates tracking data and gener- ates the data output stream (compatible to ARTTRACK2 ART-...
Page 12
Synccard2 board integrated in the ARTTRACK Controller (discontinued) which serves for synchronizing the cameras Synccard3 ART Controller ART Con- board integrated in the troller/M which serves for synchronizing the cameras SynccardTP board integrated in the TRACKPACK...
Page 13
term definition TRACKPACK/E infrared camera TRACKPACK Controller (discontin- calculates tracking data and generates the data output stream ued) (compatible to TRACKPACK TRACKPACK/C virtual point cloud used for calculating the relative position of cameras or SMART- TRACK2/3/M that cover the measurement volume wand precalibrated stick carrying two markers.
1 Safety 1.1 Symbols and their meaning You can find the following symbols and signs on the equipment or in the manual: Useful and important notes. Important notes, which may lead to system malfunction or to the loss of warranty by non-observance. Important safety warning to assure user’s and operational safety.
1.2 Warnings Do not install or use any equipment when the power cord is damaged. Insert batteries in the indicated polarity ! Some equipment employs connectors of proprietary design. Do not try to connect these to any other computer ports (e.g. COM port or LAN) Verify that voltage and frequency of your electrical grid comply with the appliance ratings of the equipment.
The ventilation holes of the equipment (particularly of SMART- TRACK2 ARTTRACK2 ART Controller ART Controller/M ) must not be covered. Ensure unblocked airflow at all times. The minimum distance between equipment and surrounding objects has to be larger than 3 cm.
All warranty and liability is void when the equipment is opened. In order to replace mains fuses (e.g. ART Controller ) always unplug the power cord first. Risk of electric shock ! Risk of explosion if removable batteries are replaced by an incorrect...
1 Safety 1.2.5 Disposal & Recycling Waste Electronic and Electrical Equipment (WEEE) should never be disposed of along with household waste. Batteries should never be disposed of along with household waste. Batteries or rechargeable batteries that are not permanently installed must be removed beforehand and disposed of separately.
2 General Information 2.1 Cleaning of the equipment Use a dry, lint-free and antistatic cloth or tissue (e.g. lens-cleaning tissue for optical equipment). Only the housing of the cameras may be cleaned. Before cleaning shut down the system and disconnect the power cords. Do not use any solvents, water or chemicals to clean the cameras! 2.2 Maintenance and service Routine maintenance of the equipment is recommended every three years.
You are responsible for deleting personal or confidential data from the equipment to be disposed of. You can do this by resetting the device to its factory settings. Please refer to DTRACK3 User’s Guide Connecting to the controller Configuring your controller’s network address without network access...
For further details regarding the Battery Directive, please refer to our website at https://ar-tracking.com/de/art-geraete-ruecknahmekonzept Batteries should never be disposed of along with household waste. Batteries or rechargeable batteries that are not permanently installed must be removed beforehand and disposed of separately.
2 General Information 2.5 Warranty General Please refer to the terms & conditions on our website at https://ar-tracking.com/en/terms-agb Hardware warrants the hardware to be free from defects in material and workman- ship, design and manufacturing for the warranty period set forth in our terms & conditions (see website) after the time of delivery.
Page 23
2.6 Liability interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use the software or hardware. Measurement results products are not authorized for use under any circumstance where human life might be at risk due to malfunction, measurement errors or interrupted operation of the system without written approval of a managing director of It is the user’s sole responsibility to check the results of the measurement data and to protect any downstream system against malfunction, measurement errors or interrupted...
3 Introduction to tracking SMART- tracking systems are infrared (IR) optical tracking systems, whereas the TRACK2/3/M are fully integrated stand-alone tracking systems, designed to be used in small volumes (approx. 2m ). In this user manual we are going to perceive "tracking" as measurement of positional and rotational information (i.e.
Marker types Passive markers are covered with retro reflective material - they act as light reflectors. Active light emitters (i.e. based on infrared LEDs) are called active mark- ers. Please refer to the ART Hardware Installation Guide for more information on mark- ers & targets.
Page 26
DTRACK3 via ethernet (i.e. without the frontend software). This is also done by estab- lishing a TCP/IP connection with the controller and exchanging short command strings (refer to the DTRACK3 Programmer’s Guide...
4 Installing the DTRACK3 software The software DTRACK3 is intended to access any controller via ethernet and runs on a remote PC (Windows or Linux). DTRACK3 itself is delivered via USB pen-drive. The latest version can be downloaded from our Download Center at http://www.ar-tracking.com/downloads/...
Page 28
4 Installing the DTRACK3 software Please read the license terms carefully and press I Agree if you agree indeed. A new win- dow shows the installation progress. The installation of the DTRACK3 software is shown using a progress bar. After...
4.2 Installation under Linux Press Finish to complete the DTRACK3 setup wizard. Now, you can use DTRACK3 Information regarding requirements to run DTRACK3 (operating sys- tem, etc.) are opened automatically after the installation is complete. Please read the information carefully.
Page 30
4 Installing the DTRACK3 software DTRACK3 may only be upgraded to the next version (e.g. v3.1.0 v3.2.0) having a valid ’DTRACK3 Upgrade’ license. Please double- check your license status first (see chapter 7.2 on page 59 for more information).
5 Connecting to the controller 5.1 Start DTRACK3 frontend software When you start up DTRACK3 on the remote PC you will see the following welcome splash screen (see figure 5.1 on page 31) . Using the mouse or shortkeys (2 = down, 4 = left, 6 = right, 8 = up) you can move around the splash screen window, e.g.
5 Connecting to the controller status message Description testing ’IP-address’ DTRACK3 is trying to access the last known controller using the IP address shown testing ’IP-address’ ... OK controller is powered-up and is accessible by DTRACK3 Controller: ’hostname’ Serial is able to connect to the last known...
5.1 Start DTRACK3 frontend software Command line parameter Description -directstart Connect with the last used controller (can be combined with -measure) -help Shows a window with these command line pa- rameters and additional examples -host <name or IP> Connect with given controller (by hostname or IP...
Page 34
5 Connecting to the controller (a) specific controller (b) scan the network Figure 5.2: Controller Selection You can easily identify your controller by comparing the serial number (e.g. ART Con- troller SMARTTRACK3 301422021 or s3-00432 listed in column Serial) with the corre-...
Please make sure that the controller is connected to the local network and that it is powered up ! In case of LANs protected by firewalls all necessary ports for DTRACK3 network communication have to be unblocked. Please re- fer to section A.1 on page 187.
5 Connecting to the controller If Wake On LAN is successful DTRACK3 will automatically establish the connection with this controller and start the frontend software. Please make sure that the controller is still connected to the local net- work and that is in standby-mode!
Page 37
’ART_Controller_XXXX_licenses.txt’ (will be written to USB pen drive during factory reset) The setup file Following, a description of the file (e.g. ART_Controller_00117_setup.txt) format: # ART Controller Setup: # ethernet settings: # - uncomment just one of the lines starting with 'SETNET' # ethernet settings: DHCP # - uncomment the following line to activate DHCP #SETNET="dhcp"...
5 Connecting to the controller # - only use if destination for tracking data or DTRACK3 frontend is in a different network than ATC # - note: gateway must be an IP number in same network/netmask as ATC! # - uncomment the following line to set a fix IP address, subnet mask and gateway IP address #SETNET="ip 192.168.0.1 255.255.255.0 192.168.0.253"...
The information file This file contains the current settings of the controller, e.g. the host-name, serial number and current IP address. Following, a description of the file format (e.g. ART_Controller_0007_info.txt or ART_Controller_301422021_info.txt): ART Controller Information: Name : smarttrack-0007 (or atc-301422021)
6 Menu Overview Please refer to the corresponding sections for each of the menus. DTRACK3 Shortcut page 57 Password password access control DTRACK3 frontend Licenses License overview Adding licenses (e.g. higher amount of cameras, Measurement Tool or Cascaded Systems) Configurations Select, create new and save different configurations,...
Fingertracking Display Fingertracking measurement data (not avail- able for SMARTTRACK2/3/M Measurement Tool Display Measurement Tool data Events Display event messages generated by DTRACK3 Tools Shortcut page 159 Measure points Provides simple measurement acquisition for use with the Measurement Tool Help...
6 Menu Overview 6.1 GUI overview DTRACK3 The graphical user interface of can be divided into the following parts (see figure 6.1 on page 42): menu bar with access to all settings (please refer to chapter 6 on page 40)
6.2 Toolbar Figure 6.2: DTRACK3 Toolbar 6.2 Toolbar By default, the toolbar (see figure 6.2 on page 43) consists of the following elements (from left to right): Toolbar element Description Start/Stop button Starts and stops the measurement Camera Status Shows the number of markers seen (2DOF) / used for tracking...
6 Menu Overview DTRACK3 Figure 6.3: Camera Status (toolbar element) Sync Status The Sync status field shows the current tracking frequency in Hz set in Hardware Synccard (Note: Hardware Inertial Sensor Tracking Frequency when using Hybrid Bodies). The background is changing its colour in case the effective fre- quency is decreasing due to processing overload (see figure 6.4 on page 44):...
6.3 Docking Displays DTRACK3 Figure 6.6: Radio transceiver status (toolbar element) Inertial Sensor Status The Inertial Sensor Status displays the currently selected chan- nel (see figure 6.7 on page 45) of the inertial dongles (wireless only) set in Hardware Inertial Sensor .
6 Menu Overview Figure 6.8: DTRACK3 Monitor 2DOF display (docking display) shapes of all recognized markers / flashes or other IR sources that can be seen inside the field of view of the cameras. It is particularly useful for the adjustment (especially...
Adding/removing cameras (not available for SMARTTRACK2/3/M ) It is possible to add or remove cameras without restarting the ART Controller ART Controller/M Please refer to chapter 8.1 on page 68 how to dynamically analyse your system for changes in configuration.
6 Menu Overview Figure 6.9: DTRACK3 Monitor 2DOF display elements the intensity of the brightest pixel in the field of view (refer to figure 6.1 on page 42), in this case 4 of 10. As a rule of thumb: For measurement applications with high accuracy requirements the markers should be displayed in green with intensities of min.
6.3 Docking Displays Function Shortcut Grid Shows a grid in the camera monitor. Cross Shows a cross in the camera monitor. Fullscreen Resizes Monitor 2DOF display to full screen and back. One Camera Only show the view of the selected camera.
6 Menu Overview Open the context menu of the Monitor 2DOF display and start the scan by left- clicking Start Scan for all enabled cameras (see figure 6.10 on page 48). A scan function will detect and suppress reflections automatically. Cancel the scan at any point by clicking Cancel, otherwise wait for completion and accept the detected areas by clicking .
6.3 Docking Displays clear regions by shift + left mouse button click, hold & drag a rectangle shaped box to create a clearing area, then release the mouse button move areas by left mouse button click, drag & drop an existing area. Leave the edit mode by opening the context menu (right-click the Monitor 2DOF display of the respective camera monitor, then de-select...
Page 52
The rotation angles (rx, ry and rz) are rotations around the X, Y and Z axis respectively. The mathematical definition can be found in the DTRACK3 Programmer’s Guide Additional information for inertial sensors In the...
6.3 Docking Displays sensor ID battery level temperature in C The temperature values between single inertial sensors may vary. The operating temperature is reached as soon as there are no more tem- perature changes inside the sensors indicated by a green status bar. It is not dependent on the absolute temperature value.
Flystick2/2+/3 is being tracked; tracking data is displayed Flystick2/2+/3 is not being tracked (e.g. Flystick has not been as- signed to ART radio transceiver); instead of tracking data dashes are displayed blue ... button is being pressed white / black ...
6.3 Docking Displays Figure 6.15: Measurement Tool Display (docking display) 6.3.6 Measurement Tool display Measurement Tool display is split into two parts (see figure 6.15 on page 55): Measurement Tool measurement results 1. the Measurement Tool ID 2. the assigned reference ID of the corresponding reference body 3.
7 Menu DTRACK3 - Basic Configuration DTRACK3 Shortcut Password Licenses Configurations Start/Stop Controller standby Controller reboot (not available for SMARTTRACK2 Quit Table 7.1: Menu DTRACK3 7.1 Password In order to restrict the access to the currently connected controller you may enable pass- word protection of the frontend.
Page 58
7 Menu DTRACK3 - Basic Configuration Figure 7.1: Enable Access control password. Enter the password and press once again. Please refer to figure 7.2 on page 58. The password protection feature is disabled and the previously set password is deleted.
Hardware Information dialog. Contact your representative and communicate your version of DTRACK3 Synccard2/3 gether with the serial number of the or alternatively the MAC address of the Ethernet port (=Identification) in order to receive a valid license code.
7 Menu DTRACK3 - Basic Configuration Exit the window Licenses 7.2.2 License model Starting with DTRACK3 version v3.1.0 a new license model has been established: System Feature Values Status Cascaded Systems supported / not supported / ex- piry at date / expired since date Inertial Sensors max.
When the license for your cameras expires you will not be able to start a measurement at all ! 7.2.2.2 Update & Upgrade Licenses License DTRACK3 Upgrade defines which updates of the DTRACK3 software are pos- sible. It corresponds either to a version number or the release date of a future release DTRACK3 .
7 Menu DTRACK3 - Basic Configuration e.g. v3.1.0 v3.1.1 v3.1.2 v3.1.3 ..., may be performed without restrictions at any time. All patch releases and updates (e.g. v3.1.0 v3.1.1 v3.1.2 v3.1.3 ...) may be installed without restrictions. DTRACK3 may only be upgraded to the next version (e.g. v3.1.0 v3.2.0) having a valid...
7.3 Configurations Figure 7.6: Edit configurations 7.3.1.2 Creating a new configuration Press to create a new configuration using the corresponding window (see figure 7.7 on page 63). You can assign a meaningful description (’description’) and enter your user name (’owner ’).
7 Menu DTRACK3 - Basic Configuration Figure 7.8: Locking a configuration 7.3.2 Backup Configurations It is possible to export and re-import single configurations or to backup and restore all settings at once. (a) Select the configurations to save (b) Select the folder on remote PC Figure 7.9: Backup configurations...
7.3 Configurations 7.9(b) on page 64). A confirmation window will inform you of the successful export (see figure 7.10 on page 64). 7.3.3 Restore Configurations ’Restore’ loads previously exported configuration files or complete backups from a remote PC. First select the folder on the remote PC where you have stored the configuration files (see figure 7.11(a) on page 65), then select the configurations to import (see figure 7.11(b) on page 65).
7 Menu DTRACK3 - Basic Configuration When exporting single or multiple configurations please assign mean- ingful filenames (e.g. exporting date ’Standard 07122012’). Configura- tions using the standard filename (e.g. "Standard") will be overwritten! 7.4 Start/Stop Start or stop the measurement by pressing the button...
Hardware 8.1 Search hardware Without the need for restarting the controller you can dynamically analyse your system for changes in configuration (e.g. added or removed cameras, ART RadioTransceiver2/3 This function is not available for SMARTTRACK2 . Therefore proceed as follows: connect a new camera to the controller wait until the camera has finished booting...
8.2 Cascaded System Settings ART Controller ART Controller/M will detect all cameras that have been removed from an already calibrated tracking system (e.g. due to a disconnected cable) and mark those as missing until a room (re-)calibration has been performed. The...
Page 70
Before starting a measurement, please double-check whether a BNC connection for synchronisation has been established between master ART Controller ’OUT1’ or ART Controller/M ’OUT ’ and slave(s) ’EXT.In’. Do not use the PoE injector nor the BNC synchronisation when connecting SMARTTRACK3 &...
8.3 Camera Settings 8.3 Camera Settings This dialog (see figure 8.2 on page 71) shows a comprehensive list of all cameras cur- rently connected to the system as well as all cameras that have been removed since the last valid room calibration. It allows changes of all camera specific settings (e.g. flash intensity, static reflex suppression, syncgroup assignment, etc.) either for all cameras at once (globally) or for each camera separately by left-clicking and selecting the appropri- ate entry.
Page 72
flash. Thus it is not possible to adjust the flash intensity. When using ARTTRACK2/C cameras it is not possible to adjust the flash intensity of the corresponding external flashes with the DTRACK3 frontend software! Please contact in case you need to adjust the flash intensity of the external flashes.
Page 73
ART Controller ART Controller/M ). To change the predefined time delays please refer to 8.4 on page 78. Please refer to the ART Hardware Installation Guide Installation of the Controller syncgroup assignment of ARTTRACK cameras in backward compatible systems. ART Controller/M...
Page 74
8 Menu Hardware - Hardware configuration higher max. frame-rates (refer to ART Hardware Installation Guide Technical Specifications for each camera model) lower latencies (i.e. time delays for measurement data). To switch the camera mode, click on the field in the column ’Camera...
8.3 Camera Settings global display intensity Move the slider to adjust the brightness of the status LEDs and the 2-digit LED matrix display on the ARTTRACK5 . The brightness can be dimmed from 0...100% if necessary (e.g. in light-sensitive environments). global display mode (ARTTRACK5 only)
180 . ’UD’ is displayed in corresponding camera monitor. display intensity Adjust the brightness of the status LEDs and the 2-digit LED matrix display display mode (De-)activates 2-digit matrix display (ART- TRACK5 only) sync group Select the syncgroup (’Channel 1’ - ’Channel 3’ for ART-...
8.3 Camera Settings Option Description marker mode configure the marker detection algorithm maximum number of markers set maximum number of markers that a camera is al- lowed to detect simultaneously maximum diameter of markers set maximum size of a marker that a camera is allowed to detect (in percentage of the camera’s sensor size) minimum diameter of markers set minimum size of a marker that a camera is allowed...
SMARTTRACK2 8.4 Synccard Settings This dialog shows the model and the serial number of the ART Synccard . Furthermore you can select the mode of synchronisation (i.e. internal or external source). The available modes for synchronisation are shown in table 8.7 on page 79.
Page 79
8.4 Synccard Settings Figure 8.5: Synccard Settings supported Synccard modes field of application internal generated signal, ... Hz run the controller without exter- nal synchronisation (available val- ues dependent on camera model) external video signal active-stereo projection with an external video signal, for validated shutter glasses analogue video sync signal (=VGA) external video signal, for validated shutter glasses, divisor 2 external TTL signal...
(i.e. triggers on falling edge). The output synchronisation signal can be chosen from ’TTL’ or ’video’ for SMART- output TRACK3 SMARTTRACK3/M ART Hardware Installation Guide & . Please refer to the Synchronisation for more information.
), a divisor can be set to reduce the frequency accordingly. Set the factor from 1 - 10. The max. frame-rate depends on the camera model and the selected camera mode. Please refer to the ART Hardware Installation Guide Technical Specifications for each camera model.
8 Menu Hardware - Hardware configuration Figure 8.6: ART Radio Info Settings Info Description Model Shows the model of the transceiver or the device respectively Serial Shows the serial number of the transceiver or device respec- tively Version Shows the firmware version of the transceiver or device re-...
Wireless hybrid targets are distributed together with an antenna and two wireless transceivers (’Dongles’) for communication with the inertial sensors as a part of the Hybrid Motion Capture suit. Please also refer to the ART Hardware Installation Guide Markers & Targets. SMARTTRACK2 individual hybrid targets are available only.
8 Menu Hardware - Hardware configuration Info Description Device ID dongle Shows the serial number of the transceiver Model Shows the type of the transceiver (Dongle USB only) Firmware Version Shows the firmware version of the transceiver Currently used radio Shows the radio channel of the transceiver (default: 35 / 55);...
8.6 Inertial Sensor 8.6.1.3 Connecting the wireless inertial sensors This needs to be done initially - in case the sensors are already connected please skip this step. pre-calibrated targets are delivered with their corresponding optical target geome- tries stored inside the inertial sensor. Thus when adding the recognized inertial sensors, all corresponding target geometries are automatically added to the tab ’standard bodies’...
8 Menu Hardware - Hardware configuration Figure 8.9: Adding wireless inertial sensors mode DTRACK3 will search for the sensors on the default channels 35 and 55 even if the current channel of dongles / sensors has been set differently. In case the dongles / sensor channels have been set manually, please change the scan mode to ’single’...
8.6 Inertial Sensor Figure 8.10: Inertial Sensor Settings - Wireless transceivers and sensors added Info Description Device ID sensor + wire- Shows the serial number of the sensor less icon Model Shows the type of the sensor (e.g. Colibri Wireless) Name Shows the target name (pre-calibrated from Hybrid Motion Capture suit or user-defined)
Inertial Sensor Settings Hybrid Bodies only when necessary. 8.6.2 Wired hybrid targets Within DTRACK3 go to the menu Hardware Inertial Sensor Hybrid Bodies (see figure 8.14 on 91) and activate the desired amount of bodies . Next assign suitable names by double-clicking the corresponding field...
8.6 Inertial Sensor 8.6.2.1 Connecting the wired inertial sensor This needs to be done initially - in case the sensor is already available please skip this step. Go to the menu Hardware Inertial Sensor and open the Settings sub-dialog (see figure 8.11 on page 89).
8 Menu Hardware - Hardware configuration Figure 8.12: Adding wired inertial sensor Figure 8.13: Inertial Sensor Settings - Wired inertial sensor added Info Description Device ID sensor Shows the serial number of the sensor Model Shows the type of the sensor (e.g. 3-Space wired) Name Shows the target name (empty unless user-defined) Firmware Version...
8.6 Inertial Sensor the window to select a different value, if necessary. 8.6.2.2 Assigning the wired inertial sensor After adding the inertial sensor it needs to be assigned to an optical target, which has been calibrated beforehand. Change to the sub-dialog Hybrid bodies inside the dialog Inertial Sensor Settings...
8 Menu Hardware - Hardware configuration selected bodies Description Body ID Shows the body ID number of the hybrid target Name Shows the target name (empty unless user-defined) Model Shows the type of the assigned inertial sensor (e.g. 3-Space wired) Device ID Shows the device ID of the assigned inertial sensor Calibration status...
8.6 Inertial Sensor During the following calibration process the target has to be tilted with moderate speed around all axes of the inertial sensor (please refer to the animation in the dialog see fig- ure 8.15 on page 92). After the countdown disappears the upcoming dialog will show the status of the calibration via a progress bar (see figure 8.16 on page 93.) Figure 8.16: Hybrid Body Calibration - Progress Bar In the upcoming result window (see figure 8.17 on page 93) the residual of the calibration...
8 Menu Hardware - Hardware configuration The sensor delay specifies the latency of the inertial data compared to real-time. This is sensor specific and dependent on the type of con- nection (wired / wireless). Values up to 5 ms are ideal for HMD applica- tions.
(see figure 8.13 on page 90) or in the toolbar DTRACK3 frontend (refer to chapter 6.2 on page 43) and leave the process running for about 5-10 minutes. The progress bar will stop at 100% (progress bar turns green) even though the warming up of the sensors continues.
8 Menu Hardware - Hardware configuration Figure 8.21: Inertial Sensors Settings - Tracking Frequency ’as inertial sensor ’: An inertial sensor is used (only available, if attached). When using multiple inertial sensors use the adjacent drop-down menu to select the ap- propriate one.
Page 97
8.7 Network Figure 8.22: Network Settings When the checkbox DHCP client is ticked the controller may be connected to a LAN with DHCP support. The controller then works as a DHCP client. The corresponding address, subnet mask gateway nameserver which have been assigned to the controller by the DHCP server are shown for your information.
8 Menu Hardware - Hardware configuration CPU temperature At the bottom of this dialog you can read the CPU temperature inside the controller. The upper value shows the current temperature in C, while the lower value indicates the temperature maximum since power-on, i.e.
Page 99
8.8 Time NTP In order to activate the NTP synchronisation , select the radio button and enter hostname IP address of your NTP server. Please ask your system administrator for further information. Click Apply to activate the synchronisation. While the controller is being synchronised the message ’wait’ is displayed next to the ’state’...
9 Menu Tracking - Tracking Configuration Calibration Shortcut Room calibration Room adjustment Shift + F5 Single markers Body administration Body calibration Body adjustment Shift + F6 Flystick SMART- Fingertracking (not available TRACK2/3/M Measurement Tool Measurement Tool tip calibration Output Table 9.1: Menu Tracking 9.1 Room Calibration Use the room calibration dialog (see figure 9.1 on page 101) to start the calibration pro-...
9 Menu Tracking - Tracking Configuration (a) type ’normal’ (b) type ’powerwall’ Figure 9.2: Marker distances (including numbering) on the ’calibration angle’ and defini- tion of room coordinate system The longer arm of the ’calibration angle’ defines the X axis (refer to figure 9.2 on page 102);...
9.1 Room Calibration 9.1.3 Room Calibration Progress When the room calibration process starts a window showing the progress appears (see figure 9.3(a) on page 103). The progress is shown individually for each camera which is especially helpful for big systems. As soon as enough data for calculation of the camera position has been collected for a specific camera the corresponding progress bar changes its colour to green (see 9.3(b) on 103).
; if e.g. movement of single cameras due to mechanical instabilities cannot be ruled out or thermal drifts occur it is necessary to perform room calibrations periodically. DTRACK3 provides a simplified process to revise an existing room calibration without need of an ’calibration...
9.1 Room Calibration To re-calibrate your room tick the checkbox re-calibration in the bottom left corner of the room calibration dialog (see figure 9.5 on page 105). The settings marker distances coordinate system are disabled / greyed out and thus are not allowed to be changed in comparison to the last valid standard room calibration.
9 Menu Tracking - Tracking Configuration 9.1.6 Show Details The button Show details offers information about the date of the latest room calibration. Duration You may adjust the ’duration’ of the room calibration ( Show details) in a range of 10s - 120s. Reset the value to default by pressing the Set to default button (default = 30s).
9.1 Room Calibration (a) Accept the Transfer (b) Transfer Successful Figure 9.7: Transfer Room Calibration - sub-dialogs 9.1.8 Room Calibration - SMARTTRACK2/3/M By default, the origin of the coordinate system lies approximately in the center between the two cameras . The orientation of the coordinate system is as shown in the Room calibration dialog (see figure 9.8 on page 107).
9 Menu Tracking - Tracking Configuration 9.2 Room adjustment During a room calibration the marker located in the intersection of the two arms on the ’calibration angle’ defines the origin of the coordinate system (Marker #1), see figure 9.2 on page 102. Oftentimes it might be more suitable to set the origin in respect to a well- known point in space.
9.2 Room adjustment Figure 9.9: Room adjustment dialog (coarse) 9.2.2.1 Graphical display The room coordinate system is shown as a triplet of arrows with a defined color-coding (x-axis - red, y-axis - green, z-axis - blue), while the xy-plane is shown as a yellow grid. The current and the transformed room coordinate systems are marked with (’O’) and (’T ’)
9 Menu Tracking - Tracking Configuration (a) before Transformation (b) after Transformation Figure 9.10: Room adjustment dialog (fine) 9.2.2.2 Manually transforming the coordinate system Several options for transformation of the coordinate system can be selected (refer to table 9.6 on page 111). Example All entered transformation values are relative to the original room coordinate system, i.e.
(1.0000) Start start up a module for transforming & matching to a reference co- ordinate system (DTRACK3 licenses required) Table 9.6: Room Adjustment (Fine) - Transform actions 9.2.2.3 Adjust to angle tool In some cases the room coordinate system needs to be transformed to a specific posi-...
9 Menu Tracking - Tracking Configuration Figure 9.11: Room adjustment - Adjust room coordinates to angle tool (a) Progress bar (b) Success Window Figure 9.12: Adjust room coordinates to angle tool - sub-dialogs in the Fine tab to open the room matching dialog (see figure 9.13 on page 113). This functionality depends on licenses (refer to chapter 7.2 on page 59).
Page 113
9.2 Room adjustment Figure 9.13: Room transform & matching dialog Deselect any previously assigned Measurement Tool References prior to matching of the coordinate systems. Otherwise matching results will be erroneous. Procedure A three-step process has to be performed: 1. Add measurement data from the reference coordinate system (’T ’) by manually en- tering the coordinates into the table...
9 Menu Tracking - Tracking Configuration clicking the button Measure clicking the start button on the Measurement Tool (if applicable) using the start button simulation of the Measurement Tool (refer to 9.9 on page 150) Flystick2/2+/3 clicking a button of an assigned 3.
9.4 Body administration Figure 9.14: Single Marker Settings 9.4 Body administration This dialog (see figure 9.15 on page 115) allows for managing all targets (e.g. Standard, Flystick, Measurement Tool , etc.) in the system. The number and types of bodies to be tracked may be configured in here.
9 Menu Tracking - Tracking Configuration In the bottom right of the dialog (see figure 9.15 on page 115) you will find two buttons. You may switch to the Body Calibration dialog and perform the optical calibration for the selected target via Calibration (see chapter 9.5.1 on page 121).
Table 9.8: Body Administration - Description of calibration status 9.4.1 Filtering options for 6DOF tracking data DTRACK3 incorporates advanced filtering options for enhanced 6DOF tracking perfor- mance. One can choose between recommended presets or customize filtering options in order to optimize tracking behaviour individually for each target. For example in ap- plications where reference targets are used to calculate the position of a seating buck it is possible to apply a strong filter for these targets which results in practically noise-free...
9 Menu Tracking - Tracking Configuration Figure 9.16: Filter Settings Presets optical tracking Description custom Customizable preset. A detailed description of the parameters can be found in table 9.10 on page 119. default Standard filtering without prediction or smoothing. Flystick Recommended setting for use with Flystick2/2+/3 (responsive...
9.4 Body administration tion using the following tunable settings: Settings Description Usage Strength Sets the strength of the filter. Low A higher strength may be values lead to faster reaction but ideal for tracking seating higher jitter. High values result in bucks smoother output but slower reac- tion.
figure 9.17 on page 120 shows a rigid body with five markers that are all correctly seen by the IR camera. Figure 9.17: Recognized target in DTRACK3 Monitor 2DOF display Do not calibrate the body geometry for a HMD clip-on targets manually ! Always use the built-in target library and re-calibrate afterwards to compensate for mechanical bending or twisting due to mounting.
9.5 Body calibration Ensure the absence of any additional markers in the measurement vol- ume during body calibration. If additional markers that are not part of the target are in the field of view of the IR cameras during body calibra- tion these markers will be assigned to the target.
file(s)’ option in the Body calibration dialog. 9.5.2 Selecting the coordinate system for 6DOF targets During body calibration, DTRACK3 defines a local coordinate system (body coordinate system) for each target . The type of body calibration can be set as ’due to body ’,...
Without moving the body a 6DOF measurement right after the calibration will give the angular coordinates 0 / 0 / 0 . DTRACK3 If the target was moved during calibration instead will use the direction of the target at the beginning of the calibration.
9 Menu Tracking - Tracking Configuration by the tracking system. This is where the ’5DOF central axis’ comes into play. The ’5DOF central axis’ defines the missing degree of freedom if you intend to use the tracking data for 6DOF scenarios nonetheless.
9.5 Body calibration Figure 9.20: Body Calibration Process - Progress bar 9.5.5 Body calibration result After successfully calibrating a body the result window is displayed (see figure 9.21 on 125). Figure 9.21: Body Calibration Process - Result Window All markers of the rigid body that have been recognized during calibration are listed. Con- firm the result with or discard the calibration with Cancel.
9 Menu Tracking - Tracking Configuration (a) Distances between markers (b) Emission vector & aperture (c) Cylinder Information information Figure 9.22: Body calibration Result ’Distances’ shows all possible combinations of distances for all markers (min. dis- tances are important for customer-specific geometries, call for further informa- tion) ’Emissions’...
9.5 Body calibration (a) Selecting the body file(s) to save (b) Select the folder on the remote PC Figure 9.23: Saving calibration files Figure 9.24: Saving calibration files - Confirmation Message The format of the file name will be according to "standard b01.txt" with "b01"...
9 Menu Tracking - Tracking Configuration Alternatively you can load multiple files simultaneously when the corresponding body cal- ibration files comply to the DTRACK3 file name convention (i.e. "standard b01.txt" with "b01" being the identifier which refers to the ID of the target).
9.5 Body calibration An automatic target recognition identifies the body geometry and loads the corresponding information. Go to Tracking Body Calibration and choose the tab ’Target Library ’ (refer to figure 9.26 on page 129). By default the complete library is used for target recognition, the drop-down menu filter is set to...
(see figure 9.28(b) on page 130) and exit the dialog. DTRACK3 compares the geometry of the physical target with the cali- bration data of the target library. In some cases a re-calibration might be necessary, i.e.
9.6 Body adjustment body. Body adjustment is not available for 5DOF targets or measurement tools. The main features of Body adjustment are: adjusting the body position and orientation of each target manually, use predefined body coordinate systems, move and set the origin of the body coordinate system (e.g. into a selected marker or the center of gravity), aligning the axes of body and room coordinate system without changing the origin, delete selected markers from the target geometry,...
Page 132
9 Menu Tracking - Tracking Configuration Figure 9.29: Body Adjustment To restore the default view press Reset view. Press Enter or click to accept all changes for all bodies (i.e after confirmation the changes are sent to the controller) and to close the dialog. Press Apply instead to change the currently selected body only - the body will be redrawn and the dialog will be left open.
9.6 Body adjustment Option Description ’Small markers’ reduces the size of the marker spheres ’Colored markers’ shows the markers in RGB colors (untick: greyish) ’Emissions’ shows emission vectors (arrows) and emission aperture (cones) (if applicable) ’Long axes’ extends the coordinate axes of the body coordinate system by infinite dashed lines ’Show COG’...
9 Menu Tracking - Tracking Configuration Action Description Body position [mm] translate the body coordinate system along its axes in steps of 1mm Body orientation [deg] rotate the body coordinate system around its axes Set origin activate and highlight a marker in the ’Graphic view’...
Figure 9.30: Flystick Settings Checkbox Description use old output format use the legacy output format of the Flystick1 (refer to the DTRACK3 Programmer’s Guide activate MultiUser function activate the use of multiple Flystick2/2+/3 (refer to section 9.7 on page 136)
Flystick2/2+/3 . Tick the checkbox ’activate MultiUser function’ to activate the function. Please refer to the DTRACK3 Programmer’s Guide Output of Measurement Data via Ethernet for more details. Use head targets In order to use a Flystick2/2+/3...
Test to send a series of feedback commands to test beep and vibration of the Flystick2+ The corresponding status LEDs will light up to indicate radio communication. Please refer to the ART Hardware Installation Guide Interaction devices Flystick2+ Control Elements.
4. (optionally) Install an ART RadioTransceiver2/3 when using FINGERTRACKING2 Tactile ART Hardware Installation Guide devices (refer to the Other equipment Radio Transceiver and section 8.5 on page 81 for details). 5. (optionally) Assign tactile devices for all hand targets, if applicable Simply repeat all steps for each tracked hand in your system.
9.8 Fingertracking 9.8.1.1 Available hand geometries It is also possible to (re-)assign previously calibrated hand geometries (i.e. position and orientation of the finger tips) to existing hand target calibrations . This way one set of Fin- gertracking hand targets can be used by several different users and, most importantly, one needs to calibrate the hand geometry only once for each person during first installa- tion.
9 Menu Tracking - Tracking Configuration (a) Select the hand geometry file(s) to (b) Select the folder on the remote PC save Figure 9.32: Fingertracking Administration - Saving hand geometry files Figure 9.33: Fingertracking Administration - Saving hand geometry files - Confirmation window select all (see figure 9.34(b) on page 140).
9.8 Fingertracking Figure 9.35: Fingertracking Administration - Loading hand geometry files - Confirmation window remove the corresponding entry. A confirmation window will show up to confirm the removal (see figure 9.36(b) on page 141). (a) Select the hand geometry file(s) to delete (b) Confirm the removal Figure 9.36: Fingertracking Administration - Deleting hand geometry files 9.8.2 Fingertracking Body calibration via Target Library...
FINGER- TRACKING2 Tactile devices have to be set up properly. Refer to the ART Hardware Installation Guide Interaction devices FINGER- TRACKING2 Tactile Hand Targets how to switch the configuration.
9.8 Fingertracking 9.8.3 Fingertracking Body calibration Custom Figure 9.38: Fingertracking Administration - Body Calibration Custom When using hand targets not found inside the target library (e.g. customized) a standard body calibration has to be carried out. The process of calibrating a 6DOF body is de- scribed in chapter 9.5.1 on page 121.
9 Menu Tracking - Tracking Configuration Figure 9.39: Fingertracking Administration - Hand Geometry Calibration (optionally) activate the 5 finger simulation (only available for 3-finger thimble sets) by ticking the checkbox 3 - 5 press Calibrate to start the two-step calibration process For easy identification and assignment of the correct hand geometry for different users please use meaningful names for the ’geometry’.
Page 145
9.8 Fingertracking Figure 9.40: Fingertracking Administration - Hand Geometry Calibration progress bar A progress bar shows the status of the calibration (see figure 9.40 on page 145). If calibration step 1 fails, please check if modulated flash is activated for at least one camera and if the correct handedness and thimble set are selected.
If you are using a three finger thimble set but would like to get data for five fingers, tick the checkbox simulate 3 - DTRACK3 will simulate the data of the two missing fingers by putting them parallel to the middle finger. By default, the checkbox simulate 3 - unticked until you have carried out a hand geometry calibration.
9.8 Fingertracking In the rare case when the Fingertracking devices have lost synchro- nization use the reset procedure to regain synchronisation. Refer to ART Hardware Installation Guide Interaction devices Finger- tracking Description of the hand targets. 9.8.5 Fingertracking Tactile Assignment...
You can also test one finger after the other by pressing the corresponding buttons Test thumb, Test index Test middle. The corresponding status LED will light up to indicate ART Hardware Installation Guide radio communication. Refer to the Interaction de- vices Fingertracking Description of the hand targets.
Double-click the corresponding entry Tip diameter [mm] enter a value (in mm) when using ball-shaped tips. The diameter will be included in the DTRACK3 Programmer’s Guide data output (refer to the Output of Measurement Data via...
Tip diameter [mm] define the diameter of the tip (ball-shaped) use old output format use the legacy output format (refer to the DTRACK3 Programmer’s Guide measurement duration [s] configure how long a measurement with the Mea- surement Tool (valid range: 0.2 - 10.0 sec) should...
9 Menu Tracking - Tracking Configuration press Select. ’Reference ID’ entry will be updated accordingly. Repeat these steps if you want to assign references to other Measurement Tools . If you are working with reference bodies you will need to calibrate them as well. This is done using a standard body calibration of e.g.
Calibrate to start the calibration process. Gently move the Measurement Tool while tilting it around its tip in all axes. A progress bar DTRACK3 will show the current status (see figure 9.46(a) on page 153. will calculate the position of the tip relative to the markers of the Measurement Tool , i.e. the origin of the body coordinate system is transformed into the Measurement Tool ’s tip.
PC from where you started the DTRACK3 frontend. You can also send the data to a multicast IP address (in the range of 224.0.1.0 to 239.255.255.255) by ticking the checkbox multicast.
Page 155
Please refer to section 7.2 on page 59 for more information. Table 9.16: Description of UDP output data Please refer to the DTRACK3 Programmer’s Guide Output of Measurement Data via Ethernet for the format of the data output.
Inertial Sensor Settings Tracking. Please refer to chapter 8.6.2.5 on page 95 for further information. When using the identifier ’timestamp’ please refer to the DTRACK3 Programmer’s Guide Output of Measurement Data via Ethernet garding the accuracy of timestamps. Please double-check that output channels are activated only for con- nected clients ready to receive data.
Measurement Tool Events Table 10.1: Menu View Set to default This function resets the appearance of the DTRACK3 frontend, i.e. all views and the size of the windows are reverted to default values. Only the Monitor 2DOF and the displays...
Page 158
10 Menu View - Frontend configuration Flystick The Flystick display shows the measurement results of the position and orien- tation of the Flystick.
11 Menu Tools Tools Shortcut Measure points Table 11.1: Menu Tools 11.1 Measure Points This tool (see figure 11.1 on page 159) provides a simple acquisition method for mea- surements with the Measurement Tool . Figure 11.1: Measure Points The dialog shows the following informations: The measurement of a point is started either by pressing the button Measure point by performing a gesture with the Measurement Tool .
Page 160
11 Menu Tools Control Description Measure point Place the Measurement Tool at the position you want to measure and press this button. Insert point Add an additional measurement to the list (above the selected point). Delete point Remove the selected measurement from the list. Save list Export the list of measurements to a file (e.g.
12 Menu Help About Shortcut What’s this? Shift + F1 What’s new? Controller Update Service DTRACK3 About Qt Table 12.1: Menu Help 12.1 What’s this? By clicking What’s this, you may use the context-sensitive help function within the DTRACK3 fron- tend software.
Figure 12.1: What’s new Information 12.3 Controller Update After updating the DTRACK3 frontend software an automatic update of the controller and cameras is started, if necessary. In case you have aborted this process during first run you can re-open the update assistant here (see figure 12.2 on page 162).
Page 163
12.3 Controller Update Click Next to start the update process. Confirm by clicking in the upcoming dialog (see figure 12.3(a) on page 163). A final warning will open after which the update is started (see figure 12.3(b) on page 163). Do not stop the process afterwards. (a) Confirmation window (b) Confirmation warning Figure 12.3: Confirming the update...
All patch releases and updates (e.g. v3.1.0 v3.1.1 v3.1.2 v3.1.3 ...) may be installed without restrictions. DTRACK3 may only be upgraded to the next version (e.g. v3.1.0 v3.2.0) having a valid ’DTRACK3 Upgrade’ license. Please double- check your license status first (see chapter 7.2 on page 59 for more information).
12.4 Service Figure 12.6: Upgrade Warning Figure 12.7: Upgrade Denied Figure 12.8: Upgrade Valid License Code Entry After entering the code press and the upgrade will be started. Please refer to the previous section and figure 12.4(a) on page 163. 12.4 Service The service dialog shows important information when contacting technical support...
12 Menu Help Service-ID is a unique identifier of your controller. Next the current software version on your controller (i.e. backend) is shown next to DTRACK . You can select both entries to copy & paste. The following entries show the Service Level Warranty Level.
12.5 DTRACK3 Figure 12.10: Export System Information 12.5 DTRACK3 This dialog offers information about the software version and release date of the DTRACK3 fron- tend and backend software running on the controller (see figure 12.11 on page 168). Ad- ditionally hostname and serial number of the controller are shown. By clicking on the...
12 Menu Help Figure 12.11: About DTRACK3 Information 12.6 About Qt This offers information about the Qt software toolkit used within DTRACK3 Figure 12.12: About Qt Information...
Our goal is to offer the best support possible. Therefore, we ask you to have the system running and that you have internet access when you call us. Additionally we will need DTRACK3 User’s Guide details about your system. Please refer to the...
In case you are using a firewall, please do not block DTRACK3 communication. Please refer to chapter A.1 on page 187. For more information, please also refer to the ART Hardware Installation Guide stallation of the Controller Installation of the SMARTTRACK3 Connection to local network LAN.
By synchronizing both systems, the cameras emit their flash in a way that does not interfere. Please refer to the ART Hardware Installation Guide Synchronisation. When I connect the "ExtIn", the shutter emitters stop working. Some projectors create only a weak sync signal (TTL), which is not strong enough to...
If you don’t want to change the module you may also use the ’old output format’ for legacy Flystick1. Please refer to chapter 9.7 on page 135 for more details. 13.6 Software DTRACK3 Where do I get the software DTRACK3 from? The software DTRACK3 is delivered on a USB pen drive with the tracking system.
Page 173
Why is the Monitor 2DOF display crossed out for some cameras? Please check if all the cameras used during room calibration are connected. Please refer to the ART Hardware Installation Guide for the common rea- sons of disconnected cameras. Please refer to section 6.3.1 on page 45 for more information about Adding / remov- ing cameras.
Please check that the cameras are not in the field of view of each other to avoid mutual blinding. Furthermore, remove other strong IR radiation sources from the tracking volume or, at least, prevent them from interfering with the tracking system. Please refer to the ART Hardware Installation Guide Setting up the cameras for more information.
Page 175
13.6 Software DTRACK3 Where do I get a software update from? The latest patch release of DTRACK3 is always available at the Download Center DTRACK3 Please refer to chapter 7.2 on page 59 for more information about release policy. I want to run a software update. How do I preserve my data and my configurations?
Move the wand gently within the measurement volume, in order to generate a virtual point cloud. This point cloud should fill at least about two thirds of the measurement volume. Please refer to the ART Hardware Installation Guide Setting up the cameras Room Calibration - Overview for more information.
Page 177
13.7 Calibration Please refer to the ART Hardware Installation Guide Setting up the cameras Room Calibration - Overview for more information. I cannot cover two thirds of the measurement volume within the set time for the room calibration. How do I extend the time for the calibration process?
Page 178
The scaling error can be determined, for instance, by measuring points on a defined scale (e.g. tape measure). The determined scaling error can thus be adjusted with the DTRACK3 ’scaling factor ’ (refer to chapter 9.2 on page 108). Please contact if you require further information.
Page 179
I cannot increase the number of targets anymore. The maximum number of targets to be tracked (including Flystick2/2+/3 Fingertrack- devices) depends on the license that is installed. Go to DTRACK3 Licenses to see which license you have. Starting with DTRACK3 version v3.0.0 a new license model has been established.
13 Frequently asked questions (FAQ) How shall I evaluate the body calibration results? Verify that all markers of the target have been recognized during the DTRACK3 body cal- ibration. Further, you may check if the single distances between the markers are correct (refer to chapter 9.5.5 on page 125).
If they cannot be removed you may use the reflex suppression feature of DTRACK3 If mutual blinding is possible please either try to adjust the cameras differently or try to arrange them in different syncgroups.
Page 182
Flysticks list. Flystick2/2+/3 Make sure that the battery is charged. Press any button of the the orange status LED should be switched on. Go to Hardware ART Radio Info to see if the radio transceiver has been recognized. Go to Hardware...
’OUT1’ on the controller’s Synccard2/3 The configuration dial has to be turned to the proper position. Please refer to the ART Hardware Installation Guide System setup Interaction devices. Increase the brightness of the LEDs on FINGERTRACKING2 devices.
Page 184
This is not bug, but rather it is due to the sequential activation of the finger thimble markers in order to achieve a separation of the fingers. What’s the meaning of the status LEDs on the Fingertracking hand target? ART Hardware Installation Guide Please refer to the System setup...
13.11 Measurement Tool Fingertracking output data is not transmitted. Go to Tracking Output and check if the data output is configured correctly: data receiver defined (’send to’), identifiers ’gl’ and ’glcal’ selected. Is it possible to upgrade to the 3-finger or the 5-finger version? Yes, if you are currently using the non-tactile 3-finger version you may also use 5-finger thimble sets and vice versa.
13 Frequently asked questions (FAQ) Shutter glasses IR synchronized shutter glasses might not work with tracking systems. Due to the increasing variety, only validated a few of these shutter glasses. However, we may support customers who are performing tests with shutter glasses that have not been vali- dated yet.
, radio synchronization RealD CE1 RealD CE2 RealD CE3 RealD CE4 RealD CE5 Volfoni EDGE , with Volfoni or NuVision Long-Range Emitter XPand X103 , with NuVision Long-Range Emitter XPand X101 XPand X104LX Virtalis ActiveWorks 500 DTRACK3 frontend software System requirements...
Page 188
15.0 64 Bit Linux Ubuntu 18.04 64 Bit Linux CentOS 7.5 64 Bit Linux Debian 10.0 64 Bit Used IP ports in Controller Controller DTRACK3 fron- purpose tend TCP 50105 TCP dynamic general communication UDP 50105 UDP dynamic general communication...
5.2 Command line parameters ......33 DTRACK3 menu structure overview ..... . 41 6.2 Toolbar elements of...
Page 194
List of Tables 9.12 Body Adjustment (General) - Transform actions ....134 9.13 Body Adjustment (Special) - Transform actions ....134 9.14 Flystick settings - Description of the checkboxes and options .
Need help?
Do you have a question about the DTRACK3 and is the answer not in the manual?
Questions and answers