drawStreamNetworkSamples: Construct probability-based and heuristic designs from Som et...

In apear9/SSNdesign: An R Package for Optimal and Adaptive Sampling Designs on Stream Networks

Description

This function is a wrapper for Stream.Network.Samples. This function constructs many of the designs outlined in Som et al. (2014), such as GRTS and stream network designs with clusters around confluences.

Usage

drawStreamNetworkSamples(ssn, new.ssn.path, overwrite.path = FALSE,
  sample.method, sample.size, use.locID = FALSE, ...)

Arguments

ssn	An object of class SpatialStreamNetwork.
new.ssn.path	A path for the new .ssn directory where the results should be written out.
overwrite.path	A logical indicating whether the ssn directory referred to in new.ssn.path should be overwritten, if it exists already. Defaults to FALSE.
sample.method	A character vector providing the label for the specific sampling design that is desired, with references to Som et al. (2014) including simple random sample "SRS", "GRTS", "GRTSmouth", "GRTSclus","Headwater.Clust.and.Singles", "Trib.Sets.Head.Singles.sample", "Trib.Sets.Head.Singles.Mouth.sample"
sample.size	A numeric scalar specifying the desired sample size.
use.locID	A logical indicating whether sampling sites should be selected by locID instead of pid. Defaults to FALSE. NOTE: NOT CURRENTLY IMPLEMENTED.
...	Other arguments to Stream.Network.Samples. An example is cluster.number, which is required for some sample.method arguments.

Value

An object of class SpatialStreamNetwork. Note, any prediction points will have to be imported separately.

References

Som, N.A., Monestiez, P., Ver Hoef, J.M., Zimmerman, D.L., & Peterson, E.E. (2014). Spatial sampling on streams: principles for inference on aquatic networks. Environmetrics, 25(5), 306-323. doi: 10.1002/env.2284.

Examples

## Not run: 

# Create stream network
s <- createSSN(10, systematicDesign(.25), path = tempPath("s.ssn"), importToR = T)
createDistMat(s)
# Plot systematic design
plot(s)
# Now find a GRTS design
g <- drawStreamNetworkSamples(s, tempPath("g.ssn"), sample.method = "GRTS", sample.size = 10)
# Plot this design
plot(g)


## End(Not run)

apear9/SSNdesign documentation built on Feb. 19, 2020, 4:29 a.m.