Package: rabies
RABIES: Rodent Automated Bold Improvement of EPI Sequences.RABIES is an open source image processing pipeline for rodent fMRI. It conducts state-of-the-art preprocessing and confound correction, and supplies standard resting-state functional connectivity analyses. Visit our documentation athttps://rabies.readthedocs.io/en/stable/.What you can do with RABIESThe primary purpose of RABIES is to provide rodent fMRI research with a standard, flexible, and reliable image processing platform. The package is complemented with informative data diagnostic features for confound characterization and encourages best practices for quality control and reproducibility. The RABIES software is structured into three main processing stages:preprocessing,confound correctionandanalysis.PreprocessingThe preprocessing workflow regroups essential fMRI preprocessing steps prior to analysis. It includes a robust registration workflow with automatically-adapting parameters allowing to succesfully process diverse acquisition types (i.e. rodent species, scan field strength, coil type, ...), and can conduct the following preprocessing steps:head motion correctionsusceptibility distortion correctionresampling to native or common spacebrain parcellationslice timing correction (optional)despiking (optional)visual assessment of registration for quality controlConfound correctionFollowing preprocessing, a range of strategies to correct fMRI confounds (e.g. motion) can then be conducted within RABIES:linear detrendingconfound regression (with several options for nuisance regressors)frequency filtering (highpass, lowpass, bandpass)frame censoring (or scrubbing)ICA-AROMAspatial smoothingAnalysisSimple resting-state connectivity analyses are made available after preprocessing and confound correction. RABIES also provides a 'data diagnosis' workflow, which generates several indices of data quality and potential confounds, and conversaly, aims to improve the correction of confounds and transparency with regards to data quality:seed-based functional connectivitywhole-brain connectivity matrixgroup-ICAdual regressiondata diagnosisNotes on software designNipype workflows: The image processing pipelines are structured using theNipype library, which allows to build dynamic workflows in the form of a computational graph. Each node in the graph consists of a processing step, and the required inputs/outputs define the links between nodes. In addition to supporting code organization, Nipype workflows also handle severalplugin architecturesfor parallel execution as well as memory management. The computational time to run the entire RABIES pipeline will vary substantially depending on data size, but for most uses, it will rangefrom a few hours to a daywhen using proper computational resources and parallel execution.Reproducible and transparent research: RABIES aims to follow best practices for reproducible and transparent research, including the following:open source codehttps://github.com/CoBrALab/RABIESstandardized input data format withBIDSeasily shared, automatically-generated visual outputs for quality controlcontainerized distribution of the software hosted onDocker Hubwhich can be downloaded via Docker and Singularity platformsCitationCiting RABIES: Apreprint introducing the softwareis available on bioXriv, which should be cited accordingly when using RABIES.Boilerplate: a boilerplate summarizing the preprocessing and confound correction operations is automatically generated in the output folder. You can use the boilerplate to help describe your methods in a paper.LicenseTheRABIES licenseallows for uses in academic and educational environments only. Commercial use requires a commercial license from CoBrALabcontact@cobralab.ca,http://cobralab.caAcknowledgementsThis software was developped by theCoBrALab, located at the Cerebral Imaging Center of the Douglas Mental Health University Institute, Montreal, Canada, in affiliation with McGill University, Montreal, Canada. This work was supported by funding from Healthy Brains, Healthy Lives (HBHL), the Fonds de recherche du Québec - Santé (FRQS) and - Nature et technologies (FRQNT), and the Natural Sciences and Engineering Research Council (NSERC) of Canada.fMRIPrepwas an important inspirational source for this project, in particular with regards to best practices for software reproducibility and code design using Nipype. We also thank the organizers ofBrainHack School Montreal, which guided the initial steps of this project in 2018.Ask for helpIf you need support in using the software or experience issues that are not documented, we'll provide support on theGithub discussion.Contributing to RABIESRead our dedicateddocumentation