Skip to content

Driving Example

Overview

The SightLab Driving Simulation provides a flexible platform for creating and customizing driving experiences. Located in the ExampleScripts-Driving folder, it supports various hardware configurations including desktop, VR headsets, and custom input devices. See the Download Button below for an expanded version with more city maps and features.


Download Latest Version

(note this download is the expanded version with additional maps, and elevation detection on)

Features

Core Features

  • Modifiable car models and environments
  • Realistic vehicle controls (gas, brake, steering)
  • Real-time collision detection
  • Interactive headlights system
  • Dynamic engine audio with speed-based pitch adjustment
  • Elevation and ramp support
  • Variable Speed Control
  • HUD display of speed, fixations, timestamp
  • Dynamic animations of RPM, MPH gauges, steering wheel, tires, and more
  • Multi-user capabilities

Analysis Features

  • Driver attention and fixation tracking
  • Car velocity, position and rotation saved to data files (can add custom data as well)
  • Interactive session replay
  • Gaze pattern visualization
  • Performance metrics logging
  • Physiological tracking integration
  • Heat map analysis
  • Instructor view with real time control and monitoring

Environmental Features

  • Day/Night/Fog cycles
  • Variable lighting conditions
  • Traffic simulation
  • 360° media integration
  • Customizable obstacles and pedestrians

Included Scripts

Driving_GUI_Main.py This is the main script to run. uses the GUI to select environments. If you downloaded the expanded version this includes 3 city maps, freeway ramps and night and day scenes. The standard version in SightLab Example Scripts just has one city with day and night cycles.

Driving_Main_noGUI.py uses only code, but has similar functionality to Driving_GUI

Driving_GUI_Traffic.py shows adding some cross traffic flow. Can modify the code to adjust speed and number of additional cars. Uses collision detection to check whether your vehicle collides with any others.

Driving_Simulator_360 (additional download) - shows using a 360 video to simulate driving in New York

Driving_Config.py Used to configure additional options (see below)

In the expanded driving download there is also a folder called Longer_Road that has an endlessly stretching highway

For 360 Video Drive through example with Mixed Media contact support@worldviz.com (see below for info)

Controls

Keyboard controls available to all. Additionally, see the SightLab Controls page for more.

  • View adjustment: T, F, G, H keys
  • Start/Next trial: Spacebar
  • Save/Store Position: v key
  • Select Viewpoint: b key

XBOX/Game Controller

  • Steering: Left Stick- Turn left or right
  • Gas: Right Trigger
  • Brake: Left Trigger
  • Reverse: Hold X while pressing the gas or the brake
  • Look Around: Right stick or use the mouse
  • Select Button: Change Viewpoints

Desktop Controls

  • Movement: WASD keys
  • Gas: = key
  • Brake: - key

VR Controls

General VR

  • Steering: Left Stick- Turn left or right
  • Gas: Right Trigger (for some headsets, also need to hold the RH B button)
  • Brake: Left Trigger
  • Reverse: Hold Y while pressing the gas or the brake
  • View adjustment: WASD, X, and Z keys

SteamVR/Vive Specific

  • Steering: RH trackpad (left/right)
  • Gas: RH system button
  • Brake: RH grip button

Steering Wheel Controllers

Wheel motion - Turns car left and right

Gas and Brake - Mapped to gas and brake pedals

Logitech G923 Wheel (tested and verified, but can easily add additional ones)

Thrustmaster

To add a new wheel, run the wheel_inspector.py script in the modules folder, then press on the gas to see which ID is for throttle and the same for brake. You can then also press each button to find the ID (or run the Set Up Game Controllers program in Windows). Modify one of the included wheel input files (such as the g923_input.py) and change the necessary IDs for the throttle, axis and clutch. Button mappings for things such as viewpoints can be set up by making a copy of one of the wheel vizconnect files and modifying those under "mappings". Contact support@worldviz.com for more information. 

        self.wheel_axis = 0      # Steering wheel: -1 to +1
        self.throttle_axis = 1   # Throttle pedal: 1.0 when not pressed, -1.0 when fully pressed
        self.brake_axis = 2      # Brake pedal: 1.0 when not pressed, -1.0 when fully pressed  
        self.clutch_axis = 3     # Clutch pedal: 1.0 when not pressed, varies when pressed

Running the GUI Example

Run Driving_GUI_Main.py. Pressing spacebar will start the experiment or proceed to the next trial. Data will be saved in the data folder. Note that the first hardware selection is now Desktop with Game controller. If no controller connected and using keyboard and mouse, select the second item in the dropdown.

Notes

If the car shoots up into the air on starting you may need to physically move back a little bit to avoid triggering the collision detection while it's starting.

Session Replay

After running a session, use SightLabVR_Replay.py to view a playback of your session, including the car's movement.

Customization

Changing the Environment

  1. Place a new environment file in the Resources/environments folder.

  2. (for the GUI) Select the new environment using the GUI:

    • Click "Modify" on the GUI screen
    • Choose the new environment

  3. With code

ENVIRONMENT_MODEL = 'path/to/environment.osgb' 
vizfx.addChild(ENVIRONMENT_MODEL)

Changing the Vehicle

Change the path to your new vehicle in Driving_Config.py as well as references to items that can be animated or used (headlights, wheels, steering wheel, mph and rpm gauge)

CAR_MODEL = 'Resources/jeepmodel.osgb'

Basic Setup Using Code

  1. Import car class from module (make sure car_module.py exists next to your main script):
