BASTD is a package with a series of functions used to analyze and visualize stop-signal task (SST) data such as that generated by OSARI.
Written by Jason L He, Rohan Puri, Rebecca J Hirst
Created in R Studio 1.3.1093
Last edited: 07/04/2021
If using this please cite:
He, J. L , Hirst, R. J , Puri, R.,Coxon, J., Byblow, W., Hinder, M., Skippen, P., Matzke, D., Heathcote, A., Wadsley, C.G., Hyde, C., Parmar., D., Pedapati, E., Gilbert, D.L., Huddleston, D.A., Motofsky, S., Leunissen, I., McDonald, H., Chowdhury, N., Gretton, M., Nikitenko, T., Zandbelt, B., Luke., Strickland., Puts, N. (In prep) OSARI, an Open-Source Anticipated Response Inhibition task
BASTD was created to comprehensively batch analyse data from standard stop-signal paradigms. It was primarily developed to analyse data from OSTAP's OSARI, though it can be adapted to analyse data from other stop-signal paradigms. If you need help with implementing BASTD, please email the team at: opensourceTAP@gmail.com
The functions of BASTD can be separated into those which analyze and those which visualize.
The functions which analyze data are:
BASTD_analyze()
OSARI_analyze()
STOPIT_analyze()
BASTD expects recorded stop-signal data as a txt input with the column headers: ID, Block, Trial, Stimulus, Signal, Correct, Response, RT, RE, SSD, TrialType. Although originally generated for OSARI it can be used with data output from any stop-signal task so long as data are formated in this way (data output from OSARI is formatted using OSARI_analyze
).
ID
: Any Character or StringTrial
: Numeric values in increasing order and reset after every blockStimulus
: 1 or 2 (for choice-reaction variants of the SST)Signal
: 0 or 1 (0 meaning no signal was presenented, i.e., a Go-trial, and 1 meaning a signal was presented i.e., a Stop-trial)Correct
: 0 or 2 (0 for incorrect, 2 for correct)Response
: 0 or 1 (0 for no response, 1 for a response)RT
: A numerical value for RT in ms (e.g., 300 ms)RE
: Not currently implementedSSD
: A numerical value for Stop-signal delay in ms (e.g., 250 ms)TrialType (Optional)
: only relevant for data from OSARI
Provided the column names are consistent with the above, BASTD_analyze should be able to analyze any dataset from a SST.
Converts data from OSARI to be compatible with BASTD_analyze. Returns analyzed data. See example-data
for file structure.
Converts data from STOP-IT to be compatible with BASTD_analyze. Returns analyzed data. See example-data
for file structure.
The functions which visualize data are:
OSARI_visualize()
STOPIT_visualize()
An example of visualized data using BASTD:
When analysing the data from Anticipatory Response Inhibition (ARI) stop-signal tasks such as OSARI, we recommend users be aware of recent updates in the modelling literature, in particular the relevance of Context Independance. If you have reason to suspect a violation of Context Independance in your data/selected paradigm, we recommend using the Dynamic Models of Choice (DMC) R system. Please see the manuscript for further information.