Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
aineniamh authored Feb 6, 2024
1 parent deae910 commit 4d36d20
Showing 1 changed file with 9 additions and 7 deletions.
16 changes: 9 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
<img src="./docs/piranha.svg" width="400">

## 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
Expand All @@ -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.
Expand Down Expand Up @@ -182,7 +182,7 @@ Piranha is also available now on bioconda and can be installed with



## Quick usage
# Quick usage

`piranha -i <demultiplexed read directory> -b <path/to/barcodes.csv>`

Expand Down Expand Up @@ -243,6 +243,8 @@ This is what piranha will look for. Point the software to the directory containi
<br>
<br>

# 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`.
Expand Down Expand Up @@ -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:

Expand Down Expand Up @@ -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.

Expand Down

0 comments on commit 4d36d20

Please sign in to comment.