from car_module import Car
  1. Set up the car instance in Driving_Config.py (note that STEERING_WHEEL_NAME and individual wheels are optional if you want a steering wheel that turns and tires that spin). 
    my_car = Car(model_path=CAR_MODEL, use_headlights=True, steering_wheel_name=STEERING_WHEEL_NAME, engine_audio=ENGINE_AUDIO,
             front_left_wheel=FRONT_LEFT_WHEEL, front_right_wheel=FRONT_RIGHT_WHEEL, 
             back_left_wheel=BACK_LEFT_WHEEL, back_right_wheel=BACK_RIGHT_WHEEL, 
             mph_gauge=MPH_GAUGE, rpm_gauge=RPM_GAUGE, sightlab_instance=sightlab)

    Code to access underlying car object
    car = my_car.car
  2. Add car as a sceneObject so that it will be tracked in the session replay
    sightlab.addSceneObject("car", car)
  3. Start the engine sound and perform other setup actions (such as toggling on headlights if needed) after the SightLab main loop starts

def sightLabExperiment():
    while True:
        for i in range(sightlab.getTrialCount()):
            if sightlab.getTrialNumber() == 1:
                print('trial 1 day')
            elif sightlab.getTrialNumber() == 2:
                print('trial 2 night')
                my_car.toggle_headlights(True)
            yield viztask.waitKeyDown(' ')
            yield sightlab.startTrial()
            my_car.start_engine_sound(volume=1)

5. Setup the link of the driving transport to the car
rawTransport = vizconnect.getRawTransport('driving')
transport = vizconnect.getTransport('driving')
transportNode = transport.getNode3d()
my_car.link_to_transport(transportNode)
#Optionally change position of transport
transportNode.setPosition([0.25, 0.65, 0.35])

Changing View Position in Car

  1. Run the script using the Vizard editor and use either the TFGH, ZX keys to position your viewpoint if Desktop or WASD, ZX for HMD
  2. Press the 'v' key when your position looks correct
  3. This will print out your current position in the Vizard interactive window
  4. Copy and paste this position into the Driving_Config.py PASSENGER_POSITION or in the code under the hardware options
if sightlab.getConfig() in ['Driving Desktop']:
    transportNode2.setPosition([0.25, 0.65, 0.35])

elif sightlab.getConfig() in ['Driving SteamVR']:
    transportNode2.setPosition([0.188, 1.315, 0.8676])

Driving Configuration

The Driving Config provides extensive customization options:

CAR_MODEL = 'Resources/jeepmodel.osgb'
#CAR_MODEL = 'sightlab_resources/objects/car.osgb'
#CAR_MODEL = 'Resources/bmw.osgb'
STEERING_WHEEL_NAME = 'Steering_Real Car 22_Body_0'
ENGINE_AUDIO = 'Resources/engine_sound8.wav'
PASSENGER_POSITION = [-0.08379964530467987, -0.23322515189647675, 0.14180484414100647]
PASSENGER_POSITION_TRUCK = [0.2632506489753723, 0.556177020072937, 0.3184721767902374]
THIRD_PERSON_VIEW = [0.6829884052276611, 1.5265825986862183, -3.218057870864868]
CLOSER_IN_VIEW = [0.2637367844581604, 0.556177020072937, 0.5279949903488159]
CAR_STARTING_POSITION = [0.25, 0, 0.35]
ENGINE_VOLUME = 0.2
FRONT_RIGHT_WHEEL = 'FR_Real Car 22_Body_0'
FRONT_LEFT_WHEEL = 'FL_Real Car 22_Body_0'
BACK_RIGHT_WHEEL = 'BR_Real Car 22_Body_0'
BACK_LEFT_WHEEL = 'BL_Real Car 22_Body_0'
MPH_GAUGE = 'mph_gauge'
RPM_GAUGE = 'Dok 1_Real Car 22_Body_0'

ENVIRONMENT_MODEL = "Resources/environments/street_day.osgb"  #Fallback environment model for non-GUI

USE_COLLISION = True #Set to true for elevation detection
COLLISION__UPDATE_TYPE = "update"
#set to "timer" if frame rate going too low. "update" is smoother
COLLISION_UPDATE_INTERVAL = 0.07 #If using timer set the rate to update. Lower numbers smoother but lower framerate

#CAR_TYPE = 'Truck'
CAR_TYPE = 'Car'

COAST_RATE = 0.35 #Higher Number, faster stop

MAX_SPEED = 27.5 #Note this is multiplied by 2, so for 50mph, put 25

Customizing Controls

  1. Navigate to the vizconnect file in util_files/sightlab_utils/vizconnect_configs.
  2. Go to Advanced > Transports > Driving > Mappings and Acceleration/Deceleration under "Events".
  3. Modify the mappings as needed.

Note: You may need to set permissions on the file to edit the vizconnect.

Advanced Versions

Contact sales@worldviz.com for information on advanced versions:

  1. Version that shows driving over elevations and ramps
  2. 360 video driving simulator (combining 3D models and 360 videos)
  3. Flying simulator

Adding Ramps/Elevation Detection (SightLab 1.9.8 or higher)

  1. Add this line at the top of your script: 
from sightlab_utils import collision
  1. After the "updateCarTransform" function, add: 
c = collision.Collision()

360 Driving Simulator Instructions (Available Upon Request)

Controls

  • Reset Position: R key
  • Start/Stop Simulation: Spacebar
  • Pause Video: V key
  • Reset Video: B key
  • Fast Forward: F key
  • Get Current Position: T key
  • Toggle Overlays: H key
  • Toggle Gaze Point: P key
  • Take Screenshot: / key

Notes

Was this page helpful?