plot.topo {oce}R Documentation

Plot topography data

Description

Plot contours of topographic data.

Usage

## S4 method for signature 'topo'
plot(x, 
     xlab="", ylab="",
     asp,
     clongitude, clatitude, span,
     expand=1.5,
     water.z,
     col.water,
     lty.water,
     lwd.water,
     land.z, 
     col.land,
     lty.land,
     lwd.land,
     geographical=FALSE,
     location="topright", 
     mgp=getOption("oceMgp"),
     mar=c(mgp[1]+1,mgp[1]+1,1,1),
     debug=getOption("oceDebug"),
     ...)

Arguments

x

an topo object, e.g. as read by read.topo.

xlab

label for x axis

ylab

label for y axis

asp

Aspect ratio for plot. The default is for plot.coastline to set the aspect ratio to give natural latitude-longitude scaling somewhere near the centre latitude on the plot. Often, it makes sense to set asp yourself, e.g. to get correct shapes at 45N, use asp=1/cos(45*pi/180). Note that the land mass is not symmetric about the equator, so to get good world views you should set asp=1 or set ylim to be symmetric about zero. Any given value of asp is ignored, if clongitude and clatitude are given.

clatitude

optional center latitude of map, in degrees north. If this and clongitude are provided, then any provided value of asp is ignored, and instead the plot aspect ratio is computed based on the center latitude. Also, if clongitude and clatitude are provided, then span must be, also.

clongitude

optional center longitude of map, in degrees east; see clatitude.

span

optional suggested span of plot, in kilometers (must be supplied, if clongitude and clatitude are supplied).

expand

numerical factor for the expansion of plot limits, showing area outside the plot, e.g. if showing a ship track as a coastline, and then an actual coastline to show the ocean boundary. The value of expand is ignored if either xlim or ylim is given.

water.z

depths at which to plot water contours. If not provided, these are inferred from the data.

col.water

colours corresponding to water.z values. If not provided, these will be "fill" colours from oce.colorsGebco.

lty.water

line type(s) for water contours

lwd.water

line width(s) for water contours

land.z

depths at which to plot land contours. If not provided, these are inferred from the data. If set to NULL, no land contours will be plotted.

col.land

colours corresponding to land.z values. If not provided, these will be "fill" colours from oce.colorsGebco.

lty.land

line type(s) for land contours

lwd.land

line width(s) for land contours

geographical

set to TRUE to get latitudes and longitudes without minus signs.

location

location for a legend (or "none", for no legend).

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

debug

boolean value, set to TRUE to get some debugging information.

...

additional arguments passed on to plotting functions

Details

The plot aspect ratio is set based on the middle latitude in the plot. Be aware that the ETOPO2 data are on a 2-minute (roughly 2-mile) spacing, and coastlines created with such data can be quite inaccurate on scales of 100km or less.

The line properties, such as land.lwd, may either be a single item, or a vector; in the latter case, the length must match the length of the corresponding properties, e.g. land.z.

Author(s)

Dan Kelley

See Also

TOPO data can be created with read.topo and summarized with summary.topo.

Examples

library(oce)
data(topoWorld)
plot(topoWorld, clongitude=-60, clatitude=45, span=10000)

[Package oce version 0.9-18 Index]