Stream.Network.Samples: For a SpatialStreamNetwork object with a dense grid of...

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

Description

For a Spatial Stream Network with a dense grid of potential sampling locations, this function draws samples according to the sampling designs found most optimal in Som et al. (2014), and a few others.

Usage

Stream.Network.Samples(ssn.list, sample.method, sample.size, use.locID,
  cluster.number = NULL, Wmat = NULL, DistMat = NULL,
  ClustDistMethod, max.dist, ...)

Arguments

ssn.list	an object of class list that contains one item names "ssn.object" which is a SpatialStreamNetwork and another item named "bin.table" which is the binaryID table for the assoicated SpatialStreamNetwork
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 with the desired sample size (USUALLY) but can differ depending on sampling design chosen - something to clean up.
use.locID	a logical indicating whether sites should be selected by locID instead of pid.
cluster.number	a numeric scalar for the number of sampling locations contained within each clusted sample.
Wmat	leftover from previous version of function when weigths matrix required as input
DistMat	leftover from previous version of function when distance matrix required as input
ClustDistMethod	An argument that controls the way that clusters of sites are created. Defaults to "prop.shortest.seg". Other options are "NoBound" and "fixed". If uncertain, leave blank. If you choosed "fixed", then you will need to specify max.dist.
max.dist	The largest distance (in map units) that can separate any two sites belonging to a single cluster. Defaults to the minimum edge length in the SSN. Leave blank if you have no strong beliefs about what this should be.
...	Other arguments to internal functions. None implemented as yet.

Value

a list containing a SpatialStreamNetwork for the selected samples, and a numeric vector with the selected pids

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.

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