Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
circular layout in R
branch: master
Failed to load latest commit information.
R fixed keep.diagonal
demo todo
inst refresh documentation
man revise vignette
vignettes submit 0.2.4 to CRAN
.Rbuildignore Update .Rbuildignore
.gitignore Update .gitignore
.travis.yml Update .travis.yml
NAMESPACE revise vignette
NEWS graphic parameter can be specified as 3-column df Update

circlize: circular visualizatio in R

This package aims to implement circular layout in R.

Since most of the figures are composed of points, lines and polygons, we just need to implement functions for drawing points, lines and polygons.

Current there are following low-level graphical functions:

  • circos.points
  • circos.lines
  • circos.rect
  • circos.polygon
  • circos.text
  • circos.axis
  •, This maybe the unique feature for circos layout to represent relationships between elements.

For drawing points, lines and text through the whole track (among several sectors), the following functions are available:

  • circos.trackPoints
  • circos.trackLines
  • circos.trackText

Functions to arrange circos layout:

  • circos.trackPlotRegion
  • circos.updatePlotRegion
  • circos.par
  • circos.clear

Theoretically, you are able to draw most kinds of circos plots by the above functions.

For specific use in genomics, we also implement functions which add graphics in genome scale.

Functions to initialize circos plot with genomic coordinates:

  • circos.initializeWithIdeogram
  • circos.genomicInitialize

Functions to arrange genomic circos layout:

  • circos.genomicTrackPlotRegion

Functions to add basic graphics in genomic scale:

  • circos.genomicPoints
  • circos.genomicLines
  • circos.genomicText
  • circos.genomicRect
  • circos.genomicLink

Functions with specific purpose:

  • circos.genomicDensity
  • circos.genomicRainfall

Finally, function that draws chord diagram:

  • chordDiagram

Please refer to the vignettes to find out how to draw basic and advanced circos plots by this package.


The package has been submitted to CRAN, so you can install it through:


Together with the package there are several vignettes which provide detailed description and examples.


For examples of circlize package, please visit .

Something went wrong with that request. Please try again.