addPoints: Add EventData/PolyData to an Existing Plot as Points

In PBSmapping: Mapping Fisheries Data and Spatial Analysis Tools

Add EventData/PolyData to an Existing Plot as Points

Description

Add EventData/PolyData to an existing plot, where each unique EID describes a point.

Usage

addPoints (data, xlim = NULL, ylim = NULL, polyProps = NULL,
           cex = NULL, col = NULL, pch = NULL, ...)

Arguments

data	EventData or PolyData to add (required).
xlim	range of X-coordinates.
ylim	range of Y-coordinates.
polyProps	PolyData specifying which points to plot and their properties. par parameters passed as direct arguments supersede these data.
cex	vector describing character expansion factors (cycled by EID or PID).
col	vector describing colours (cycled by EID or PID).
pch	vector describing plotting characters (cycled by EID or PID).
...	additional par parameters for the points function.

Details

This function clips data to xlim and ylim before plotting. It only adds PolyData containing X and Y columns.

For additional help on the arguments cex, col, and pch, please see par.

Value

PolyData consisting of the PolyProps used to create the plot.

Author(s)

Nicholas M. Boers, Staff Software Engineer
Jobber, Edmonton AB
Last modified Rd: 2013-04-10

See Also

combineEvents, convDP, findPolys, locateEvents, plotPoints.

Examples

local(envir=.PBSmapEnv,expr={
  oldpar = par(no.readonly=TRUE)
  #--- load the data (if using R)
  if (!is.null(version$language) && (version$language=="R"))
    data(nepacLL,surveyData,envir=.PBSmapEnv)
  #--- plot a map
  plotMap(nepacLL, xlim=c(-136, -125), ylim=c(48, 57))
  #--- add events
  addPoints(surveyData, col=1:7)
  par(oldpar)
})

PBSmapping documentation built on Sept. 30, 2024, 9:21 a.m.