dantaki / Sv2

Support Vector Structural Variation Genotyper

A genotyper for the rest of us

Danny Antaki, William M Brandler, Jonathan Sebat; SV²: Accurate Structural Variation Genotyping and De Novo Mutation Detection from Whole Genomes, Bioinformatics, , btx813, https://doi.org/10.1093/bioinformatics/btx813

SV² filters and integrates structural variants from multiple calling algorithms. Given multiple samples, SV² creates a genotype matrix. SV² also provides annotations for genes, repeat elements, and common SVs for filtering post-genotyping.

Table of Contents

• User Guide
  • Tutorial
• Getting Started
  • Installation
• Input
• Output
• Training
• Performance
• Requirements
• Citing SV²
• Troubleshooting
• License
• Contact

SV² (support-vector structural-variant genotyper) is a machine learning algorithm for genotyping deletions and duplications from paired-end whole genome sequencing data. SV² can rapidly integrate variant calls from multiple SV discovery algorithms into a unified callset with high genotyping accuracy and detection of de novo mutations.

User Guide

Tutorial

Getting Started

1️⃣ Installation

Install with pip Recommended

$ pip install sv2 

2️⃣ Configure SV²

# download required resource files
$ sv2 -download

# define fasta locations
$ sv2 -hg19 /full/path/to/hg19.fa [-hg38 hg38.fa -mm10 mm10.fa] 

3️⃣ Run SV²

$ sv2 -i in.bam -v sv.vcf -snv in.vcf.gz -p in.ped

📓 SV² Options Documentation

Input

SV² requires BAM/CRAM files, SVs to genotype, SNV VCF files, and PED files.

$sv2 -i <in.bam ...> -v <sv.vcf ...> -b <sv.bed ...> -snv <snv.vcf.gz ...> -p <fam.ped ...> 

Documentation for required inputs:

• Input files

• BED format

• VCF format

Output

Output is generated in the current working directory by default.

$ sv2 ... -O <output path prefix>

• sv2_preprocessing/ contains preprocessing output

• sv2_features/ feature extraction output

• sv2_genotypes/ genotype output

Output VCF contains annotations for genes and filters

• SV² can merge divergent breakpoints. By default this option is off.

• 📓 Merging Documentation

Training

Advanced users can retrain SV² genotyping classifiers with the original or custom training set.

📓 Training Documentation

Performance

SV² estimated runtime performance. Details

SV² performance was determined with independent evaluation cohorts. Genotypes were validated with Illumina 2.5M microarrays and PacBio single molecule sequencing.

Performance of de novo mutations

Please refer to the publication for performance details.

Requirements

• python 2.7

  • cython
  • numpy
  • pandas
  • pybedtools
  • pysam 0.9+
  • scikit-learn v0.19+

• bedtools 2.25.0 or later

📓 Usage Documentation

Citing SV²

Danny Antaki, William M Brandler, Jonathan Sebat; SV²: Accurate Structural Variation Genotyping and De Novo Mutation Detection from Whole Genomes, Bioinformatics, , btx813, https://doi.org/10.1093/bioinformatics/btx813

Link to Article

Troubleshooting

License

MIT License

Copyright (c) 2017 Danny Antaki

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contact

📫 [email protected] 🤘