LINC Brain Client

The LINC Brain Python client allows you to:

• Download Datasets and individual subject folders or files
• Validate data to locally conform to standards
• Organize your data locally before upload
• Upload Datasets
• Interact with the LINC Brain archive's web API from Python
• Delete data in the LINC Brain archive
• Perform other auxiliary operations with data or the LINC Brain archive

Note: This project is under heavy development. See the issues log or Work-in-Progress (WiP).

Installation

LINC Brain Client releases are available from PyPI and conda-forge. Install them in your Python (native, virtualenv, or conda) environment via

pip install lincbrain-cli

or

conda install -c conda-forge lincbrain-cli

CLI Tool

This package provides a command line utility with a basic interface to help you prepare and upload your data to, or obtain data from, the LINC Brain archive.

$> lincbrain
Usage: lincbrain [OPTIONS] COMMAND [ARGS]...

  A client to support interactions with LINC Brain archive
  (https://lincbrain.org).

  To see help for a specific command, run

      lincbrain COMMAND --help

  e.g. lincbrain upload --help

Options:
  --version
  -l, --log-level [DEBUG|INFO|WARNING|ERROR|CRITICAL]
                                  Log level (case insensitive).  May be
                                  specified as an integer.  [default: INFO]
  --pdb                           Fall into pdb if errors out
  --help                          Show this message and exit.

Commands:
  delete            Delete datasets and assets from the server.
  digest            Calculate file digests
  download          Download a file or entire folder from LINC Brain Archive.
  instances         List known LINC Brain Archive instances that the CLI can...
  ls                List .nwb files and datasets metadata.
  move              Move or rename assets in a local Dataset and/or on...
  organize          (Re)organize files according to the metadata.
  shell-completion  Emit shell script for enabling command completion.
  upload            Upload Dataset files to LINC Brain Archive.
  validate          Validate files for NWB and LINC Brain compliance.
  validate-bids     Validate BIDS paths.

Run lincbrain --help or lincbrain <subcommand> --help (e.g. lincbrain upload --help) to see manual pages.

Resources

The LINC Brain ecosystem is forked from the DANDI Archive project. Resources there should point you towards common questions encountered within the LINC Brain project.

• To learn how to interact with the LINC Brain Archive (e.g. a forked DANDI archive) and for examples on how to use the DANDI Client in various use cases, see the handbook (specifically the sections on using the CLI to download and upload Dandisets).

• To get help:

  • ask a question: https://github.com/dandi/helpdesk/discussions
  • file a feature request or bug report: https://github.com/dandi/helpdesk/issues/new/choose
  • contact the DANDI team: help@dandiarchive.org

• To understand how to contribute to the dandi-cli repository, see the DEVELOPMENT.md file.