plotBubbles function

Construct a Bubble Plot from a Matrix

Construct a bubble plot for a matrix z.

plotBubbles(z, xval=FALSE, yval=FALSE, dnam=FALSE, rpro=FALSE, 
   cpro=FALSE, rres=FALSE, cres=FALSE, powr=0.5, size=0.2, lwd=1,
   clrs=c("black","red","blue"), hide0=FALSE, frange=0.05, prettyaxis=FALSE, ...)

Arguments

• z: numeric -- input matrix, array (2 dimensions) or data frame.
• xval: numeric -- x-values and/or labels for the columns of z. if xval=TRUE, the first row contains x-values for the columns.
• yval: numeric -- y-values and/or labels for the rows of z. If yval=TRUE, the first column contains y-values for the rows.
• dnam: logical -- if TRUE, attempt to use dimnames of input matrix z as xval and yval. The dimnames are converted to numeric values and must be strictly increasing or decreasing. If successful, these values will overwrite previously specified values of xval and yval or any default indices.
• rpro: logical -- if TRUE, convert rows to proportions.
• cpro: logical -- if TRUE, convert columns to proportions.
• rres: logical -- if TRUE, use row residuals (subtract row means).
• cres: logical -- if TRUE, use column residuals (subtract column means).
• powr: numeric -- power transform; radii are proportional to z^powr. Note: powr=0.5 yields bubble areas proportional to z.
• size: numeric -- size (inches) of the largest bubble.
• lwd: numeric -- line width for drawing circles.
• clrs: character -- colours (3-element vector) used for positive, negative, and zero values, respectively.
• hide0: logical -- if TRUE, hide zero-value bubbles.
• frange: numeric -- number specifying the fraction by which the range of the axes should be extended.
• prettyaxis: logical -- if TRUE, apply the pretty function to both axes.
• ...: dots -- additional arguments for plotting functions.

Details

The function plotBubbles essentially flips the z matrix visually. The columns of z become the x-values while the rows of z become the y-values, where the first row is displayed as the bottom y-value and the last row is displayed as the top y-value. The function's original intention was to display proportions-at-age vs. year.

Author(s)

Jon T. Schnute, Research Scientist Emeritus

Pacific Biological Station, Fisheries and Oceans Canada, Nanaimo BC

Maintainer: Rowan Haigh, Program Head -- Offshore Rockfish

Pacific Biological Station (PBS), Fisheries & Oceans Canada (DFO), Nanaimo BC

locus opus: Offsite, Vancouver BC

Last modified Rd: 2023-10-18

See Also

In package PBSmodelling:

genMatrix

Examples

local(envir=.PBSmodEnv,expr={
  oldpar = par(no.readonly=TRUE)
  plotBubbles(round(genMatrix(40,20),0),clrs=c("green","grey","red"));
  data(CCA.qbr,envir=.PBSmodEnv)
  plotBubbles(CCA.qbr,cpro=TRUE,powr=.5,dnam=TRUE,size=.15,
    ylim=c(0,70),xlab="Year",ylab="Quillback Rockfish Age")
  par(oldpar)
})