sampSurf (version 0.7-6)

standingTrees-class: Class "standingTrees"

Description

The “standingTrees” class is a simplified container class that can hold multiple objects of class “'>standingTree”. Its specific purpose is to hold a population of standing trees that are either generated synthetically as part of a simulation, or a collection from field measurements. The constructor of the same name has several different forms corresponding to possible argument signatures.

Objects from the Class

Objects can be created by calls of the form new("standingTrees", ...); however, as in the other classes within this package, constructors have been written to simplify the process. The standingTrees constructor should therefore be used in preference to new.

Slots

Please see the virtual base class, “'>StemContainer”, for additional slots definitions.

trees:

Object of class "list": This holds the collection of “standingTree” objects.

Please note that at the present time this class only partially meets the requirements of a true “container class” in object oriented programming. This is because it does not as yet have methods for object deletion, editing, or addition to the list of standing trees. Because the statistics and bounding box are tied to the collection, a caution is in order regarding changing in any way the objects within your R code. The best way to handle this is to simply extract the list from the object, do whatever editing has to be done to it, then use the constructor below to make a new object. Then everything will be correctly represented within the object.

Extends

Class "'>StemContainer", directly.

Methods

hist

signature(x = "standingTrees"): Displays a histogram of different variables in the collection.

plot

signature(x = "standingTrees", y = "missing"): Plot the collection.

summary

signature(object = "standingTrees"): Same as show currently.

References

“The Stem Class” vignette in this package.

See Also

Classes: "'>standingTree", "'>Stem", "'>StemContainer"; and to construct objects, the standingTrees constructor, perhaps using sampleTrees.

Examples

# NOT RUN {
showClass("standingTrees")
buff = matrix(c(0,100,0,100), nrow=2, byrow=TRUE,
              dimnames=list(c('x','y'),c('min','max')))
st = sampleTrees(10, dbh = c(10,25), sampleRect = buff)
sts = standingTrees(st)
summary(sts)
# }