MyNixOS website logo
Description

Circular Drift-Diffusion Model.

Circular drift-diffusion model for continuous reports.

Circular Drift-diffusion Model

CircularDDM implements circular drift-diffusion model, using Armadillo C++.

MATLAB callable functions reside in inst/matlab folder. Currently, we provide only Linux binary (mexa64 files compiled by g++ 5.4.0). If the libraries, GNU gsl and armadillo C++ (requiring LAPACK and BLAS), are installed, one should be able to compile the source codes in other systems, such as Windows (mexw64 files) and OS X (mexmaci64 files).

Getting Started

The following examples are extracted from CircularDDM help pages

require(CircularDDM)

###################
## dcddm example ##
###################
x <- cbind(
RT= c(1.2595272, 0.8693937, 0.8009044, 1.0018933, 2.3640007, 1.0521304),
R = c(1.9217430, 1.7844653, 0.2662521, 2.1569724, 1.7277440, 0.8607271)
)
pVec <- c(a=2.45, vx=1.5, vy=1.25, t0=.1, s=1)
dcddm(x, pVec)

###################
## rcddm example ##
###################
pVec <- c(a=2, vx=1.5, vy=1.25, t0=.25, s=1)
den  <- rcddm(1e3, pVec);
hist(den[,1], breaks = "fd", xlab="Response Time", main="Density")
hist(den[,3], breaks = "fd", xlab="Response Angle", main="Density")

Installation and Prerequisites

R package

## From github
devtools::install_github("TasCL/CircularDDM")
## From source: 
install.packages("CircularDDM_0.0.8.tar.gz", repos = NULL, type="source")

R package requires:

  • R (>= 3.0.2)
  • Rtools
  • Rcpp (>= 0.12.3)
  • RcppArmadillo (>= 0.6.700.6.0)

MATLAB toolbox

The installation for MATLAB is simply copying the files in 'matlab' folder to MATLAB toolbox folder. For example, in Linux default path, MATLAB toolbox is at '/usr/local/MATLAB/R2016a/toolbox' (version number may vary, e.g., 'R2015', etc.). The following is a step-by-step instruction.

  1. Create a folder (e.g., by issuing 'mkdir') called 'CircularDDM' under '/usr/local/MATLAB/R2016a/toolbox'
  2. Copy all files in the 'inst/matlab' in the source tar ball to '/usr/local/MATLAB/R2016a/toolbox/CircularDDM'. Entering 'matlabroot' in MATLAB prompt will show MATLAB root folder.
  3. Use a text editor to open /usr/local/MATLAB/R2016a/toolbox/local/pathdef.m. Note that pathdef.m might have not set a write flag. "chmod +w pathdef.m" will add write ('w') flag on the file.
  4. Add "matlabroot,'/toolbox/CircularDDM:', ..." before "%%% END ENTRIES %%%"
  5. Save and close the file.
  6. Enter the following three command in MATLAB prompt to test if CircularDDM package is installed properly.
help('rcircularddm')
help('dcircularddm')
help('rvonmises')

MATLAB package requires:

  • GNU gsl 1.16 (gsl requires CBLAS)
  • Armadillo ( >= 0.6.700.6.0)
  • Armadillo requires either (1) LAPACK and BLAS, (2) OpenBLAS or (3) Intel Math Kernel Library (MKL). I have not tested the third option. However Aramadillo's author recommends it as a perhaps even faster option.
  • See Armadillo C++ for details.

References

  • Smith, P. L. (2016). Diffusion Theory of Decision Making in Continuous Report. Psychological Review, 123(4), 425--451, doi: http://dx.doi.org/10.1037/rev0000023.
Metadata

Version

0.1.0

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows