A platform to visualize and analyze genome contact maps
Project description
.. _browser: http://gcmapexplorer.readthedocs.io/en/latest/mapBrowser.html
.. _genome contact map: http://gcmapexplorer.readthedocs.io/en/latest/about_gcmap_file.html
.. _genomic track datasets: http://gcmapexplorer.readthedocs.io/en/latest/about_h5_file.html
.. _Normalization of contact maps: http://gcmapexplorer.readthedocs.io/en/latest/cmapNormalization.html
.. _convert bigWig/wig/bed file to genomic track dataset h5 file: http://gcmapexplorer.readthedocs.io/en/latest/about_h5_file.html#convert-bigwig-wig-bed-to-genomic-track-h5-file
.. image:: https://travis-ci.org/rjdkmr/gcMapExplorer.svg?branch=master
:target: https://travis-ci.org/rjdkmr/gcMapExplorer
Genome Contact Map Explorer - gcMapExplorer
===========================================
It is a platform to visualize and analyze the contact maps that are generated from Hi-C experiments. This package is developed by considering the huge size of contact maps at very fine resolution. It contains
* Graphical user interface - Several windows like applications to perform tasks (See below tables).
* Command Line Interface - Several commands to perform tasks (See below tables).
* `Application Programming Interface <http://gcmapexplorer.readthedocs.io/en/latest/apidoc/summary.html>`_
- It can be used to perform analysis by any mathematical operations through programming.
**For more details, visit:** `gcMapExplorer Homepage <http://gcmapexplorer.readthedocs.io/>`_
**For Discussion and Questions, visit** `this forum <https://groups.google.com/forum/#!forum/gcmapexplorer>`_
Features
--------
* Support for **huge contact maps** - Use of Disk instead of RAM - Matrices/arrays are stored in Disks -
mathematical operations by directly reading/writing from/to Disks, **without loading them into RAM**
* A browser_ with rich interfaces
for **Comparative** and **Interactive** visualization of **two dimensional contact maps** along
with **genomic datasets** such as produced by DNase-seq, ChIP-seq, RNA-seq etc.
* Contact maps can be **zoomed in/out** from finest resolution to whole chromosome level.
* Rich customizations of **color scale for contact maps** visualization
* Rich customizations of **X- and Y- axis properties**.
* **Save visualization states and view-points** for later browsing
* `Normalization of contact maps`_ by
* **Iterative Correction** (IC)
* **Knight-Ruiz Matrix Balancing** (KR)
* **Vanilla-Coverage** (VC)
* **Distance-Frequency**
* A **new file format** based on HDF5 for `genome contact map`_ and `genomic track datasets`_.
* **Portable**, **platform independent** and can be read through C/C++, JAVA, Python and R programming language.
* **Very fast to read** - fast browsing of contact maps and genomic datasets
* Another file format for `chromosomal contact map <http://gcmapexplorer.readthedocs.io/en/latest/about_ccmap_file.html>`_
- much faster than above format to read/write but not compact. Suitable for performing calculations.
* `A GUI interface and commands <http://gcmapexplorer.readthedocs.io/en/latest/about_gcmap_file.html#convert-hi-c-data-to-gcmap>`_
to convert Coordinate Sparse, Pair Coordinate Sparse, HOMER Interaction matrix, Bin-Contact formats into the new gcmap and ccmap formats.
* Command `to convert juicebox/juicer hic format to gcmap <<http://gcmapexplorer.readthedocs.io/en/latest/commands/hic2gcmap.html>`_.
* Interface and commands to `convert bigWig/wig/bed file to genomic track dataset h5 file`_.
* Interface and commands for `Normalization of contact maps`_.
* Publication ready images at one click.
Citation
--------
Rajendra Kumar, Haitham Sobhy, Per Stenberg and Ludvig Lizana.
`Genome Contact Map Explorer - A platform for the comparison, interactive visualization and analysis of genome contact maps. <https://doi.org/10.1093/nar/gkx644>`_
*Nucleic Acids Res.* (2017).
Interfaces and Commands
-----------------------
Usage
-----
Run ``gcMapExplorer`` command on terminal to get list of all sub-commands.
**Following sub-commands are available:**
.. list-table:: Graphical User Interface Applications
:widths: 1, 4
:header-rows: 1
:name: gui-table
* - Command
- Function
* - browser_
- Interactive Browser for genomic contact maps
* - `cmapImporter <http://gcmapexplorer.readthedocs.io/en/latest/commands/cmapImporter.html>`_
- Interface to import contact maps and datasets
* - `cmapNormalizer <http://gcmapexplorer.readthedocs.io/en/latest/commands/cmapNormalizer.html>`_
- Interface to normalize contact maps
* - `h5Converter <http://gcmapexplorer.readthedocs.io/en/latest/commands/h5Converter.html>`_
- Interface to convert bigWig/wig/bed file to h5 file
.. list-table:: Commands to import Hi-C data
:widths: 1, 4
:header-rows: 1
:name: import-hic-command-table
* - Command
- Function
* - `coo2cmap <http://gcmapexplorer.readthedocs.io/en/latest/commands/coo2cmap.html>`_
- Import COO sparse matrix format to ccmap or gcmap
* - `pairCoo2cmap <http://gcmapexplorer.readthedocs.io/en/latest/commands/pairCoo2cmap.html>`_
- Import map from files similar to paired COO format
* - `homer2cmap <http://gcmapexplorer.readthedocs.io/en/latest/commands/homer2cmap.html>`_
- Import HOMER Hi-C interaction matrix to ccmap or gcmap
* - `bc2cmap <http://gcmapexplorer.readthedocs.io/en/latest/commands/bc2cmap.html>`_
- Import Bin-Contact format files to ccmap or gcmap
* - `hic2gcmap <http://gcmapexplorer.readthedocs.io/en/latest/commands/hic2gcmap.html>`_
- Import hic to gcmap
.. list-table:: Commands to convert bigWig/wig/bed to h5
:widths: 1, 4
:header-rows: 1
:name: convert-to-h5-file-table
* - Command
- Function
* - `bigwig2h5 <http://gcmapexplorer.readthedocs.io/en/latest/commands/bigWig2h5.html>`_
- Convert a bigWig file to HDF5 format h5 file
* - `wig2h5 <http://gcmapexplorer.readthedocs.io/en/latest/commands/wig2h5.html>`_
- Convert a wig file to HDF5 format h5 file
* - `bed2h5 <http://gcmapexplorer.readthedocs.io/en/latest/commands/bed2h5.html>`_
- Convert a bed file to HDF5 format h5 file
* - `encode2h5 <http://gcmapexplorer.readthedocs.io/en/latest/commands/encode2h5.html>`_
- Download and convert ENCODE datasets to HDF5 format h5 files
.. list-table:: Commands to normalize Hi-C map
:widths: 1, 4
:header-rows: 1
:name: normalize-maps-table
* - Command
- Function
* - `normKR <http://gcmapexplorer.readthedocs.io/en/latest/commands/normKR.html>`_
- Normalization using Knight-Ruiz matrix balancing
* - `normVC <http://gcmapexplorer.readthedocs.io/en/latest/commands/normVC.html>`_
- Normalization using Vanilla-Coverage method
* - `normIC <http://gcmapexplorer.readthedocs.io/en/latest/commands/normIC.html>`_
- Normalization using Iterative Correction
* - `normMCFS <http://gcmapexplorer.readthedocs.io/en/latest/commands/normMCFS.html>`_
- Scale maps using Median/Mean Contact Frequency
.. list-table:: Commands for Analysis
:widths: 1, 4
:header-rows: 1
* - Command
- Function
* - corrBWcmaps
- Calculate correlation between contact maps
.. list-table:: Configuration utility
:widths: 1, 4
:header-rows: 1
* - Command
- Function
* - `config <http://gcmapexplorer.readthedocs.io/en/latest/commands/config.html>`_
- To print configuration file and clean scratch directory
Command help
------------
Run ``gcMapExplorer <sub-commands> -h`` command.
For example:
* ``gcMapExplorer normKR -h``
* ``gcMapExplorer coo2cmap -h``
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gcMapExplorer-1.0.29.tar.gz
(658.3 kB
view hashes)
Built Distributions
Close
Hashes for gcMapExplorer-1.0.29-cp36-cp36m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 29e2cb58959084035107be0ee10d1342b0b1ac16d65ab246007497e5364cd18b |
|
MD5 | f9bae1f0e4e4571f5606a7364b73b791 |
|
BLAKE2b-256 | a9b2ef87cd892436e7cb2e25acdd19e01799fdd7c5f67dc37165c99d4216ec6e |
Close
Hashes for gcMapExplorer-1.0.29-cp36-cp36m-macosx_10_13_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 247b227c1cf4bb32fb99a68efeed66cdd0c933939e20172b21237c14ca99a3f5 |
|
MD5 | d8ff8b6f6ba75f35f887384bcec61894 |
|
BLAKE2b-256 | 8b8652cef5c4f80f325b4d5128986d991e41b587133eab4fcba59fecf7eaef90 |
Close
Hashes for gcMapExplorer-1.0.29-cp35-cp35m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2ec339022ec185c059671524a9b35640e441e83fc8cf9f64a2cf577d76f1b840 |
|
MD5 | 79272313614542293e044b884aac0f85 |
|
BLAKE2b-256 | 5422c0282e78a3bc5098c3ed3313822bfa0ff345f845ec0c4b5cf3bd6d3087c8 |
Close
Hashes for gcMapExplorer-1.0.29-cp35-cp35m-macosx_10_13_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f591bd1600b3127bb915a087a9e3563b1260ef24639a48dc99ad21344fa6fa2e |
|
MD5 | 2ed2269221080789f1dd0190de87afee |
|
BLAKE2b-256 | 74e756daeffc49e80d90045963ed7dbe71005625ca697ff7a5af179f81a438ad |
Close
Hashes for gcMapExplorer-1.0.29-cp34-cp34m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ddd11a120fb7a8f7310111fb09d20e43c161f8d6096fce5bb3d682ee1fcf18c0 |
|
MD5 | 9673a7b0d9a492f07c7574206f935611 |
|
BLAKE2b-256 | 6d989739b0ad8ac82d4bc253307c45609abbfa2b80ecaa8effffa3e5b3d023c9 |
Close
Hashes for gcMapExplorer-1.0.29-cp34-cp34m-macosx_10_13_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d513ee6ec4a4f5fb26c564a5b47066bfa498de7489a704b39b05f7bcf9ee2462 |
|
MD5 | 51dc711822d80be5d4f6c968311e39a6 |
|
BLAKE2b-256 | a7bf59025dc4cde42081ccd38b3f00fd0a5d1694f31458a078b2038fdafe0c6b |