PBSmapping (version 2.72.1)

makeProps: Make Polygon Properties

Description

Append a column for a polygon property (e.g., border or lty) to PolyData based on measurements in the PolyData's Z column.

Usage

makeProps(pdata,breaks,propName="col",propVals=1:(length(breaks)-1))

Arguments

pdata

PolyData with a Z column.

breaks

either a vector of cut points or a scalar denoting the number of intervals that Z is to be cut into.

propName

name of the new column to append to pdata.

propVals

vector of values to associate with Z breaks.

Value

PolyData with the same columns as pdata plus an additional column propName.

Details

This function acts like the cut function to produce PolyData suitable for the polyProps plotting argument (see addLabels, addLines, addPoints, addPolys, addStipples, plotLines, plotMap,plotPoints, and plotPolys). The Z column of pdata is equivalent to the data vector x of the cut function.

See Also

addLabels, addLines, addPoints, addPolys, addStipples, plotLines, plotMap, plotPoints, plotPolys, PolyData, PolySet.

Examples

# NOT RUN {
local(envir=.PBSmapEnv,expr={
  #--- create a PolyData object
  pd <- data.frame(PID=1:10, Z=1:10)

  #--- using 3 intervals, create a column named `col' and populate it with
  #--- the supplied values
  makeProps(pdata=pd, breaks=3, propName="col", propVals=c(1:3))
})
# }