Creates a multi-panel summary plot of data measured by a current meter.

# S4 method for cm
plot(
  x,
  which = c(1:2),
  type = "l",
  xlim,
  ylim,
  xaxs = "r",
  yaxs = "r",
  drawTimeRange = getOption("oceDrawTimeRange"),
  drawZeroLine = FALSE,
  mgp = getOption("oceMgp"),
  mar = c(mgp[1] + 1.5, mgp[1] + 1.5, 1.5, 1.5),
  small = 2000,
  main = "",
  tformat,
  debug = getOption("oceDebug"),
  ...
)

Arguments

x

a cm object.

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 which.

type

type of plot, as for plot().

xlim, ylim

optional limit to the x and y axes, passed to oce.plot.ts() for time-series plots.

xaxs, yaxs

optional controls over the limits of the x and y axes, passed to oce.plot.ts() for time-series plots. These values default to "r", meaning to use the regular method of extend the plot past its normal limits. It is common to use "i" to make the graph extend to the panel limits.

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.

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").

small

an integer indicating the size of data set to be considered "small", to be plotted with points or lines using the standard plot() function. Data sets with more than small points will be plotted with smoothScatter() instead.

main

main title for plot, used just on the top panel, if there are several panels.

tformat

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

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.

Details

The panels are controlled by the which argument, as follows.

  • which=1 or which="u" for a time-series graph of eastward velocity, u, as a function of time.

  • which=2 or which="v" for a time-series graph of northward velocity, u, as a function of time.

  • which=3 or "progressive vector" for progressive-vector plot

  • which=4 or "uv" for a plot of v versus u. (Dots are used for small datasets, and smoothScatter for large ones.)

  • which=5 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=6 or "uv+ellipse+arrow" as the "uv+ellipse" case, but with an added arrow indicating the mean current.

  • which=7 or "pressure" for pressure

  • which=8 or "salinity" for salinity

  • which=9 or "temperature" for temperature

  • which=10 or "TS" for a TS diagram

  • which=11 or "conductivity" for conductivity

  • which=20 or "direction" for the direction of flow

Author

Dan Kelley

Examples

library(oce)
data(cm)
summary(cm)
#> Cm summary
#> ----------
#> 
#> * File source:   "/Users/kelley/Dropbox/data/archive/sleiwex/2008/moorings/m11/cm/interocean_0811786/manufacturer/cm_interocean_0811786.s4a.tab"
#> * Instr. type:   (2Hz)S4
#> * Serial Num.:   8111786
#> * Version:       2.399
#> * North:         magnetic
#> * Time: 2008-06-26 to 2008-06-26 23:59:00 (1440 samples, mean increment 1 min)
#> * Data Overview
#> 
#>                                 Min.      Mean   Max. Dim.  NAs OriginalName
#>     Sample..                     842    1561.5   2281 1440    0     Sample #
#>     Date                          NA        NA     NA 1440    0         Date
#>     Time                          NA        NA     NA 1440    0         Time
#>     dec.S                          0         0      0 1440    0        dec S
#>     v [m/s]                   -0.862 -0.088736   0.74 1440    0       Vnorth
#>     u [m/s]                   -0.478   0.02761  0.654 1440    0        Veast
#>     Speed                       1.44    53.569  98.29 1440    0        Speed
#>     Dir                            7    126.99  352.1 1440    0          Dir
#>     Vref                          NA        NA     NA 1440 1440         Vref
#>     Hx                          -210   -31.052    177 1440    0           Hx
#>     Hy                          -212  -0.58889    211 1440    0           Hy
#>     conductivity [mS/cm]        36.8    36.924   37.2 1440    0         Cond
#>     temperature [°C, ITS-90]   1.204    2.0773  3.065 1440    0       T-Temp
#>     Depth                     73.242    74.767 77.148 1440    0        Depth
#>     none                          NA        NA     NA 1440 1440         none
#>     none.1                        NA        NA     NA 1440 1440         none
#>     Hdg                            0    175.79  359.2 1440    0          Hdg
#>     X                             NA        NA     NA 1440 1440            -
#>     salinity [PSS-78]         41.307     42.71 44.205 1440    0          Sal
#>     Dens                      1033.3    1034.5 1035.8 1440    0         Dens
#>     SV                        1467.9    1469.8 1472.2 1440    0           SV
#>     X.1                           NA        NA     NA 1440 1440            -
#>     N.S.Dist                 -2535.2    4159.5  10349 1440    0     N-S Dist
#>     E.W.Dist                 -2033.5    893.81 4687.5 1440    0     E-W Dist
#>     X.2                           NA        NA     NA 1440 1440            -
#>     SRB.Date                      NA        NA     NA 1440 1440     SRB Date
#>     SRB.Time                      NA        NA     NA 1440    0     SRB Time
#>     Vref.1                     1.226    1.2263   1.23 1440 1152         Vref
#>     Hx.1                          NA        NA     NA 1440 1440           Hx
#>     Hy.1                          NA        NA     NA 1440 1440           Hy
#>     Cond.1                        NA        NA     NA 1440 1440         Cond
#>     T.Temp.1                      NA        NA     NA 1440 1440       T-Temp
#>     Depth.1                       NA        NA     NA 1440 1440        Depth
#>     none.2                        NA        NA     NA 1440 1440         none
#>     none.3                        NA        NA     NA 1440 1440         none
#>     Hdg.1                         NA        NA     NA 1440 1440          Hdg
#>     X.3                           NA        NA     NA 1440 1440            -
#>     Sal.1                         NA        NA     NA 1440 1440          Sal
#>     Dens.1                        NA        NA     NA 1440 1440         Dens
#>     SV.1                          NA        NA     NA 1440 1440           SV
#>     pressure [dbar]           73.855    75.392 77.794 1440    0            -
#> 
#> * Processing Log
#> 
#>     - 2023-02-10 12:50:57 UTC: `create 'cm' object`
#>     - 2023-02-10 12:50:57 UTC: `read.oce("~/data/archive/sleiwex/2008/moorings/m11/cm/interocean_0811786/manufacturer/cm_interocean_0811786.s4a.tab", ...)`
#>     - 2023-02-10 12:50:57 UTC: `subset.cm(x, subset=time < as.POSIXct("2008-06-27 00:00:00", tz = "UTC"))`
plot(cm)