Skip to content

Commit 642d2a8

Browse files
committed
Update docs
1 parent 7df162f commit 642d2a8

File tree

1 file changed

+26
-1
lines changed

1 file changed

+26
-1
lines changed

docs/usage.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -303,7 +303,7 @@ By default, the input GTF file will be filtered to ensure that sequence names co
303303
## Contamination screening options
304304

305305
:::note
306-
Not currently available using ARM architecture ('-profile arm')
306+
The `--contaminant_screening` option is not currently available using ARM architecture ('-profile arm')
307307
:::
308308

309309
The pipeline provides the option to scan unaligned reads for contamination from other species using [Kraken2](https://ccb.jhu.edu/software/kraken2/), with the possibility of applying corrections from [Bracken](https://ccb.jhu.edu/software/bracken/). Since running Bracken is not computationally expensive, we recommend always using it to refine the abundance estimates generated by Kraken2.
@@ -364,6 +364,26 @@ genome: 'GRCh37'
364364

365365
You can also generate such `YAML`/`JSON` files via [nf-core/launch](https://nf-co.re/launch).
366366

367+
### Running on Linux ARM architectures
368+
369+
The pipeline can be executed in an ARM compatible mode by specifying the ARM profile, for example:
370+
371+
```bash
372+
nextflow run \
373+
nf-core/rnaseq \
374+
--input <SAMPLESHEET> \
375+
--outdir <OUTDIR> \
376+
--gtf <GTF> \
377+
--fasta <GENOME FASTA> \
378+
-profile docker,arm
379+
```
380+
381+
This will use ARM-compatible containers, and apply a small number of overrides to Conda definitions to support ARM operation.
382+
383+
:::warning
384+
Please note that the ARM profile is experimental. It is expected to function correctly in all cases unless explicitly indicated otherwise—currently, exceptions include the use of the hisat2 aligner and contaminant screening via kraken2. However, because testing is presently conducted manually, we cannot guarantee its reliability.
385+
:::
386+
367387
### Updating the pipeline
368388

369389
When you run the above command, Nextflow automatically pulls the pipeline code from GitHub and stores it as a cached version. When running the pipeline after this, it will always use the cached version if available - even if the pipeline has been updated since. To make sure that you're running the latest version of the pipeline, make sure that you regularly update the cached version of the pipeline:
@@ -428,8 +448,13 @@ If `-profile` is not specified, the pipeline will run locally and expect all sof
428448
- A generic configuration profile to enable [Wave](https://seqera.io/wave/) containers. Use together with one of the above (requires Nextflow ` 24.03.0-edge` or later).
429449
- `conda`
430450
- A generic configuration profile to be used with [Conda](https://conda.io/docs/). Please only use Conda as a last resort i.e. when it's not possible to run the pipeline with Docker, Singularity, Podman, Shifter, Charliecloud, or Apptainer.
451+
- `arm`
431452
- A configuration profile that will set `docker.runOptions` appropriately for ARM architectures, and apply overrides supplying ARM-compatible containers and Conda environments.
432453

454+
:::warning
455+
Please note that the ARM profile is experimental. It is expected to function correctly in all cases unless explicitly indicated otherwise—currently, exceptions include the use of the hisat2 aligner and contaminant screening via kraken2. However, because testing is presently conducted manually, we cannot guarantee its reliability.
456+
:::
457+
433458
### `-resume`
434459

435460
Specify this when restarting a pipeline. Nextflow will use cached results from any pipeline steps where the inputs are the same, continuing from where it got to previously. For input to be considered the same, not only the names must be identical but the files' contents as well. For more info about this parameter, see [this blog post](https://www.nextflow.io/blog/2019/demystifying-nextflow-resume.html).

0 commit comments

Comments
 (0)