Skip to content

Commit 443a009

Browse files
authored
Merge pull request #1086 from nf-core/deprecate_wustl_htcf
FIX: Restore config + add warning
2 parents 0bd43c1 + 3977b7b commit 443a009

4 files changed

Lines changed: 81 additions & 0 deletions

File tree

.github/workflows/main.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,7 @@ jobs:
214214
- "vsc_kul_uhasselt"
215215
- "vsc_ugent"
216216
- "wehi"
217+
- "wustl_htcf"
217218
- "xanadu"
218219
- "york_viking"
219220

conf/wustl_htcf.config

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
// Forked from https://github.com/nf-core/configs/blob/master/conf/prince.config
2+
3+
params {
4+
config_profile_description = """
5+
WUSTL High Throughput Computing Facility cluster profile provided by nf-core/configs.
6+
Run from your scratch directory, the output files may be large!
7+
Please consider running the pipeline on a compute node the first time, as it will be pulling the docker image, which will be converted into a singularity image, which is heavy on the login node. Subsequent runs can be done on the login node, as the docker image will only be pulled and converted once. By default, the images will be stored in ${params.singularityDir}
8+
""".stripIndent()
9+
config_profile_contact = "Gavin John <gavinjohn@wustl.edu>"
10+
config_profile_url = "https://github.com/nf-core/configs/blob/master/docs/wustl_htcf.md"
11+
12+
max_cpus = 24
13+
max_memory = 750.GB
14+
max_time = 168.h
15+
16+
// Define singularity directory based on LAB environment variable or group membership
17+
singularityDir = "/ref/${System.getenv("LAB") ?: "id -nG".execute().text.split(" ").last().trim()}/data/singularity_images_nextflow"
18+
19+
warning_message = {
20+
System.out.println("WARNING: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!")
21+
System.out.println("WARNING:")
22+
System.out.println("WARNING: THIS CONFIG IS NO LONGER MAINTAINED.")
23+
System.out.println("WARNING:")
24+
System.out.println("WARNING: THIS CONFIG WILL BE DEPRECATED BY THE END OF MAY 2026 DUE TO AN UPCOMING VERSION NEXTFLOW THAT WILL NOT BE BACKWARDS COMPATIBLE.
25+
System.out.println("WARNING: MODIFICATIONS TO THIS CONFIG AND TESTING BY USERS OF THE INFRASTRUCTURE ARE REQUIRED TO ENSURE THE CONFIG REMAINS FUNCTIONAL.")
26+
System.out.println("WARNING:")
27+
System.out.println("WARNING: PLEASE GET IN CONTACT WITH THE NF-CORE COMMUNITY VIA SLACK (#configs CHANNEL) OR EMAIL (https://nf-co.re/join) ASAP")
28+
System.out.println("WARNING: TO ALLOW CONTINUED USE OF YOUR CONFIG WITH NF-CORE PIPELINES")
29+
System.out.println("WARNING:")
30+
System.out.println("WARNING: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!")
31+
}.call()
32+
}
33+
34+
spack {
35+
enabled = true
36+
}
37+
38+
singularity {
39+
enabled = true
40+
cacheDir = params.singularityDir
41+
}
42+
43+
process {
44+
resourceLimits = [
45+
memory: 750.GB,
46+
cpus: 24,
47+
time: 168.h
48+
]
49+
beforeScript = "exec \$( spack load --sh singularity )"
50+
executor = "slurm"
51+
}
52+

docs/wustl_htcf.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# nf-core/configs: WUSTL High Throughput Computing Facility Configuration
2+
3+
Forked from the prince configuration.
4+
5+
<!-- https://github.com/nf-core/configs/blob/master/docs/prince.md -->
6+
7+
## nf-core pipelines that use this repo
8+
9+
All nf-core pipelines that use this config repo (which is most), can be run on the HTCF. **Before** running a pipeline for the first time, go into an interactive slurm session on a compute node (`srun --pty --time=02:00:00 -c 2`), as the docker images for the pipeline will need to be pulled and converted.
10+
11+
Now, run the pipeline of your choice with `-profile wustl_htcf`. This will download and launch `wustl_htcf.config` which has been pre-configured with a setup suitable for the HTCF 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. This step **takes time**!!
12+
An example commandline:
13+
14+
```bash
15+
nextflow run nf-core/<pipeline name> -profile wustl_htcf <additional flags>
16+
```
17+
18+
## nf-core pipelines that do not use this repo
19+
20+
If the pipeline has not yet been configured to use the nf-core/configs repository, then you will have to do it manually. Add the following lines to the end of the pipeline's `nextflow.config`
21+
22+
```bash
23+
// Allow the use of nf-core/configs configuration files
24+
includeConfig "https://raw.githubusercontent.com/nf-core/configs/master/nfcore_custom.config"
25+
```

nfcore_custom.config

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -466,6 +466,9 @@ profiles {
466466
wehi {
467467
includeConfig "${params.custom_config_base}/conf/wehi.config"
468468
}
469+
wustl_htcf {
470+
includeConfig "${params.custom_config_base}/conf/wustl_htcf.config"
471+
}
469472
xanadu {
470473
includeConfig "${params.custom_config_base}/conf/xanadu.config"
471474
}

0 commit comments

Comments
 (0)