R: Plot a topo Object

plot,topo-method {oce}

R Documentation

Plot a topo Object

Description

This plots contours of topographic elevation. The plot aspect ratio is set based on the middle latitude in the plot. 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.

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`	a topo object.
`xlab`, `ylab`	Character strings giving a label for the x and y axes.
`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.
`clongitude`	Optional center longitude of map, in degrees east; see `clatitude`.
`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.
`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`	Colors corresponding to `water.z` values. If not provided, these will be `"fill"` colors 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`	Colors corresponding to `land.z` values. If not provided, these will be `"fill"` colors from `oce.colorsGebco()`.
`lty.land`	Line type(s) for land contours.
`lwd.land`	Line width(s) for land contours.
`geographical`	Logical, indicating whether to plot 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`	Four-element numerical vector to be used with `par("mar")`.
`debug`	Numerical value, with positive values indicating higher levels of debugging.
`...`	Additional arguments passed on to plotting functions.

Author(s)

Dan Kelley

Examples

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