annotate SalmID/README.md @ 7:87c7eebc6797

planemo upload
author jpayne
date Fri, 07 Jun 2019 15:48:15 -0400
parents fae43708974d
children
rev   line source
jpayne@1 1 [![DOI](https://zenodo.org/badge/97020646.svg)](https://zenodo.org/badge/latestdoi/97020646)
jpayne@1 2
jpayne@1 3 # SalmID
jpayne@1 4 Rapid tool to check taxonomic ID of single isolate samples. Currently only IDs Salmonella species and subspecies, and some common contaminants (Listeria, Escherichia).
jpayne@1 5
jpayne@1 6 ## Requirements:
jpayne@1 7 Python 3
jpayne@1 8
jpayne@1 9 ## Installation:
jpayne@1 10 The easy way with homebrew ([Linux](http://linuxbrew.sh/) or [MacOS](https://brew.sh/)):
jpayne@1 11 ```
jpayne@1 12 brew install brewsci/bio/salmid
jpayne@1 13 ```
jpayne@1 14 Big thanks to [Torsten Seemann](https://tseemann.github.io/) for including this in homebrew!
jpayne@1 15
jpayne@1 16 Alernatively git clone to your machine:
jpayne@1 17 ```
jpayne@1 18 git clone --recursive https://github.com/hcdenbakker/SalmID.git
jpayne@1 19 ```
jpayne@1 20
jpayne@1 21 Make SalmID executable:
jpayne@1 22 ```
jpayne@1 23 cd SalmID
jpayne@1 24 ```
jpayne@1 25
jpayne@1 26 ```
jpayne@1 27 chmod +x SalmID.py
jpayne@1 28 ```
jpayne@1 29
jpayne@1 30
jpayne@1 31 Add the SalmID folder to your path
jpayne@1 32
jpayne@1 33 To execute:
jpayne@1 34 ```
jpayne@1 35 SalmID.py -e .fastq.gz
jpayne@1 36 ```
jpayne@1 37 This will perform a SalmID run on all fastq.gz files in the current directory.
jpayne@1 38 ```
jpayne@1 39 SalmID.py -i your_fastq_gz.fastq.gz
jpayne@1 40 ```
jpayne@1 41 This will perform a SalmID run on an individual file (i.e., your_fastq_gz.fastq.gz)
jpayne@1 42 ```
jpayne@1 43 SalmID.py -d directory_with_data -e _1.fastq.gz
jpayne@1 44 ```
jpayne@1 45 This will perform a SalmID run on all files in directory 'directory_with_data' with extension '_1.fastq.gz'
jpayne@1 46
jpayne@1 47 ## Todo's and thoughts for future releases:
jpayne@1 48 - Provide coverage estimates for genomes in sample based on kmer frequencies
jpayne@1 49 - Write code to use SalmID on long read (minion, pacbio) platforms