Plot Taper Profiles from Dendrometered Trees

Share:

Description

This routine will generate a lattice conditional plot for one or more trees in an list returned from SplineVolume. The plots can include a splined version of the profile if desired.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
taperPlot(ds,
          TreeNos = NA,
          diamKind = c("dib", "dob"),
          diamType = c("diameter", "radius", "xsection"),
          standUp = FALSE,
          ylab = NULL,
          xlab = NULL,
          rugReadings = c('SC','PC'), 
          method = "mono",
          maxTrees = 50,
          fileName = "",
          pointsize.text = 12,
          ...)

Arguments

ds

A list object of class “SplineVolume”, that has been generated by SplineVolume.

TreeNos

The tree numbers in the collection to be plotted. If NA or NULL, the entire collection of trees in the object will be plotted. Otherwise, this should be a vector of tree numbers. Any not found in the collection are ignred.

diamKind

One can choose to use diameter inside or outside bark, though they may both be the same if no bark thinckness information was taken in the dendrometry.

diamType

Once can also choose to use diameter, radius or cross-sectional area in the plots.

standUp

TRUE: align the tree height vertically; FALSE align it horizontally (default).

ylab

The y-axis label for plotting, the default depends on standUp and diamType. Beyond this, you should pass your own labels to make sense of the graph (i.e., for inside or outside bark). See xyplot for more information.

xlab

The x-axis label for plotting–see ylab for more information.

rugReadings

A vector of character product codes indicating where in the sense of tree height readings you would like ‘rug’ marks to appear in the graphs. For example, the defaults c('SC','PC') are two codes the author used to signify crown base in sawtimber and pulpwood products. Use NA or NULL for no rug marks.

method

The spline method to use in plotting if desired. The method must be one that is compatible with splinefun. Note that if no spline is desire, use NA or NULL.

maxTrees

Limits the maximum nmber of tree profiles in any one lattice plot. This is obviously resettable and is there simply as a way to alert you about perhaps plotting hundreds of trees when you did not want to. Override as desired.

fileName

The file name for the output file. Please see hardcopyLattice for more details. A blank string (default) signals no hard copy.

pointsize.text

The point size for the hard copy if desired. Please see hardcopyLattice for more details.

...

Arguments that are to be passed to xyplot.

Details

The default produces one lattice condition panel for each tree. it is quite simple. Please note that you must pass it a legal list of S3 class “SplineVolume” for it to work. There are few error checks other than this.

Value

The function returns the Lattice plot object invisibly.

Author(s)

Jeffrey Gove

See Also

xyplot

Examples

1
2
3
4
5
6
7
#
# assume dendro is an object from SplineVolume, then, e.g.,...
#
## Not run: 
plt = taperPlot(dendro, type='l', grid=T, diamType='xsection', standUp=TRUE)

## End(Not run)