hfsMODWT: Prepare "ssMODWT" Objects for Further Summary Analysis

In ssWavelets: Wavelet Functionality for Package 'sampSurf'

Description

This function takes a number of “ssMODWT” result objects and sets up a data frame with the isotropic variances for each level in the decomposition. It also includes total variance, average energy and surface mean from the decompositions, among others.

This is helpful in further analysis of the H. F. Smith type (using the companion hfsPlot), either by model estimation, plotting, or both.

Usage

hfsMODWT(..., ids = NA, long = TRUE, runQuiet = TRUE)

Arguments

...	Any number of “ssMODWT” objects.
ids	A character vector of simplified ids for each of the “...” objects. The names of the objects will be used by default (ids = NA). The identifying names (ids) should correspond to some measure of the size of the inclusion zone; e.g., for circular plots, these might be ids = c('cp.8', 'cp.10') for radii of 8 and 10m (ft), respectively.
long	TRUE: The results are a data frame in “long” format (more useful for, e.g., plotting with lattice); FALSE: the results are returned in “wide” format.
runQuiet	TRUE: No feedback when run; FALSE: Some summary results.

Details

Normally one run of this routine might correspond to a given sampling method, but with different design parameters like plot size or basal area factor. The reason for this is that then multiple methods (data frames from this function) are passed to one of the plotting methods (see below) and are assigned secondary identifiers to distinguish between sets of sampling methods (i.e., circular plots, horizontal point sampling, etc.). This seemed to be the simplest way to structure it at the time.

Note that one must not mix units of measure (“English” and “metric'”) in the “ssMODWT” objects passed. No formal check is made for this, so be good.

The average inclusion zone area is returned in the data frame as the unit of ‘effort’ corresponding to the various variances. For fixed-area plots, this is constant, for inclusion zones with area that is variable based on some size attribute of the standing trees or downed logs, this is the average over all inclusion areas in the population.

Details of its use are given in the vignette along with examples, which are somewhat lengthy to set up, therefore there are no examples presented below.

Value

A data frame in either wide or long format. The columns for both options are discussed in the vignette.

Author(s)

Jeffrey H. Gove

References

H. F. Smith. 1938. An empirical law describing heterogeneity in the yields of agricultural crops. Journal of Agricultural Science, 28:1–23

See Also

hfsPlot, varPlot

Examples

#
# please see the examples in the vignette.
#

ssWavelets documentation built on May 2, 2019, 5:54 p.m.