Metadata-Version: 2.1
Name: Viola-SV
Version: 1.0.0.dev8
Summary: SV signature analysis tool with custom SV type
Home-page: https://github.com/dermasugita/Viola-SV
Author: Itsuki Sugita, Shohei Matsuyama, Hiroki Dobashi
Author-email: itsukiisogin@gmail.com
License: Apache License 2.0
Keywords: bioinformatics
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: pandas
Requires-Dist: PyVCF
Requires-Dist: intervaltree
Requires-Dist: biopython
Requires-Dist: scikit-learn
Requires-Dist: scipy
Requires-Dist: click
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'

************************
Welcom to Viola Package!
************************

| Current version: 1.0.0.dev8
| Official Document --> `here`_.

.. _here: https://dermasugita.github.io/ViolaDocs/docs/html/index.html

.. image:: https://dermasugita.github.io/ViolaDocs/docs/html/_static/Viola-logo/JPG/wide.jpg


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!

Installation
=========================

The package can be installed with ``pip``:

.. code:: console

   $ pip install viola-sv

To import Viola in your script, simply run below:

.. code:: python

   import viola

Command line tools:

.. code:: console

   $ viola <command> [something]


Prerequisites
==============

Python version 3.6 or newer.

Recommended Environment
=======================

* OS
   * Linux
   * Mac
* Script Manager
   * Jupyter Notebook/Jupyter Lab
   * Google Colaboratory

Docker support is coming soon!

How to Learn Viola
===================

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`_.

Documentation
=============

- `Quick Start`_
- `Signature Analysis Tutorial`_
- `API Reference`_

.. _Quick Start: https://dermasugita.github.io/ViolaDocs/docs/html/quickstart.html
.. _Signature Analysis Tutorial: https://dermasugita.github.io/ViolaDocs/docs/html/signature_analysis.html
.. _API Reference: https://dermasugita.github.io/ViolaDocs/docs/html/reference/index.html
.. _User Guide: https://dermasugita.github.io/ViolaDocs/docs/html/userguide/index.html
.. _CLI tutorial: https://dermasugita.github.io/ViolaDocs/docs/html/userguide/cli.html

Publications
=============

https://www.biorxiv.org/content/10.1101/2021.03.31.437648v1.full

