Giter VIP home page Giter VIP logo

clinvap's Introduction

Pipeline Logo

Release: Github https://www.singularity-hub.org/static/img/hosted-singularity--hub-%23e32929.svg Docker: Available License: MIT

Clinical Variant Annotation Pipeline

Clinical Variant Annotation Pipeline (ClinVAP) creates a genetic report of somatic mutations from a variant call format (VCF) file. Please refer this document for implementation of the pipeline. Documentation of the pipeline is available at Wiki page.

Usage with Singularity

Requirements: Singularity 2.4+
Please make sure that you have 12 GB of empty space on your home directory, and ports 5000 and 27021 are not being used by another application. To run the pipeline, please follow the steps given below.

  1. Pull reporting image from Singularity Hub. singularity pull -n reporting_app.img shub://PersonalizedOncology/ClinVAP:report
  2. Pull dependency files image from Singularity Hub. singularity pull -n file_deploy.img shub://PersonalizedOncology/ClinVAP:filedeploy
  3. Run dependency files image first to transfer those file on your local folder. singularity run -B /LOCAL/PATH/TO/FILES:/mnt file_deploy.img
  4. Run the reporting image to generate the clinical reports. singularity run -B /LOCAL/PATH/TO/FILES:/data -B /PATH/TO/INPUT/DATA:/inout reporting_app.img -t /inout -p jwp

You should now have the report in your /PATH/TO/INPUT/DATA folder.

Usage with Docker

For Mac and Ubuntu Users

Requirements: Docker Engine release 1.13.0+, Compose release 1.10.0+.
Please make sure that you have 34 GB of physical empty space on your Docker Disk Image, and ports 5000 and 27017 are not being used by another application.

To tun the pipeline, please follow the steps given below.

1. git clone https://github.com/PersonalizedOncology/ClinVAP.git

Pelase note that the input VCF file(s) should be in ReportingApplication/inout folder.

2. cd ClinVAP/
3. docker-compose run --service-ports ClinicalReportR -t /inout -p jwp

  • -t: folder name containing input data. This should be in the data volume of ClinicalReportR service (modify Docker compose file to change this).
  • -p: output format to save the results.
    • j to save report in JSON format
    • w to save report in DOCX format
    • p to save report in PDF format

You should now have the report in ReportingApplication/inout folder.

Running with Docker Toolbox For Windows Users

Requirements: Docker Engine release 1.13.0+, Compose release 1.10.0+.
Please make sure that you have 34 GB of physical empty space on your Docker Disk Image, and ports 5000 and 27017 are not being used by another application.

To tun the pipeline, please follow the steps given below.

1. git clone https://github.com/PersonalizedOncology/ClinVAP.git

Pelase note that the input VCF file(s) should be in ReportingApplication/inout folder.

2. cd ClinVAP/
3. docker-compose run --service-ports ClinicalReportR -t //inout -p jwp

  • -t: folder name containing input data. This should be in the data volume of ClinicalReportR service (modify Docker compose file to change this).
  • -p: output format to save the results.
    • j to save report in JSON format
    • w to save report in DOCX format
    • p to save report in PDF format

You should now have the report in ReportingApplication/inout folder.

Demo Run

We provided an example input file, strelka_passed_missense_somatic_snvs.vcf under ./ReportingApplication/inout folder along with a dummy metadata file, strelka_passed_missense_somatic_snvs.json. The corresponding report of the strelka input file is provided here as an example.

Running Demo with Singularity

1. git clone https://github.com/PersonalizedOncology/ClinVAP.git
2. singularity pull -n reporting_app.img  shub://PersonalizedOncology/ClinVAP:report
3. singularity pull -n file_deploy.img  shub://PersonalizedOncology/ClinVAP:filedeploy
4. mkdir vep_files
5. singularity run -B ./vep_files:/mnt file_deploy.img
6. singularity run -B ./vep_files:/data -B ./ClinVAP/ReportingApplication/inout:/inout reporting_app.img -t /inout -p jwp

Running Demo with Docker

1. git clone https://github.com/PersonalizedOncology/ClinVAP.git
2. cd ClinVAP/
3. docker-compose run --service-ports ClinicalReportR -t /inout -p jwp

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.