Learn R Programming

oce (version 0.9-18)

plot.ctd: Plot seawater CTD data

Description

Plot CTD data, by default in a four-panel display showing (a) profiles of salinity and temperature, (b) profiles of density and the square of buoyancy frequency, (c) a TS diagram and (d) a coastline diagram indicating the station location.

Usage

## S3 method for class 'ctd':
plot(x, which,
     col=par("fg"), fill,
     borderCoastline=NA, colCoastline="lightgray",
     eos=getOption("oceEOS", default='gsw'),
     ref.lat=NaN, ref.lon=NaN, 
     grid=TRUE,
     coastline="best",
     Slim, Clim, Tlim, plim, densitylim, N2lim, Rrholim,
     dpdtlim, timelim,
     lonlim, latlim,
     clongitude, clatitude, span, showHemi=TRUE,
     lonlabel=NULL, latlabel=NULL, sides=NULL,
     projection=NULL, parameters=NULL, orientation=NULL,
     latlon.pch=20, latlon.cex=1.5, latlon.col="red",
     cex=1, cex.axis=par('cex.axis'),
     pch=1,
     useSmoothScatter=FALSE,
     df,
     keepNA=FALSE,
     type='l',
     adorn=NULL,
     mgp=getOption("oceMgp"),
     mar=c(mgp[1]+1.5,mgp[1]+1.5,mgp[1]+1.5,mgp[1]+1),
     inset=FALSE,
     add=FALSE,
     debug=getOption("oceDebug"),
     ...)

Arguments

x
A ctd object, e.g. as read by read.ctd, or a list containing items named salinity and temperature.
which
list of desired plot types, as given below. If which is not supplied, a default will be used. This default will be c(1,2,3,5) if the CTD is in profiling mode (i.e. if x@metadata$deploymentType=="profile"
col
colour of lines or symbols
fill
a legacy parameter that will be permitted only temporarily; see History.
borderCoastline
colour of coastlines and international borders, passed to plot.coastline if a map is included in which.
colCoastline
fill colour of coastlines and international borders, passed to plot.coastline if a map is included in which. Set to NULL to avoid filling.
eos
equation of state to be used, either "unesco" or "gsw".
ref.lat
Latitude of reference point for distance calculation
ref.lon
Longitude of reference point for distance calculation
grid
Set TRUE to get a grid on all plots.
coastline
a specification of the coastline to be used for which="map". This may be a coastline object, whether built-in or supplied by the user, or a character string. If the later, it may be the name of a built-in coastline (
Slim
optional limits of salinity axes
Clim
optional limits of conductivity axes
Tlim
optional limits of temperature axes
plim
optional limits of pressure axes
densitylim
optional limits of density axis
N2lim
optional limits of $N^2$ axis
Rrholim
optional limits of $R_rho$ axis
dpdtlim
optional limits of dP/dt axis
timelim
optional limits of delta-time axis
lonlim
optional limits of longitude axis of map (ignored if no map plotted) DEPRECATED 2014-01-07
latlim
optional limits of latitude axis of map (ignored if no map plotted) DEPRECATED 2014-01-07
clongitude
center longitude
clatitude
center latitude
span
optional span of map, in km. If not given, this will be determined as a small multiple of the distance to the nearest point of land, in an attempt to show some coastline in the plot.
showHemi
logical indicating whether to show hemisphere in axis tick labels.
lonlabel,latlabel,sides
optional vectors of longitude and latitude to label on the indicated sides of plot, passed to plot.coastline. Using these arguments permits reasonably simple customization. If the
projection
projection for map, if desired. If this is NULL, no projection will be used; the map will simply show longitude and latitude in a cartesian frame, scaled to retain shapes at the centre. If this is the string "automat
parameters
parameters for map, as for projection.
orientation
orientation for map, as for projection.
latlon.pch
pch for sample location (ignored if no map plotted)
latlon.cex
cex for sample location (ignored if no map plotted)
latlon.col
col for sample location (ignored if no map plotted)
cex
size to be used for plot symbols (see par)
cex.axis
size factor for axis labels (see par)
pch
code for plotting symbol (see par).
useSmoothScatter
boolean, set to TRUE to use smoothScatter instead of plot to draw the plot.
df
optional argument that is ignored except for plotting buoyancy frequency; in that case, it is passed to swN2 as the argument named df.
keepNA
flag indicating whether to keep NA values in linegraphs, which will yield breaks in the lines.
type
type of plot to draw, using the same scheme as plot.
adorn
list of expressions to be executed for the panels in turn, e.g. to adorn the plots. If the number matches the number of panels, then the strings are applied to the appropriate panels, as they are drawn from top-left to bottom-right. If onl
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").
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
add
add to an existing plot. This only works if length(which)=1, and it will yield odd results if the value of which does not match that in the previous plots.
debug
set to a positive value to get debugging information during processing.
...
optional arguments passed to plotting functions. A common example is to set df, for use in swN2 calculations.

History

Until February, 2016, plot.cctd relied on a now-defunct argument fill to control colours; colCoastline is to be used now, instead. Also, now it is possible to set the edge of coasts and international boundaries, with borderCoastline.

Details

Creates a multi-panel summary plot of data measured in a CTD cast. The panels are controlled by the which argument. Normally, 4 panels are specified with the which, but it can also be useful to specify less than 4 panels, and then to draw other panels after this call.

If only 2 panels are requested, they will be drawn side by side.

If more than one panel is drawn, then on exit from plot.ctd, the value of par will be reset to the value it had before the function call. However, if only one panel is drawn, the adjustments to par made within plot.ctd are left in place, so that further additions may be made to the plot.

See Also

The documentation for ctd-class explains the structure of CTD objects, and also outlines the other functions dealing with them.

Examples

Run this code
library(oce)
data(ctd) 
plot(ctd)

Run the code above in your browser using DataLab