spatstat (version 1.41-1)

rose: Rose Diagram

Description

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

Usage

rose(x, ...)
## S3 method for class 'default':
rose(x, breaks = NULL, \dots, nclass = NULL,
                       unit = c("degree", "radian"), main)
## S3 method for class 'histogram':
rose(x, \dots,
                       unit = c("degree", "radian"), main,
                       do.plot = TRUE)
## S3 method for class 'density':
rose(x, \dots, 
                  unit = c("degree", "radian"), main,
                  do.plot = TRUE)
## S3 method for class 'fv':
rose(x, \dots, 
                  unit = c("degree", "radian"), main,
                  do.plot = TRUE)

Arguments

x

Data to be plotted. A numeric vector containing angles, or a histogram object containing a histogram of angular values, or a density object containing a smooth density estimate for angular data, or an fv

breaks, nclass

Arguments passed to hist to determine the histogram breakpoints.

...

Additional arguments passed to polygon controlling the appearance of the plot (or passed from rose.default to hist to c

unit

The unit in which the angles are expressed.

main

Optional main title for the plot.

do.plot

Logical value indicating whether to really perform the plot.

Value

• A window (class "owin") containing the plotted region.

Details

A rose diagram or rose of directions is the analogue of a histogram or bar chart for data which represent angles in two dimensions. The bars of the bar chart are replaced by circular sectors in the rose diagram.

The function rose is generic, with a default method for numeric data, and methods for histograms and function tables. If x is a numeric vector, it must contain angular values in the range 0 to 360 (if unit="degree") or in the range 0 to 2 * pi (if unit="radian"). A histogram of the data will first be computed using hist. Then the rose diagram of this histogram will be plotted by rose.histogram.

If x is an object of class "histogram" produced by the function hist, representing the histogram of angular data, then the rose diagram of the densities (rather than the counts) in this histogram object will be plotted.

If x is an object of class "density" produced by circdensity or density.default, representing a kernel smoothed density estimate of angular data, then the rose diagram of the density estimate will be plotted. If x is a function value table (object of class "fv") then the argument of the function will be interpreted as an angle, and the value of the function will be interpreted as the radius.

See Also

fv, hist, circdensity, density.default.

Examples

ang <- runif(1000, max=360)
  rose(ang, col="grey")