monteTreeStatsBB {ssExtra}R Documentation

Calculate Tree-wise Statistics for Big BAF Sampling

Description

This routine will calculate the simple tree-wise statistics (mean, var, var of the mean, correlation) on the individual sample draws from each of the four sampling surfaces that can occur in big BAF sampling (see, e.g., "ssBigBAF").

Usage

monteTreeStatsBB(sdx,
                 ssBB,
                 stype = c("bigBAF", "count"),
                 ...)

Arguments

sdx

The sample cell numbers (the sample point index); note that it will be renamed to cellNum in the data frames exported here.

ssBB

An object of class “ssBigBAF”.

stype

‘bigBAF’ for tree stats on the big BAF surfaces; ‘count’ for the count surfaces.

...

Just gobbled for now.

Details

This routine is meant to be called from within monte in the Monte Carlo sampling for construction of “monteBigBAF” objects. However, given a sample of points (actually raster cells) from the sampling surfaces, one can call this routine directly to calculate sampling statistics over all points in the sample. For example, each “monteBigBAF” object contains all of the sample replicate draws in the mc.samples slot, so one could pass the ith such draw to this routine as desired.

It is important to note that the tree-wise basal area results are for the individual (and cell-wise aggregate) tree basal areas; they are not expanded. The tree (and cell-wise aggregate) VBARs are also returned. This is what distinguishes it from monteStatsBB, which calculates summaries based on point-wise expanded totals.

The routine is called once for the count surface summaries (stype = 'count'), and then again for the big BAF summaries ('bigBAF') as desired.

Value

A list with...

df.trees

A tree-wise data frame with each row containing the results (tree basal area and VBAR) from an individual tree in the sample, sorted by point. It also includes zero-records for any background cells selected in the sample of points.

list.df

A list of data frames corresponding to df.trees, where the individual data frames are NULL for packground points, or the trees measured in that cell/point; this list will have length length(sdx) (i.e., the sample size in terms of number of points).

df.cells

A cell-wise (point-wise) data frame where the trees have been aggregated (summed) by cell for tree-based (not expanded) totals at each cell/point.

treeStats

A data frame with the summary stats over all trees in df.trees.

cellStats

A data frame with the summary stats over all cells/points in df.cells.

n.v

The number of trees in the sample (i.e., in df.trees). This is the number of sampled VBAR trees.

Author(s)

Jeffrey H. Gove

See Also

monteStatsBB

Examples

#
# if nhAll310.mc is an object of class "monteBigBAF"
# and nhAll310.bb is the corresponding "ssBigBAF" object
# then the following retrieves the first sample of
# size n=10, and the associated sample statistics...
#
## Not run: 
ns = nhAll310.mc@mc.samples$n.10$mc.1
stats = monteTreeStatsBB(ns, nhAll310.bb)

## End(Not run)

[Package ssExtra version 0.1-2 Index]