annotation_questions: Questions for a face annotation task

View source: R/annotation.R

annotation_questionsR Documentation

Questions for a face annotation task

Description

Ready-made questions for annotation_task. Each question is a list, so you can change them or add your own (see Details).

Usage

annotation_questions(which = c("face_check", "emotion", "intensity"))

Arguments

which

Names of the ready-made questions, in the order they are asked:

"face_check"

Does the outline contain a face? Yes, not a face, a different person, or can't tell. The other questions are asked only after "Yes", so detector mistakes never get an emotion.

"emotion"

Which emotion the face shows, one of the task's classes.

"intensity"

How intense it is, 1 to 7.

"valence"

How negative or positive the face is, -3 to 3.

"arousal"

How calm or excited the face is, 0 to 6.

"why"

For items with a reference label and a model prediction (annotation_task(items = ...)): what explains the result, compared with the label and the model. The model is wrong, the label is debatable, the wrong face was scored, no face is visible, the model and the label agree, or something else. Asked after the label, the prediction and the scores are shown (reveal = TRUE).

Details

A question is a list with

id

A name in lower case: letters, digits and underscores.

type

"single" (one of a few options) or "likert" (a whole number from min to max).

prompt

The question as coders read it.

options

For "single": the answers, or options_from = "classes" for the task's classes. Optional labels: a named list of the text shown for each answer.

min, max

For "likert", with optional anchors = list(min = "...", max = "...").

show_if

Optional: ask only after another question got one of these answers, as in list(face_check = "ok").

reveal

Optional, for items with a reference label and a model prediction: TRUE asks the question only once they are shown, which with blind = TRUE is after the other questions are answered.

required

FALSE lets coders leave it unanswered.

Value

A list of questions.

See Also

annotation_task

Examples

annotation_questions(c("face_check", "emotion"))

# Add a question of your own
gaze <- list(id = "gaze", type = "single", prompt = "Where does the person look?",
             options = c("camera", "away", "closed"), show_if = list(face_check = "ok"))
questions <- c(annotation_questions(), list(gaze))


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