dUGMF_grid: Generate Grid for PDF of the Urgency Gating Model With Flip

View source: R/UGMF.R

dUGMF_gridR Documentation

Generate Grid for PDF of the Urgency Gating Model With Flip

Description

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

Usage

dUGMF_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 before the flip (E_{01}).

  4. Stimulus strength after the flip (E_{02}).

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

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

  7. Flip-time (t_0). Time when stimulus strength changes.

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

  9. 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.

  10. 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).

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

  12. 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.


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