plot.echosounder: Plot echosounder data

Description

Plot echosounder data

Usage

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

Arguments

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"

beam

a more detailed specification of the data to be plotted. For single-beam data, this may only be "a". For dual-beam data, this may be "a" for the narrow-beam signal, or "b" for the wide-beam signal

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, ylab

optional labels for the horizontal and vertical axes; if not provided, the labels depend on the value of which.

xlim

optional range for x axis.

ylim

optional range for y axis.

zlim

optional range for colour scale.

type

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

col

colour scale 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.

tformat

optional argument passed to imagep, for plot types that call that function. (See strptime for the format used.)

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.

drawTimeRange

if TRUE, the time range will be drawn at the top. Ignored except for which=2, i.e. distance-depth plots.

drawPalette

if TRUE, the palette will be drawn.

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.

Value

A list is silently returned, containing xat and yat, values that can be used by oce.grid to add a grid to the plot.

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.

Examples

Run this code

library(oce)
data(echosounder)
plot(echosounder, which=c(1,2), drawBottom=TRUE)