Skip to content

Commit

Permalink
updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
mattheww95 committed Oct 19, 2023
1 parent 5ba894b commit 580dfd9
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 1 deletion.
2 changes: 2 additions & 0 deletions docs/subworkflows/annotate_genomes.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@
1. **Genome annotation** is performed using [Bakta](https://github.com/oschwengers/bakta) [Bakta](bakta_annotate.nf), you must download a Bakta database and add its path to the `nextflow.config` file or add its path as a command line option. To skip running Bakta add `--skip_bakta true` to your command line options.
2. **Screening for antimicrobial resistance** with **Abricate**. [Abricate](https://github.com/tseemann/abricate) is used with the default options and default database, however you can specify a database by updating the `args` in the `nextflow.config` for Abricate. You can also skip running Abricate by adding `--skip_abricate true` to your command line options.
3. **Screening for plasmids** is performed using [Mob-suite](https://github.com/phac-nml/mob-suite) with default options.
2. **Selection of Pointfindr database**. This step is only ran if running [StarAMR](https://github.com/phac-nml/staramr). It will try and select the correct database based on the species identified earlier in the pipeline. If a database cannot be determined pointfinder will simply not be run.
3. **Exporting of StarAMR databases used**. The database info from StarAMR will be exported from the pipeline into a file and copied into the StarAMR directory **so that you can** validate the correct database has been used.
4. **Screening for antimicrobial resistance** with **StarAMR**. [StarAMR](https://github.com/phac-nml/staramr) is provided as an additional option to screen for antimicrobial resistance in ResFinder, PointFinder and PlasmidFinder databases. Passing in a database is optional as the one within the container will be used by default.

>NOTE:
Expand Down
30 changes: 29 additions & 1 deletion docs/usage/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ Numerous steps within mikrokondo can be turned off without compromising the stab
- `skip_mobrecon`
- This step allows you to skip running mob-suite recon on your data.
- `skip_starmar`
- This step allows you to skip running staramr on your data.
- This step allows you to skip running StarAMR on your data.

** All of the above options can be turned on by entering `--{skip_option} true` in the command line arguments to the pipeline (where optional parameters can be added)** e.g. To skip read sub-sampling add to the command line arguments `--skip_depth_sampling true`

Expand Down Expand Up @@ -520,6 +520,34 @@ Unicycler is an option provided for hybrid assembly, it is a great option and ou
- threads_increase_factor: Factor to increase the number of threads passed to Unicycler. Do not alter this field unless doing pipeline development.


### Mob-suite Recon
mob-suite recon provides annotation of plasmids in you data.

- mobsuite_recon
- singularity: The singularity container containing mob-suite recon.
- docker: The Docker container containing mob-suite recon.
- **args**: Additional arguments to pass to mobsuite.
- fasta_ext: The file extension for FASTAs. Do not alter this field unless doing pipeline development.
- results_ext: The file extension for results in mob-suite. Do not alter this field unless doing pipeline development.
- mob_results_file: The final results to be included in the final report by mob-suite. Do not alter this field unless doing pipeline development.
- report_tag: The field name of mob-suite data in the final report. Do not alter this field unless doing pipeline development.
- header_p: Default is `true` and indicates that the results output by mob-suite contains a header. Do not alter this field unless doing pipeline development.

## StarAMR
StarAMR provides annotation of antimicrobial resistance genes within your data. The process will alter FASTA headers of input files to ensure the header length <50 characters long.

- staramr
- singularity: The singularity container containing staramr.
- docker: The Docker container containing starmar.
- **db**: The database for StarAMR. The default value of `null` tells the pipeline to use the database included in the StarAMR container. However you can specify a path to a valid StarAMR datbase and use that instead.
- tsv_ext: File extension of the reports from StarAMR. Do not alter this field unless doing pipeline development.
- txt_ext: File extension of the text reports from StarAMR. Do not alter this field unless doing pipeline development.
- xlsx_ext: File extension of the excel spread sheet from StarAMR. Do not alter this field unless doing pipeline development.
- **args**: Additional arguments to pass to StarAMR. Do not alter this field unless doing pipeline development.
- point_finder_dbs: A list containing the valid databases StarAMR supports for pointfinder. The way they are structured matches what StarAMR needs for input. Do not alter this field unless doing pipeline development. Do not alter this field unless doing pipeline development.
- report_tag: The field name of StarAMR in the final summary report. Do not alter this field unless doing pipeline development.
- header_p: Indicates the final report from StarAMR contains a header line. Do not alter this field unless doing pipeline development.

### Bakta
Bakta is use to provide annotation of genomes, it is very reliable but it can be slow.

Expand Down

0 comments on commit 580dfd9

Please sign in to comment.