Preperations for participants
If you want to work on your own machine during the workshop, please make sure that you install the relevant software and set it up appropriately in advance. At the end of this page, a short script can help you to verify that everything works as it should.
If you run into problems, please get in touch prior to the workshop. We are happy to help with installation problems or general questions, but a virtual workshop does not allow for any concurrent user support and help, unfortunately, and we thus won't be able to deal with problems that surface during the sessions. Reach out to us about problems as early as you can by filing an issue on our GitHub repository: github.com/adswa/dl-workshop.
If you haven't set up the software, you can log into a Jupyter Hub instance we will provide.
| NOTE FOR WINDOWS USERS |
|---|
| DataLad and its underlying tools work less well on Windows. An honest assessment can be found in the DataLad handbook. Alternatively to using your Windows OS you can use the Windows Subsystem for Linux (2), your institutions high-performance compute cluster, or the provided Jupyter hub. |
| NOTE FOR HCP/HTC USERS |
|---|
| If you want to use shared high-performance or high-throughput infrastructure, but there is no DataLad installation yet, you can either install the required software on a per-user basis (no root privileges required) following instructions in the DataLad Handbook, or you can ask your system's administrator to install the software. Feel free to share adina.wagner@t-online.de as a point of contact for additional information and handbook.datalad.org/r.html?install for installation instructions. |
An intro to the command line¶
During the workshop we will primarily work with the command line. If you are using your own computer, but are not used to typing in your computer's terminal, we recommend that you familiarize yourself with the basics. You can find a short tutorial here.
Software installation¶
| The following software is required to follow along interactively. Please install it as early as you can |
|---|
| DataLad: handbook.datalad.org/intro/installation.html (depending on installation method and operating system, Git and git-annex can already be included a DataLad installation) |
| Git: git-scm.com |
| git-annex: git-annex.branchable.com/ |
Check your installation¶
To check whether everything worked out, please run the following command in your terminal (without the leading $):
$ datalad -f'{infos[git-annex][version]}' wtf
8.20200330
If this returns a version number as above (it does not need to be identical to 8.20200330), you're good! 👍
Potential errors:
If you see the following, your Git identity isn't configured yet:
It is highly recommended to configure Git before using DataLad. Set both 'user.name' and 'user.email' configuration variables.
If you don't get a version number of N/A, git-annex is missing. Please double check by typing git-annex into your terminal and pressing enter - if your shell responds with command not found, please install git-annex.
If your shell returns command not found, DataLad is missing. Please double check by retrying this operation in a new shell or typing rehash beforehand.
Getting help¶
If you run into problems, please reach out as early as you can by filing an issue on our GitHub repository: github.com/adswa/mpi-datamanagement-ws/.