oce (version 0.8-9)

plot.echosounder: Plot echosounder data

Description

Plot echosounder data

Usage

## S3 method for class 'echosounder':
plot(x,
     which=1, 
     newx, xlab="",
     xlim, ylim, zlim,
     type="l", col=oceColorsJet, lwd=2,
     despike=FALSE,
     drawBottom, ignore=5,
     radius, coastline,
     adorn=NULL,
     mgp=getOption("oceMgp"),
     mar=c(mgp[1]+1,mgp[1]+1,mgp[1]+1,mgp[1]+1),
     atTop, labelsTop,
     debug=getOption("oceDebug"),
     ...)

Arguments

x

An echosounder object, e.g. as read by read.echosounder, or created by as.echosounder.

which

list of desired plot types: which=1 or which="zt image" gives a z-time image, which=2 or which="zx image" gives a z-distance image, and which=3 or which="map" gi

newx

optional vector of values to appear on the horizontal axis if which=1, instead of time. This must be of the same length as the time vector, because the image is remapped from time to newx using

xlab

label for horizontal axis.

xlim

optional range for x axis.

ylim

optional range for y axis.

zlim

optional range for colorscale.

type

type of graph, "l" for line, "p" for points, or "b" for both.

col

colorscale for image, a function

lwd

line width (ignored if type="p")

atTop

optional vector of time values, for labels at the top of the plot produced with which=2. If labelsTop is provided, then it will hold the labels. If labelsTop is not provided, the labels will be co

labelsTop

optional vector of character strings to be plotted above the atTop times. Ignored unless atTop was provided.

despike

remove vertical banding by using smooth to smooth across image columns, row by row.

drawBottom

optional flag used for section images. If TRUE, then the bottom is inferred as a smoothed version of the ridge of highest image value, and data below that are grayed out after the image is drawn. If drawBottom

ignore

optional flag specifying the thickness in metres of a surface region to be ignored during the bottom-detection process. This is ignored unless drawBottom=TRUE.

radius

radius to use for maps; ignored unless which=3 or which="map".

coastline

coastline to use for maps; ignored unless which=3 or which="map".

adorn

list of expressions to be executed for the panels in turn, e.g. to adorn the plots. If the number matches the number of panels, then the strings are applied to the appropriate panels, as they are drawn from top-left to bottom-right. I

mgp

3-element numerical vector to use for par(mgp), and also for par(mar), computed from this. The default is tighter than the R default, in order to use more space for the data and less for the axes.

mar

value to be used with par("mar").

debug

set to an integer exceeding zero, to get debugging information during processing.

...

optional arguments passed to plotting functions. For example, for maps, it is possible to specify the radius of the view in kilometres, with radius.

Details

Simple linear approximation is used when a newx value is specifie with the which=2 method, but arguably a gridding method should be used, and this may be added in the future.

See Also

The documentation for echosounder-class explains the structure of echosounder objects, and also outlines the other functions dealing with them.

Examples

library(oce)
data(echosounder)
data(coastlineSLE)
plot(echosounder, which=c(1,3), coastline=coastlineSLE, radius=2, drawBottom=TRUE)