Skip to main content

A Structural Variant Post-Processing Package

Project description

.. image:: http://mavis.bcgsc.ca/docs/latest/_static/acronym.svg

|

.. role:: raw-html-m2r(raw)
:format: html



.. image:: https://img.shields.io/pypi/v/mavis.svg
:target: https://img.shields.io/pypi/v/mavis.svg
:alt: PyPi

.. image:: https://travis-ci.org/creisle/mavis.svg?branch=master
:target: https://travis-ci.org/creisle/mavis.svg?branch=master
:alt: Travis

.. image:: https://readthedocs.org/projects/pip/badge/
:target: https://readthedocs.org/projects/pip/badge/
:alt: ReadTheDocs


:raw-html-m2r:`<br/>`

About
=====

`MAVIS <http://mavis.bcgsc.ca>`__ is python command-line tool for the post-processing of structural variant calls.
The general `MAVIS <http://mavis.bcgsc.ca>`__ pipeline consists of six main stages


* convert
* `cluster <http://mavis.bcgsc.ca/docs/latest/mavis.cluster.html#mavis-cluster>`_
* `validate <http://mavis.bcgsc.ca/docs/latest/mavis.validate.html#mavis-validate>`_
* `annotate <http://mavis.bcgsc.ca/docs/latest/mavis.annotate.html#mavis-annotate>`_
* `pairing <http://mavis.bcgsc.ca/docs/latest/mavis.pairing.html#mavis-pairing>`_
* `summary <http://mavis.bcgsc.ca/docs/latest/mavis.summary.html#mavis-summary>`_

Getting Help
------------

All steps in the MAVIS pipeline are called following the main mavis entry point. The usage menu can be viewed
by running without any arguments, or by giving the -h/--help option

.. code-block::

mavis -h


Help sub-menus can be found by giving the pipeline step followed by no arguments or the -h options

.. code-block::

mavis cluster -h


Common problems and questions are addressed on the `wiki <https://github.com/bcgsc/mavis/wiki/Help-and-Frequently-Asked-Questions>`_.
If you have a question or issue that is not answered there (or already a github issue) please submit
a github issue to our `github page <https://github.com/bcgsc/mavis/issues>`__ or contact us by email at `mavis@bcgsc.ca <mailto:mavis@bcgsc.ca>`_

Install Instructions
--------------------

There are 3 major steps to setting up and installing `MAVIS <http://mavis.bcgsc.ca>`_.

1. Install Aligner
^^^^^^^^^^^^^^^^^^

In addition to the python package dependencies, `MAVIS <http://mavis.bcgsc.ca>`__ also requires an aligner to be installed.
Currently the only aligners supported are `blat <http://mavis.bcgsc.ca/docs/latest/glossary.html#term-blat>`__ and `bwa mem <http://mavis.bcgsc.ca/docs/latest/glossary.html#term-bwa>`_.
For MAVIS to run successfully the aligner must be installed and accessible on the path.
If you have a non-standard install you may find it useful to edit the PATH environment variable. For example

.. code-block:: bash

export PATH=/path/to/directory/containing/blat/binary:$PATH

`blat <http://mavis.bcgsc.ca/docs/latest/glossary.html#term-blat>`__ is the default aligner. To configure MAVIS to use `bwa mem <http://mavis.bcgsc.ca/docs/latest/glossary.html#term-bwa>`__ as a default instead, use the
`MAVIS environment variables <http://mavis.bcgsc.ca/configuration.html#environment-variables>`_. Make sure to specify BOTH of the variables below to change the default aligner.

.. code-block:: bash

export MAVIS_ALIGNER='bwa mem'
export MAVIS_ALIGNER_REFERENCE=/path/to/mem/fasta/ref/file

After this has been installed MAVIS itself can be installed through `pip <https://pypi.org/project/mavis/>`_

2. Install MAVIS
^^^^^^^^^^^^^^^^

Install using pip
~~~~~~~~~~~~~~~~~

The easiest way to install `MAVIS <http://mavis.bcgsc.ca>`__ is through the python package manager, pip. If you do not have python3 installed it can be found `here <https://www.python.org/downloads>`_

