ccTrackHist: Define a track of histograms

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

Define a track of histograms

Description

Object ccTrack will call the function circlize::circos.trackHist while drawing.

Usage

ccTrackHist(
  sectors,
  x,
  track.height = circos.par("track.height"),
  track.index = NULL,
  ylim = NULL,
  force.ylim = TRUE,
  col = ifelse(draw.density, "black", NA),
  border = "black",
  lty = par("lty"),
  lwd = par("lwd"),
  bg.col = NA,
  bg.border = "black",
  bg.lty = par("lty"),
  bg.lwd = par("lwd"),
  breaks = "Sturges",
  include.lowest = TRUE,
  right = TRUE,
  draw.density = FALSE,
  bin.size = NULL,
  area = FALSE,
  factors = sectors
)

Arguments

sectors	A factor or a character vector which represents the categories of data
x	Data on the x-axis
track.height	Height of the track. It is the percentage to the radius of the unit circle. If to update a track, this argument is disabled.
track.index	Index for the track which is going to be updated. Setting it to NULL means creating the plotting regions in the next newest track.
ylim	Ranges on y-direction. By default, ylim is calculated automatically.
force.ylim	Whether to force all cells in the track to share the same ylim.
col	Filled color for histogram
border	Border color for histogram
lty	Line style for histogram
lwd	Line width for histogram
bg.col	Background color for the plotting regions
bg.border	Color for the border of the plotting regions
bg.lty	Line style for the border of the plotting regions
bg.lwd	Line width for the border of the plotting regions
breaks	see hist
include.lowest	see hist
right	see hist
draw.density	whether draw density lines instead of histogram bars.
bin.size	size of the bins of the histogram
area	whether to fill the area below the density lines. If it is set to TRUE, col controls the filled color in the area and border controls color of the line.
factors	The same as sectors. It will be removed in future versions.

Value

Object ccTrack

Examples

library(circlizePlus)
n = 1000
df = data.frame(sectors = sample(letters[1:8], n, replace = TRUE),
                x = rnorm(n), y = runif(n))
library(circlizePlus)
par1=ccPar("track.height" = 0.1)
cc=ccPlot(sectors = df$sectors, x = df$x) + par1;bgcol = rep(c("#EFEFEF", "#CCCCCC"), 4)
track2 = ccTrackHist(df$sectors, df$x, bin.size = 0.2, bg.col = bgcol, col = NA)
cc=cc+track2
cc
circos.clear()

circlizePlus documentation built on June 8, 2025, 10:42 a.m.