Whether you want to use the HU-GIN, the LMU-GIN or another datalad capable tool, you will need to install datalad and ssh keys on your computer.

Installation

We encountered several issue, especially with windows computer. In order to limit the amount of different issues, please follow the process step by step.

Install the needed tools (datalad and ssh keys) on:

• OSX
• windows: datalad walkthrough

You can now clone your repository and use synchronisation scripts to update your repository.

Direct datalad use

Initialisation

You may want to download submodule content (only filenames) using datalad get . -n -r

Synchronisation

You may also type the datalad commands included in the script:

• use cd ... to navigat to the main folder, (on some OS, if you right-click a folder, you can choose to open a terminal there)
• datalad save -r -m {you can add a message here !}: write all changes in the version history system locally (using the same commit message in all respositories)

• datalad update -r --how=merge :merge new content found on the server version

• datalad push -r: upload all saved changes on the server

Files that are annexed can be dropped (erased from the local computer once safe on the server) using the following command:

• datalad drop . -r

On the contrary, one can download all of them using:

• datalad get . -r

Notes:

• the . indicate "everything", you can also specify a unique file to download.
• -r indicates the command will be run recusirvely in all submodule (also by default in submodules of submodules is there are any)
• when running code using datalad run, data will be fetched on demand. See http://handbook.datalad.org/en/latest/basics/basics-run.html

Create new submodules

Note about creating repositories via datalad: Datalad cannot create a repository in an organisation you are not an owner of on GIN. You may either create a repository under your username or another organisation and change the owner later:

datalad create-sibling-gin organameorusername/nameoftherepo -s gin  --api https://gindata.biologie.hu-berlin.de  --credential juliencolomb

or ask an owner to create a repository and add it to your main repository with:

`git submodule add ssh://git@gindata.biologie.hu-berlin.de:10022/... "path-to-create" `

(a tonic form doing that has not been implemented yet.)