plotB: Plot Biomass, Recruitment, and Landings

In arnima-github/scape: Statistical Catch-at-Age Plotting Environment

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)")

arnima-github/scape documentation built on Oct. 23, 2024, 9:59 a.m.