From 4d36d2012aa9dd8736c9bf76ed342d18370a290b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81ine=20O=27Toole?= Date: Tue, 6 Feb 2024 13:20:27 +0000 Subject: [PATCH] Update README.md --- README.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index d6a938a..5d44725 100644 --- a/README.md +++ b/README.md @@ -10,13 +10,13 @@ Piranha is a tool developed to help standardise and streamline sequencing of pol Any issues or feedback about the analysis or report please flag to this repository. -## Note: piranha has been tested primarily on poliovirus VP1 sequencing data. There are alternative analysis modes in development (e.g. whole genome, panEV), but the authors recommend additional QC checks if using piranha beyond its established poliovirus VP1 pipeline. +> Note: piranha has been tested primarily on poliovirus VP1 sequencing data. There are alternative analysis modes in development (e.g. whole genome, panEV), but the authors recommend additional QC checks if using piranha beyond its established poliovirus VP1 pipeline. -## See example report [here](https://polio-nanopore.github.io/piranha/report.html) +## Example report [here](https://polio-nanopore.github.io/piranha/report.html) -## See example data [here](https://github.com/polio-nanopore/piranha/tree/main/test_data) +## Example data [here](https://github.com/polio-nanopore/piranha/tree/main/test_data) ## Installing via PIRANHA GUI @@ -30,7 +30,7 @@ Piranha does not require use of the command-line to run. Users can access piranh [![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/piranha-polio/README.html) -## Installation instructions (quick command line reference) +## Installation instructions (quick) >You need to have Git, a version of conda (link to Miniconda [here](https://docs.conda.io/en/latest/miniconda.html)) and mamba installed to run the following commands. @@ -182,7 +182,7 @@ Piranha is also available now on bioconda and can be installed with -## Quick usage +# Quick usage `piranha -i -b ` @@ -243,6 +243,8 @@ This is what piranha will look for. Point the software to the directory containi

+# Configuration + ## Input configuration Piranha has been preconfigured with defaults specific to the VP1 protocol developed by the [Polio Sequencing Consortium](https://www.protocols.io/workspaces/poliovirus-sequencing-consortium). All command line arguments (full list below) can be configured either as command line flags when running piranha, or as snakecase arguments in a yaml config file (which can then be supplied with the `-c` flag). Snakecase formatting separates works with an underscore, i.e. `my_argument`. @@ -407,7 +409,7 @@ and piranha will check which ones you have installed with your version of medaka >```Where a version of Guppy has been used without an exactly corresponding medaka model, the medaka model with the highest version equal to or less than the guppy version should be selected.``` -## Process enterovirus sequences +## Process enterovirus sequences **\*NEW FEATURE\*** Piranha now has the flexibility to cluster sequencing reads by a specified reference group field (`-rg / --reference-group-field`, or `reference_group_field` in a config file). By default, this field is set to `ddns_group` and any records in the reference file must contain this as an annotation in the header description. The reference file that is supplied with piranha contains this field in all records and the values fall into the following categories: @@ -467,7 +469,7 @@ piranha -c config.ev.yaml ``` -## Experimental haplotype calling pipeline +## Experimental haplotype calling pipeline **\*NEW FEATURE\*** There is now an experimental haplotype calling pipeline that uses freebayes for initial variant calling and flopp for read phasing with the called variants. It has a number internal QC steps for merging identical haplotypes. This pipeline requires further validation, but can theoretically produce multiple consensus sequences for each poliovirus population present within a sample. The pipeline has mostly be tested on VDPVs of two mixtures, but will be further assessed.