watchme_prepare_data: Creates a wearableCamImages object from information read in a...
In masalmon/watchme: Analysis of Autographer Images Annotations

Description Usage Arguments Details Value Examples

Creates a wearableCamImages object from information read in a csv file.

1
2
3

watchme_prepare_data(path_results, sep_results, quote_sign = "'",
  participant_id = "no_id", path_dico, sep_dico, tz = "Asia/Kolkata",
  robust_reading = FALSE)

`path_results`	the path to the file with coding results
`sep_results`	the separator in the file with coding results
`quote_sign`	the quote argument of read.table for the results, default is "\'"
`participant_id`	participant ID, if available.
`path_dico`	the path to the file with the list of annotations
`sep_dico`	the separator in the file with the list of annotations
`tz`	timezone
`robust_reading`	FALSE by default. When TRUE the annotation column is the whole line: the file is read once for finding photo paths and times, and once again for finding code.

Please check the format that both files should have by looking at the provided example data. However you could consider write your own function for converting the input instead of having to re-format all your existing data, which we could even add to the package.

A tibble with

participant_id Name or ID number of the participant (character)
image_time Path or name of the image in order to be able to identify duplicates (character)
image_time Time and date of each image (POSIXt)
booleanCodes columns of boolean, indicating if a given code was given to a given picture. codes is a condensed form of this.
the attribute dico tibble for defining the codes with at least Code and Meaning column, possibly Group column for having groups of codes (e.g. sport encompasses running and swimming)

path_results <- system.file('extdata', 'image_level_pinocchio.csv', package = 'watchme')
sep_results <- ','
path_dico <-  system.file('extdata', 'dicoCoding_pinocchio.csv', package = 'watchme')
sep_dico <- ';'
data_pictures <- watchme_prepare_data(path_results=path_results, sep_results=sep_results,
              path_dico=path_dico, sep_dico=sep_dico)
data_pictures
attr(data_pictures, "dico")