horizontalPointCVIZ: Generate Objects of Class "'horizontalPointCVIZ'"

In sampSurf: Sampling Surface Simulation for Areal Sampling Methods

Description

This generic is the base constructor for creating objects of class “horizontalPointCVIZ”. Please see the associated horizontalPointCVIZ-methods method for more details.

Usage

horizontalPointCVIZ(standingTree, angleGauge, ...)

Arguments

standingTree	Signature object of class "standingTree".
angleGauge	Signature object of class "angleGauge".
...	See associated method.

Details

It is very important to note both here and in the method documentation that the call to this constructor is the appropriate place to include any extra arguments that should be passed on to the controlVariate constructor for control of subsampling within the inclusion zone. In addition, different proxy functions can have extra arguments associated with them beyond the three required ones. Again, this is the place to pass any of these extra arguments to the proxy functions. Please see getProxy for documentation on the built-in proxy functions, and note the different arguments associated with each function.

Value

A valid object of class “horizontalPointCVIZ”.

Note

Please see the two vignettes cited above for more details on this and related classes.

In the following run, it is possible to look at the contents of the mcsObj slot for the object. Please note that any slot within this object other than those used to control the CV subsampling (e.g., segBnds) will not be used to estimate volume for the tree. This object will be used to control subsampling at each grid cell location within the inclusion zone when applied to the izGrid constructor. Therefore, while the volume and variance in this slot's object are applicable to the tree, they are not related to the final estimate that will be derived within sampSurf.

Author(s)

Jeffrey H. Gove

References

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

Gove, J. H. 2013. The “InclusionZone” Class. sampSurf Package vignette.

See Also

Other Monte Carlo methods that work with horizontal point sampling include: horizontalPointCMCIZ, horizontalPointISIZ, criticalHeightIZ, importanceCHSIZ, antitheticICHSIZ, pairedAICHSIZ.

Examples

#
# restrict CV sampling between 10-20m height and use the
# "wbProxy" function with solid type = 0.9*4 (close to true taper);
# with 2 subsamples to be taken on the tree at each grid cell...
#
st = standingTree(dbh=50, solidType=4, height=25)
ag = angleGauge(baf=4)
cvhps.iz = horizontalPointCVIZ(st, ag, segBnds=c(10,20),
           proxy='wbProxy', solidTypeProxy=0.9, n.s=2)
summary(cvhps.iz)
plot(cvhps.iz)

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