Skip to content
Python library for processing and visualizing Hi-C data
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
figures Update HiCtool_GM12878_HEK293T_1mb_observed.png May 21, 2019
tutorial . May 21, 2019
.DS_Store . May 21, 2019 Update May 20, 2019

HiCtool: a standardized pipeline to process and visualize Hi-C data (v2.1)

HiCtool is an open-source bioinformatic tool based on Python, which integrates several software to perform a standardized Hi-C data analysis, from the processing of raw data, to the visualization of heatmaps and the identification of topologically associated domains (TADs).

Table of Contents


We implemented a tool that is divided into three main sections:

  • Data preprocessing
  • Data normalization and visualization
  • TAD analysis

HiCtool leads the user step-by-step through a pipeline, which goes from the raw Hi-C data to the computation, visualization, and optimized storage of contact matrices (intra- and inter-chromosomal) and TAD coordinates.

HiCtool can implement contact data normalization following two approaches:

  • The explicit-factor correction method reported by Yaffe and Tanay and performed by the library HiFive. In this case, only intra-chromosomal analysis is performed, per each chromosome singularly and only single heatmaps can be plotted. In addition, there is the possibility to plot topological domains over the heatmap at a resolution of 40kb or lower.
  • The matrix balancing approach performed by Hi-Corrector. In this case, a global analysis is performed including all the chromosomes and both intra- and inter-chromosomal maps. It is possible to visualize either single intra- and inter-chromosomal heatmap or the global all-by-all chromosomes heatmap (for the global heatmap visualization, resolution could be limited by your hardware). In addition, there is the possibility to plot topological domains over the intra-chromosomal heatmap (resolution of 40kb or lower) or plot the same maps from different samples on a side-by-side view for easy comparison.


HiCtool is in a pipeline format based on single unix commands to allow easy usage. In order to use HiCtool, you need to install the following Python libraries, packages and software. Everything is open source. After that, you need the HiCtool source codes. Click here to download HiCtool, unzip the file, all the scripts are under the folder scripts. Hi-Corrector source code is already inside this folder.

1. Python libraries [for python>2.7]:

2. Python packages:

3. Other software:


We have compiled a full tutorial to show the usage of the pipeline. Please check the Tutorial Homepage.

Version history

May 20, 2019

  • Version 2.1 released:

    • HiCtool is now based only on unix commands. A Python script is given which contains utility functions for I/O of files generated with HiCtool in the Python console.
    • The entire pre-processing is now performed with a single-command.
    • Possibility of processing Hi-C data generated with a cocktail of restriction enzymes (i.e. as in the Arima Kit) or with restriction enzymes including "N" in their sequence.
    • HiCtool includes now additional species besides hg38 and mm10: hg19, mm9, dm6, susScr3, susScr11.
    • New function to visualize heatmaps from different samples or conditions on a side-by-side view for comparison.
    • Small bug fixes.

March 28, 2019

  • Version 2.0 released:

    • HiCtool code is now hosted on GitHub.
    • Added inter-chromosomal analysis and visualization.
    • Included an additional global normalization method based on a matrix balancing approach.
    • New function to plot the all-by-all chromosomes global contact matrix.
    • Possibility of saving contact matrices in tab separated format.
    • Possibility of plotting topological domains over the heatmaps.
    • Small bug fixes.

December 2015 - October 2018

  • The initial release of HiCtool v1.0 came out in late 2015. GITAR manuscript (including HiCtool) published in October 2018.


HiCtool was developed by Riccardo Calandrelli and Qiuyang Wu from Dr. Sheng Zhong's Lab at University of California, San Diego.

If you use HiCtool, please cite the paper:

Calandrelli, R., Wu, Q., Guan, J., & Zhong, S. (2018). GITAR: An open source tool for analysis and visualization of Hi-C data. Genomics, proteomics & bioinformatics.


For issues related to the use of HiCtool or if you want to report a bug, please contact Riccardo Calandrelli at

You can’t perform that action at this time.