plot_trend: Plot CES trend

In btorobrob/cesr: Trend analysis of Constant Effort Site ringing data

Plot CES trend

Description

Plots an estimated trend from CES data either to the screen or to a file.

Usage

plot_trend(x, type, group=NULL, file = NULL, width=480, height=480, units='px', main=FALSE, lty=c(1,2), lcol='black', lwd=1, line=NA, rlty=3, rlwd=1, rcol='black', annual=FALSE, pch=19, pcol='black', pcex=1, ...)

Arguments

x	A CES object
type	Which trend to plot? Can be either 'Adult' or 'Juvenile' Abundance, 'Productivity' or 'Survival'. Only the first letter needs to be given, in either lower or upper case.
group	If survival trends have been calculated by group, the group level to be plotted.
file	A valid file name, ending in either '.png', '.jpg', '.jpeg', 'svg', '.tif', '.tiff', '.ps' or '.pdf' to produce a file of the appropriate type. If file=NULL (the default) the trend will be plotted to the screen.
width	The width of the device.
height	The height of the device.
units	The units in which height and width are given. Can be px (pixels, the default), in(ches), or mm.
main	should the plot have a title? If a value other than TRUE/FALSE is given then that will be used as the title.
lty, lwd, lcol	a vector of length 1 or 2, if length 2 the first entry will be used for the trend line, the second for the confidence limits.
line	if required, the value (e.g. 1) at which a horizontal reference line will be drawn.
rlty, rcol, rlwd	if a reference line is specified, the line type, color and width to use.
annual	logical, plot the annual estimates too?
pch, pcol, pcex	if annual=TRUE, symbol, color and size to use in plotting points.
...	additional arguments passed to plot, such as bty, ylab or ylim.

Details

Plots a single CES trend to a file, or to the screen if no file is not specified. PNG format is small and lossless and so good for images of this type. Invisibly returns a dataframe with the annual values used to create the graph. If you wish a finer degree of control over the appearance of the graph, best import this data to your favourite graphing package, or plot this data directly in R.

Value

If assigned to an object, a dataframe with the following columns: 'years', 'parm', 'se', 'index', 'lcl', 'ucl'.

Note

If you get an error about "figure margins too large", you need to either increase the height and width (of the file, or make the plotting window larger), or check you have the correct units.

Author(s)

Rob Robinson

Examples

##---- Should be DIRECTLY executable !! ----
##-- ==>  Define data, use random,
##--	or do  help(data=index)  for the standard data sets.

btorobrob/cesr documentation built on June 9, 2025, 5:39 a.m.