__
oooooo     oooo oo                    88  88                    .o8o.  oo  ooo
 `888.     .8'  `'                   88 ss 88                   88 `"  `'  `88
  `888.   .8'  ooo  ooood8b  o888o    88__88   ooooo8b  o888o  o88o   ooo   88   .oooo.  ooooo8b
   `888. .8'   `88   88""8P d8' `8b     ||      88""8P d8' `8b  88    `88   88  d8'  `8b  88""8P
    `888.8'     88   88     88   88    _||_     88     88   88  88     88   88  888ooo88  88
     `888'      88   88     88   88  // || \\   88     88   88  88     88   88  88    .o  88
      `8'      o88o o88b     o888o  //      \\ d88b     o888o  o88o   o88o o88o `Y8bd8P' 088b

ViroProfiler is a bioinformatics best-practice analysis pipeline for viral metagenomics data analyses.

The pipeline is built using Nextflow, a workflow tool to run tasks across multiple compute infrastructures in a very portable manner. It uses Docker/Singularity containers making installation trivial and results highly reproducible.

1. Install Miniconda3.

2. Install Nextflow and Singularity using conda:

   # You may need to restart your terminal before running the following commands
   conda install -c conda-forge -c bioconda nextflow singularity

3. Download the pipeline and database.

   # setup database
   nextflow run deng-lab/viroprofiler -r main -profile singularity --mode "setup"

4. Run the pipeline,

   # run test
   nextflow run deng-lab/viroprofiler -r main -profile singularity,test
   
   # run your own data
   nextflow run deng-lab/viroprofiler -r main -profile singularity --input samplesheet.csv

5. Update the pipeline,

   nextflow pull deng-lab/viroprofiler

   Please refer to the tutorial for more information on how to run the pipeline with customized parameters and options.

Please refer to the documentation.

If you would like to contribute to this pipeline, please see the contributing guidelines.

For further information or help, please open an issue.

If you use ViroProfiler for your analysis, please cite the publication as follows:

Jinlong Ru, Mohammadali Khan Mirzaei, Jinling Xue, Xue Peng, Li Deng. ViroProfiler: a containerized bioinformatics pipeline for viral metagenomic data analysis. Gut Microbes (2023); doi: https://doi.org/10.1080/19490976.2023.2192522

An extensive list of references for the tools and data used by the pipeline can be found in the CITATIONS.md file. If you use ViroProfiler for your work, please cite the relevant references.