Incrementally Build Complex Plots using Natural Semantics

Builds complex plots, heatmaps in particular, using natural semantics. Bigger plots can be assembled using directives such as 'LeftOf', 'RightOf', 'TopOf', and 'Beneath' and more. Other features include clustering, dendrograms and integration with 'ggplot2' generated grid objects. This package is particularly designed for bioinformaticians to assemble complex plots for publication.

WHeatmap designs a set of languages and a layer system that allows arbitrary positioning of heatmaps programmatically.

It makes plotting complex heatmaps using plain English such as TopOf, RightOf and BottomLeftOf etc.

To install from github using devtools,


For example, the following complex layout

This complex layout

can be generated simply by

WHeatmap(matrix(1:12,nrow=2), cmp=CMPar('Greens'), name='a') + 
  WHeatmap(matrix(1:6,nrow=1), Beneath(pad=0.05), cmp=CMPar('Set2'), name='b') +
  WHeatmap(matrix(c(1:30,30:1),nrow=5), Beneath(pad=0.05), 'c', cmp=CMPar(cmap='jet')) +
  WHeatmap(matrix(1:24,nrow=4), RightOf('c'), 'd', cmp=CMPar('Set1')) +
  WLegendV('c', LeftOf('c', pad=0.01), yticklabel.side='l') +
  WLegendV('b', RightOf('b', width=0.1)) + 
  WLegendV('a', RightOf('a')) + 
  WHeatmap(matrix(1:100, nrow=10), RightOf('d'), cmp=CMPar('RdYlGn')) +
  WColorBarH(matrix(5:1), TopOf(), cmp=CMPar( = 'diverge_hcl')) +
  WColorBarH(matrix(50:1), TopOf(), cmp=CMPar( = 'terrain_hcl')) +
  WColorBarH(matrix(1:8), TopOf(), cmp=CMPar( = 'sequential_hcl')) +
  WColorBarH(matrix(1:8), TopOf(), cmp=CMPar( = 'YlOrRd'))

One who is really obssessed with %>% can do something like

WHeatmap(cc$mat, name='h1') %>% add(WColorBarV(, LeftOf('h1'), 'c1'))

The layout looks like


In order to cross-refer panels in the plot, one has to use a unique name. This name can be given through the name= option and user has to make sure the uniqueness of the names from existing objects in the plot. If not specified, wheatmap can generate a unique name and that name is visible from ly() function. A special NULL tag can be used to refer to the last plotted object.

More User guides:


  • The internal grid.dendrogram() function is adapted from ComplexHeatmap package.


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.1.0 by Wanding Zhou, 4 years ago

Report a bug at

Browse source code at

Authors: Wanding Zhou [aut, cre]

Documentation:   PDF Manual  

GPL-3 license

Imports grid, stats, colorspace, RColorBrewer

Suggests knitr, rmarkdown

See at CRAN