From 1c623953322329c05345517940a5d19fbf678fb9 Mon Sep 17 00:00:00 2001 From: Edmund Miller Date: Mon, 9 Mar 2020 20:07:46 -0500 Subject: [PATCH] docs(utd_ganymede): add initial documentation --- README.md | 1 + docs/utd_ganymede.md | 18 ++++++++++++++++++ nfcore_custom.config | 4 +++- 3 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 docs/utd_ganymede.md diff --git a/README.md b/README.md index 755b1d2..686b157 100644 --- a/README.md +++ b/README.md @@ -117,6 +117,7 @@ Currently documentation is available for the following systems: * [SHH](docs/shh.md) * [UCT_HEX](docs/uct_hex.md) * [UPPMAX](docs/uppmax.md) +* [UTD_GANYMEDE](docs/utd_ganymede.md) * [UZH](docs/uzh.md) ### Uploading to `nf-core/configs` diff --git a/docs/utd_ganymede.md b/docs/utd_ganymede.md new file mode 100644 index 0000000..81dd46a --- /dev/null +++ b/docs/utd_ganymede.md @@ -0,0 +1,18 @@ +# nf-core/configs: UTD Ganymede Configuration + +All nf-core pipelines have been successfully configured for use on the Ganymede HPC cluster at the [The Univeristy of Texas at Dallas](https://www.utdallas.edu/). + +To use, run the pipeline with `-profile utd_ganymede`. This will download and launch the [`utd_ganymede.config`](../conf/utd_ganymede.config) which has been pre-configured with a setup suitable for the Ganymede HPC 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. + +Before running the pipeline you will need to load Singularity using the environment module system on Ganymede. You can do this by issuing the commands below: + +```bash +## Singularity environment modules +module purge +module load singularity +``` + +All of the intermediate files required to run the pipeline will be stored in the `work/` directory. It is recommended to delete this directory after the pipeline has finished successfully because it can get quite large, and all of the main output files will be saved in the `results/` directory anyway. + +>NB: You will need an account to use the HPC cluster on Ganymede in order to run the pipeline. If in doubt contact Ganymedeadmins. +>NB: Nextflow will need to submit the jobs via SLURM to the HPC cluster and as such the commands above will have to be executed on one of the login nodes. If in doubt contact GanymedeAdmins. diff --git a/nfcore_custom.config b/nfcore_custom.config index 848db80..383eaf0 100644 --- a/nfcore_custom.config +++ b/nfcore_custom.config @@ -37,6 +37,7 @@ profiles { shh { includeConfig "${params.custom_config_base}/conf/shh.config" } uct_hex { includeConfig "${params.custom_config_base}/conf/uct_hex.config" } uppmax { includeConfig "${params.custom_config_base}/conf/uppmax.config" } + utd_ganymede { includeConfig "${params.custom_config_base}/conf/utd_ganymede.config" } uzh { includeConfig "${params.custom_config_base}/conf/uzh.config" } } @@ -50,6 +51,7 @@ params { crick: ['.thecrick.org'], genotoul: ['.genologin1.toulouse.inra.fr', '.genologin2.toulouse.inra.fr'], genouest: ['.genouest.org'], - uppmax: ['.uppmax.uu.se'] + uppmax: ['.uppmax.uu.se'], + utd_ganymede: ['ganymede.utdallas.edu'] ] }