Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more instructions now nextflow run. #48

Merged
merged 4 commits into from
Nov 22, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 16 additions & 4 deletions README.md
tgurbich marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -177,8 +177,12 @@ Note, that by default the script uses FASTA file names as prefixes and truncates

Running `mettannotator` with the `--help` option will pull the repository and display the help message:

> [!NOTE]
> We use the `-latest` flag with the `nextflow run` command, which ensures that the latest available version of the pipeline is pulled.
> If you encounter any issues with the `nextflow run` command, please refer to the [Nextflow documentation](https://www.nextflow.io/docs/latest/reference/cli.html#run).

```angular2html
nextflow run ebi-metagenomics/mettannotator/main.nf --help
$ nextflow run -latest ebi-metagenomics/mettannotator/main.nf --help
N E X T F L O W ~ version 23.04.3
Launching `mettannotator/main.nf` [disturbed_davinci] DSL2 - revision: f2a0e51af6

Expand Down Expand Up @@ -259,17 +263,25 @@ nextflow run ebi-metagenomics/mettannotator \
--dbs <PATH/TO/WHERE/DBS/WILL/BE/SAVED>
```

> **Warning:**
> [!WARNING]
> Please provide pipeline parameters via the CLI or Nextflow `-params-file` option. Custom config files including those
> provided by the `-c` Nextflow option can be used to provide any configuration _**except for parameters**_;
> see [docs](https://nf-co.re/usage/configuration#custom-configuration-files).

#### Running the pipeline from the source code

If the Nextflow integration with Git does not work, users can download the tarball from the releases page. After extracting the tarball, the pipeline can be run directly by executing the following command:

```bash
$ nextflow run path-to-source-code/main.nf --help
```

#### Local execution

The pipeline can be run on a desktop or laptop, with the caveat that it will take a few hours to complete depending on the resources. There is a local profile in the Nextflow config that limits the total resources the pipeline can use to 8 cores and 12 GB of RAM. In order to run it (Docker or Singularity are still required):

```bash
nextflow run ebi-metagenomics/mettannotator \
nextflow run -latest ebi-metagenomics/mettannotator \
-profile local,<docker or singulairty> \
--input assemblies_sheet.csv \
--outdir <OUTDIR> \
Expand Down Expand Up @@ -302,7 +314,7 @@ To run the pipeline using a test dataset, execute the following command:
```bash
wget https://raw.githubusercontent.com/EBI-Metagenomics/mettannotator/master/tests/test.csv

nextflow run ebi-metagenomics/mettannotator \
nextflow run -latest ebi-metagenomics/mettannotator \
-profile <docker/singularity/...> \
--input test.csv \
--outdir <OUTDIR> \
Expand Down
Loading