Metadata-Version: 2.1
Name: mitoviz
Version: 0.2.3
Summary: Plot variants on the human mitochondrial genome.
Home-page: https://github.com/robertopreste/mitoviz
Author: Roberto Preste
Author-email: robertopreste@gmail.com
License: MIT license
Description: =======
        mitoviz
        =======
        
        
        .. image:: https://img.shields.io/pypi/v/mitoviz.svg
                :target: https://pypi.python.org/pypi/mitoviz
        
        .. image:: https://www.repostatus.org/badges/latest/wip.svg
            :alt: Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.
            :target: https://www.repostatus.org/#wip
        
        .. image:: https://travis-ci.com/robertopreste/mitoviz.svg?branch=master
                :target: https://travis-ci.com/robertopreste/mitoviz
        
        .. image:: https://codecov.io/gh/robertopreste/mitoviz/branch/master/graph/badge.svg
            :target: https://codecov.io/gh/robertopreste/mitoviz
        
        .. image:: https://readthedocs.org/projects/mitoviz/badge/?version=latest
                :target: https://mitoviz.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. image:: https://pyup.io/repos/github/robertopreste/mitoviz/python-3-shield.svg
             :target: https://pyup.io/repos/github/robertopreste/mitoviz/
             :alt: Python 3
        
        
        Plot variants on the human mitochondrial genome.
        
        
        * Free software: MIT license
        * Documentation: https://mitoviz.readthedocs.io
        * GitHub repo: https://github.com/robertopreste/mitoviz
        
        
        Features
        ========
        
        mitoviz is a simple python package to plot human mitochondrial variants on a graphical
        representation of the human mitochondrial genome. It currently supports plotting variants
        stored in a VCF file.
        
        Variants are shown according to their heteroplasmic fraction (HF), plotting variants with
        HF = 1.0 on the outer border of the mitochondrial circle, those with HF = 0.0 on the inner
        border and all the others according to their actual HF value.
        
        .. image:: /images/sample_hf.png
          :alt: Mitochondrial plot with HF
        
        If the HF information is not available, variants will all be shown in the middle of the
        mitochondrial circle.
        
        .. image:: /images/sample.png
          :alt: Mitochondrial plot without HF
        
        Usage
        =====
        
        mitoviz can be used both from the command line and as a python module.
        
        Command Line
        ------------
        
        Given a VCF file with human mitochondrial variants (``sample.vcf``), plotting them is fairly
        simple::
        
            $ mitoviz sample.vcf
        
        An image named ``mitoviz.png`` will be created in the current directory.
        
        If you want to provide a specific filename where the plot will be saved, just add the ``--output``
        option with the desired path::
        
            $ mitoviz sample.vcf --output my_mt_plot.png
        
        If the provided VCF file contains more than one sample, a separate plot will be created for each
        of them; if you want to plot only a specific sample, use the ``--sample`` option::
        
            $ mitoviz multisample.vcf --sample SRR1777294
        
        Python Module
        -------------
        
        Import mitoviz and use its ``plot_vcf`` function to use it in your own script::
        
            from mitoviz import plot_vcf
        
            my_plot = plot_vcf("sample.vcf")
        
        In this case, no plot will be shown until a call to ``plt.show()`` is made. It is possible to
        save the resulting plot using the ``save`` option and to provide a specific file where the plot will be
        saved using the ``output`` option::
        
            from mitoviz import plot_vcf
        
            plot_vcf("sample.vcf", save=True, output="my_mt_plot.png")
        
        If the provided VCF file contains more than one sample, a separate plot will be created for each
        of them; if you want to plot only a specific sample, use the ``sample`` option::
        
            from mitoviz import plot_vcf
        
            plot_vcf("multisample.vcf", save=True, sample="SRR1777294")
        
        Please refer to the Usage_ section of the documentation for further information.
        
        Installation
        ============
        
        **PLEASE NOTE: HmtNote only supports Python >= 3.6!**
        
        The preferred installation method for mitoviz is using ``pip``::
        
            $ pip install mitoviz
        
        Please refer to the Installation_ section of the documentation for further information.
        
        Credits
        =======
        
        This package was created with Cookiecutter_ and the `cc-pypackage`_ project template.
        
        .. _Cookiecutter: https://github.com/audreyr/cookiecutter
        .. _`cc-pypackage`: https://github.com/robertopreste/cc-pypackage
        .. _Usage: https://mitoviz.readthedocs.io/en/latest/usage.html
        .. _Installation: https://mitoviz.readthedocs.io/en/latest/installation.html
        
        
        =======
        History
        =======
        
        0.1.0 (2019-12-27)
        ==================
        
        * First release.
        
        0.2.0 (2019-12-29)
        ==================
        
        * Add functionality to plot multiple samples.
        
        0.2.1 (2020-01-06)
        ------------------
        
        * Add legend to plots and update colors.
        
        0.2.2 (2020-01-08)
        ------------------
        
        * Add option to plot variant labels.
        
        0.2.3 (2020-01-11)
        ------------------
        
        * Make legend plotting optional.
        
Keywords: mitoviz
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/x-rst
