cplots (version 0.5-0)

cbarplot: Circular Bar Plot

Description

Function cbarplot can be used to plot 2-dimensional circular bar plots. The circular bar plots can only adopt the height-proportional transformation because of the white space between bars.

Usage

cbarplot(
  x,
  nbins = 36,
  radius = 1/sqrt(base::pi),
  prob = TRUE,
  nlabels = 4,
  col = NULL,
  border = NULL,
  m = NA,
  xlim = NULL,
  ylim = NULL,
  main = NULL
)

Arguments

x

a numeric vector storing angular values between 0 and 2 pi, or an object that can be coerced to.

nbins

the number of bins of the circular bar plot. Internally, it is rounded to a multiple of 4.

radius

the radius of the reference circle.

prob

logical; if TRUE, the circular histogram graphic is a representation of probability densities; if FALSE, a representation of frequencies.

nlabels

integer, for the number of levels to be plotted; if 0, no label is plotted

col

the color to fill the bars.

border

the color of the border around the bars.

m

the number of points within each bin to plot the top of a bar. The larger the number is, the smoother the plot looks.

xlim

numeric vectors of length 2, giving the x coordinates ranges.

ylim

numeric vectors of length 2, giving the y coordinates ranges.

main

the main title (on top)

Value

No return value

References

Xu, D. and Wang, Y. (2020). Area-proportional Visualization for Circular Data. Journal of Computational and Graphical Statistics, 29, 351-357.

See Also

cdensity, cdotplot, chist

Examples

# NOT RUN {
# 600 observations from two von Mises distributions
library(circular)
x = c(rvonmises(200, circular(pi/4), 5), rvonmises(400, circular(pi), 20))

cbarplot(x)                     
cbarplot(x, prob=FALSE)
cbarplot(x, radius=1, nlabels=0, col="lightblue")
cbarplot(x, radius=1, col="lightblue", border="skyblue4")

# }