Skip to content

Commit 8fcb28e

Browse files
authored
Update README.md
1 parent 44db5e3 commit 8fcb28e

File tree

1 file changed

+15
-19
lines changed

1 file changed

+15
-19
lines changed

README.md

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
<p align="center">
2-
<img src="media/banner-tp-small.png">
2+
<img src="media/banner-2-0-small.png">
33
</p>
44

55
# UXF - Unity Experiment Framework
6-
A set of components which simplify human behaviour experiments developed in the Unity engine. This is the development project, if you want to download the package, do not clone this repository, see "Get Started" below.
6+
A set of components which simplify human behaviour experiments developed in the Unity engine. UXF 2.0 supports Desktop, PCVR, Standalone VR, as well as Web based experiments for full remote data collection, with different data output modes. This is the development project, if you want to download the package, do not clone this repository, see "Get Started" below.
77

88
<p align="center">
99
<a href="https://doi.org/10.3758/s13428-019-01242-0">
1010
<img src="media/uxf-paper.PNG">
1111
</a>
1212

13-
Read the [open access paper](https://doi.org/10.3758/s13428-019-01242-0) in Behavior Research Methods! Developed by Jack Brookes, Immersive Cognition Group, University of Leeds.
13+
Read the [open access paper](https://doi.org/10.3758/s13428-019-01242-0) in Behavior Research Methods! The paper is now slightly out of date but gives a good overview of the motivation of this project. Developed by Jack Brookes, Immersive Cognition Group, University of Leeds.
1414
</p>
1515

1616
If you have developed a project using UXF please [let me know](http://twitter.com/jackbrookes)!
@@ -49,15 +49,15 @@ If you have developed a project using UXF please [let me know](http://twitter.co
4949

5050
1. Import the latest ```UXF.unitypackage``` [release](https://github.com/immersivecognition/unity-experiment-framework/releases/latest) to your existing Unity project. (Drag the file into your project.)
5151

52-
2. The UXF Setup Wizard will launch (or via the top menu: UXF > UXF Wizard) - Use it to fix any .NET compatibility issues.
52+
2. The UXF Setup Wizard will launch (or via the top menu: UXF > UXF Wizard) - Use it to fix any compatibility issues.
5353

54-
3. Open an example scene. (UXF -> Examples -> Advanced -> AdvancedExample)
54+
3. Open an example scene. (e.g. UXF -> Examples -> 2_MoveToTarget -> MoveToTargetExample)
5555

56-
4. Press play, and use the UI to create a new participant list in an appropriate directory.
56+
4. Press play, and use the UI to enter any details.
5757

5858
5. Press start to begin the session.
5959

60-
Visit the [Uncyclo](https://github.com/immersivecognition/unity-experiment-framework/wiki) for more detail.
60+
Visit the [Uncyclo](https://github.com/immersivecognition/unity-experiment-framework/wiki) for more details.
6161

6262
## Features
6363

@@ -68,11 +68,11 @@ Visit the [Uncyclo](https://github.com/immersivecognition/unity-experiment-framewor
6868

6969
### Data collection
7070

71-
UXF automates the process of collecting data.
71+
UXF automates the process of collecting data. How the data are stored depends on the platform (PC, Web, etc) as well as your configuration of different "Data Handlers". For PC platforms, you probably just want to store data in files on the PC locally. In that case, the File Saver data handler will output data in several forms:
7272

73-
**Behavioural data** is collected with 1 row per `Trial`, and automatically records some values such as the timestamp of the start and end of the trial. Developers can easily record observations of any type and associate them with a trial. Data is output with one row per trial in a results csv file.
73+
**Behavioural data** are collected with 1 row per `Trial`, and automatically records some values such as the timestamp of the start and end of the trial. Developers can easily record observations of any type and associate them with a trial. Data is output with one row per trial in a results csv file.
7474

75-
**Continuous data** is data that is measured continuously over time during a trial. The main use case of this is to track the position and rotation of any object in the scene, which is captured at whatever frame rate the application is running at (in the `Update()` loop) by adding a `PositionRotationTracker` component to a GameObject. This can be used to track positions of user controlled objects (such as hands or head in a virtual reality application) or an arbitrary object in the scene (e.g. some kind of stimuli). However this system is generic and developers can create their own `Tracker` classes that perform measurements of any variable during trials.
75+
**Continuous data** are data that are measured continuously over time during a trial. The main use case of this is to track the position and rotation of any object in the scene, which is captured at whatever frame rate the application is running at (in the `Update()` loop) by adding a `PositionRotationTracker` component to a GameObject. This can be used to track positions of user controlled objects (such as hands or head in a virtual reality application) or an arbitrary object in the scene (e.g. some kind of stimuli). However this system is generic and developers can create their own `Tracker` classes that perform measurements of any variable during trials.
7676

7777
Data is stored in CSV files with automatic handling of file & directory naming.
7878

@@ -95,13 +95,13 @@ trial_results.csv | Main results file (behavioural data)
9595

9696
**Example Output** You can see an example of the data structure UXF outputs in the [example_output](example_output) folder of this repository.
9797

98-
### Events
98+
### Web & Database
9999

100-
A `UnityEvent` is invoked on `Trial` begin and end, allowing you to easily trigger presentation of stimuli at trial start (for example).
100+
For Web platforms, the data cannot be stored on the participant's PC. Instead, data can be uploaded to a database. UXF handles all of the hard work for you and automatically uploads the data files as long as you set up a DynamoDB database using Amazon Web Services.
101101

102-
### CSV Participant List
102+
### Events
103103

104-
A participant list feature is used allowing experimenters to optionally pre-prepare participant information. Additionally, this participant list is shared between experiments, allowing easy cross comparison of observations within participants.
104+
A `UnityEvent` is invoked on `Trial` begin and end, allowing you to easily trigger presentation of stimuli at trial start (for example).
105105

106106
### Settings system
107107

@@ -112,13 +112,9 @@ The settings is cascading, allowing setting independent variables at a `Session`
112112
A UI is available (but optional) allowing loading of participant data from file (or add new participant data). Variables that are collected are customisable and can be used in the experiment (e.g. a parameter for a participant's age could be used to change the difficulty of the experiment).
113113

114114
<p align="center">
115-
<img src="media/screenshot-1.png" width=300>
115+
<img src="media/uxf-ui.png" width=300>
116116
</p>
117117

118-
### File IO
119-
120-
Files are read and written in a separate thread to avoid frame drops, which can induce motion sickness in VR HMDs.
121-
122118
## Example
123119

124120
UXF is built around the idea of separating the specification of your experiment (the "what") and the implementation of your experiment (the "how").

0 commit comments

Comments
 (0)