plot.circular {circular} | R Documentation |
Creates a plot of circular data points on the current graphics device. Data points are either plotted as points on the unit circle, or the range of the circle is divided into a specified number of bins, and points are stacked in the bins corresponding to the number of observations in each bin.
## S3 method for class 'circular': plot(x, pch = 16, cex = 1, stack = FALSE, axes = TRUE, sep = 0.025, shrink = 1, bins, ticks = FALSE, tcl = 0.025, tcl.text = 0.125, col, tol = 0.04, uin, xlim = c(-1, 1), ylim = c(-1, 1), main = NULL, digits=2, ...)
x |
a vector, matrix or data.frame. The object is coerced to class circular . |
pch |
point character to use. See help on par . |
cex |
point character size. See help on par. |
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 . |
axes |
logical; if TRUE axes are plotted according to properties of x . |
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. |
shrink |
parameter that controls the size of the plotted circle. Default is 1. Larger values shrink the circle, while smaller values enlarge the circle. |
bins |
if stack==TRUE , bins is the number of arcs to partition the circle with. |
ticks |
logical; if TRUE ticks are plotted according to the
value of bins . |
tcl |
length of the ticks. |
tcl.text |
The position of the axis labels. |
col |
color of the points. The values are recycled if needed. |
tol |
proportion of white space at the margins of plot |
uin |
desired values for the units per inch parameter. If of length 1, the desired units per inch on the x axis. |
xlim, ylim |
the ranges to be encompassed by the x and y axes. Useful for centering the plot. |
main |
title of the plot. |
digits |
number of digits used to print axis values. |
... |
futher parameters passed to plot.default . |
When there are many closely distributed observations, stacking is
recommended. When stacking the points, if there are many points in a particular bin, it may be necessary to shrink the plot of the circle so that all points fit. This is controlled with the parameter shrink
. Generally the parameter sep
does not need adjustment, however, when shrinking the plot, or for a very large number of observations, it may be helpful.
a list with information on the plot: zero, rotation and next.points.
some codes from eqscplot
in MASS is used.
Claudio Agostinelli and Ulric Lund
axis.circular
, ticks.circular
and rose.diag
.
# Generate 100 observations from a von Mises distribution. # with mean direction 0 and concentration 3. data.vm <- rvonmises(n=100, mu=0, kappa=3) # Plot data set. All points do not fit on plot. plot(data.vm, stack=TRUE, bins=150) # Shrink the plot so that all points fit. plot(data.vm, stack=TRUE, bins=150, shrink=1.5)