varPlot: Summary Wavelet Variance Plot

In ssWavelets: Wavelet Functionality for Package 'sampSurf'

Description

This routine creates a plot of the marginal isotropic variances against distance/scale conditioned on either (i) each of the different sampling methods, one panel for each method+size (i.e., baf, plot size) combination: groupSM = FALSE; or (ii) just the sampMethod level with each of the ‘sizes’ grouped: groupSM = TRUE. Note that using (i) could conceivably get rather busy panel-wise.

Usage

varPlot(..., 
        sampMeth = c("Meth.A", "Meth.B"), 
        groupSM = TRUE, 
        units = c("metric", "English"), 
        isoSmooth = TRUE, 
        showPlot = TRUE, 
        fileName = "", 
        ylab = "Isotropic Variance", 
        xlab = "Distance", 
        scales = "same", 
        type = "b", 
        pch = 19, 
        as.table = TRUE, 
        theme = c("plain", "custom", "ggplot", "economist"), 
        runQuiet = FALSE
       )

Arguments

...	Any number of long-form data frames as generated from hfsMODWT.
sampMeth	A character vector of sampling method identifiers that will give a label to each of the data frame objects in ‘...’ that is useful for grouping. For example, if the first data frame is from fixed-area plot sampling and the second from critial height sampling, one might use sampMeth = c("FAP","CHS") for the identifiers of these methods.
groupSM	TRUE: condition on sampMeth and group on the id column in the data frames; FALSE: condition on id and do not group.
units	The appropriate units that match the underlying sampling surface. Please be mindful that no checking is possible for the correct units as there is no connection between the original “sampSurf” objects and the data frames used for input.
isoSmooth	TRUE: include ‘LLJ’ (smooth) in the result for the isotropic variance at level J; FALSE: do not include the smooth component.
showPlot	TRUE: display the plot; FALSE: no display.
fileName	The file name for a ‘hard copy’; “” for no hard copy file of the plot.
ylab	See par.
xlab	See par.
scales	See xyplot.
type	See par.
pch	See par.
as.table	See xyplot.
theme	One of the lattice themes listed in the argument default; see the styles in latticeExtra.
runQuiet	TRUE: No feedback when run; FALSE: Some summary results.

Details

The sampMeth argument is helpful for distinguishing between sampling methods if more than one different method is used in the data frame(s) passed. Simply use a vector of blank strings if nothing is desired.

A hard copy to a file may be printed if hardcopyLattice is available (it resides in another of the author's packages and is available on request). Otherwise, simply print/plot the plt component of the return list to a trellis.device as usual for “lattice” objects.

Note that if groupSM = TRUE then we will have as many panels as sampling methods; if it is FALSE, then the number of panels is as above in (i).

If we want to look at a plot of just the isotropic wavelet variances without the smooth/scale component (LL.var in the “ssMODWT” object) at level J0, then one can use isoSmooth = FALSE.

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 list with...

df:	The concatenated data frames from “...”.
plt:	The “lattice” plot object.

Author(s)

Jeffrey H. Gove

See Also

hfsMODWT, hfsPlot

Examples

#
# please see the examples in the vignette.
#

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