NeuroDataPub: NCCR-SYNAPSY Neuroimaging Dataset Publishing Tool

This tool is developed by the Connectomics Lab at the University Hospital of Lausanne (CHUV) for use within the lab and within the National Centre of Competence in Research (NCCR) "SYNAPSY – Synaptic Bases of Mental Diseases" NCCR-SYNAPSY, as well as for open-source software distribution.

Overview

NeuroDataPub is an open-source neuroimaging dataset publishing tool written in Python and built on top of Datalad and git-annex. It aims to lower the barriers, for the NCCR-SYNAPSY members, to manage and publish, privately or publicly, their dataset repositories on GitHub and the annexed files on their SSH data server, in order to fully fulfill the implemented Neuroimaging Data Management Plan.

Since v0.3, you can use either (1) a server accessible via ssh or (2) the Open Science Foundation (OSF) platform, as a git-annex special remote, to host your annexed files.

Since v0.4, NeuroDataPub can handle datasets that do and do not follow the Brain Imaging Data Structure standard.

NeuroDataPub comes with its graphical user interface, aka the NeuroDataPub Assistant, created to facilitate:

• the configuration of the siblings,

• the creation of the JSON configuration files, as well as

• the execution of NeuroDataPub in three different modes:

  1. creation and publication of a datalad dataset,
  2. creation of a datalad dataset only,
  3. publication of an existing datalad dataset only,

• the creation of a Linux shell script for later execution where all commands are recorded.

NeuroDataPub is a Python 3.8 package that can be easily installed with pip as follows:

bash pip install neurodatapub

Documentation

• https://neurodatapub.readthedocs.io/

Usage

NeuroDataPub has the following commandline arguments:

```output usage: neurodatapub [-h] --mode {all,create-only,publish-only} --datasetdir DATASETDIR [--isnotbids] --dataladdir DATALADDIR --githubsiblingconfig GITHUBSIBLINGCONFIG (--gitannexsshspecialsiblingconfig GITANNEXSSHSPECIALSIBLINGCONFIG | --osfsiblingconfig OSFSIBLINGCONFIG) [--gui] [--generate_script] [-v]

Command-line argument parser of NeuroDataPub (v0.4)

optional arguments: -h, --help show this help message and exit. --mode {all,create-only,publish-only} Mode in which neurodatapub is run: "create-only" create the datalad dataset only, "publish-only" publish the datalad dataset only, `"all" create and publish the datalad dataset. --datasetdir DATASETDIR The directory with the input dataset formatted according to the BIDS standard. Specify if the directory with the input dataset is not formatted according to the BIDS standard. --isnotbids Specify if the directory with the input dataset is not formatted according to the BIDS standard. --dataladdir DATALADDIR The local directory where the Datalad dataset should be. --githubsiblingconfig GITHUBSIBLINGCONFIG Path to a JSON file containing configuration parameters for the GitHub dataset repository sibling. --gitannexsshspecialsiblingconfig GITANNEXSSHSPECIALSIBLINGCONFIG Path to a JSON file containing configuration parameters for the git-annex SSH special remote dataset sibling. --osfsiblingconfig OSFSIBLINGCONFIG Path to a JSON file containing configuration parameters for the git-annex OSF special remote dataset sibling. --gui Run NeuroDataPub in GUI mode. --generatescript Dry run that generates a bash script called `neurodatapubDD-MM-YYYY_hh:mm:ss.shin thecode/` folder of the input dataset that records all commands for later execution. -v, --version show program's version number and exit.

```

Acknowledgment

If your are using NeuroDataPub in your work, please acknowledge this software and its dependencies:

• Tourbier S, Hagmann P., (2021). NCCR-SYNAPSY/neurodatapub: NCCR-SYNAPSY Neuroimaging Dataset Publishing Tool (Version 0.1). Zenodo.

• Halchenko et al., (2021). DataLad: distributed system for joint management of code, data, and their relationship. Journal of Open Source Software, 6(63), 3262, https://doi.org/10.21105/joss.03262.

License information

This software is distributed under the open-source Apache 2.0 license. See license for more details.

All trademarks referenced herein are property of their respective holders.

Help/Questions

If you run into any problems or have any code bugs or questions, please create a new GitHub Issue.

Funding

Supported by the National Centre of Competence in Research (NCCR) "SYNAPSY – Synaptic Bases of Mental Diseases" (NCCR-SYNAPSY website / NCCR-SYNAPSY Swiss National Science Foundation page) supported by SNF-185897 grant.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Sébastien Tourbier 💻 📖 🎨 🤔 🚇 🚧 🧑‍🏫 📆 💬 👀

Patric Hagmann 🔍

This project follows the all-contributors specification. Contributions of any kind welcome!