Cheatsheet

DataLad cheatsheet

Installing a dataset

datalad install [-h] [-s SOURCE] [-d DATASET] [-g] [-D DESCRIPTION] [-r] [-R LEVELS] [--reckless [auto|ephemeral|shared-...]] [-J NJOBS] [PATH [PATH ...]]

Example:

datalad install -r git@github.com:LAAC-LSCP/datasets.git

Note: some datasets might have additional installation instructions!

More: datalad install

Getting data

datalad get [-h] [-s LABEL] [-d PATH] [-r] [-R LEVELS] [-n] [-D DESCRIPTION] [--reckless [auto|ephemeral|shared-...]] [-J NJOBS] [PATH [PATH ...]]

Example:

datalad get annotations/vtc

More: datalad get

Getting updates

datalad update --merge

More: datalad update

Saving changes

datalad save [-h] [-m MESSAGE] [-d DATASET] [-t ID] [-r] [-R LEVELS] [-u] [-F MESSAGE_FILE] [--to-git] [-J NJOBS] [PATH [PATH ...]]

Example:

datalad save metadata/children.csv -m "correcting children metadata"

datalad save is analoguous to doing git add+git commit. It will decide automatically whether to store the files in git or in the annex.

Note: datalad save records the changes locally. They still have to be pulished - just like with git commit !

More: datalad save

Publishing changes

datalad push [-h] [-d DATASET] [--to SIBLING] [--since SINCE] [--data {anything|nothing|auto|auto-if-wanted}] [-f {all|gitpush|checkdatapresent}] [-r] [-R LEVELS] [-J NJOBS] [PATH [PATH ...]]

Example:

datalad push

More: datalad push

ChildProject cheatsheet