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]