Skip to content

Home

Jump to bottom
Pedro Lucas edited this page Jan 17, 2022 · 26 revisions

This wiki is for documenting the MoMoCapture app that is being developed in the fourMs Lab at University of Oslo. It was originally developed for MusicLab events, but is also used for other data collection procedures.

Recorded Data

The recorded data are packaged into a zip-file with two CSV files:

  • Device motion: ISOdate_deviceID_dm.csv
  • GeoLocalization: ISOdate_deviceID_gl.csv

Where ISOdate is a date in ISO format but using a dash (-) instead of a colon (:) due to file naming restrictions. This format is the date and time in UTC YYYY-MM-DDThh-mm-ss.SSSZ. The deviceID is the identifier for the device, which means that all the files with this same ID belongs to the same device. (e.g. 2022-01-16T11-56-49.415Z_c67e7e60-e905-377a-1134-d65f2dba5ee9_dm.csv)

The data fileds are described more below.

Inertial Data

The CSV file containing motion data consists of columns with the following variables:

  • timestamp: The date and time in ISO format YYYY-MM-DDThh:mm:ss.SSSZ.
  • time: a time marker from the device (in milliseconds), which resets to zero when the hardware initializes and is incremented over time (it might be more precise than the timestamp).
  • x: accelerometer data in the X direction
  • y: accelerometer data in the Y direction
  • z: accelerometer data in the Z direction
  • alpha: rotation in the Z direction
  • beta: rotation in the X direction
  • gamma: rotation in the Y direction

The specification of the inertial sensor readings is documented in the W3C DeviceOrientation Event Specification, and can be seen in the image below.

Orientation

The iOS 13 version does not have the rotation information (alpha, beta, gamma). So for this OS, the orientation information (also alpha, beta, gamma) is sent in an additional file following the official documentation.

Units: The Android IMU sensors report acceleration in m/s2 (Android documentation). The Apple IMU sensors report acceleration in "increments of the gravitational acceleration, with the value 1.0 representing an acceleration of 9.8 meters per second (per second) in the given direction" (Apple documentation).

The Geolocation Data

The CSV file containing GPS data consists of the following columns:

  • time: the epoch timestamp. It can be converted online or in your programming language of choice.
  • lat: the GPS latitude, ranging from 0 to 90 (in decimal degrees). It can be converted online.
  • long: the GPS longitude, ranging from 0 to 180 (in decimal degrees).
  • accuracy: the accuracy of the GPS measurement (in meters) (more information on this value here).

Questionnaires

If the form contains a question with the text 'userID' the app will put the userID in this field and disable the field for editing. It is recommended to use this feature as this is the only way to match pre/post questionnaire and the data.

Currently the matrix question and linear scale features of Nettskjema are not implemented in the questionnaire functionality. Conditional formatting (display only if another question was answered a certain way) is also not functioning in the current implementation.

A project from the fourMs Lab, RITMO Centre for Interdisciplinary Studies in Rhythm, Time and Motion, Department of Musicology, University of Oslo.

Clone this wiki locally