Skip to contents

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.