circular (version 0.5-1)

axis.circular: Add Axis to a Circular Plot

Description

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

Usage

axis.circular(at=NULL, labels=NULL,  units = NULL, template=NULL,  
          modulo=NULL, zero=NULL, rotation=NULL, tick=TRUE, lty, lwd, 
          cex, col, font, tcl=0.025, tcl.text=0.125, digits=2)

Arguments

at

the points at which tick-marks are to be drawn. If NULL the tick-marks are placed to 0, pi/2, pi and 3pi/2 radians.

labels

a vector of character strings to be placed at the tickpoints. If NULL the labels are chosen according to units and template arguments.

units

either radians or degrees. If NULL the value is taken from the attributes of the object at.

template

either none or geographics. If NULL the value is taken from the attributes of the object at.

modulo

either asis or 2pi or pi. If NULL the value is taken from the attributes of the object at.

zero

the zero of the plot (in radians, counterclockwise). If NULL the value is taken from the attributes of the object at.

rotation

the rotation of the plot. If NULL the value is taken from the attributes of the object at.

tick

logical: if TRUE ticks are plotted at tick-marks.

lty, lwd

line type, width for the tick marks. If missing means to use `par("lty")' and `par("lwd")'.

cex

a numerical value giving the amount by which plotting text and symbols should be scaled relative to the default.

col

color for the the tick marks. If missing means to use `par("col.axis")'.

font

font for text. If missing means to use `par("font.axis")'.

tcl

The length of tick marks.

tcl.text

The position of the axis labels.

digits

number of digits used to print axis values.

Author

Claudio Agostinelli

See Also

plot.circular and ticks.circular.

Examples

data.vm <- rvonmises(n=100, mu=circular(0), kappa=3) 
plot(data.vm, axes=FALSE, ticks=FALSE)
axis.circular(at=circular(seq(0, 11/6*pi, pi/6)), labels=c("0",
expression(frac(pi,6)), expression(paste(frac(1,3), pi)),
expression(frac(pi,2)), expression(paste(frac(2,3), pi)),
expression(paste(frac(5,6), pi)), expression(pi),
expression(paste(frac(7,6), pi)), expression(paste(frac(4,3), pi)),
expression(paste(frac(3,2), pi)), expression(paste(frac(5,3), pi)),
expression(paste(frac(11,6), pi))))