================================================================================================
================================================================================================
vsenseVVAR - User Behaviour Database for Volumetric Video in Augmented Reality
===========================================================================

This database includes the collected user behaviour data in the form of 
  user (or device) location, device rotation, and volumetric video 
  rotation. These data were collected using a marker-based custom-built 
  augmented reality (AR) application. To build this application, Unity 3D
  game engine, Vuforia AR SDK, and a bespoke volumetric video player were
  used. Since we do not have the rights to redistribute the "SirFrederick" 
  and "Nico" contents used in this study, interested researchers are 
  encouraged to contact Volograms (https://www.volograms.com/) to obtain 
  these volumetric video sequences. This database was created and used in
  a QoMEX 2021 short paper [2], which was based on Ms. Radhika Kulkarni's 
  M.Sc. thesis [1]. The codes provided with this database are the analysis 
  codes of the QoMEX 2021 study, and the technical details are presented 
  in [2]. If you use this database in your research, please kindly cite [2] 
  in your publications:

[1] R. Kulkarni. "User Behaviour Analysis and Modelling using AR 
    Application for Volumetric Videos." M.Sc. Dissertation, Trinity
    College, The University of Dublin. 2020.

[2] E. Zerman, R. Kulkarni, A. Smolic. "User Behaviour Analysis of 
    Volumetric Video inAugmented Reality." Thirteenth International 
    Conference on Quality of Multimedia Experience (QoMEX), Montréal, 
    Canada, June 2021.

=====================================
V-SENSE, SCSS, Trinity College Dublin
Emin Zerman
emin.zerman@tcd.ie
=====================================

CONTENTS
========

+ 'results'
      This folder contains the log files for different participants and for
      two different volumetric video contents. The naming convention is as
      follows:
       + Participant_##_Fredrick.txt
       + Participant_##_Nico.txt
      where ## denotes the participant number. The log files have the 
      following format:

      > YYYY/MM/DD_HH:mm:ss.ms       // Timestamp
      > devPosX devPosY devPosZ      // Device position (unused)
      > devRotX devRotY devRotZ      // Device rotation
      > marPosX marPosY marPosZ      // Marker-based device position
      > objRotX objRotY objRotZ      // Object (volumetric video) rotation

      The position values were always in XYZ format and the rotation values 
      were always in Euler angle format. Please consider that Unity applies
      rotations on ZXY order. That is, the rotation is done first on z axis, 
      then x axis, and lastly on y axis, on this order. A sample log block
      is shown below:

      > 2020/08/10_12:44:19.19       // Timestamp
      > 0 1.24 -3.55                 // Device position (unused)
      > 329.2093 18.65701 331.2298   // Device rotation
      > 1.427278 3.569891 -0.1944616 // Marker-based device position
      > 287.1646 76.0759 283.4213    // Object (volumetric video) rotation


- 'script_analyseVVARresults_forQoMEX.m'
      This script is the main script that is used for the analysis of the 
      data. It can be run directly on MATLAB.

- 'processVVARlog_QoMEX.m'
      This function is used to process the collected data log files after
      the initial parse operation.

- 'parseLog.m' 
      This function is used to parse the log files.

- 'rotateAroundAxis.m'
      This function is used to rotate the data points around the XYZ axes
      according to the Unity's rotation rules. That is, the rotation is 
      done first on z axis, then x axis, and lastly on y axis, on this 
      order.

- 'participantAgeSexDistribution.csv'
      This file includes the age and sex information for the participants.
      Although our analyses did not result in significant results between
      different sex or age groups, for completeness, we provide this data
      along with the log files.

================================================================================================
================================================================================================