Skip to content
Snippets Groups Projects
Commit c5c4a29e authored by Alex Kanitz's avatar Alex Kanitz
Browse files

Merge branch 'check_readme' into 'master'

update install instructions

See merge request zavolan_group/pipelines/rnaseqpipeline!17
parents dbc37e38 60597a61
No related branches found
No related tags found
1 merge request!17update install instructions
Pipeline #10225 passed
...@@ -14,6 +14,16 @@ workflow: ...@@ -14,6 +14,16 @@ workflow:
## Installation ## Installation
### Cloning the repository
Traverse to the desired path on your file system, then clone the repository and
move into it with:
```bash
git clone ssh://git@git.scicore.unibas.ch:2222/zavolan_group/pipelines/rnaseqpipeline.git
cd rnaseqpipeline
```
### Installing Singularity ### Installing Singularity
For improved reproducibility and reusability of the workflow, as well as an For improved reproducibility and reusability of the workflow, as well as an
...@@ -26,9 +36,12 @@ that Singularity be installed. See the links below for installation ...@@ -26,9 +36,12 @@ that Singularity be installed. See the links below for installation
instructions for the most up-to-date (as of writing) as well as for the tested instructions for the most up-to-date (as of writing) as well as for the tested
version (2.6.1) of Singularity: version (2.6.1) of Singularity:
- [Singularity v3.5](https://sylabs.io/guides/3.5/user-guide/quick_start.html) - [Singularity v3.5](https://sylabs.io/guides/3.5/user-guide/quick_start.html)
- [Singularity v2.6](https://sylabs.io/guides/2.6/user-guide/installation.html) - [Singularity v2.6](https://sylabs.io/guides/2.6/user-guide/installation.html)
If you have root privileges, you can directly install Singularity together with snakemake in a virtual environment (see next section)
### Setting up a Snakemake virtual environment ### Setting up a Snakemake virtual environment
In addition to Singularity, [Snakemake] needs to be installed. We strongly In addition to Singularity, [Snakemake] needs to be installed. We strongly
...@@ -43,26 +56,30 @@ minimal version (Python and package manager) [Miniconda] (see the link for ...@@ -43,26 +56,30 @@ minimal version (Python and package manager) [Miniconda] (see the link for
installation instructions). Be sure to select the correct version for your installation instructions). Be sure to select the correct version for your
operating system and ensure that you select the Python 3 option. operating system and ensure that you select the Python 3 option.
To create and activate the environment, run: To create and activate a snakemake environment, run:
```bash ```bash
conda create -n rnaseq_pipeline \ conda create -n rnaseq_pipeline \
-c bioconda \ -c bioconda \
-c conda-forge \ -c conda-forge \
snakemake=5.10.0 snakemake=5.10.0
conda activate rnaseq_pipeline conda activate rnaseq_pipeline
``` ```
### Cloning the repository or, to create a conda environment containing Snakemake AND Singularity (currently not working on MacOS):
Traverse to the desired path on your file system, then clone the repository and > Note: Singularity has to be installed as root, so wherever you don't have root privileges, use the installation methods described above!
move into it with:
```bash ```bash
git clone ssh://git@git.scicore.unibas.ch:2222/zavolan_group/pipelines/rnaseqpipeline.git conda create -n rnaseq_pipeline \
cd rnaseqpipeline -c bioconda \
-c conda-forge \
snakemake=5.10.0 \
singularity=3.5.2
conda activate rnaseq_pipeline
``` ```
All installation requirements should now be met with. All installation requirements should now be met with.
## Testing the installation ## Testing the installation
...@@ -84,7 +101,7 @@ bash tests/test_integration_workflow/test.local.sh ...@@ -84,7 +101,7 @@ bash tests/test_integration_workflow/test.local.sh
Execute the following command to run the test workflow on a Slurm-managed HPC. Execute the following command to run the test workflow on a Slurm-managed HPC.
```bash ```bash
bash tests/test_integration_workflow/test.local.sh bash tests/test_integration_workflow/test.slurm.sh
``` ```
> **NOTE:** Depending on the configuration of your Slurm installation or if > **NOTE:** Depending on the configuration of your Slurm installation or if
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment