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))

Value

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

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.

Author

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

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.

Examples

Run this code

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))
})

Run the code above in your browser using DataLab