standingTrees-methods {sampSurf}R Documentation

Methods for standingTrees Object Construction

Description

The following are the constructor methods for class “standingTrees” in Package sampSurf. Please see “The Stem Class” vignette for more information and examples on the usage of the methods.

Methods

signature(object = "list", container = "missing")

Ultimately, all of the constructors end up calling this one to generate the object after they have done what they were meant to, and then converted all of the “standingTree” objects into a list structure. So if one wishes, one can simply create one's own list of “standingTree” objects and use this constructor.

usage...

standingTrees(object,
              description = '',
              ... )
signature(object = "data.frame", container = "missing")

This particular method allows one to pass a data frame in the form generated from sampleTrees in the object argument to construct an object of class “standingTrees”. Note, however, that the data frame does not have to be created by sampleTrees, and it does not have to contain synthetic/simulated trees. As long as all of the columns are present that are generated by sampleTrees it will be used; for example, the data frame can be constructed from a field sample of trees.

usage...

standingTrees(object, units = 'metric', ... )
signature(object = "numeric", container = "bufferedTract")

This method will take as its first argument (object) the number of trees to be synthetically generated. The centers of the trees at breast height will all lie within the interior region of the “bufferedTract” object passed in the second (container) argument.

usage...

standingTrees(object, container, units = 'metric', ... )
signature(object = "numeric", container = "missing")

This constructor looks like it just generates trees randomly. But in reality, note the arguments below. It takes limits of a rectangular region as an alternative to specifying a bounding box matrix or a “bufferedTract” object as in two of the other constructors. Essentially, these limits get converted to a matrix bounding box and the appropriate constructor is used (see below).

usage...

standingTrees(object,
              xlim = c(0,100), 
              ylim = c(0,50),
              units = 'metric',
              ...)
signature(object = "numeric", container = "matrix")

Like the previous constructor, the trees will be generated so that their centers lie within a rectangular area specified by the matrix object in the second argument. Note that ultimately, the synthetic population of trees is generated by a call to sampleTrees.

usage...

standingTrees(object,
              container,
              units = 'metric',
              dbhs = c(8, 40),                    #cm for object construction!
              topDiams = c(0.4, 0.9),            #proportion multiplier
              heights = c(5,15),
              solidTypes = c(1,10),
              species = .StemEnv$species,
              ...) 

[Package sampSurf version 0.7-5 Index]