Rose Diagram

Plots a rose diagram (rose of directions), the analogue of a histogram or density plot for angular data.

Usage

rose(
  x,
  weights = NULL,
  binwidth = NULL,
  bins = NULL,
  axial = TRUE,
  equal_area = TRUE,
  muci = TRUE,
  origin.text = "N",
  main = NULL,
  sub = NULL,
  at = seq(0, 360 - 45, 45),
  cborder = TRUE,
  labels = TRUE,
  col = "grey",
  dots = FALSE,
  dot_pch = 1,
  dot_cex = 1,
  dot_col = "slategrey",
  stack = FALSE,
  jitter_factor = 0,
  grid = FALSE,
  grid.lines = seq(0, 135, 45),
  grid.circles = seq(0.2, 1, 0.2),
  add = FALSE,
  rule = c("sturges", "rice"),
  ...
)

Arguments

x: Data to be plotted. A numeric vector containing angles (in degrees).
weights: Optional vector of numeric weights associated with x.
binwidth: The width of the bins (in degrees).
bins: number of arcs to partition the circle width. Overridden by binwidth.
axial: Logical. Whether data are uniaxial (axial=FALSE) or biaxial (TRUE, the default).
equal_area: Logical. Whether the radii of the bins are proportional to the frequencies (equal_area=FALSE, i.e. equal-angle) or proportional to the square-root of the frequencies (equal_area=TRUE, the default).
muci: logical. Whether the mean and its 95% CI are added to the plot or not.
origin.text: character. String to be drawn at the top margin of the plot ("N" by default)
main, sub: Character string specifying the title and subtitle of the plot. If sub = NULL, it will show the bin width.
at: Optional vector of angles at which tick marks should be plotted. Set at=numeric(0) to suppress tick marks.
cborder: logical. Whether to plot the primitive of the circular plot (TRUE by default) or not.
labels: Either a logical value indicating whether to plot labels next to the tick marks, or a vector of labels for the tick marks.
col: fill color of rose petals / fans
dots: logical. Whether a circular dot plot should be added (FALSE is the default).
dot_cex, dot_pch, dot_col: Plotting arguments for circular dot plot
stack: logical. Groups and stacks the dots if TRUE. Default is FALSE.
jitter_factor: Add a small amount of noise to the angles' 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.
grid: logical. Whether to add a grid to the circular plot. Default is FALSE.
grid.lines, grid.circles: numeric. Adds a sequence of straight grid lines and circles based on angles (in degrees) and radii, respectively. Ignored when grid=FALSE
add: logical. Add to existing plot? (TRUE by default).
rule: character. Rule to select optimal bin width, one of "sturges" (the default) or "rice". The optimal number according to Sturges' rule is \(1 + \log2(n)\), while for Rice's rule it is \(2 n^{1/3}\) (less conservative for large n).
...: Additional graphical arguments passed to graphics::polygon() for plotting the rose petals / fans

Value

class of histogram that is a list of the calculated frequencies parameters including the bin width.

Examples

x <- rvm(100, mean = 90, k = 5)
rose(x, axial = FALSE, border = TRUE, grid = TRUE)


data("san_andreas")
rose(san_andreas$azi, main = "equal area")

rose(san_andreas$azi, equal_area = FALSE, main = "equal angle")


# weighted frequencies:
rose(san_andreas$azi, weights = 1 / san_andreas$unc, main = "weighted")


# add dots:
rose(san_andreas$azi, dots = TRUE, main = "dot plot", jitter = .2)


# stack dots:
rose(san_andreas$azi,
  dots = TRUE, stack = TRUE, dot_cex = 0.5, dot_pch = 21,
  main = "stacked dot plot"
)

Usage

Arguments

Value

See also

Examples