read_annotations: Read the answers of a face annotation task

View source: R/annotation.R

read_annotationsR Documentation

Read the answers of a face annotation task

Description

Reads what coders answered in annotate_faces: the files in the task's results folder, and any exported files you add.

Usage

read_annotations(task, files = NULL, revisions = c("last", "all"))

Arguments

task

An annotation_task, or its folder.

files

Answer files to read, or "te-annotations:..." codes from the Copy R code button of a coding page in a notebook. Default: every .jsonl and .json file in the task's results folder.

revisions

"last" (default) keeps each coder's last answer to each item; "all" keeps every change, for checking.

Value

A data frame with one row per item, coder and question: item_id, coder_id, question, value (the answer as text, NA when the question was not asked or the item was skipped), value_num (the answer as a number, for Likert questions), status ("answered" or "skipped"), revision, rt_ms (time on the item), shown_at, submitted_at and session_id, followed by the item's face: source, frame, frame_index, time, face, track_id and person_id. For a task made from items: the item's id, kind, media, reference (its label), prediction and score columns.

See Also

annotation_agreement, consensus_labels


transforEmotion documentation built on Oct. 26, 2026, 5:07 p.m.