Viola is a flexible and powerful python package designed specifically for analysis of genomic structural variant (SV) signatures. We provide following tools for SV signature analysis:
- Custom SV classification tool
- Feature matrix generator
- SV signature extractor (NMF) with stability evaluation system.
In addition to these, Viola offers a number of other useful utilities, including:
- VCF filter that accepts genomic coordinates and INFO/FORMAT columns.
- VCF merging tool with user-defined thresholds.
- Breakends-to-breakpoint converter with SVTYPE inference.
- Microhomology inference.
- VCF-to-BEDPE conversion.
- Command line tools for light users.
Currently, Viola supports four popular SV callers as input VCF files:
- Manta
- Delly
- Lumpy
- Gridss
In the future, we plan to support more SV callers!
The package can be installed with pip:
$ pip install viola-svTo import Viola in your script, simply run below:
import violaCommand line tools:
$ viola <command> [something]Python version 3.6 or newer.
- OS
- Linux
- Mac
- Script Manager
- Jupyter Notebook/Jupyter Lab
- Google Colaboratory
Docker support is coming soon!
As a first step we recommend the Quick Start page where you can see the basic behaviour of Viola. A good second step is to read the Signature Analysis Tutorial page.
For command line interfaces, see CLI tutorial.
If you want to get a deeper understanding of how Viola objects are structured, how filtering works and how merging works, please refer to the User Guide.
Manuals for individual classes/methods/functions are available in the API Reference.
For further discussion, please join our google group! We're waiting for your comments, ideas, and requests. The questions about how to use Viola-SV are also welcome!
Sugita, I., Matsuyama, S., Dobashi, H., Komura, D. & Ishikawa, S. Viola: a structural variant signature extractor with user-defined classifications. Bioinformatics (2021) doi:10.1093/bioinformatics/btab662.