controlVariate: Generate Objects of Class "'controlVariate'"
In sampSurf: Sampling Surface Simulation for Areal Sampling Methods

Description Usage Arguments Details Value Author(s) References See Also Examples

This generic has two methods, they are used to apply control variate subsampling to an individual "Stem" object, or collections of "Stem" objects. See controlVariate-methods for details.

1	controlVariate(object, ...)

`object`	This is the signature argument, see the `controlVariate-methods` for possible values.
`...`	Arguments that can be passed along to the proxy function.

Control variate sampling uses the differences between measured and proxy model cross-sectional areas to estimate the volume of a bole section. Control variate sampling is sensitive to departures of the proxy from the true bole, and can actually produce negative volumes. See the examples in the vignette reference below for examples illustrating this phenomenon.

A valid object of class "controlVariate" or "mcsContainer", depending on which method was used.

Jeffrey H. Gove

: Gove, J. H. 2013. Monte Carlo sampling methods in sampSurf. Package vignette.

See controlVariate-methods for methods. Other similar generics for Monte Carlo methods include: crudeMonteCarlo, importanceSampling, antitheticSampling.

#
# estimate volume between 10 and 15 m, using 5 random heights...
#
sTree = standingTree(dbh = 40, topDiam = 0, height = 20, solidType = 2.8)
sTree.cv = controlVariate(sTree, n.s = 5, segBnds = c(10,15), startSeed = 114,
           proxy = 'wbProxy', solidTypeProxy = 2.5, truncateProxyStem = FALSE)
sTree.cv