# Make Genome Level Trellis Graph
[](https://github.com/jokergoo/gtrellis/actions)
[](https://codecov.io/github/jokergoo/gtrellis)
[](https://bioconductor.org/packages/stats/bioc/gtrellis/)
[](https://bioconductor.org/packages/stats/bioc/gtrellis/)
[](http://bioconductor.org/packages/devel/bioc/html/gtrellis.html)
Genome level Trellis graph visualizes genomic data conditioned by genomic categories (e.g. chromosomes). For each genomic category, multiple dimensional data which are represented as tracks describe different features from different aspects. This package provides high flexibility to arrange genomic categories and to add self-defined graphics in the plot.
### Citation
Zuguang Gu, et al., [gtrellis: an R/Bioconductor package for making genome-level Trellis graphics](http://bmcbioinformatics.biomedcentral.com/articles/10.1186/s12859-016-1051-4), 2016. BMC Bioinformatics.
### Install
**gtrellis** is available on [Bioconductor](http://bioconductor.org/packages/release/bioc/html/gtrellis.html), you can install it by:
```{r}
if (!requireNamespace("BiocManager", quietly=TRUE))
install.packages("BiocManager")
BiocManager::install("gtrellis")
```
If you want the latest version, install it directly from GitHub:
```{r}
library(devtools)
install_github("jokergoo/gtrellis")
```
### Usage
Basic usage is:
```r
library(gtrellis)
bed = circlize::generateRandomBed()
gtrellis_layout(track_ylim = range(bed[[4]]))
add_track(bed, panel.fun = function(bed) {
x = (bed[[2]] + bed[[3]]) / 2
y = bed[[4]]
grid.points(x, y, pch = 16, size = unit(1, "mm"))
})
```
There are several tracks with pre-defined graphics:
- `add_points_track()`
- `add_lines_track()`
- `add_rect_track()`
- `add_segments_track()`
- `add_heatmap_track()`
### Layout
**gtrellis** supports several types of layouts:
One row layout:
Multiple row layout that chromosomes with similar length are arranged in a same column:
Chromosomes in a same row are arranged compactly to the left:
For each chromosome, multiple tracks are supported:
### Example
Example figures are:
### License
MIT @ Zuguang Gu
