Learn R Programming

Citation

Zhang Z, Cao T, Huang Y and Xia Y (2025) CirclizePlus: using ggplot2 feature to write readable R code for circular visualization. Front. Genet. 16:1535368. doi: 10.3389/fgene.2025.1535368

Highlights

  • Programming in circlizePlus is summarized into 5 addition rules, which are simple and clear.
  • Like ggplot2, it makes programming circular visualizations in the form of addition of plotting functions.
  • In ggplot2, the data parameter of the function that draws geometric figures can be missing, and it will use the data parameter value in the ggplot() function. circlizePlus implements similar functionality. In circlizePlus, the function that draws geometric figures can get the default coordinate data (such as x, y) from the track it belongs to.
  • Like ggplot2, it supports data mapping. The coordinate parameters are mapped to the default values ​​by passing in an anonymous function of the form "function(x,y){...}".

Installation

It is recommended that you have the latest version of the R environment installed. You need to install devtools and load it into the R environment, and then you can install circlizePlus from Github.

if (!requireNamespace("devtools", quietly=TRUE))
    install.packages("devtools")
install_github("TianzeLab/circlizePlus")

Every time you reboot the R environment, you need to load circlizePlus again.

library(circlizePlus)

Acknowledgements

We are grateful to Dr. Zuguang Gu from DFKZ for his invaluable guidance and support throughout the project.

Sample code

Dr. Gu has written a book("Circular Visualization in R") explaining how circlize works. To illustrate the similarities and differences between circlize and cirzelizePlus, we've rewritten the code in the book as sample code. Visit circlizePlusBook for details.

Copy Link

Version

Install

install.packages('circlizePlus')

Monthly Downloads

477

Version

0.9.0

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Tianze Cao

Last Published

April 22nd, 2025

Functions in circlizePlus (0.9.0)

ccGenomicText

Add text for genomic data visualization
ccGenomicTrack-class

S4 class ccGenomicTrack
ccRaster

Add raster image
ccRect

Draw rectangle in a region
ccGenomicHeatmap

Define a heatmap track for genomic graph
ccPar-class

Object generator for S4 class ccPar
ccPar

Parameters for the circular layout
ccGenomicTrack

Define a track for genomic data visualization
ccHeatmap-class

S4 class ccHeatmap
ccPlot-class

S4 class ccPlot
ccPlot

Object generator for S4 class ccPlot
ccSegments

Draw segments connecting points in a region
ccHeatmapLink-class

S4 class ccHeatmapLink
ccHeatmap

Object generator for S4 class ccHeatmap
ccText

Draw text in a cell
ccHeatmapLink

Draw a link between two matrix rows in the circular heatmap
ccLines

Draw lines in a region
ccViolin

Draw violin plots
circlizePlus-package

circlizePlus: Using 'ggplot2' Feature to Write Readable R Code for Circular Visualization
ccPolygon

Draw polygon
ccPoints

Draw points in a region
ccTrackLines

Add lines on all sections of a single track.
ccTrackText

Add texts on all sections of a single track.
ccTrack-class

S4 class ccTrack
ccGenomicRainfall

Create a rainfall plot
ccGenomicRect

Draw rectangle for genomic data visualization
ccLink-class

S4 class ccLink
ccLink

Add a link
ccTrackPoints

Add points on all sections of a single track.
data-set

Data set in circlizePlus
show,ccHeatmap-method

Draw the figures described by ccHeatmap
ccTrack

Define a generic track
show,ccPlot-method

Draw the figures described by ccPlot
ccYaxis

Draw y-axis
ccTrackGeom-class

S4 class ccTrackGeom
ccXaxis

Draw x-axis
ccTrackHist

Define a track of histograms
ccCell-class

S4 class ccCell
ccCell

Generate a cell container that belongs to a particular sector
ccBarplot

Draw barplots
ccDendrogram

Draw dendrogram plots in a track
ccCells-class

S4 class ccCells
ccCells

Generate a list of multiple object ccCell-class
addition-rules

Addition rules in circlizePlus
ccBoxplot

Draw boxplots
ccArrow

Draw an arrow
ccGenomicLink-class

S4 class ccGenomicLink
ccCellGeom-class

S4 class ccCellGeom
ccGenomicLines

Add lines for genomic data visualization
ccGenomicLink

Add links between two sets of genomic positions
ccGenomicIdeogram

Define an ideograms track for genomic graph
ccGenomicPoints

Add points for genomic data visualization
ccGenomicLabels

Add labels to specific genomic track
ccGenomicAxis

Add genomic axes
ccGenomicDensity

Create a track of density plot
ccGenomicCellGeom-class

S4 class ccGenomicCellGeom