plotB {scape}

Plot Biomass, Recruitment, and Landings

Description

Plot scape model predicted biomass, stock recruitment, and landings.

Usage

plotB(model, what="d", series=NULL, years=NULL, axes=TRUE, div=1,
      legend="bottom", main="", xlab="", ylab="", cex.main=1.2,
      cex.legend=1, cex.lab=1, cex.axis=0.8, las=1,
      tck=c(1,what=="d")/2, tick.number=5, lty.grid=3, col.grid="white",
      pch=16, cex.points=0.8, col.points="black", lty.lines=1:3,
      lwd.lines=2, col.lines="black", ratio.bars=3, col.bars="gray",
      plot=TRUE, ...)

Arguments

model

fitted scape model.

what

what to plot: "d"[efault], "s"[tock recruitment], or "l"[andings].

series

vector of strings indicating which column names in model$B data frame to plot (all by default).

years

vector of numbers indicating which years to include (all by default).

axes

whether to plot axis values.

div

denominator to shorten values on the y axis, or a vector with two elements referring to x and y axis.

legend

legend location: "bottom", "left", "top", "right", or "" to suppress legend.

main

main title.

xlab

x-axis label.

ylab

y-axis label.

cex.main

size of main title.

cex.legend

size of legend text.

cex.lab

size of axis labels.

cex.axis

size of tick labels.

las

orientation of tick labels: 0=parallel, 1=horizontal, 2=perpendicular, 3=vertical.

tck

tick mark length.

tick.number

number of tick marks.

lty.grid

line type of gridlines.

col.grid

color of gridlines.

pch

symbol for points.

cex.points

size of points.

col.points

color of points.

lty.lines

line type of main lines.

lwd.lines

line width of main lines.

col.lines

color of main lines.

ratio.bars

width of bars.

col.bars

color of bars.

plot

whether to draw plot.

...

passed to xyplot and panel.superpose.

Details

The "d"[efault] plot shows spawning biomass and vulnerable biomass as lines, and landings as bars, on the same scale.

Value

When plot=TRUE, a trellis plot is drawn and a data frame is returned, containing the data used for plotting. When plot=FALSE, a trellis object is returned.

Note

The Args function from the gdata package is recommended for reviewing the arguments, instead of args.

See Also

xyplot, panel.barchart, and panel.superpose are the underlying drawing functions.

plotCA, plotCL, plotIndex, and plotLA plot model fit and data.

plotB, plotN, and plotSel plot derived quantities.

scape-package gives an overview of the package.

Examples

plotB(x.ling, series=c("VB.1","VB.2","Y"), div=1000, xlab="Year\n",
      ylab="Biomass and landings (kt)")

plotB(x.ling, "s", div=1000, xlab="Biomass age 4+ (kt)",
      ylab="Recruitment (million one-year-olds)")