spaceFillingMaxiMin: A utility function for maximin space-filling designs

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

Description

spaceFillingMaximin is a utility function used by constructSpaceFillingDesign. It is also fully compatible with optimiseSSNDesign. It is a utility function that maximises the minimum interpoint distance between a set of design points.

Usage

spaceFillingMaxiMin(ssn, glmssn, design.points, prior.parameters, n.draws,
  extra.arguments)

Arguments

ssn	Ignored in this function but this argument is present so this function is consistent with all other utility functions.
glmssn	Ignored in this function but this argument is present so this function is consistent with all other utility functions.
design.points	A vector of pids corresponding to a set of observed sites in the obspoints slot of the SpatialStreamNetwork object.
prior.parameters	Ignored in this function but this argument is present so this function is consistent with all other utility functions.
n.draws	Ignored in this function but this argument is present so this function is consistent with all other utility functions.
extra.arguments	A list of extra parameters that control the behaviour of the utility function. The distance matrices required to compute covariance matrices are also stored in this list. Note that these are generated inside optimiseSSNDesign.

Details

spaceFillingMaximin is deterministic and will ignore the arguments prior.parameters and n.draws. It is expected to be very fast, unless there are several hundred design points to select.

For examples, please see constructSpaceFillingDesign.

Value

The expected utility of a design. This number represents the smallest non-zero distance between any pair of sites in the design.

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