Add Points to a Circular Plot — plot

Add points to a plot of circular data points on the current graphics device.

Usage

plot_points(
  x,
  axial = TRUE,
  stack = FALSE,
  binwidth = 1,
  cex = 1,
  sep = 0.025,
  jitter_factor = 0,
  ...,
  scale = 1.1,
  add = TRUE,
  main = NULL,
  labels = TRUE,
  at = seq(0, 360 - 45, 45),
  cborder = TRUE
)

Arguments

x: Data to be plotted. A numeric vector containing angles (in degrees).
axial: Logical. Whether data are uniaxial (axial=FALSE) or biaxial (TRUE, the default).
stack: logical: if TRUE, points are stacked on the perimeter of the circle. Otherwise, all points are plotted on the perimeter of the circle. Default is FALSE.
binwidth: numeric. Bin width (in degrees) for the stacked dot plots. ignored when stack==FALSE. Is set to 1 degree by default.
cex: character (or symbol) expansion: a numerical vector. This works as a multiple of par("cex").
sep: constant used to specify the distance between stacked points, if stack==TRUE or in the case of more than one dataset. Default is 0.025; smaller values will create smaller spaces.
jitter_factor: numeric. Adds a small amount of random variation to the location of each points along radius that is added to scale. Jitter is ignored when stack==TRUE). If 0, no jitter is added (by default); if negative, the points fall into the circle.
...: Further graphical parameters may also be supplied as arguments.
scale: radius of plotted circle. Default is 1.1. Larger values shrink the circle, while smaller values enlarge the circle.
add: logical
main: Character string specifying the title of the plot.
labels: Either a logical value indicating whether to plot labels next to the tick marks, or a vector of labels for the tick marks.
at: Optional vector of angles at which tick marks should be plotted. Set at=numeric(0) to suppress tick marks.
cborder: logical. Border of rose plot.

Value

A list with information on the plot

Examples

x <- rvm(100, mean = 90, k = 5)
plot_points(x, add = FALSE)

plot_points(x, jitter_factor = .2, add = FALSE) # jittered plot

plot_points(x, stack = TRUE, binwidth = 3, add = FALSE) # stacked plot