oce (version 0.8-7)

plotTS: Plot temperature-salinity diagram for seawater (CTD) data

Description

Plot temperature-salinity diagram for seawater (CTD) data.

Usage

plotTS(x,
     inSitu=FALSE,
     referencePressure=0,
     rhoLevels=6,
     grid=TRUE,
     col.grid="lightgray",
     lty.grid="dotted",
     rho1000=FALSE,
     cex=par("cex"), col=par("col"), pch=par("pch"), bg,
     col.rho="darkgray",
     cex.rho=3/4*par("cex"),
     rotateRhoLabels=FALSE,
     connectPoints=FALSE,
     useSmoothScatter=FALSE,
     xlab,
     ylab,
     Slim,
     Tlim,
     mgp=getOption("oceMgp"),
     mar=c(mgp[1]+1,mgp[1]+1,mgp[1],mgp[1]),
     lwd.rho=par("lwd"), lty.rho=par("lty"),
     add=FALSE, inset=FALSE,
     debug=getOption("oceDebug"),
     ...)

Arguments

x

An object containing salinity and temperature data, typically a cdt object or section object.

inSitu

A boolean indicating whether to use in-situ temperature or (the default) potential temperature, calculated with reference pressure given by referencePressure.

referencePressure

reference pressure, to be used in calculating potential temperature, if inSitu is FALSE.

rhoLevels

Either a list of density levels for which to draw isopycnal lines, or a suggestion for the number of levels. In the latter case, pretty() is used to select levels.

grid

a flag that can be set to TRUE to get a grid.

col.grid

colour for grid.

lty.grid

line type for grid.

rho1000

if TRUE, label isopycnals as e.g. 1024; if FALSE, label as e.g. 24

cex

character-expansion factor for symbols, as in par("cex").

pch

symbol type, as in par("pch").

bg

optional colour to be painted under plotting area, before plotting. (This is useful for cases in which inset=TRUE.)

col

colour for symbols.

col.rho

colour for isopycnal lines.

cex.rho

size of isopycnal labels.

rotateRhoLabels

if TRUE, labels in right-hand margin are written vertically

connectPoints

if TRUE, the points are connected with line segments, in sequence

useSmoothScatter

if TRUE, use smoothScatter to plot the points.

xlab

optional label for the x axis, with default "Salinity [PSU]".

ylab

optional label for the y axis, with default "Temperature [C]".

Slim

optional limits for salinity axis, otherwise inferred from data.

Tlim

optional limits for temperature axis, otherwise inferred from data.

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

lwd.rho

line width for density lines. If connectPoints=TRUE, then the line connecting points may be controlled by including a lwd value in the optional arguments.

lty.rho

line type for density lines. (See the note about connectPoints for lwd.rho.)

add

a flag that controls whether to add to an existing plot. (It makes sense to use add=TRUE in the panel argument of a coplot, for example.)

inset

set to TRUE for use within plotInset. The effect is to prevent the present function from adjusting margins, which is necessary because margin adjustment is the basis for the meth

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.

Value

• None.

Details

Creates a temperature-salinity plot for a CTD cast, with labeled isopycnals.

See Also

summary.ctd summarizes the information, while read.ctd scans it from a file.

Examples

library(oce)
data(ctd)
plotTS(ctd)