1
0
Fork 0
mirror of https://github.com/MillironX/nf-configs.git synced 2024-11-25 17:29:55 +00:00
nf-configs/docs/abims.md
2020-10-23 00:11:58 +02:00

53 lines
1.9 KiB
Markdown

# nf-core/configs: ABiMS Configuration
All nf-core pipelines have been successfully configured for use on the ABiMS cluster.
To use, run the pipeline with `-profile abims`. This will download and launch the [`abims.config`](../conf/abims.config) which has been pre-configured with a setup suitable for the ABiMS cluster. Using this profile, a docker image containing all of the required software will be downloaded, and converted to a Singularity image before execution of the pipeline.
## Request an account
You will need an account to use the HPC cluster on ABiMS in order
to run the pipeline. If in doubt see [http://abims.sb-roscoff.fr/account](http://abims.sb-roscoff.fr/account).
## Running the workflow on the ABiMS cluster
Nextflow is installed on the ABiMS cluster. Some documentation is available on the [ABiMS website](http://abims.sb-roscoff.fr/resources/cluster/howto#nextflow).
You need to activate it like this:
```bash
module load nextflow slurm-drmaa graphviz
```
Nextflow manages each process as a separate job that is submitted to the cluster by using the sbatch command.
Nextflow shouldn't run directly on the submission node but on a compute node. Run nextflow from a compute node:
```bash
# Login to a compute node
srun --pty bash
# Load the dependencies if not done before
module load nextflow slurm-drmaa graphviz
# Run a downloaded/git-cloned nextflow workflow from
nextflow run \\
/path/to/nf-core/workflow \\
-resume
-profile abims \\
--email my-email@example.org \\
-c my-specific.config
...
# Or use the nf-core client
nextflow run nf-core/rnaseq ...
```
## Singularity images mutualized directory
To reduce the disk usage, nf-core images can be stored in a mutualized directory: `/shared/software/singularity/images/nf-core/`
The environment variable `NXF_SINGULARITY_CACHEDIR: /shared/data/cache/nextflow` will indicate this directory to nextflow.
## Databanks
A local copy of several genomes are available in `/shared/bank/` directory.