Audio Annotator


1. Run the application by double clicking the AudioAnnotation.exe.

2. Once the application is running. Provide a valid directory path where your audio files (.wav and .msv) are located. The program expects to see both types of files in the same location. Besides, it also expects that the number of files .wav and .msv match. If the files number doesn’t match, the program will continue running but it will send a warning message.

3. If the files are loaded successfully, you will see the following screen:


audioAnnotator_screen_1.jpg
audioAnnotator_screen_1.jpg



4. The program creates an annotation field for each file found in the audio. Then, as a sanity check, see that the number of rows and the number of files matches.

5. The program highlights in “green” the row that is currently selected.

6. When a row is selected, a “play audio button” contained in the first column will be highlighted. You can click the “play audio button” to listen to the corresponding audio files. To avoid confusion, only one file can be played at the time. Thus, the program disables the other table fields when a file is being played.

7. Another way to play the audio file is pressing the “F1” key.

8. The other table columns contain the annotation information. The columns with cells in “white” means that the column fields are editable. The column with cells in “gray” means that the fields are not editable. The file ID number and the file creation time are not editable.

9. The annotation information corresponding to each column can be described as follows:
Column
Name
Functionality
1
Play button
Plays the audio file associated with the current row.
2
Audio ID
Indicates the ID of the audio file.
When a row is being added, the row will not have a file association. In such case, the row ID will be empty (“-----”).
This field is not editable.

3
Category Field
It is a dropdown menu containing the entries set up for Posture/Activity categories. This information is loaded from the ActivityLabelsRealtime.xml file. Hence, you can modify the labels appearing in the dropdown menu by customizing the category entries in the file.
4
Start/End Field
It sets the Start/End labels. In general, the program will try to complete these entries automatically according with the category labels you have selected.
However, if you find a mistake, you can always overwrite the value suggested.

5
Creation Time
“Hour : Minute : Second”

This field indicates the time when the audio file was created. Make sure these values matches the times you expect. Specially, pay attention to the seconds entry.

This field is not editable.

6
Label Time
“Hour : Minute : Second”

This field indicates the time that will be used in the output Wockets annotation file. In general, this time will be similar to the creation time. However, if you need to adjust this field you can edit the entry.

7
Notes
You can write any notes you need. This field is completely editable. Just try to avoid using “TAB” or “;” (semi-colon) keys.

10. Editable Fields are accessed by just clicking with the mouse on them or pressing “F2”.

11. Rows can be added by pressing the “Add Rows” button. The new row will be inserted after the row you were located. The new row will not have an associated audio file (you will see “------” in the Audio ID field). The “Label Time” field ID will correspond to the next available creation time file.

12. Rows can be removed by pressing the “Remove Rows” button. The program will remove the active row (row with “green” background).

13. Row can be skipped by just leaving the row without editing or filling it with blank.

14. Row contents can be cleaned up by setting the category label to “blank”. (Select “blank” in the “category label” field using the combo box.

15. The annotation values can be saved by pressing the “Save Category” button.

16. The program will continue to the second pass of the annotation by pressing the “Next Category” button.

17. Once the program is in the second pass, you will see the field values associated with the second annotation category.

18. The “Previous Category” will allow you to see the annotations from the first pass. You can come back from one pass to another anytime you want. The program automatically will save the category annotation values.

19. The “Generate Xml” button will generate an Xml according with the information you have entered.

20. This version has two columns each one representing a category. It allows annotating in a double or single pass mode. The default state is double pass (only one column enabled). You can change the state to single pass by checking “the single pass mode box”.

21. There is also an exit without saving option which allows to prevent your annotation file be corrupted in case you entered the wrong protocol.