Skip to content

Commit afd39a8

Browse files
committed
adding helpful presets for viruses and especially for sars-cov-2 that will vastly simplify running our 90% use case
1 parent be7cc5f commit afd39a8

29 files changed

+1401
-61
lines changed

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,8 @@
5959
!/conf/nanopore_tests
6060
!/conf/illumina_tests/*.config
6161
!/conf/nanopore_tests/*.config
62+
!/conf/presets
63+
!/conf/presets/*.config
6264
!/conf/*.config
6365
!/conf/*.yml
6466
!/conf/*.yaml

README.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33

44

55
- [Overview](#overview)
6+
- [Analysis Presets](#analysis-presets)
67
- [Quick Start](#quick-start)
78
- [Detailed Setup Instructions](#detailed-setup-instructions)
89
- [Configuration](#configuration)
@@ -57,6 +58,29 @@ nextflow run nrminor/oneroof \
5758

5859
If you want to use Apptainer containers instead of Docker, just add `-profile apptainer` to either of the above `nextflow run` commands. And if you don’t want to use containers at all, simply run `pixi shell --frozen` to bring all the pipeline’s dependencies into scope and then add `-profile containerless` to your `nextflow run` command.
5960

61+
### Analysis Presets
62+
63+
For common use cases, `oneroof` provides analysis presets that pre-configure databases for metagenomics and decontamination. Presets can be combined with execution profiles:
64+
65+
```bash
66+
# General viral analysis with Docker
67+
nextflow run nrminor/oneroof -profile virus,docker \
68+
--refseq my_ref.fasta \
69+
--illumina_fastq_dir my_reads/
70+
71+
# SARS-CoV-2 analysis (includes Nextclade)
72+
nextflow run nrminor/oneroof -profile sarscov2,docker \
73+
--refseq my_ref.fasta \
74+
--illumina_fastq_dir my_reads/
75+
```
76+
77+
Available presets:
78+
79+
| Preset | Description |
80+
|--------|-------------|
81+
| `virus` | General viral metagenomics: Sylph IMG/VR 4.1 database (2.9M viral genomes) + panhuman decontamination index |
82+
| `sarscov2` | SARS-CoV-2 analysis: inherits `virus` preset + Nextclade SARS-CoV-2 dataset for clade assignment |
83+
6084
For power users working with a local clone of the repository, we also provide the `oneroof` CLI—a friendly command-line interface with organized help, input validation, and easy resume functionality. See the [OneRoof CLI](#oneroof-cli-power-users) section below for details.
6185

6286
## Quick Start
@@ -201,6 +225,19 @@ oneroof resume
201225

202226
# Run test profiles (no --refseq needed)
203227
oneroof run --profile illumina_test_with_primers
228+
229+
# Use analysis presets for common workflows
230+
oneroof run \
231+
--refseq my_ref.fasta \
232+
--illumina-fastq-dir my_reads/ \
233+
--preset virus \
234+
--profile docker
235+
236+
# Presets can also be specified directly in --profile
237+
oneroof run \
238+
--refseq my_ref.fasta \
239+
--illumina-fastq-dir my_reads/ \
240+
--profile sarscov2,docker
204241
```
205242

206243
The CLI generates and executes standard Nextflow commands under the hood, so all Nextflow features (caching, resume, etc.) work as expected.

0 commit comments

Comments
 (0)