Ensuring you have a recent version of pip and setuptools will improve the install experience. Older versions of pip and setuptools may have issues with obtaining some of the mavis python dependencies

.. code-block:: bash

pip install --upgrade pip setuptools

or (for Anaconda users)

.. code-block:: bash

conda update pip setuptools

If this is not a clean/new python install it may be useful to set up mavis in a `virtual python environment <https://docs.python.org/3/tutorial/venv.html>`_

Then install mavis itself

.. code-block:: bash

pip install mavis

This will install mavis and its python dependencies.

Install using Buildout
~~~~~~~~~~~~~~~~~~~~~~

Alternatively you can use the `bootstrap/buildout <http://www.buildout.org/en/latest/>`__ to install mavis into bin/mavis

.. code-block:: bash

git clone https://github.com/bcgsc/mavis.git
cd mavis
pip install zc.buildout
python bootstrap.py
bin/buildout

This will install mavis and its python dependencies into eggs inside the cloned mavis directory which can be used by simply running bin/mavis

3. Build or Download Reference Files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

After `MAVIS <http://mavis.bcgsc.ca>`__ is installed the `reference files <http://mavis.bcgsc.ca/docs/latest/mavis_input.html#reference-input-files>`__ must be generated (or downloaded) before it can be run. A simple bash script to download the hg19 reference files and generate a MAVIS environment file is provided under mavis/tools for convenience.

.. code-block:: bash

cd /path/to/where/you/want/to/put/the/files
wget https://raw.githubusercontent.com/bcgsc/mavis/master/tools/get_hg19_reference_files.sh
bash get_hg19_reference_files.sh
source reference_inputs/hg19_env.sh

Once the above 3 steps are complete `MAVIS <http://mavis.bcgsc.ca>`__ is ready to be run.
See the MAVIS `tutorial <http://mavis.bcgsc.ca/docs/latest/pipeline.html#mavis-mini-tutorial>`__ to learn about running MAVIS.

Build the Sphinx Documentation
------------------------------

.. code-block::

pip install .[docs]
sphinx-build docs/source/ html

Deploy to PyPi
--------------

Install m2r to ensure the README is converted nicely

.. code-block:: bash

pip install m2r

Install to build the egg

.. code-block:: bash

python setup.py install

Build the other distribution files

.. code-block:: bash

python setup.py sdist

Use twine to upload

.. code-block:: bash

twine upload -r pypi dist/*

Citation
--------

If you use MAVIS as a part of your project please cite

`Reisle,C. et al. (2018) MAVIS: Merging, Annotation, Validation, and Illustration of Structural variants. Bioinformatics. <https://doi.org/10.1093/bioinformatics/bty621>`_

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mavis-2.2.0.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

mavis-2.2.0-py3.6.egg (829.4 kB view details)

Uploaded Egg

File details

Details for the file mavis-2.2.0.tar.gz.

File metadata

  • Download URL: mavis-2.2.0.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.0

File hashes

Hashes for mavis-2.2.0.tar.gz
Algorithm Hash digest
SHA256 504db4d4d51f1af7c01f8c42856a8103511c120b5b2e752ec4e45244d501313c
MD5 ecd5041721f201bebfd81b9ba14dab0f
BLAKE2b-256 b1b40c87bf14a0d0b6509ea003fb28d2186d6f214e3954d21fa4361306b9f1eb

See more details on using hashes here.

File details

Details for the file mavis-2.2.0-py3.6.egg.

File metadata

  • Download URL: mavis-2.2.0-py3.6.egg
  • Upload date:
  • Size: 829.4 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.0

File hashes

Hashes for mavis-2.2.0-py3.6.egg
Algorithm Hash digest
SHA256 d8fc486479d84499250f1e5df884a3dac30d0070520867cc66a977d9723bdbd6
MD5 20473cbfe249b1ba415c02cb06690823
BLAKE2b-256 f1c5c7c53f4fe87f0d3fd9c73b89188b84dc963cee1ad15728e356b191314515

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page