imap.ll: The Imap plotting function - usually called by imap()

Description

imap.ll() is the underlying mapping function that is called by imap() for each item in the 'longlat' list.

Usage

imap.ll(area = npacific, longrange, latrange, poly = NA, antarctic = FALSE, arctic = FALSE, oz = FALSE, axes = "map",  grid = FALSE, aspect = 1.5, add = FALSE, zoom = TRUE, lines.out.of.bounds = TRUE, tol = 0.05, ...)
select.lines(area = npacific, longrange, latrange, poly = NA, antarctic = FALSE, arctic = FALSE, oz = FALSE, axes = "map", grid = FALSE, aspect = 1.5, add = FALSE, zoom = TRUE, lines.out.of.bounds = TRUE, tol = 0.005, ...)

Arguments

area

A 2 dimension matrix or data frame with the first column the longitude or x-axis column and the second column the latitude or y-axis column. A simple two item list where the first item is the longitude (or x) and the second item is the latitude (or y) can also be supplied. As with the lines() function a row of NA's will produce a break in the lines (equivalent to a pen-up on a plotter).

longrange

The initial longitudinal or x-axis range to be plotted.

latrange

The initial latitudinal or y-axis range to be plotted.

poly

A single value for the fill color of the polygon(s).

antarctic

Should the perspective be looking down on the South Pole. Default is FALSE. If TRUE, axes will be set to FALSE.

arctic

Should the perspective be looking down on the North Pole. Default is FALSE. If TRUE, axes will be set to FALSE.

Should the perspective be with the South Pole on top (As one in Australia (Oz) might like.). Default is FALSE.

axes

One of "map" (the default), "std", or FALSE. Using "map" will show longitude and latitude markings, "std" will give the standard plotting labels, and FALSE will give no axes at all.

grid

If TRUE a thin dashed grid will be shown. Default in FALSE.

aspect

A figure aspect for which larger values mean the figure will be more high than wide. Lower values will give a figure that is wider than high. The default is 1.5.

add

If TRUE, 'area' will added to the current plot. Default if FALSE.

zoom

If TRUE (default) the zooming feature will be enabled. Zooming is accomplished by left-clicking in two different locations on the figure to define a rectangle that will be zoomed into. Left-clicking outside the plot region (but somewhere in the figure region) will zoom out. Double left clicking on the same spot will reset the plot. Right-click to stop.

lines.out.of.bounds

Vestigial. May only need to be set to FALSE for older versions of Splus. Default is TRUE.

tol

The tolerance used when double left clicking on the same spot to reset the data. If very low values of data are supplied or the zooming in is extreme, this value may need to be lowered. Default is 0.05 .

...

Any extra arguments are checked the a 'plt.' prefix. Any such argument will be applied to the plot() function, all others will be applied to the lines() function. (For those looking to see how this was done, look at the top of the imap.ll() function and search on 'plot.dots' and 'lines.dots')

Value

Only data contained within the last area to be zoomed in on is invisibly returned as a (n x 2) matrix.

Details

The function select.lines has similar argumnets to imap.ll but is used to select line seqments. See the Examples Section.

Examples

Run this code

## Not run: 
# 
# ilines(list(npacific, select.lines(npacific)))  # Select one or more line seqments with left-click(s) and then a right-click to stop.
#  
# Africa <- select.lines(world.h.land) # Select the African polygon.
# imap(zoom = FALSE)
# imap(Africa, poly = 'purple', add = T, zoom = FALSE)
# 
# ## End(Not run)