lines.chron: Plot all simulation runs as lines.

Description Usage Arguments Value Examples

View source: R/lines.chron.R

Description

Plots every single simulation run for each specified variable as a separate semi-transparent line.

Usage

1
2
3
4
## S3 method for class 'chron'
lines(results, field.list = NULL, col.list = c("darkred",
  "darkgreen", "blue", "grey", "goldenrod"), opacity = 20, ylim = NULL,
  small.n = NULL, small.n.op = 126, add = FALSE, legend = TRUE, ...)

Arguments

results

A list resembling the output from date.simulate or a related function, or a data table resembling the first component thereof - i.e. the full simulation results.

field.list

A character vector of columns in 'results' to be plotted. Defaults to NULL, in which case all suitable columns in 'results' are used. Nb. variables entitled "catch" or "effort" will be ignored, due to their roles in output from cpue.

col.list

Character vector: colours to be used for each column plotted. Defaults to c("darkred", "darkgreen", "blue", "grey", "goldenrod"). Nb. if more than five columns are plotted then the default colours will start to recycle.

opacity

Numeric: opacity of each line. Defaults to 20.

ylim

Numeric: an easy way to override the built-in scaling in plot - if a vector of length 1 is passed it will be converted into c(0, ylim) to be passed to the ylim argument in plot. Alternatively a vector of length 2 will be passed straight to plot as is. Defaults to NULL, in which case the built-in scaling in plot takes over.

small.n

Character vector of colours to be used for boxes marking periods of low "effort", when plotting cpue results. Has no effect if 'results' doesn't have a third element called "small.n". Defaults to NULL, in which case no boxes are plotted.

small.n.op

Numeric vector of length equal to 'small.n' (or otherwise recycled to that length) specifying opacity for small.n boxes. Defaults to 126 (i.e. ~50pc).

add

Logical: should data be added to current plot, or should axis.setup be called to start a new plot? Defaults to FALSE.

legend

Logical: should an automatic legend of column names and corresponding colours be plotted? Defaults to TRUE.

...

Other graphical arguments to be passed to plot. Nb. (a) includes special arguments for axis.setup (currently just 'lab.sp'), (b) 'ylab' will default to "Estimated frequency density", as per axis.setup, unless specified here.

Value

None.

Examples

1
2
3
date.ranges <- data.table(Start=c(450, 450, 600), End=c(700, 800, 650), frags=c(3, 6, 25))
x <- freq.simulate(date.ranges, weight=date.ranges$frags, bin.width=50, reps=200, summ=FALSE)
lines.chron(x)

davidcorton/archSeries documentation built on May 4, 2021, 10:09 p.m.