dUGM_grid: Generate Grid for PDF of the Urgency Gating Model

View source: R/UGM.R

dUGM_gridR Documentation

Generate Grid for PDF of the Urgency Gating Model

Description

Generate a grid of response-time values and the corresponding PDF values. For more details on the model see, for example, dUGM.

Usage

dUGM_grid(rt_max = 10, phi, x_res = "default", t_res = "default")

Arguments

rt_max

maximal response time <- max(rt)

phi

parameter vector in the following order:

  1. Non-decision time (t_{nd}). Time for non-decision processes such as stimulus encoding and response execution. Total decision time t is the sum of the decision and non-decision times.

  2. Relative start (w). Sets the start point of accumulation as a ratio of the two decision thresholds. Related to the absolute start z point via equation z = b_l + w*(b_u - b_l).

  3. Stimulus strength (E_0). Strength of the stimulus.

  4. Log10-leakage (log_{10}(L)). Rate of leaky integration.

  5. Log10-urgency (log_{10}(k)). Decision urgency. If k is small, the choice is dominated by leakage and approximates a LM. If k is large, it is an urgency dominated decision.

  6. Noise scale (\sigma). Model scaling parameter.

  7. Decision thresholds (b). Sets the location of each decision threshold. The upper threshold b_u is above 0 and the lower threshold b_l is below 0 such that b_u = -b_l = b. The threshold separation a = 2b.

  8. Contamination (g). Sets the strength of the contamination process. Contamination process is a uniform distribution f_c(t) where f_c(t) = 1/(g_u-g_l) if g_l <= t <= g_u and f_c(t) = 0 if t < g_l or t > g_u. It is combined with PDF f_i(t) to give the final combined distribution f_{i,c}(t) = g*f_c(t) + (1-g)*f_i(t), which is then output by the program. If g = 0, it just outputs f_i(t).

  9. Lower bound of contamination distribution (g_l). See parameter g.

  10. Upper bound of contamination distribution (g_u). See parameter g.

x_res

spatial/evidence resolution

t_res

time resolution

Value

list of RTs and corresponding defective PDFs at lower and upper threshold

Author(s)

Raphael Hartmann & Matthew Murrow

References

Cisek, P., Puskas, G. A., & El-Murr, S. (2009). Decisions in changing conditions: the urgency-gating model. Journal of Neuroscience, 29(37), 11560-11571.

Trueblood, J. S., Heathcote, A., Evans, N. J., & Holmes, W. R. (2021). Urgency, leakage, and the relative nature of information processing in decision-making. Psychological Review, 128(1), 160-186.


ream documentation built on Oct. 7, 2024, 1:20 a.m.