# bubble3: Create a bubble plot. In r4ss: R Code for Stock Synthesis

## Description

Bubble plot based on function vaguely based on `bubble` by Edzer Pebesma in gstat package. By default, positive values have closed bubbles and negative values have open bubbles.

## Usage

 ```1 2 3 4 5 6``` ```bubble3(x, y, z, col = 1, cexZ1 = 5, maxsize = NULL, do.sqrt = TRUE, bg.open = gray(0.95, 0.3), legend = TRUE, legendloc = "top", legend.z = "default", legend.yadj = 1.1, main = "", cex.main = 1, xlab = "", ylab = "", minnbubble = 3, xlim = NULL, ylim = NULL, axis1 = TRUE, xlimextra = 1, add = FALSE, las = 1, allopen = TRUE) ```

## Arguments

 `x` Vector of x-values. `y` Vector of y-values. `z` Vector of bubble sizes, where positive sizes will be plotted as closed bubbles and negative as open unless `allopen==TRUE`. `col` Color for bubbles. Should be either a single value or vector of length equal to x, y, and z vectors. `cexZ1` Character expansion (cex) value for a proportion of 1.0. `maxsize` Size of largest bubble. Preferred option is now an expansion factor for a bubble with z=1 (see `cexZ1` above). `do.sqrt` Should size be based on the area? (Diameter proportional to sqrt(z)). Default=TRUE. `bg.open` background color for open bubbles (border will equal 'col') `legend` Add a legend to the plot? `legendloc` Location for legend (default='top') `legend.z` If a legend is added, what z values will be shown. Default is c(-3,-2,-1,.1,1,2,3) for Pearson-like quantities and a smaller range for proportions that are all less than 1. `legend.yadj` If a legend is added, how much should the y-axis be expanded to make space for it. `main` Title of plot. Default="". `cex.main` Character expansion for title. Default=1. `xlab` X-axis label. `ylab` Y-axis label. `minnbubble` Minimum number of unique x values below which extra space is added to horizontal axis (to make plot look better). Default = 8. `xlim` Optional limits on x-range. `ylim` Optional limits on y-range. `axis1` Show the horizontal axis on plot? Option allows turning off for use in multi-figure plots. `xlimextra` Extra space (see minnbubble above). Default = 1. `add` Add bubbles to existing plot? Default=FALSE. `las` Style of axis labels (see ?par for more info). `allopen` Should all bubbles be open (instead of just negative values)?

## Author(s)

Ian Stewart and Ian Taylor

r4ss documentation built on Oct. 30, 2019, 11:25 a.m.