Skip to main content

Variant annotator for MToolBox.

Project description

mtoolnote

Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.

Variant annotator for MToolBox.

Features

mtoolnote can annotate mitochondrial variants from:

  • human genomes, using data stored in a local database derived from HmtVar;
  • non-human genomes, using data from BioMart.
    • Currently, only the following species are supported: oaries, ptroglodytes, scerevisiae
      ecaballus, fcatus, cfamiliaris, pabelii, ggallus, mmulatta, rnorvegicus, btaurus, oanatinus, sscrofa, nleucogenys, chircus, mmusculus, tguttata, tnigroviridis, mgallopavo, mdomestica, drerio

Usage

Once installed, mtoolnote offers a CLI command and a Python function to annotate both human and non-human VCF files.

Human mitochondrial variant annotation

Using the CLI:

$ mtoolnote INPUT_VCF OUTPUT_VCF

where INPUT_VCF and OUTPUT_VCF represent file paths. Use the --csv flag option to create an annotated CSV file in addition to the VCF output.

Using the Python module:

import mtoolnote
mtoolnote.annotate("input.vcf", "output.vcf")

Use the csv=True option to create an annotated CSV file in addition to the VCF output.

Non-human mitochondrial variant annotation

Using the CLI:

$ mtoolnote INPUT_VCF OUTPUT_VCF SPECIES

where SPECIES indicates the sample species, one of oaries, ptroglodytes, scerevisiae, ecaballus, fcatus, cfamiliaris, pabelii, ggallus, mmulatta, rnorvegicus, btaurus, oanatinus, sscrofa, nleucogenys, chircus, mmusculus, tguttata, tnigroviridis, mgallopavo, mdomestica, drerio. Use the --csv flag option to create an annotated CSV file in addition to the VCF output.

Using the Python module:

import mtoolnote
mtoolnote.annotate("input.vcf", "output_vcf", "species")

Use the csv=True option to create an annotated CSV file in addition to the VCF output.

Installation

After cloning this repo, cd in it and install mtoolnote using:

$ python setup.py install
# in case this does not work:
$ pip install -r requirements.txt
$ pip install .

or in development mode:

$ pip install -r requirements_dev.txt
$ pip install -e .

Testing

After installation, run all tests with:

$ pytest

or the full suite (tests using python3.6, python3.7, flake8) with:

$ tox

Credits

This package was created with Cookiecutter and the cc-pypackage project template.

History

0.1.0 (2019-08-27)

  • First development release.

0.1.1 (2019-09-02)

  • Add option to create csv from annotated vcf file.

0.1.2 (2019-09-17)

  • Fix requirements;
  • Relocate local database for human annotation.

0.1.3 (2019-09-25)

  • Add multi-threading processing for non-human annotations (fix #1).

0.1.4 (2019-11-30)

  • Add haplogroup-specific allele frequencies to final annotations (fix #4);
  • Add external predictors to final annotations (fix #5).

Project details


Release history Release notifications

Download files

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

Files for mtoolnote, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size mtoolnote-0.1.4-py2.py3-none-any.whl (8.0 MB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size mtoolnote-0.1.4.tar.gz (8.0 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page