hfsPlot: H. F. Smith Plot

In ssWavelets: Wavelet Functionality for Package 'sampSurf'

Description

This routine will generate a lattice plot for the marginal isotropic wavelet variance in the form of an ‘H. F. Smith’ plot; that is, variance versus the average inclusion zone area increasing on the x-axis for the different sampling methods.

The routine assumes the existence of one or more data frames from hfsMODWT, which takes an “ssMODWT” object set and exports the appropriate data frame—in this case the hfsMODWT output should be in the long form.

Usage

hfsPlot(...,
        sampMeth = c("Meth.A", "Meth.B"),
        conditionOn = c("iso.j", "tau.j", "j"),
        units = c("metric", "English"),
        showPlot = TRUE,
        fileName = "",
        ylab = "Isotropic Variance",
        xlab = "Average Inclusion Zone Area",
        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.
conditionOn	One of the factor or character columns in the data frame; for columns tau.j and j, they will be converted appropriately.
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.
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.

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

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

hfsMODWT, varPlot

Examples

#
# please see the examples in the vignette.
#

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