Derivatives of the First-Passage Time Density and Cumulative Distribution Function, and Random Sampling from the (Truncated) First-Passage Time Distribution
Overview
First, we provide functions to calculate the partial derivative of the first-passage time diffusion probability density function (PDF) and cumulative distribution function (CDF) with respect to the first-passage time t (only for PDF), the upper barrier a, the drift rate v, the relative starting point w, the non-decision time t0, the inter-trial variability of the drift rate sv, the inter-trial variability of the rel. starting point sw, and the inter-trial variability of the non-decision time st0. In addition the PDF and CDF themselves are also provided. Most calculations are done on the logarithmic scale to make it more stable. Since the PDF, CDF, and their derivatives are represented as infinite series, we give the user the option to control the approximation errors with the argument 'precision'. For the numerical integration we used the C library cubature by Johnson, S. G. (2005-2013) https://github.com/stevengj/cubature. Numerical integration is required whenever sv, sw, and/or st0 is not zero. Note that numerical integration reduces speed of the computation and the precision cannot be guaranteed anymore. Therefore, whenever numerical integration is used an estimate of the approximation error is provided in the output list. Note: The large number of contributors (ctb) is due to copying a lot of C/C++ code chunks from the GNU Scientific Library (GSL). Second, we provide methods to sample from the first-passage time distribution with or without user-defined truncation from above. The first method is a new adaptive rejection sampler building on the works of Gilks and Wild (1992; doi:10.2307/2347565) and Hartmann and Klauer (in press). The second method is a rejection sampler provided by Drugowitsch (2016; doi:10.1038/srep20490). The third method is an inverse transformation sampler. The fourth method is a "pseudo" adaptive rejection sampler that builds on the first method. For more details see the corresponding help files.
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK14 OK2026-03-10
Documentation
- Help pages
- 23
- Examples that run
- 100%23 run in a plain check
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 96%
Downloads
Dependencies
Installing WienR adds no packages beyond those that come with R.
Code & Tests
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 0.3-17Latest
- 0.3-152023-11-29 · diff ↗
- 0.3-142023-07-04 · diff ↗
- 0.3-102023-05-23 · diff ↗
- 0.3-9
- RR 4.3.0 released · 2023-04-21
- 0.3-82023-01-26 · diff ↗
- 0.3-72022-10-28 · diff ↗
- 0.3-62022-04-23 · diff ↗
- RR 4.2.0 released · 2022-04-22
- 0.3-42022-04-16 · diff ↗
- 0.3-0
- 0.2-22021-09-02 · diff ↗
Package metadata
- First published
- 2021-05-07
- Total releases
- 14 / 5 yrs
- License
- GPL (>= 2) OSI
- Download size
- 68 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("WienR")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.