Sovereign 8s.is mirror of standardgalactic/HiC_pipeline
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-03 21:21:39 +08:00
demo ready for distribution 2018-09-16 20:53:37 -04:00
docs added the phasing module 2024-07-10 20:52:10 +08:00
runHiC fixed several bugs 2026-07-03 21:10:50 +08:00
scripts fixed several bugs 2026-07-03 21:10:50 +08:00
.DS_Store fixed several bugs 2026-07-03 21:10:50 +08:00
.gitattributes 👾 Added .gitattributes 2014-12-16 10:26:45 +08:00
LICENSE Add LICENSE 2015-07-16 09:18:52 +08:00
MANIFEST.in New version, ready for test 2018-09-14 11:12:46 -04:00
README.rst v0.8.7 2023-01-19 14:19:03 +08:00
setup.py fixed a package name normalization bug 2026-07-03 21:21:39 +08:00

runHiC
******
.. image:: https://zenodo.org/badge/doi/10.5281/zenodo.55324.svg
   :target: http://dx.doi.org/10.5281/zenodo.55324
.. image:: https://static.pepy.tech/personalized-badge/runhic?period=total&units=international_system&left_color=black&right_color=orange&left_text=Downloads
   :target: https://pepy.tech/project/runhic

runHiC is an easy-to-use command-line tool for Hi-C data processing.

Since version 0.8.6, runHiC has supported data from all kinds of 3C-based experiments,
including Hi-C, Micro-C, HiChIP/PLAC-Seq, and ChIA-PET. For experiments that do not use
restriction enzymes for DNA fragmentation, you can set the enzyme name arbitrarily for your
record. For example, for Micro-C, you can set it to *MNase*; for ChIA-PET, you can set it to
*sonication*.

Since version 0.8.5, runHiC has changed the default aligner to `chromap <https://github.com/haowenz/chromap>`_,
which is comparable to `bwa-mem <https://github.com/lh3/bwa>`_ in alignment accuracy, but runs over 10 times faster.

Since version 0.8.1, runHiC can be used directly on `Arima HiC <https://arimagenomics.com>`_ data
by setting the enzyme name to *Arima*.

Since version 0.8.0, runHiC has changed its default data container/format from HDF5 to
`Pairs <https://github.com/4dn-dcic/pairix/blob/master/pairs_format_specification.md>`_ and
`Cooler <https://github.com/mirnylab/cooler>`_. 

Design Concepts
===============
runHiC is designed to process Hi-C data from raw sequencing reads(.sra, .fastq, .fastq.gz) to the ICE-corrected
contact matrices. It currently contains 5 subcommands:

+------------+-------------------------------------------------------------------------------------------------------------------+
| mapping    | Map raw sequencing reads to a supplied genome. Support three read aligners: chromap, bwa and minimap2.            |
+------------+-------------------------------------------------------------------------------------------------------------------+
| filtering  | Perform read-level and fragment-level noise removing                                                              |
+------------+-------------------------------------------------------------------------------------------------------------------+
| binning    | 1.Generate contact matirx; 2. Perform ICE/matrix-balancing normalization                                          |
+------------+-------------------------------------------------------------------------------------------------------------------+
| pileup     | Perform the entire processing steps from *mapping* to *binning*                                                   |
+------------+-------------------------------------------------------------------------------------------------------------------+
| quality    | Evaluate the quality of your Hi-C data                                                                            |
+------------+-------------------------------------------------------------------------------------------------------------------+

Links
=====
- `Detailed Documentation <http://xiaotaowang.github.io/HiC_pipeline/>`_
    - `Installation <http://xiaotaowang.github.io/HiC_pipeline/install.html>`_
    - `Quick Start <http://xiaotaowang.github.io/HiC_pipeline/quickstart.html>`_
    - `Data Quality <http://xiaotaowang.github.io/HiC_pipeline/quality.html>`_
    - `Parallel Computation <http://xiaotaowang.github.io/HiC_pipeline/parallel.html>`_
- `Code Repository <https://github.com/XiaoTaoWang/HiC_pipeline/>`_ (At GitHub, Track the package issue)
- `PyPI <https://pypi.python.org/pypi/runHiC>`_ (Download and Installation)

Usage
=====
Open a terminal, type ``runHiC -h`` or ``runHiC <subcommand> -h`` for help information.

Citation
========
Xiaotao Wang. (2016). runHiC: A user-friendly Hi-C data processing software based on hiclib. Zenodo.
`10.5281/zenodo.55324 <http://dx.doi.org/10.5281/zenodo.55324>`_