points.circular: Add Points to a Circular Plot

In circular: Circular Statistics

Description

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

Usage

## S3 method for class 'circular'
points(x, pch = 16, cex = 1, stack = FALSE,
  start.sep=0, sep = 0.025, 
  shrink = 1, bins = NULL, col = NULL, next.points = NULL, 
  plot.info = NULL, zero = NULL, rotation = NULL, ...)

Arguments

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.
start.sep	constant used to specify the distance between the center of the point and the axis.
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.
col	color of the points. The values are recycled if needed.
next.points	if stack=FALSE, the distance from the circle the next dataset is plotted. Ingored if plot.info is provided.
plot.info	an object from plot.circular that contains information on the zero, the rotation and next.points.
zero	the zero of the plot. Ignored if plot.info is provided.
rotation	the rotation of the plot. Ignored if plot.info is provided.
...	futher parameters passed to points.default.

Details

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. Since version 0.3-9 the intervals are on the form [a,b).

Value

A list with information on the plot: zero, rotation and next.points.

Author(s)

Claudio Agostinelli

See Also

plot.circular and lines.circular.

Examples

data.1 <- rvonmises(n=100, mu=circular(0), kappa=3)
data.2 <- rvonmises(n=100, mu=circular(pi/3), kappa=3) 
res <- plot(data.1, stack=FALSE, col=1) 
points(data.2, plot.info=res, col=2)

Example output

Attaching package: 'circular'

The following objects are masked from 'package:stats':

    sd, var

circular documentation built on May 2, 2019, 4:42 p.m.