Metadata-Version: 2.1
Name: plothic
Version: 0.3.4
Summary: Plot whole genome contact heatmap
Author: Zijie Jiang
Author-email: jzjlab@163.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: hic-straw (>=1.3.1,<2.0.0)
Requires-Dist: matplotlib (>=3.9.2,<4.0.0)
Requires-Dist: numpy (>=2.1.1,<3.0.0)
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: scikit-learn (>=1.5.2,<2.0.0)
Requires-Dist: scipy (>=1.14.1,<2.0.0)
Requires-Dist: six (>=1.16.0,<2.0.0)
Project-URL: Documentation, https://github.com/Jwindler/PlotHiC
Project-URL: Homepage, https://github.com/Jwindler/PlotHiC
Project-URL: Repository, https://github.com/Jwindler/PlotHiC
Description-Content-Type: text/markdown

# PlotHiC

`PlotHiC`  is used to visualize global interaction heatmaps after genome scaffolding.

**If you have any questions, please [Open Issues](https://github.com/Jwindler/PlotHiC/issues/new) or provide us with your comments via the email below.**

Email: [jzjlab@163.com](mailto:jzjlab@163.com)



## Content 


- [PlotHiC](#plothic)
  - [Content](#content)
  - [Installation](#installation)
    - [pip](#pip)
  - [Usage](#usage)
    - [Input file](#input-file)
    - [example](#example)
    - [other parameter](#other-parameter)
    - [Color map](#color-map)
  - [Citations](#citations)





## Installation

- Dependency : `python = "^3.10"`

### pip

```bash
# pip install 
pip install plothic

```



## Usage

### Input file

- `genome.hic`

This file is taken directly from `3d-dna`, you need to select the final `hic` file (which has already been error adjusted and chromosome boundaries determined).



- `chr.tx`

1. This file is used for heatmap labeling. The first column is the name of the chromosome.
2. The second column is the length of the chromosome (this length is the length of the hic file in Juicebox and can be manually determined from Juicebox). 
3. The third column is the order in which the chromosomes are placed, which is used to customize the arrangement of chromosomes (for example, from max to min).

**Note:** the length is in .hic file, not true base length.

```sh
# name length index
Chr1 24800000 5
Chr2 44380000 4
Chr3 63338000 3
Chr4 81187000 2
Chr5 97650000 1
```



### example

- **Default order**

```sh
plothic -hic genome.hic -chr chr.txt -r 100000

# -hic > .hic file 
# -chr > chromosome length (in .hic file)
# -r > resolution to visualization
```

![](https://s2.loli.net/2024/12/30/RaTqyHziYbFJDOM.png)



- **Custom order**

```sh
plothic -hic genome.hic -chr chr.txt -r 100000 --order

# -hic > .hic file 
# -chr > chromosome length (in .hic file)
# -r > resolution to visualization
# --order > 
```

![](https://s2.loli.net/2024/12/30/Dbu6Wmjq9zUK8dG.png)



### other parameter

![](https://s2.loli.net/2024/11/18/dmuXrbsB9DRhlyt.png)



### Color map

**PlotHiC** uses `YlOrRd` by default, you can choose more colors from [Matplotlib](https://matplotlib.org/stable/users/explain/colors/colormaps.html).

![](https://s2.loli.net/2024/11/13/MYZe56Vy2BT1tDp.png)



## Citations

**If you used PlotHiC in your research, please cite us:**

```sh
Zijie Jiang, Zhixiang Peng, Zhaoyuan Wei, Jiahe Sun, Yongjiang Luo, Lingzi Bie, Guoqing Zhang, Yi Wang, A deep learning-based method enables the automatic and accurate assembly of chromosome-level genomes, Nucleic Acids Research, 2024;, gkae789, https://doi.org/10.1093/nar/gkae789
```

