update_model_decision_bias_incrementally: Update model's decision biases based on exposure data.

In hlplab/MVBeliefUpdatr: Fitting, Summarizing, and Visualizing of Multivariate Gaussian Ideal Observers and Adaptors

Update model's decision biases based on exposure data.

Description

Returns the model with updated decision biases.

Usage

update_model_decision_bias_incrementally(
  model,
  beta,
  exposure,
  exposure.category = "category",
  exposure.cues = get_cue_labels_from_model(model),
  exposure.order = NULL,
  noise_treatment = if (!is.null(first(model$Sigma_noise))) "marginalize" else "no_noise",
  lapse_treatment = "no_lapses",
  keep.update_history = TRUE,
  keep.exposure_data = FALSE,
  verbose = FALSE
)

Arguments

model	A model object with decision biases.
exposure	data.frame or tibble with exposure data. Each row is assumed to contain one observation.
exposure.category	Name of variable in data that contains the category information. (default: "category")
exposure.cues	Name(s) of variables in data that contain the cue information. By default these cue names are extracted from the prior object.
exposure.order	Name of variable in data that contains the order of the exposure data. If 'NULL' the exposure data is assumed to be in the order in which it should be presented.
noise_treatment	Determines whether and how multivariate Gaussian noise is considered during categorization. See update_model_decision_bias_by_one_observation.
lapse_treatment	Determines whether attentional lapses can occur during which no updating occurs. See update_model_decision_bias_by_one_observation.
keep.update_history	Should the history of the updating be stored and returned? If so, the output is tibble with the one model for each exposure observation. This is useful, for example, if one wants to visualize the changes in the category parameters, posterior predictive, categorization function, or alike across time. (default: 'TRUE')
keep.exposure_data	Should the input data be included in the output? If 'FALSE' then only the category and cue columns will be kept. If 'TRUE' then all columns will be kept. (default: 'FALSE')
verbose	Should more informative output be provided?

Value

An model object.

See Also

update_model_decision_bias_by_one_observation, which is called by update_model_decision_bias_incrementally

hlplab/MVBeliefUpdatr documentation built on March 29, 2025, 10:42 p.m.