plotrix (version 1.2-2)

radial.plot: radial.plot

Description

radial.plot displays a plot of radial lines or a polygon centered at the midpoint of the plot frame, the lengths or vertices corresponding to the numeric magnitudes of the data values.

Usage

radial.plot(lengths,radial.pos,radial.range,labels,label.pos,rp.type="r",
 label.prop=1.1,main="",xlab="",ylab="",...)

Arguments

lengths

numeric data vector. Magnitudes will be represented as line lengths or polygon vertices.

radial.pos

numeric vector of positions in radians. These are interpreted as beginning at the right (0 radians) and moving counterclockwise.

radial.range

range of positions in radians. This allows a vector of lines to be spread over part of the 2*pi range of the plot.

labels

character strings to be placed at the outer ends of the lines. If set to NULL, will suppress printing of labels, but if missing, the radial positions will be used.

label.pos

the positions of the labels as distance from the 'center' of the plot. If missing, they will be placed at 1.1 times the maximum of lengths.

rp.type

whether to draw radial lines or a polygon.

label.prop

the label position radius as aproportion of the maximum line length.

main

The title for the plot.

xlab,ylab

Normally x and y axis labels are suppressed.

...

additional arguments are passed to plot.

Value

• nil

authors

Jim Lemon

Details

The radial.plot family of plots is useful for illustrating cyclic data such as wind direction and velocity, activity at different times of the day, and so on. While radial.plot actually does the plotting, another function is usually called for specific types of cyclic data.

See Also

polar.plot,clock24.plot

Examples

testlen<-rnorm(10)*2+5
 testpos<-seq(0,18*pi/10,length=10)
 testlab<-letters[1:10]
 radial.plot(testlen,testpos,main="Test Radial Lines")
 par(ask=TRUE)
 testlen<-c(sin(seq(0,1.98*pi,length=100))+2+rnorm(100)/10)
 testpos<-seq(0,1.98*pi,length=100)
 radial.plot(testlen,testpos,rp.type="p",main="Test Polygon",col="blue")
 par(ask=FALSE)