Learn R Programming

circleplot (version 0.4.1)

circleplot_fun: Plot a pairwise associations between nodes

Description

Draws a circular plot of pairwise association values.

Usage

circleplot(x, cluster, reduce, style, add, plot.control)

Arguments

x

a data source containing information on pairwise associations. The standard input is a data.frame with 3 columns, where the first two columns specify the identities of the connected nodes, and the third gives a numeric value describing the connection between those node. Alternatively, x can be a matrix of class 'matrix' or 'dist' with identical results, or list containing >1 of the above.

cluster

logical - should points be rearranged using hclust? Defaults to TRUE, unless distance.matrix contains missing values, in which case cluster is set to FALSE and cannot be overwritten.

reduce

logical - should points with no connections be removed from the plot? Defaults to FALSE

style

command to change the style of plot presentation, largely interms of how points are drawn on the circumference. style='classic' (the default) uses points, 'pie' uses polygons, and 'clock' uses lines.

add

logical (defaulting to FALSE), with behaviour dependent on class(x). When class(x)=="list", default is to divide the window automatically using par(mfrow), while setting add=TRUE allows you to specify your own mfrow values. When class(x)!="list", asks whether new points and lines be added to the existing plot window.

plot.control

a list giving information on how the plot should appear. If given, may contain any or all of the named objects given in notes (below).

Value

Draws a plot showing the labels of the specified object as nodes around the circumference of a circle, with parabolic lines joining them. When a list is supplied as an input, circleplot invisibly returns a list altered by clean.list(); otherwise invisibly returns point and line attributes of a single plot.