VivoosVR

License

BSD 3-Clause

See LICENSE

About

VivoosVR is a virtual treatment tool to assist in exposure therapy where participants are placed in a computer-generated 3D virtual world and guided through the selected environments, situations and conditions.

Physiological values of the participants are constantly monitored via GSR and pulse sensors. The system is designed to be used by qualified therapists and our target participants are young people suffering from phobias and social anxiety.

Simulation worlds have been created using Unity game engine and we support popular VR HMDs such as Oculus Rift and HTC Vive. We also have plans to optimize the system for mobile VR solutions in the near future.

VivoosVR is being developed in cooperation with a team of psychology / psychiatry experts.

Prerequisites

• SQL Server 2014 (or above) Express

  • If you have problems while installing, this link can guide you through installation

• SQL Server Management Studio 2017 (or above)

• Neulog API

• Acquire and install either or both of the following products:

  • HTC Vive
  • Oculus Rift

• Visual Studio

Git initialisation

GitHub Desktop

1. Download and install GitHub Desktop

2. Run GitHub Desktop Application and click on File -> Clone Repository:

3. Click on "URL" tab and copy the following link of the VivoosVR Repo and paste it on the URL part:

4. Set local path of the repo

5. Click on "Clone" to complete connecting to VivoosVR Repo using GitHub Desktop.

Installation

SQL Server Management Studio

1. Locate "Database" folder in your local repo path and copy "Vivoos.bak" file in this folder to "C:\Program Files\Microsoft SQL Server\MSSQL14.SQLEXPRESS\MSSQL\Backup"

2. Open the SQL Server Management Studio and login. In the Object Explorer tab, right click on "Databases" and select "Restore Database".

   

3. Select Device part, click add and find "Vivoos.bak" file

   

   

   

4. Close the SQL Server Management Studio Application.

Scenario Installation

If you wish to use the scenarios below in VivoosVR, you need to execute following steps:

1. Click on the link which belongs to the scenario you would like to add.
2. Download the zip in the link
3. Extract the zip into the VivoosVR Scenario folder (Default Path: C:\Scenarios) (If the folder does not exist, you need to create the folder manually)

Links to the latest version of the scenarios can be found below:

1. Fear of Dogs - Park Scenario - version 0.9.2
2. Fear of Height - Balcony Scenario - version 0.9.6
3. Fear of Flight - Plane Scenario - version 0.7.1
4. Social Anxiety - Presantation - version 0.9.6
5. Fear of Height - Elevator Scenario - version 0.7.5
6. Fear of Height - Elevator Scenario Transparent - version 0.7.5
7. Fear of Public Speaking - version 0.1.0
8. Fear of Spiders - version 0.9.2
9. Fear of Neeedle - version 0.2.0
10. Fear of Cats - version 0.2.2
11. Metro Scene - Standing setup - version 0.2.1
12. Metro Scene - Sitting setup - version 0.2.1
13. Attention Deficit Hyperactivity Disorder (ADHD) - Classrom - version 0.1.9
14. Germofobia - version 0.2.0

WebVR related links can be found below:

1. Fear of Height - Balcony Scenario - WebVR:
   1. Build: Fear of Height - Balcony Scenario - WebVR version 0.8.0
   2. Try: Fear of Height - Balcony Scenario

Link to the 360VR videos of some scenarios can be found below:

1. Fear of Height - Elevator Scenario - 360 video
2. Fear of Height - Balcony Scenario - 360 video
3. Germofobia - Toilet Scenario - 360 video

How to Use

VivoosVR

1. If you click the exe of the program (VivoosVR\VivoosVR\bin\debug), login form welcomes you. Default user: Username: user Password:123 Default admin: Username: admin Password:123 You can add new users in admin page.

2. For using the scenarios, you can download them in the github. Default path is C:/Scenarios. You can create a folder named Scenarios and copy the scenarios in this folder. If you want to copy another path, please login with the admin password and change the scenarios path. (Login -> Find the scenario and click edit -> Change the path)

3. If you login with the default user password, the first screen you will see is the patient page. You can see a list of your patients in this page. You can also add new patients or you can edit existing patient information.

4. You can click the “Session List” of one of your patients. In this page, you can see the sessions of the selected patient. You can also download the data (GSR and Pulse data due to the time) of the session or delete the session.

5. By clicking the “New Session” button in the “Sessions Page”, you can choose and begin any of the existing exposure scenarios.

6. In the “New Session Controls” page, you can trigger and control scenario events. Moreover, you can track the anxiety level of the patient through GSR and pulse graphs.

Neulog

Currently VivoosVR communicates with the following modules and sensors of the Neulog:

• Heart Rate & Pulse Logger Sensor

• GSR Logger Sensor

You need to perform following tasks to make Neulog modules and sensors work correctly with VivoosVR:

1. Plug USB module, Heart Rate & Pulse Logger Sensor and GSR Logger Sensor to each other and plug them to your computer via USB Port (Order of the modules are not important!)

2. Attach handle of the heart rate and pulse sensor to little finger of your right hand in a way that glassy side of the handle touches the bottom side of your finger

3. Attach the handles of the gsr module to ring finger and index finger of your right hand in a way that metal part of the handles touches the bottom side of your finger