PlanArt data and location specification
Overview
EMATviewer uses the MView files created for the data gathered by the PlanArt project. Each of the PlanArt MView files contain the EMA position data and the audio data that was gathered during the presentation of a slide containing text or a picture to the subject. The directory structure for mview files should mirror that of the PlanArt/SessionData directory on DataStore. The data can be copied to a local folder to speed up access. Only the MView files are required, so a copy of the other data files is not needed. An MView only copy of the PlanArt data is available on DataStore in the folder PlanArt/MView-SessionData There are variations of the directory structure which reflect the type of data gathered. (i.e. box, finger, lip etc) Typically the Mview Files will be located in a sub-folder with a similar structure to this example:
\R00115_S1_S2_SP07\byslide\MView\Mic-LX\16KHz
The filename for the Mview files have the following format: mview + slide number + repeat number + .mat i.e. mview0110.mat
Where slide number is the number assigned to the presented slide and repeat number is the number of times the slide was re-presented to the subject for this version of the recording, i.e. in the above, the slide number is 11 and the repeat number is 0
Columns in the data spreadsheet
These are the required and optional columns used in the spreadsheet for PlanArt data. The columns can be arranged in any order within the spreadsheet. Other columns may also be present, if the extra column name is not used for outputting data then it will be ignored.
For an example of the required and optional columns see the PlanArt-example-data-spreadsheet.xlsx
Required Columns
|
Column Name
|
Description
|
Type
|
|---|---|---|
| ExperimentID | The ID of the experiment, i.e. R00115_S1_S2_SP07 | text |
| Filename | The slide number and repeat number for the filename, leading zeros can be omitted, i.e a value of 112 would identify the file mview0112.mat | number |
| Use | Use or Ignore the item when examining the data, Set the value to 1 if you want to use the item, set the value to 0 to ignore the item | number |
| Beg | The time in seconds when the item starts within the data file | number |
| End | The time in seconds when the item ends within the data file | number |
Optional Columns
| Column Name | Description |
Type
|
|---|---|---|
| Target | Text to be displayed with the signal, such as the text of the utterance. | text |
| Task | The name of the task being performed for this item. This is used for filtering the items by specific tasks. | text |
MView file format
The PlanArt MView files use Matlab version 7.3 format which is based on HDF5 with a Matlab structure
The MView files contain a mixture of the following data items:
|
Item
|
Description
|
|---|---|
| Audio | The audio waveform |
| LX | The laryngograph waveform |
| Text | The text presented in the slide |
| finger | finger tip EMA position data |
| pick | finger pick EMA position data |
| TB | Tongue Back EMA position data |
| TM | Tongue Mid EMA position data |
| TT | Tongue Tip EMA position data |
| UJ | Upper Jaw EMA position data |
| UL | Upper Lip EMA position data |
| LL | Lower Lip EMA position data |
| LJ | Lower Jaw EMA position data |
