R: Add Points to a Circular Plot

points.circular {circular} | R Documentation

## Add Points to a Circular Plot

### 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)

[Package circular version 0.4-93 Index]