ioptimum: Identification of the Optimal Sampling Effort

View source: R/ioptimum.R

ioptimumR Documentation

Identification of the Optimal Sampling Effort

Description

Estimates the sampling effort at which the improvement in precision (MultSE) per additional sampling unit becomes sub-optimal or redundant, based on predefined cut-off thresholds.

Usage

ioptimum(xx, multi.site = TRUE, c1 = 10, c2 = 5, c3 = 2.5)

Arguments

xx

A data frame generated by summary_ssp.

multi.site

Logical. Indicates whether multiple sites were simulated.

c1

First cut threshold. Default is 10% improvement over the highest MultSE.

c2

Second cut threshold. Default is 5% improvement over the highest MultSE.

c3

Third cut threshold. Default is 2.5% improvement over the highest MultSE.

Details

Sampling efforts between the minimum (e.g. 2 samples) and c1 represent the necessary effort to achieve acceptable precision. Efforts between c1 and c2 reflect sub-optimal gains, and those between c2 and c3 are considered optimal. Beyond c3, any additional effort results in marginal improvements in MultSE and may be considered redundant. This classification helps support cost-benefit decisions in ecological survey design (see Underwood, 1990). If c3 is not reached within the simulated range, the maximum available effort is returned with a warning.

Value

A vector or matrix indicating the sampling sizes corresponding to each cut-off point.

Note

The cut-off thresholds are arbitrary and should be adjusted based on the ecological question and resource availability. In some cases, c3 may not be reached within the range of simulated sampling efforts.

References

Underwood, A. J. (1990). Experiments in ecology and management: Their logics, functions and interpretations. Australian Journal of Ecology, 15, 365–389.

Guerra-Castro, E.J., Cajas, J.C., Simões, N., Cruz-Motta, J.J., & Mascaró, M. (2021). SSP: an R package to estimate sampling effort in studies of ecological communities. Ecography 44(4), 561-573. doi: \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1111/ecog.05284")}

See Also

plot_ssp, summary_ssp, sampsd

Examples

## Single site example
data(micromollusk)
par.mic <- assempar(data = micromollusk, type = "P/A", Sest.method = "average")
sim.mic <- simdata(par.mic, cases = 3, N = 20, sites = 1)
sam.mic <- sampsd(dat.sim = sim.mic,
                  Par = par.mic,
                  transformation = "P/A",
                  method = "jaccard",
                  n = 10,
                  m = 1,
                  k = 3)
summ.mic <- summary_ssp(results = sam.mic, multi.site = FALSE)
opt.mic <- ioptimum(xx = summ.mic, multi.site = FALSE)

## Multiple sites example
data(sponges)
par.spo <- assempar(data = sponges, type = "counts", Sest.method = "average")
sim.spo <- simdata(par.spo, cases = 3, N = 10, sites = 3)
sam.spo <- sampsd(dat.sim = sim.spo,
                  Par = par.spo,
                  transformation = "square root",
                  method = "bray",
                  n = 10,
                  m = 3,
                  k = 3)
summ.spo <- summary_ssp(results = sam.spo, multi.site = TRUE)
opt.spo <- ioptimum(xx = summ.spo, multi.site = TRUE)


SSP documentation built on June 8, 2025, 11:41 a.m.