Skip to content
/ trackc Public

trackc aims to produce beautiful genome tracks that are highly customizable

License

Notifications You must be signed in to change notification settings

seqyuan/trackc

Repository files navigation

trackc

Track view of chromosome conformation and multi-omics data

trackc is a python package for flexible visualization of rearrangement 3D genome and multi-omics data. It builds on top of matplotlib, which allows for flexible adjustments.

trackc's key applications

  • Mark the abnormal interaction formed by the structural variation of the genome.
  • Show the 3Dgenome interaction and multi-omics data after rearrangement.
  • Flexible and convenient layout for multi-track

Available track types

tracks
track functions Description
Hi-C heatmap tl.extractContactRegions, tl.extractCisContact, mapC support multi-regions and reverse regions
mark regions on heatmap mapc_markline support multi-regions and reverse regions, mark square line on mapc heatmap
Virtual4C Virtual4C support multi-regions and reverse regions
loop links links_track support multi-regions and reverse regions
bed bed_track support multi-regions and reverse regions, styles[bar, line, rectangle, triangle, link] to show ChIP-seq peak or ATAC-seq peaks, TAD domains, SVs bed or begGraph
bigwig bigwig_track support multi-regions and reverse regions
bedgraph matrix bdgmat_track support multi-regions and reverse regions, styles [heatmap, line]
zoomin visualization zoomin support multi-regions and reverse regions
gene annotation gene_track support multi-regions and reverse regions
scale bar scale_track genome position scale
multi scale bar multi_scale_track support multi-regions and reverse regions
high light some position or regions vhighlight support multi-regions and reverse regions

Here is an example of du_dynamic_2022 article diagram implemented by trackc.

gallery_rearranged_interactions.png

Installation

PyPI

Install trackc by running:

pip install trackc

Development version

To install trackc from GitHub, run:

pip install git+https://github.com/seqyuan/trackc@main

Usage

trackc support both api and cli. Here is a cli example:

trackc cli conf.yml

neo-domain.png

conf.yml content

trackc:
  - ax: l1
    height: 1.25
    track_type: hicmap
    track_para:
      mat:
        method: extractContactRegions
        clr: ./github/seqyuan/trackc_data/examples/BxPC3.chr18.mcool::/resolutions/25000
        balance: False
        row_regions:
          - 18:47400000-48280000
          - 18:75280000-74030000
      mapC:
        map_type: tri
        label: neo tad
        cmap: PuBu
        height: 40
        ax_on: False
        maxrange: 200
        minrange: 10

  - ax: l2
    height: 0.5
    track_type: bw_track
    track_para:
      bw: ./github/seqyuan/trackc_data/examples/GSM3178671_BxPC3_H3K27ac.bigwig
      regions:
        - 18:47400000-48280000
        - 18:75280000-74030000
      label: H3K27ac
      binsize: 2000
      color:
        - '#5B7695'
  - ax: l3
    height: 0.4
    track_type: multi_scale_track
    track_para:
      regions:
        - 18:47400000-48280000
        - 18:75280000-74030000
      scale_adjust: Mb
      intervals: 2
      tick_fontsize: 7

  - ax: l4
    height: 2.8
    track_type: gene_track
    track_para:
      bed12: ./github/seqyuan/trackc_data/examples/hg19_chr18.gene.bed12
      regions:
        - 18:47400000-48280000
        - 18:75280000-74030000
      line: 12
      gene_fontszie: 8

Documentation

Our documentation provide the full list of possible track types and gallary guidelines for users.

Extensive documentations are available at https://trackc.readthedocs.io

Citation

If you use trackc in your analysis, Please cite trackc as follows:

trackc: a package for flexible visualization of rearrangement 3D genome and multi-omics data