2019/04/12 by Marijn van Vliet, van Vliet, Marijn
Medicine · Neuroscience · #Attention Deficit Hyperactivity Disorder #EEG and Brain-Computer Interfaces #FOS: Computer and information sciences #Functional Brain Connectivity Studies #Software Engineering (cs.SE)
paper · pdf · doi:10.48550/arxiv.1904.06163
openalex publication_date 2019/04/12 · openalex created_date 2025/10/10 · openalex updated_date 2026/07/28
Unorganized heaps of analysis code are a growing liability as data analysis pipelines are getting longer and more complicated. This is worrying, as neuroscience papers are getting retracted due to programmer error. In this paper, some guidelines are presented that help keep analysis code well organized, easy to understand and convenient to work with: 1. Each analysis step is one script 2. A script either processes a single recording, or aggregates across recordings, never both 3. One master script to run the entire analysis 4. Save all intermediate results 5. Visualize all intermediate results 6. Each parameter and filename is defined only once 7. Distinguish files that are part of the official pipeline from other scripts In addition to discussing the reasoning behind each guideline, an example analysis pipeline is presented as a case study to see how each guideline translates into code.