boot.titan: Controls the allocation of bootstrap replicates

In TITAN2: Threshold Indicator Taxa Analysis

Controls the allocation of bootstrap replicates

Description

A wrapper function for controlling the implementation of bootstrap replicates using the function 'tboot' by sequential or parallel processing.

Usage

boot.titan(
  env,
  taxa,
  ivTot = ivTot,
  boot = boot,
  ncpus = ncpus,
  nBoot = nBoot,
  minSplt = minSplt,
  nPerm = 250,
  memory = memory,
  imax = imax,
  numUnit = numUnit
)

Arguments

env	A vector of values for each sampling location along the environmental gradient.
taxa	A site-by-taxon matrix of taxa counts at each sampling location.
ivTot	A logical indicating whether IndVal scores should be calculated using total relative abundance or the mean relative abundace originally proposed by Dufrene and Legendre (1997). The default is to pass on the argument from the original TITAN funtion call.
boot	A logical specifying whether or not to implement TITAN's' boostrap procedure. The default is to use the value specified in the original TITAN function call.
ncpus	An argument specifying the number of processing cores used by the TITAN function call. If ncpus>1 then parallel processing is implemented. The default is to use the value specified in the original TITAN function call.
nBoot	An argument specifying the number of bootstrap replicates. The default is to use the value specified in the original TITAN function call.
minSplt	An argument specifying minimum split size for partitioning along the environmental gradient. The default is to use the value specified in the original TITAN function call.
nPerm	The number of replicates used by the permutation procedure (not to be confused with the number of bootstrap replicates).
memory	A logical indicating whether scratch files should be used to store temporary data in order to conserve active memory during bootstrapping of large data sets. The default is to pass on the argument from the original TITAN funtion call.
imax	A logical indicating whether taxon-specific change points should be determined by IndVal maxima or z-score maxima (as in TITAN v1.0). The default is to pass on the argument from the original TITAN funtion call.
numUnit	An argument specifying the number of values along the environmental gradient.

Details

If 'ncpus'>1 evaluates to TRUE, the function employs the package 'snow' to implement parallel processing on multicore processors common in modern desktop computers. With some minor modification it is possible to configure this code to allocate processes to cores on a high-performance computing cluster (i.e., a supercomputer). If 'ncpus'>1 evaluates to FALSE, the function uses 'lapply' to run 'tboot' in sequence 1:nBoot times.

Value

A list of two items:

bSeq

An index of the sequence of bootstrap replicates. The structure of bSeq will differ for sequential or parallel processing.

ivz.bt.list

Itself a list of four items comprising output passed on from function tboot()

Author(s)

M. Baker and R. King

References

Baker, ME and RS King. 2010. A new method for detecting and interpreting biodiversity and ecological community thresholds. Methods in Ecology and Evolution 1(1): 25:37.

See Also

tboot(), small.boot(), big.boot(), titan()

TITAN2 documentation built on Nov. 15, 2023, 1:09 a.m.