Creating scene 2
SightLab experiments can be set up with a GUI, with code, or a combination of both. This QuickStart is first showing starting a quick session with the GUI. For running a session with code see the non-GUI example
| Quick Start - System Check | |
|---|---|
![]() |
Launch GUI: Open SightLab_VR.py in the Sightlab2 project folder |
![]() |
Choose Hardware If have any existing projects loaded, click "New" Name Project and click "Save Project" |
![]() |
Choose Hardware If have any existing projects loaded, click "New" Name Project and click "Save Project" |
![]() |
Choose Hardware Press "Continue" to start session Click "BIOPAC Markers" checkbox if running with BIOPAC Acqknowledge Press "Spacebar" to start and end the trial. See all controls here To check eye tracking press 'p' key to see gaze point in headset |
![]() |
Replay & Review Data: Use SightLabReplay.py for an interactive session replay use Spacebar to start/stop playback); view data files in the data folder. |
Quick Start - GUI Scene Setup |
|
![]() |
Launch GUI: Click the SightLab_VR.py shortcut in the Sightlab2 project folder or copy BlankProject (in Projects folder) to create a new project and launch SightLab_VR.py from the new folder |
![]() |
|
![]() |
Add Assets (optional): Place 3D models in resources/environments or 360° media in resources/media within your project folder, or use assets from the SampleProject. Access project resources by selecting the project folder in the editor or opening the folder directly. See this page for some places to gather assets. |
![]() |
Open Editor: Click Modify in the GUI to load environments, models, or 360 media. |
![]() |
Can choose from the dropdown list or also drag and drop. Click "360 Media" to use 360 media. |
![]() |
Add ROI or objects of interest: - For 360 Media, press Shift (in Desktop Mode) to enter ROI mode, then set ROIs by moving the virtual gaze point and pressing 1. - For 3D models, add ROIs and objects in the scene editor "Inspector" by clicking on the Edit button. |
![]() |
Scene Editor: - You can also use Inspector to edit the model, add a starting point, check scale, set lighting and more (if needed). See this page for more details. |
![]() |
Tag Objects: - Objects can be tagged for extra data collection, visibility as well as interactions, such as grabbing. |
![]() |
Make sure to click the "refresh" button if changes were made to a 3D model or added a new one. |
![]() |
Generate Trials: Enter a count and click Generate to add more trials if desired. Use Start/End Conditions (Keypress, Timer, Event, Gaze). |
![]() |
Adjust Options: Set additional options such as eye tracking thresholds, randomization, per trial or combined data files, screen recordings and synchronizing with BIOPAC Acqknowledge. |
![]() |
Start Session: Press "Continue" to begin the session |
![]() |
Start/End Trials: Enter Participant info (unless set to bypass). Default controls use Spacebar to start/stop. See all controls here. Press the "p" key to toggle viewing the gaze point (off by default) |
![]() |
Replay & Review Data: Use SightLabReplay.py for an interactive session replay (use Spacebar to start/stop playback); view data files in the data folder. |
![]() |
For more, refer to the SightLab documentation and examples in the ExampleScripts folder to see how to add much more functionality and use templates, such as adding instructions, rating scales, using AI agents and much more. |
Multi-User Setup: Check the multi-user guide for collaborative experiments
Non-GUI Workflow: For non-GUI see example with code (can also add code to any script created with the GUI)
For more, refer to the SightLab documentation, creating a new scene and examples in the ExampleScripts folder.
Need models or media? Check out the Getting 3D Models and Assets page















