Skip to main content

A tool for intersection and visualization of multiple genomic region sets

Project description

https://badge.fury.io/py/intervene.svg https://img.shields.io/github/issues/asntech/intervene.svg https://img.shields.io/pypi/dm/intervene.svg https://img.shields.io/twitter/url/https/github.com/asntech/intervene.svg?style=social

Introduction

Intervene is a tool for intersection and visualization of multiple gene or genomic region sets.

Read detailed **documentation** here

http://intervene.readthedocs.io/en/latest/_images/Intervene_plots.png

Installation

Intervene requires the following Python modules and R packages:

Install BEDTools

We are using pybedtools, which is Python wrapper for BEDTools. So, BEDTools should be installed before using Intervene. It’s recomended to have a latest version, but if you have an older version already install, it should be fine. Please read the instructions at https://github.com/arq5x/bedtools2 to install BEDTools, and make sure it is on your path and you are able to call bedtools from any directory.

Install required Python modules

Intervene takes care of the installation of all the required Python modules. If you already have a working installation of Python, the easiest way to install Intervene is by using pip. If you’re setting up Python for the first time, we recommend to install it using Anaconda Python distribution http://continuum.io/downloads. These come with several helpful scientific and data processing libraries. These are available for platforms including Windows, Mac OSX and Linux.

Install required R packages

Intervene rquires two R packages, UpSetR https://cran.r-project.org/package=UpSetR and corrplot https://cran.r-project.org/package=corrplot for visualization.

install.packages(c("UpSetR", "corrplot"))

Install Intervene

You can install a stable version of Intervene by using pip from PyPi or a development version by using git from GitHub.

Install using pip

You can install InterVene either from PyPi using pip or install it from the source. Please make sure you have already installed the above mentioned python libraries required to run InterVene.

Install from PyPi:

pip install intervene

Install development version from GitHub

If you have git installed, use this:

git clone https://github.com/asntech/intervene.git
cd intervene
python setup.py install

How to use Intervene

Once you have installed Intervene, you can type:

intervene --help

usage: intervene <subcommand> [options]

positional arguments <subcommand>:
  {venn,upset,pairwise}
                        List of subcommands
    venn                Venn diagram of intersection of genomic regions or list sets (upto 6-way).
    upset               UpSet diagram of intersection of genomic regions or list sets.
    pairwise            Pairwise intersection and heatmap of N genomic region sets in <BED/GTF/GFF> format.

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit

to see the help for the three subcommands pairwise, venn and upset type:

intervene pairwise --help

intervene venn --help

intervene upset --help

Run Intervene on test data

To run Intervene using example data use the following command:

intervene pairwise --test

intervene venn --test

intervene upset --test

This will save the results in the current working directory with a folder named Intervene_results. If you wish to save the results in a specific folder, you can type:

intervene upset --test --output ~/path/to/your/folder

Support

If you have questions, or found any bug in the program, please write to us at aziz.khan[at]ncmm.uio.no

Cite Us

If you use Intervene please cite us: Khan A. and Mathelier A., Intervene: a tool for intersection and visualization of multiple genomic region sets

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

intervene-0.5.1.tar.gz (5.5 MB view details)

Uploaded Source

File details

Details for the file intervene-0.5.1.tar.gz.

File metadata

  • Download URL: intervene-0.5.1.tar.gz
  • Upload date:
  • Size: 5.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for intervene-0.5.1.tar.gz
Algorithm Hash digest
SHA256 30009e038613af97466c792d3d61e4513a879f78af59e1f38e3df84f09c5ae01
MD5 c2db4555846a10ef20fe875bffc6af2b
BLAKE2b-256 ec11cc95aea8d4df2b873f909111968ba6d3fc84dc9f25304a5e554d6d2708e7

See more details on using hashes here.

Supported by

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