Welcome to the ReproStim documentation¶

Introduction¶

ReproStim is a video capture and recording suite for neuroimaging and psychology experiments. Its goal is to provide experimenters with a complete record of audio and visual stimulation for every data collection session by making it possible to easily collect high fidelity copies of the actual stimuli shown to each subject in the form of video files that can be stored alongside behavioral or neuroimaging data in public repositories. ReproStim is part of large ReproFlow process represented in the diagram below:

Fig. 1: ReproNim ReproFlow Diagram, OHBM 2024 #2277

Note: This is interactive SVG diagram, so you can open it in separate window and click on the boxes to see more.

ReproStim provides for enhanced experimental reproducibility and a safeguard against data loss in cases of data-collection irregularities. Because ReproStim provides an exact record of the actual stimuli delivered during any given experimental session, it makes it possible to precisely reproduce experimental sessions, even if the original trial sets were randomized and precise trial details not recorded. In cases of experimental irregularities, such as aborted fMRI runs, unexpected glitches in trial timing, or programming errors that cause records of trial conditions to be lost, valuable data (which can be especially costly in cases of fMRI of ECog, for example) can be recoded and recovered using the audiovisual record provided by ReproStim.

ReproStim requires minimal effort on behalf of investigators. Once it is setup as the default mode within a behavioral lab or neuroimaging center, investigators can reap the benefits of ReproStim without any additional effort on the part of individual experimenters. When successfully set up, ReproStim runs in the background, silently collecting, cataloging, and storing all audio and visual stimulation delivered to experimental subjects.

Documentation: full documentation is available at Read the Docs.

Appendix: ReproFlow Projects

BIDS - brain imaging data structure standard.
Birch - birch interface documentation.
CON - center for open neuroscience homepage.
con/noisseur - system for automated verification of entered/displayed information (on another computer).
containers/repronim - repronim containers binary distribution for reproducible neuroimaging.
containers/repronim-reprostim - reprostim containers metadata and tools to generate/build binaries.
DataLad - distributed data management free and open source tool.
DBIC - Dartmouth brain imaging center.
DICOM - digital imaging and communications in medicine standard.
HeuDiConv - heuristic-centric DICOM converter.
Magewell USB Capture - Magewell USB Capture devices.
MWCapture SDK - Magewell USB Capture SDK and APIs.
NeuroDebian - ultimate neuroscience software platform.
NTP - network time protocol wiki.
ReproEvents - events listener server and micropython-based firweware for Raspberry Pi event relay devices.
reproflow-data-sync - DataLad dataset with all samples of recorded ReproEvents, ReproStim, etc. data for purpose of calibration and establishing processing pipelines.
ReproIn - setup for automatic generation of shareable, version-controlled BIDS datasets from MR scanners.
ReproMon - service to monitor data acquisition to alert if anything goes wrong in ReproFlow.
ReproStim - automated capture of audio-visual stimuli into BIDS datasets.
reprostim-capture - set of tools and utilities to capture video/audio signal with Magewell USB Capture devices and save it to a file. It is a part of the ReproStim project.

Contents¶

Contents:

Indices and tables¶

Index