oce.plot.ts {oce} | R Documentation |
Plot a time-series, obeying the timezone and possibly drawing the range in the top-left margin.
oce.plot.ts(x, y, type = "l", xlim, ylim, xlab, ylab, drawTimeRange, adorn = NULL, fill = FALSE, xaxs = par("xaxs"), yaxs = par("yaxs"), cex = par("cex"), cex.axis = par("cex.axis"), cex.main = par("cex.main"), mgp = getOption("oceMgp"), mar = c(mgp[1] + if (nchar(xlab) > 0) 1.5 else 1, mgp[1] + 1.5, mgp[2] + 1, mgp[2] + 3/4), main = "", despike = FALSE, axes = TRUE, tformat, marginsAsImage = FALSE, grid = FALSE, grid.col = "darkgray", grid.lty = "dotted", grid.lwd = 1, debug = getOption("oceDebug"), ...)
x |
the times of observations. |
y |
the observations. |
type |
plot type, |
xlim |
optional limit for x axis. This has an additional effect, beyond that for conventional R functions: it effectively windows the data, so that autoscaling will yield limits for y that make sense within the window. |
ylim |
optional limit for y axis. |
xlab |
name for x axis; defaults to |
ylab |
name for y axis; defaults to the plotted item. |
drawTimeRange |
an optional indication of whether/how to draw a time range,
in the top-left margin of the plot; see |
adorn |
(Defunct)
An |
fill |
boolean, set |
xaxs |
control x axis ending; see |
yaxs |
control y axis ending; see |
cex |
size of labels on axes; see |
cex.axis |
see |
cex.main |
see |
mgp |
3-element numerical vector to use for |
mar |
value to be used with |
main |
title of plot. |
despike |
boolean flag that can turn on despiking with
|
axes |
boolean, set to |
tformat |
optional format for labels on the time axis |
marginsAsImage |
boolean indicatingn whether to set the right-hand
margin to the width normally taken by an image drawn with
|
grid |
if |
grid.col |
colour of grid |
grid.lty |
line type of grid |
grid.lwd |
line width of grid |
debug |
a flag that turns on debugging. Set to 1 to get a moderate amount of debugging information, or to 2 to get more. |
... |
graphical parameters passed down to |
Depending on the version of R, the standard plot
and
plot.ts
routines will not obey the time zone of the data.
This routine gets around that problem. It can also plot the time range in
the top-left margin, if desired; this string includes the timezone, to
remove any possible confusion.
The time axis is drawn with oce.axis.POSIXct
.
A list is silently returned, containing xat
and yat
,
values that can be used by oce.grid
to add a grid to the plot.
Dan Kelley
library(oce) t0 <- as.POSIXct("2008-01-01", tz="UTC") t <- seq(t0, length.out=48, by="30 min") y <- sin(as.numeric(t - t0) * 2 * pi / (12 * 3600)) oce.plot.ts(t, y, type='l', xaxs='i')