gmt (version 1.2-0)

psbar: Add Bars to GMT Mercator Map

Description

Call GMT to add bars to a map and save in postscript format.

Usage

psbar(x, cmd="-J -R -W1p -G180 -O -K", file=getOption("gmt.file"), ref=0, digits=getOption("digits"))

Arguments

x

data frame, matrix, or filename containing the data to be plotted.

cmd

string of arguments passed to psxy.

file

filename where the map is saved.

ref

reference latitude where height 1 renders a bar 1 degree high.

digits

precision used when rounding the geographic coordinates.

Value

Null, but the map is annotated and saved in postscript format.The temporary GMT input file ‘bar.gmt’ is saved in directory dirname(tempdir()), for the user to view or edit. It is later removed by psclose().

Details

The data are arranged in four columns: Lon, Lat, Width, and Height, in that order.

If x is a filename, the data should be tabular with or without a header, separated by commas or whitespace. The first line is interpreted as header if the first non-whitespace character is not minus, point, or number.

This function provides an alternative to psxy -Sb and psxy -Sr for drawing bars on a Mercator map. See the GMT documentation for details on psxy and other GMT commands.

See Also

Similar to barplot and postscript in native R graphics.

gmt, pscoast, psxy, pstext, psbar, and psclose work together to draw maps.

gmt-package gives an overview of the package.

Examples

## Not run: 
# # Draw map and save as "map.eps" in R working directory
# gmt(demo.par)
# pscoast(demo.coast)
# psxy(demo.xy)
# pstext(demo.text)
# psbar(demo.bar, ref=66)
# psclose()
# # See directory gmt/example for details
# ## End(Not run)