trinyeg/virmine

virMine 2.0

Novel viral species genomes – particularly those in high abundance – have been able to be identified directly from complex community viral metagenomes. Discovery of such viral genomes often relies heavily on manual curation and prior studies have employed a variety of different criteria when sifting through sequencing data. In an effort to provide a comprehensive means for the discovery of complete viral genomes from complex sequence data sets, we developed the tool virMine. Input can be either: (1) raw sequencing reads from short-read sequencing technologies or (2) long-read sequences or assembled contigs. Short-reads are processed and assembled. These assembled short-reads or supplied long-reads/contigs are then annotated, and individual contigs are scored based upon their likelihood of being viral in origin. Several filters have been implemented, allowing researchers to refine their search for their specific study system. virMine can be used to identify viruses in any niche and thus further our understanding of this vast reservoir of genetic diversity.

Getting Started

Option 1:

Clone Project from GitHub

git clone https://github.com/putonti/virmine.git

Move paired-end fastq files, as well as the viral and nonviral databases, to the inputFiles folder prior to building the docker image.

sudo docker build --tag virmine:latest virmine

sudo docker run -v ~/pathToLocalFolder/virmine:/virmineDockerOutputFolder -i -t virmine

Option 2:

Docker Hub Link: https://hub.docker.com/repository/docker/genevievej16/virmine

docker pull genevievej16/virmine:latest

Move paired-end fastq files, as well as the viral and nonviral databases, to your local designated output folder prior to running the docker image. While in the docker you will access the input files from the virmineDockerOutputFolder rather than from the inputFiles folder.

sudo docker run -v ~/pathToLocalFolder/virmine:/virmineDockerOutputFolder -i -t genevievej16/virmine

Prerequisites

Docker is the only prerequisite for this program to run, all other dependencies are handled by the Dockerfile. If any section of the program causes an error or is unable to run, check that you have enough memory in your Docker resources.

virMine Command Options

Either short-reads, long-reads, or assembled contigs can be provided. For short-reads:

• -a : choose your assembler (spades, metaspades, megahit, all3)
• -p : paired-end reads
• -s : single-end reads For long-reads or assembled contigs
• -A : list your long-read/contig assembly file

Required parameters:

• -v : list your viral database
• -nv : list your nonviral database
• -o : make an output file

Optional filter parameters:

• -m : minimum contig size
• -M : maximum contig size
• -c : minimum coverage
• -cov : minimum SPAdes coverage
• -g : includes genes of interest (parameter supplies protein sequences for these genes)

Additional parameters:

• -t : number of threads
• -b : blast option ['blastx' or 'blastp'] ('blastp' is faster)

Example Run with Paired-End Reads:

python3 virMine.py -a spades -p inputFiles/R1.fastq inputFiles/R2.fastq -v inputFiles/viral_aa.fasta -nv inputFiles/nonviral_aa.fasta -o virmineDockerOutputFolder/output

Example Run with Long-reads or Assembled Contigs:

python3 virMine.py -A inputFiles/assembled_contigs.fasta -v inputFiles/viral_aa.fasta -nv inputFiles/nonviral_aa.fasta -o virmineDockerOutputFolder/output

Test Data

Artificial paired-end reads of E. coli K12 (NC_000913.3) and Escherichia phage Lambda (J02459.1).

Example Command to Run Test Data:

python3 virMine.py -a all3 -p testFiles/test_data_R1.fastq testFiles/test_data_R2.fastq -v inputFiles/viral_aa.fasta -nv inputFiles/nonviral_aa.fasta -o virmineDockerOutputFolder/testOutput

Example Output

Running the test data using the option of all 3 assembly methods should result in 3 contigs (final_contigs.fasta), with 1 of those contigs being classified as viral (viral_contigs.fasta). Other output files include all predicted ORFs, the viral ORFs only, and all BLAST output files.

Further Details:

Further details about this tool can be found in Garretto et al. PeerJ 2019 (https://peerj.com/articles/6695/). A manuscript describing the upgrades implemented as part of v2.0 is currently under review.

Authors

• Andrea Garretto
• Thomas Hatzopoulos
• Genevieve Johnson
• Catherine Putonti

License

This project is licensed under the terms of the MIT License