Skip to content

FAQ

SightLab VR Pro FAQ

1. What headsets and hardware is this compatible with?

Sightlab VR Pro works with the following headsets:

For eye tracking: - Varjo Aero, XR-3, XR-4, VR-3 - Meta Quest Pro - Vive Focus 3 (with optional eye tracker add-on) - Vive Focus Vision - Vive Pro Eye - HP Omnicept - Pupil Labs (includes Vive Cosmos, Vive Pro, original Vive) - StarVR One - Tobii Pro - Pimax (through OpenXR) - SMI

For non-eye tracked headsets you can use head position with these headsets: - Meta headsets (including the Quest, Quest 2, Quest 3/3S and Quest Pro with Oculus Link) - All SteamVR compatible headsets (Pimax, Valve Index and much more) - Windows Mixed Reality headsets - Pico works with just head position and connected via SteamVR link - Vive XR Elite - Desktop mode

For additional hardware supported, see the Vizard Supported Devices page.

2. Can I import 3D models in any usual format (obj, FBX, for example) for data collection?

You can import 3D models in the usual formats, so .glTF/.glb, .obj and .fbx and other common formats will work. There may be mixed results depending on how the textures are packed (the most consistent format would be .glTF/.glb). For more information see this page.

3. Where can I get assets to build a scene with?

See this page on all the places in which to get assets. There are also included assets you can use with Sightlab.

4. Are there differences in functionality between the single and multi-user version?

The multi-user version has all the same functionality as the single user, but with the ability to have multiple participants in a session interacting together.

5. Can your software export data in CSV format? What other export formats are available?

Yes, the data files are in .csv and .txt formats.

6. What data is collected in the main template?

Number of fixations, time to first fixation, average fixation time, total fixation time, fixation timeline, gaze intersect position, individual eye rotation, saccade amplitude and velocity, time stamps, head position, pupil diameter, as well as the ability to add custom flags such as interactions. If connecting to BIOPAC can also synchronize with the physio data. Synchronization with additional data streams is also possible via a UNIX calibrated time stamp or network events. Additional data is available with custom code and varies per eye tracked headset (such as “eye openness” for the Vive Pro Eye). To add more data points see the data logger example. See this page for more details.

7. What algorithms are you using for the eye tracking data, such as fixations?

See the page on eye tracking metrics or eye tracking data

8. Can I use SightLab VR standalone?

SightLab VR Pro requires WorldViz Vizard software for its full functionality as SightLab VR Pro is an add-on software to our Vizard software engine. You can, however, still use a software like Shadow PC to stream via the cloud to a device running in stand alone mode.

9. We developed some applications in Unity 3D. Can we use them for eye-tracking?

Currently, SightLab only runs on the Vizard platform, but you can import assets from Unity by using their FBX exporter. Here's an article on doing that. You can also use the External Application Data Recorder to collect data while running a Unity Application or any game. There are limitations however, see this page for more details.

10. SightLab GUI is just showing a black screen instead of my model, or I'm getting an error when running the SightLab GUI

The first thing to try that can get past a lot of errors is to go into the "sightlab_configs" folder and delete the "recent_config" file. If this doesn't work you can run the main SightLab file in the Vizard python editor and refer to the error message.

11. How do I update the SRAnipal driver if using the Vive Pro Eye or the Vive Focus 3?

See this document on how the process of updating your SRAnipal driver works.

12. Not able to unpack the exe due to it being detected as a virus

You may need to temporarily disable real time protection or add an exclusion with Windows Defender (make sure to turn it back on afterwards).

13. I Don't have space to add all of the objects I'm trying to collect data on

See the Example Script - Large List of Items or the code attributes page to see ways you can add a large list of objects if the GUI doesn't allow to select all of them.

14. I'm getting a 'Permission Denied' error when trying to run SightLab

This usually happens if you have your participant ID either left blank or the same name as an earlier one, but that earlier one is still open in a spreadsheet editor program.

15. I'm not seeing my data file when I load the Session Replay

This is most likely that you put an underscore the participant ID name. You can remove that underscore to see the file, but underscores will cause this issue.

16. Poor framerate on a 3D model scene

You can use various optimization methods (see this page). This is a simple couple of lines that could be tried:

env = sightlab.objects[0]  # If using the GUI, add this after the experiment starts in the sightLabExperiment function
env.optimize(viz.OPT_REMOVE_REDUNDANT_NODES)

env.hint(viz.VBO_HINT)

Additionally, you can open the model in Inspector and choose the textures tab on the bottom right, then shift click to select all textures, right click and compress them.

17. How Do I Install this on a MAC?

Vizard (the software SightLab is built on) is a Windows based software, but you can use “Parallels” to run Windows based applications on your Mac. So development and basic testing with Vizard can be done on a VMware partition on Mac, but for testing with VR peripherals like VR headsets, typically a PC is the better and more functional solution.

18. I need to add a python library to my project

Search for the python library version using the Package Manager: https://docs.worldviz.com/vizard/latest/#Package_Manager.htm

19. I am not hearing audio from a windows audio player

You may need to play the sound directly in SightLab/Vizard using audio = viz.addAudio('someFile.wav')

20. Autocomplete isn't working

You either need to copy your script into the SightLab root folder, or sometimes you need to uninstall Vizard, delete the Vizard folder from Program Files and reinstall (but then would need to reinstall additional Python libraries).

21. Getting an error that the sightlab_utils module cannot be found

Add this code to the top of your script to find the path:

import sys

sys.path.append(r"C:Program FilesWorldVizVizard7binlibsite-packages")

or for Vizard 8

    import sys

    sys.path.append(r"C:Program FilesWorldVizVizard8binlibsite-packages")

22. The GUI scene preview is black after clicking "Modify"

Close and restart the GUI script and press "New" to create a new project (or delete the recent_config.stlb from the sightlab_configs folder)

For answers to all technical Vizard questions, please go to the Vizard 7 Documentation FAQ of the additional Vizard FAQ page here.