oce (version 1.8-3)

oce.grid: Add a Grid to an Existing Oce Plot

Description

Add a Grid to an Existing Oce Plot

Usage

oce.grid(xat, yat, col = "lightgray", lty = "dotted", lwd = par("lwd"))

Arguments

xat

either a list of x values at which to draw the grid, or the return value from an oce plotting function

yat

a list of y values at which to plot the grid (ignored if gx was a return value from an oce plotting function)

col

color of grid lines (see par())

lty

type for grid lines (see par())

lwd

width for grid lines (see par())

Details

For plots not created by oce functions, or for missing xat and yat, this is the same as a call to grid() with missing nx and ny. However, if xat is the return value from certain oce functions, a more sophisticated grid is constructed. The problem with grid() is that it cannot handle axes with non-uniform grids, e.g. those with time axes that span months of differing lengths.

As of early February 2015, oce.grid handles xat produced as the return value from the following functions: imagep() and oce.plot.ts(), plot,adp-method(), plot,echosounder-method(), and plotTS(). It makes no sense to try to use oce.grid for multipanel oce plots, e.g. the default plot from plot,adp-method().

Examples

library(oce)
i <- imagep(volcano)
oce.grid(i, lwd = 2)

data(sealevel)
i <- oce.plot.ts(sealevel[["time"]], sealevel[["elevation"]])
oce.grid(i, col = "red")

data(ctd)
i <- plotTS(ctd)
oce.grid(i, col = "red")

data(adp)
i <- plot(adp, which = 1)
oce.grid(i, col = "gray", lty = 1)

data(echosounder)
i <- plot(echosounder)
oce.grid(i, col = "pink", lty = 1)