Skip to content
Python library for processing and visualizing Hi-C data
Python C Shell Roff Makefile
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.

HiCtool: a standardized pipeline to process and visualize Hi-C data (v2.1.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.


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.

Version history

July 25, 2019

  • Version 2.1.1 released:

    • Optimized pre-processing and normalization to allow the analysis of very high depth sequenced files.
    • Added parameter to allow custom mapped reads filtering at the pre-processing step.
    • Bedpe file generation step added for pre-processed read pairs.
    • Deduplication step added in the pre-processing pipeline.
    • Optimized and faster FEND file generation for adding GC content and mappability score.
    • Small bug fixes.

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.


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.