standingTree-class: Class '"standingTree"': Representation of Standing Trees

In sampSurf: Sampling Surface Simulation for Areal Sampling Methods

Description

A subclass of virtual class “Stem” that can be used to represent standing trees. The class provides for creation and graphical display of “standingTree” objects.

Detail examples and information concerning this class is found in “The Stem Class” vignette, which should be consulted for more details on creating and using objects from this class.

Objects from the Class

Objects can be created by calls of the form new("standingTree", ...). However, this is not recommended. The object has a number of required slots that can be somewhat complex to calculate. Therefore, a constructor function standingTree has been provided that will make the desired object with the correct values for the slots. It is strongly recommended that one use this generic's methods to create the tree objects.

Slots

Please note that all diameters below are presumed to be in the same units as height, i.e., meters for “metric”, and feet for “English” units.

In addition to the slots provided by the virtual superclass “Stem”, the following slots are represented...

buttDiam:

Object of class "numeric": The diameter at the butt (e.g., stump) of the tree in the same units a height.

topDiam:

Object of class "numeric": The diameter at the tip of the tree in the same units a height.

height:

Object of class "numeric": The total height of the tree in feet or meters.

dbh:

Object of class "numeric": The diameter at breast height of the tree.

ba:

Object of class "numeric": The tree basal area.

solidType:

Object of class "numericNULL": Object of class "numericNULL": The form parameter in the simple taper and volume equation presented in Van Deusen (1990) and Gove and Van Deusen (2011).

treeVol:

Object of class "numeric": The tree's volume.

surfaceArea:

Object of class "numeric": The tree's surface area.

biomass:

Object of class "numeric": The tree's stem biomass. This will be NA if no conversion was specified at object creation.

carbon:

Object of class "numeric": The tree's stem carbon content. This will be NA if no conversion was specified at object creation.

conversions:

Object of class "numeric": A vector with names c('volumeToWeight','weightToCarbon') specifying the conversion factors for woody biomass and carbon content.

taper:

Object of class "data.frame": The tree's taper, either as specified from measurements, or as generated via standingTree.

profile:

Object of class "data.frame": The tree profile as generated from the taper. The tree is assumed to be oriented standing North, and the pith of the base at the origin.

transTree:

Object of class "matrix": Same as profile, but translated as desired.

spTree:

Object of class "SpatialPolygons": A SpatialPolygons representation of transTree (i.e., the full standing tree) via the sp package.

spDBH:

Object of class "SpatialPolygons": A SpatialPolygons representation of the tree dbh.

Extends

Class "Stem", directly.

Methods

bbox

signature(obj = "standingTree"): Returns the bounding box for the object.

perimeter

signature(object = "standingTree"): Extract the perimeter as a "SpatialPolygons" object for possible plotting.

plot

signature(x = "standingTree", y = "missing"): Plots the object.

summary

signature(object = "standingTree"): A summary of the object.

Author(s)

Jeffrey H. Gove

References

Gove, J. H. and Van Deusen, P. C. 2011. On fixed-area plot sampling for downed coarse woody debris. Forestry Forestry 84:109–117.

Van Deusen, P.C. 1990. Critical height versus importance sampling for log volume: does critical height prevail? Forest Science
36(4):930–938.

“The Stem Class” vignette in this package.

See Also

"Stem", "downLog", "StemContainer"

Examples

showClass("standingTree")

sampSurf documentation built on March 5, 2021, 5:06 p.m.