|
3 | 3 |
|
4 | 4 |
|
5 | 5 | - [Overview](#overview) |
| 6 | + - [Analysis Presets](#analysis-presets) |
6 | 7 | - [Quick Start](#quick-start) |
7 | 8 | - [Detailed Setup Instructions](#detailed-setup-instructions) |
8 | 9 | - [Configuration](#configuration) |
@@ -57,6 +58,29 @@ nextflow run nrminor/oneroof \ |
57 | 58 |
|
58 | 59 | 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. |
59 | 60 |
|
| 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 | + |
60 | 84 | 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. |
61 | 85 |
|
62 | 86 | ## Quick Start |
@@ -201,6 +225,19 @@ oneroof resume |
201 | 225 |
|
202 | 226 | # Run test profiles (no --refseq needed) |
203 | 227 | 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 |
204 | 241 | ``` |
205 | 242 |
|
206 | 243 | The CLI generates and executes standard Nextflow commands under the hood, so all Nextflow features (caching, resume, etc.) work as expected. |
|
0 commit comments