Before you start - reanahub/reana GitHub Wiki
Contents
- Read up about computational reproducibility
- Install and use REANA as a researcher
- Next steps
Read up about computational reproducibility
Before you start with the REANA software development itself, it is important to familiarise yourself with the topics of open science, data preservation and reuse, scientific replicability and computational reproducibility.
Amongst good overview papers to check out are:
- Reproducibility and Replicability in Science (2019), National Academic Press, DOI 10.17226/25303, 256 pages.
- Reproducibility of scientific results in the EU (2020), European Commission, DOI 10.2777/341654, 30 pages.
Install and use REANA as a researcher
The next step is to familiarise yourself with REANA from the point of view of a researcher. You would consider REANA as a black box where you run computational analyses, without especially caring about knowing what is "inside" the box.
Please do the following:
-
Install REANA on your laptop in a researcher-friendly manner. This will require to set up Docker, Kubernetes, Kind and Helm, and allow you to develop basic familiarity with those technologies.
-
Run several REANA analysis examples on your local instance. Try to understand the general flow. Observe Kubernetes pods starting and stopping as the workflow runs.
-
Skim briefly through CWL tutorial or Snakemake tutorial to get a feeling for how a researcher would express the analysis computations in a declarative way. The reading doesn't have to be detailed if you are not going to work on CWL or Snakemake; just to get the basic ideas.
-
Explore
reana-clientcommand-line client options. Use--helpto discover the functionality and try out various commands. -
Explore REANA web user interface on your local installation at https://localhost:40334.
Next steps
Once you are comfortable using REANA as a black box on your laptop, run and modify example analyses as researcher would, we can proceed with exploring what's inside the box.
Please continue to Setting up your system in order to start with REANA developments.