R: Plot Method for Kernel Density Estimation for Circular Data

plot.density.circular {circular} | R Documentation

## Plot Method for Kernel Density Estimation for Circular Data

### Description

The `plot` method for `density.circular` objects.

### Usage

    ## S3 method for class 'density.circular'
    plot(x, main=NULL, sub=NULL, xlab=NULL, ylab="Density circular", type="l",
      zero.line=TRUE, points.plot=FALSE, points.col=1, points.pch=1,
      points.cex=1, plot.type=c("circle", "line"), axes=TRUE, ticks=FALSE,
      bins=NULL, offset=1, shrink=1, tcl=0.025, tcl.text = 0.125, sep=0.025, tol=0.04,
      digits=2, cex=1, uin=NULL, xlim=NULL, ylim=NULL, join=FALSE, nosort=FALSE,
      units=NULL, template=NULL, zero=NULL, rotation=NULL,
      control.circle=circle.control(), ...)

### Arguments

`x` | an object of class `density.circular`.
`main, sub, xlab, ylab, type` | plotting parameters with useful defaults.
`zero.line` | logical; if `TRUE`, add a base line at y = 0. Used when `plot.type` is `"line"`.
`points.plot` | logical; if `TRUE` original data are added to the plot.
`points.col, points.pch, points.cex` | parameters used to draw the points.
`plot.type` | type of the plot: "line": linear plot, "circle": circular plot.
`axes` | logical; if `TRUE` axis are drawn.
`ticks` | logical; if `TRUE` ticks are drawn.
`bins` | number of ticks to plot.
`offset` | the radius of the circle
`shrink` | parameter that controls the size of the plotted function. Default is 1.
`tcl` | length of the ticks.
`tcl.text` | The position of the axis labels.
`sep` | constant used to specify the distance between stacked points. Default is 0.025; smaller values will create smaller spaces.
`tol` | proportion of white space at the margins of plot
`digits` | number of digits used to print axis values.
`cex` | point character size. See help on `par`.
`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.
`join` | logical: should the first and the last point joined.
`nosort` | logical: should the data sort before plotting. Defaults is to sort.
`units` | units measure used in the plot. If `NULL` the value is taken from the attribute of object 'x' from the argument 'x', i.e. `x$x`.
`template` | template used in the plot. If `NULL` the value is taken from the attribute of object 'x' from the argument 'x', i.e. `x$x`.
`zero` | position of the zero used in the plot. If `NULL` the value is taken from the attribute of object 'x' from the argument 'x', i.e. `x$x`.
`rotation` | rotation used in the plot. If `NULL` the value is taken from the attribute of object 'x' from the argument 'x', i.e. `x$x`.
`control.circle` | parameters passed to `plot.default` in order to draw the circle. The function `circle.control` is used to set the parameters.
`...` | futher parameters passed to `plot.default`.

### Value

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

### Author(s)

Claudio Agostinelli

### See Also

`density.circular`, `lines.density.circular`, `plot.circular`, `lines.circular` and `curve.circular`.

### Examples

    set.seed(1234)
    x <- rvonmises(n=100, mu=circular(pi), kappa=2)
    res25x <- density(x, bw=25)
    plot(res25x, points.plot=TRUE, xlim=c(-1.5,1))
    res50x <- density(x, bw=25, adjust=2)
    lines(res50x, col=2)

    resp25x <- plot(res25x, points.plot=TRUE, xlim=c(-1, 1.3), ylim=c(-1.5,1.2),
      template="geographics", main="Plotting density estimate for two data set")
    y <- rvonmises(n=100, mu=circular(pi/2), kappa=2,
      control.circular=list(template="geographics"))
    res25y <- density(y, bw=25)
    lines(res25y, points.plot=TRUE, plot.info=resp25x, col=2, points.col=2)

    plot(res25x, plot.type="line", points.plot=TRUE, xlim=c(-1, 1.3), ylim=c(-1.5,1.2),
      template="geographics", main="Plotting density estimate for two data set")
    lines(res25y, plot.type="line", points.plot=TRUE, col=2, points.col=2)

[Package circular version 0.4-93 Index]