Skip to contents

Define an observed response

Source: R/model_definition.R
add_outcome.Rd

Attach a response label to a finishing rule. In a single-response model, the first available outcome determines the observed response and time.

Usage

add_outcome(spec, label, expr, options = list())

Arguments

spec

A race_spec object.

label

Response label that should appear in the behavioral data.

expr

Accumulator or pool label, or a rule built with first_of(), all_of(), none_of(), inhibit(), or build_outcome_expr().

options

Named list of response settings:

  • component: component labels in which this outcome is active. Omit to use it in every component.

  • map_outcome_to: another declared outcome label, or NA_character_ to record no response when this outcome wins.

  • guess: a list with declared outcome labels, their probability weights (summing to one), and rt_policy = "keep" or "na". When this outcome wins, draw its recorded label using these weights; "na" discards the response time. The default policy is "keep".

Guessing and remapping require n_outcomes = 1.

Value

The updated race_spec.

Examples

spec <- race_spec()
spec <- add_accumulator(spec, "A", "lognormal")
spec <- add_outcome(spec, "A_win", "A")