NEWS
silverback 0.1.0
- silverback can be installed from R-universe (https://mcanzi.r-universe.dev).
read_gorilla() reads exports from Task Builder 1 and 2 and Questionnaire
Builder 1 and 2, in long and short format, downloaded as one file per node
or as combined files, from folders, single files or ZIP archives.
Codes such as 007 and keys such as T stay text.
gorilla_trials() returns one row per response with the same columns for
both task builders, including the repeat key, the task version and the
timing columns of the export.
gorilla_wide() returns questionnaire answers with one row per participant.
gorilla_participants() collects status, device, timing, randomiser,
branch and checkpoint outcomes and store values per participant.
summary() describes each task and questionnaire, and gorilla_checks()
lists incomplete participants, repeated participation, missing tasks, fast
or identical responses, unusual devices and unbalanced randomisers.
blind_ids() replaces public participant identifiers.
write_gorilla() writes the tidy tables to CSV files.
read_gorilla() no longer warns about parsing issues when the END OF FILE
row has no trailing commas, as in recent exports. Other rows with the wrong
number of columns give one warning that names the file.
read_gorilla() reads files saved with tabs as separators, also when a
question text in the header contains commas or line breaks, and no longer
treats the UTC Date and Local Date columns of older exports as
spreadsheet columns.
- Objects of Questionnaire Builder 2 that share a name within a
questionnaire, such as several objects left as
Rating Scale, are now
kept apart by their object ID instead of being treated as repeated answers.
read_eyetracking() and read_mousetracking() read the recordings of the
Eye Tracking (Webgazer) and Mouse Tracking components of Task Builder 2:
gaze and mouse samples assigned to screen zones, the zones themselves, and
the accuracy and outcome of each calibration attempt.
gorilla_trials() gives a message when a component, such as a Click
Response without response values, recorded empty responses, and
gorilla_checks() then uses the clicked object for the same_response
check. The response column itself is not changed.
read_gorilla() reads Excel downloads (.xlsx) and gives the same tables
as for CSV downloads. It warns when the same file is read in both formats.
read_gorilla() reads CSV files saved in Windows-1252 (with a warning) or
UTF-16, skips empty 0-byte files, and warns when the same events appear in
more than one file, as after downloading or copying a file twice, or when
a column name appears twice in a file. A file that is not text gives a
plain error.
- Exports without the status, task name or timestamp columns no longer stop
print(), summary(), gorilla_checks() or write_gorilla(), and
write_gorilla(by_task = TRUE) keeps trials without a task name in
trials_unknown_task.csv. Writing data without any rows writes nothing.
- Arguments of the wrong type give clear errors in all functions.