plot.adv {oce} | R Documentation |
Plot ADV data
## S4 method for signature 'adv' plot(x, which=c(1:3,14,15), col, titles, type="l", lwd=par('lwd'), adorn=NULL, drawTimeRange=getOption("oceDrawTimeRange"), drawZeroLine=FALSE, useSmoothScatter, mgp=getOption("oceMgp"), mar=c(mgp[1]+1.5,mgp[1]+1.5,1.5,1.5), tformat, marginsAsImage=FALSE, cex=par("cex"), cex.axis=par("cex.axis"), cex.main=par("cex.main"), xlim, ylim, brushCorrelation, colBrush="red", main="", debug=getOption("oceDebug"), ...)
x |
an |
which |
list of desired plot types. These are graphed in
panels running down from the top of the page. See
“Details” for the meanings of various values of
|
col |
optional indication of colour(s) to use. If not provided,
the default for images is |
titles |
optional vector of character strings to be used as
labels for the plot panels. For images, these strings will be
placed in the right hand side of the top margin. For timeseries,
these strings are ignored.
If this is provided, its length must equal that of |
lwd |
if the plot is of a time-series or scattergraph format with lines, this is used in the usual way; otherwise, e.g. for image formats, this is ignored. |
type |
type of plot, as for |
adorn |
optional list of |
drawTimeRange |
boolean that applies to panels with time as the horizontal axis, indicating whether to draw the time range in the top-left margin of the plot. |
drawZeroLine |
boolean that indicates whether to draw zero lines on velocities. |
useSmoothScatter |
boolean that indicates whether to use
|
,
mgp |
3-element numerical vector to use for |
mar |
value to be used with |
tformat |
optional argument passed to |
marginsAsImage |
boolean, |
cex |
size of labels on axes; see |
cex.axis |
see |
cex.main |
see |
xlim |
optional 2-element list for |
ylim |
optional 2-element list for |
brushCorrelation |
optional number between 0 and 100, indicating
a per-beam correlation threshhold below which data are to be
considered suspect. If the plot type is |
colBrush |
colour to use for brushed (bad) data, if
|
main |
main title for plot, used just on the top panel, if there are several panels. |
debug |
a flag that turns on debugging. Set to 1 to get a moderate amount of debugging information, or to 2 to get more. |
... |
optional arguments passed to plotting functions. |
Creates a multi-panel summary plot of data measured by an ADV.
The panels are controlled by the which
argument. (Note the
gaps in the sequence, e.g. 4 and 8 are not used.)
which=1
to 3
(or "u1"
to "u3"
)
yield timeseries of the first, second, and third components of velocity (in beam, xyz or enu coordinates).
which=4
is not permitted (since ADV are 3-beam devices)
which=5
to 7
(or "a1"
to "a3"
)
yield timeseries of the amplitudes of beams 1 to 3. (Note that
the data are called data$a[,1]
, data$a[,2]
and
data$a[,3]
, for these three timeseries.)
which=8
is not permitted (since ADV are 3-beam devices)
which=9
to 11
(or "q1"
to "q3"
)
yield timeseries of correlation for beams 1 to 3. (Note that the
data are called data$c[,1]
, data$c[,2]
and
data$c[,3]
, for these three timeseries.)
which=12
is not permitted (since ADVs are 3-beam devices)
which=13
is not permitted (since ADVs do not measure salinity)
which=14
or which="temperature"
yields a timeseries of temperature.
which=15
or which="pressure"
yields a timeseries of pressure.
which=16
or which="heading"
yields a timeseries of heading.
which=17
or which="pitch"
yields a timeseries of pitch.
which=18
or which="roll"
yields a timeseries of roll.
which=19
to 21
yields plots of correlation versus
amplitude, for beams 1 through 3, using smoothScatter
.
which=22
is not permitted (since ADVs are 3-beam devices)
which=23
or "progressive vector"
yields a
progressive-vector diagram in the horizontal plane, plotted with
asp=1
, and taking beam1 and beam2 as the eastward and
northward components of velocity, respectively.
which=28
or "uv"
yields velocity plot in the
horizontal plane, i.e. u[2] versus u[1]. If the number of data
points is small, a scattergraph is used, but if it is large,
smoothScatter
is used.
which=29
or "uv+ellipse"
as the "uv"
case, but with an added indication of the tidal ellipse,
calculated from the eigen vectors of the covariance matrix.
which=30
or "uv+ellipse+arrow"
as the
"uv+ellipse"
case, but with an added arrow indicating the
mean current.
which=50
or "analog1"
plots a time series of the
analog1 signal, if there is one.
which=51
or "analog2"
plots a time series of the
analog2 signal, if there is one.
which=100
or "voltage"
plots the voltage as a
timeseries, if voltage exists in the dataset.
In addition to the above, there are some groupings defined:
which="velocity"
equivalent to which=1:3
(three velocity components)
which="amplitude"
equivalent to which=5:7
(three amplitude components)
which="backscatter"
equivalent to which=9:11
(three backscatter components)
which="hydrography"
equivalent to which=14:15
(temperature and pressure)
which="angles"
equivalent to which=16:18
(heading, pitch and roll)
Dan Kelley
The documentation for adv-class
explains the structure
of ADV objects, and also outlines the other functions dealing with them.
library(oce) data(adv) plot(adv)