ExVR - Open Virtual Psychology

Summary

• Description
• Origin
• Content
• How to install
• How to compile from code
• Documentation
• Tutorials
• Captures
• Authors

Description

ExVR is a solution for creating and executing 3D/2D experiments using VR or not. Its philosophy is roughly similar to Psychopy and can easily be extended by users using scripting (C#, Python) or visual scripting (with nodes).

It is subdivided in two software:

• the designer GUI for creating the experiment content and its randomization
• the experiment launcher for that will generate and execute experiments at runtime using Unity3D

They both communicate between themselves and makes easy to operate changes and see immediately the results. Once the design done, the user can then share the full experiment by exporting it, allowing accurate replications on others computers.

Origin

The project has been developped at EPFL LNCO laboratory (Laboratory of Cognitive Neuroscience) and has been funded by the EPFL Open Science Fund from the 2019 cohort. It has been used for dozains of experiments and demos inside LNCO or during external collaborations since its creation in 2018.

Content

ExVR is subdivided in two software:

• ExVR-designer: a GUI for creating the experiments and controlling their execution
  • creation
    • experimental flow (routines, loops, interstimulus state)
    • components, configurations and their parameters
    • randomization of the differents loops
    • management of resources (scripts, images, sounds, 3D objects..)
    • actions (association of conditions and components using update/visibility timelines)
    • scripting using (C#,Python)
    • visual scripting using nodes
    • global settings (display options and others)
    • generation of the differents randomization (using instances files)
    • saving/eport/loading functions
  • execution
    • load current exp (or a subpart) to the launcher
    • load default or specific randomization (using instance files)
    • play/pause/stop/next/previous/goto
    • feedback (exp state, time, routine name, nodes states) from the exp-launcher
    • logs (messages, errors) from the software and the scripts
    • realtime update of components parameters
• ExVR-exp: an exp launcher for executing experiments
  • runtime generation for experiments from two xml files generated by the designer:
    • experiment file -> for the content
    • instance file -> for the randomization

How to install

Go to release

(TODO)

How to compile from code

• Visual Studio 2019 Version 16.10 is requested for compiling, you can get it here.

• The project is using QtCreator qmake files and the Qt library (Qt 5.15), you can get the opensource version here.

• Clone the project.

(TODO)

Documentation

• General
• UI
  • Flow creation
  • Element selection
  • Components list
  • Routines conditions
  • Resources manager
  • Randomization
  • Toolbar
  • Logs
  • Settings
• Content
  • Components description
  • Connectors description
  • Scripting
  • Visual scripting
  • Exp-launcher
  • Samples

(TODO)

Tutorials

(TODO)

Captures

(TODO)

Authors

(TODO)