Sightlab Code Attributes and Methods

SightLab Code Attributes and Methods

In SightLab, various attributes and methods can be accessed and modified for experiment customization. Most of these are also adjustable via the GUI. See also "Importing Sightlab into Your Existing Code

Also can see a generic example here without the GUI

Here's a brief overview of some key attributes and methods:

General Configuration

env = vizfx.addChild("utils/resources/environment/dojo.osgb")


Changing Resources and Media Directory

#Note put the path to the folder where the resource is located, not to the actual file (i.e. if the file is in your root folder just put ('rootFolderPath/'), use ../ if in a seprate folder inside SightLab (i.e. sightlab.set_env_path("../Demos/MyDemo/"), although it is recommended to create a separate folder as all the files in the root folder will be shown

Experiment Settings

Avatar and Gaze Point Configuration

Object Tracking and Interaction

basketball = env.getChild('basketball')sightlab.gazeObjectsDict["basketball"] = basketball For adding multiple objects can use this code:sightlab.gazeObjectsDict = {'basketball':basketball,'soccerball':soccerball}sightlab.grabObjectsDict = {'basketball':basketball,'soccerball':soccerball}
basketball = env.getChild('basketball')soccerball = env.getChild('soccerball')objectNames = ["basketball", "soccerball"]grabbableObjects = [basketball,soccerball]
for index in range(0, len(grabbableObjects)): sightlab.gazeObjectsDict[objectNames[index]] = grabbableObjects[index] sightlab.grabObjectsDict[objectNames[index]] = grabbableObjects[index]
Option 2:
OBJECT_NODE_NAMES = ['Soccerball', 'Baseball', 'Globe']
# Initialize an empty list to store the objectsgazeObjects = []
# Iterate over names to create objects and add them to the gaze objects dictionaryfor name in OBJECT_NODE_NAMES:    gazeObject = env.getChild(name)    sightlab.gazeObjectsDict[name] = gazeObject    gazeObjects.append(gazeObject)
  • gazeMat.getLineForward(10000)

Getting Position of Child Objects

If you are using env.getChild to access your objects you need to use a .getTransform to access the object's position:

targetTransform = env.getTransform('targetTransform')

It also works to call the getChild command on the GEODE associated with the object

Event Flags

def buttonTrigger():

    set_flag('T key pressed')

    print("T key pressed")


Gaze Time Events

onGazeBegin(e), onGazeEnd(e), onGazeTime(e): These functions handle events when gaze starts, ends, or reaches a certain duration (threshold). 

viz.callback(eye_tracker_utils.GAZE_BEGIN_EVENT2,onGazeBegin), viz.callback(eye_tracker_utils.GAZE_END_EVENT2,onGazeEnd), viz.callback(eye_tracker_utils.GAZE_TIME_EVENT2,onGazeTime): These lines set up callbacks that trigger the onGazeBegin, onGazeEnd, and onGazeTime functions when the corresponding gaze events occur.  

Experiment Control Events

viz.sendEvent(TRIAL_START_EVENT) Use this to trigger starting the trial (best to place this within a viztask function (see the included template)

viz.sendEvent(TRIAL_END_EVENT) Use this to trigger ending the trial (best to place this within a viztask function (see the included template)

In order to change the key or event that starts the session you can either change that in the file (CONTINUE_EVENT_KEY), or see this example for using either the right hand trigger or the spacebar:

def sightLabExperiment():

waitTrigger = viztask.waitEvent('triggerPress')

waitSpacebar = viztask.waitKeyDown(' ')

yield viztask.waitAny([waitTrigger, waitSpacebar])


Gaze Data Functions

Experiment Management Variables

Changing Starting Position and Getting Current Positoin

transportNode = vizconnect.getTransport('main_transport').getNode3d()



  #Get current position to place for setting      

        def getPosition():




Accessing Raw Data

Using the Sample Template Script

The script is one you can build off of to create new, custom experiments. Note: It is recommended to make a copy of the main script (i.e. and work off of that (so you always have an unmodified version). You can add custom code in the sightLabExperiment function to add additional functionality to your experiment. This can be such things as adding additional phases to the experiment, proximity sensors, animations, toggling visibility, adding audio, avatars and avatar interactions, enabling physics and much more. To see a full list of options see the Vizard documentation

import viz

import vizfx

from utils import sightlab

#Code to disable the GUI from showing (set to 1 if you want the GUI)

sightlab.is_GUI = 1

#run sightlab experiment. Add code here to run alongside main sightlab experiment

import viztask

def sightLabExperiment():

yield viztask.waitKeyDown(' ')

print('experiment start')

yield viztask.waitKeyDown(' ')

print('experiment end')



360 Video

sightlab_360.sphere.setEuler(180,0,0) To access the 360 video sphere object use sightlab_360.sphere. This code is showing how you can change the orientation of the video. Place this after the experiment has been started 

def sightLabExperiment():

yield viztask.waitKeyDown(' ')

print('experiment start')


The following code shows how to add multiple videos, just create a new mediaObject and then set that as the texture to the sphere object

yield viztask.waitKeyDown('v')

#Here can define if changing to an image or monoscopic/stereoscopic

mediaType = "video"

sightlab_360.sphere = panorama_utils.MonoSphere(mediaType)

mediaObject2 = viz.addVideo("utils/resources/media/football_pass.avi")


Session Replay

session_replay_object = session_replay.AvatarReplay(session_replay.replayfileName[session_replay.trialNumber-1],session_replay.trackingfileName[session_replay.trialNumber-1])

env = session_replay_object.objects[0]

envTest = session_replay_server.AvatarReplay(session_replay_server.replayfileName[str(session_replay_server.trialNumber)][i],

session_replay_server.trackingfileName[str(session_replay_server.trialNumber)][i], i, session_replay_server.sceneManager)

env = envTest.objects[0]

Remember to check out each object's available methods by typing sightlab. and browsing the autocomplete list that appears.